-- Hoogle documentation, generated by Haddock
-- See Hoogle, http://www.haskell.org/hoogle/


-- | High-resolution clock functions: monotonic, realtime, cputime.
--   
--   A package for convenient access to high-resolution clock and timer
--   functions of different operating systems via a unified API.
--   
--   POSIX code and surface API was developed by Cetin Sert in 2009.
--   
--   Windows code was contributed by Eugene Kirpichov in 2010.
--   
--   FreeBSD code was contributed by Finn Espen Gundersen on 2013-10-14.
--   
--   OS X code was contributed by Gerolf Seitz on 2013-10-15.
--   
--   Derived <tt>Generic</tt>, <tt>Typeable</tt> and other instances for
--   <tt>Clock</tt> and <tt>TimeSpec</tt> was contributed by Mathieu
--   Boespflug on 2014-09-17.
--   
--   Corrected dependency listing for <tt>GHC &lt; 7.6</tt> was contributed
--   by Brian McKenna on 2014-09-30.
--   
--   Windows code corrected by Dimitri Sabadie on 2015-02-09.
--   
--   Added <tt>timeSpecAsNanoSecs</tt> as observed widely-used by Chris
--   Done on 2015-01-06, exported correctly on 2015-04-20.
--   
--   Imported Control.Applicative operators correctly for Haskell Platform
--   on Windows on 2015-04-21.
--   
--   Unit tests and instance fixes by Christian Burger on 2015-06-25.
--   
--   Removed fromInteger definition for TimeSpec, Cetin Sert on 2015-12-15.
--   
--   <ul>
--   <li><i>Version Scheme</i> Major-<tt><i>R</i></tt>-ewrite .
--   New-<tt><i>F</i></tt>-unctionality .
--   <tt><i>I</i></tt>-mprovementAndBugFixes .
--   <tt><i>P</i></tt>-ackagingOnly</li>
--   </ul>
--   
--   <ul>
--   <li><tt>PackagingOnly</tt> changes are made for quality assurance
--   reasons.</li>
--   </ul>
@package clock
@version 0.5.2


-- | High-resolution, realtime clock and timer functions for Posix
module System.Clock

-- | Clock types. A clock may be system-wide (that is, visible to all
--   processes) or per-process (measuring time that is meaningful only
--   within a process). All implementations shall support CLOCK_REALTIME.
data Clock

-- | The identifier for the system-wide monotonic clock, which is defined
--   as a clock measuring real time, whose value cannot be set via
--   <tt>clock_settime</tt> and which cannot have negative clock jumps. The
--   maximum possible clock jump shall be implementation defined. For this
--   clock, the value returned by <a>getTime</a> represents the amount of
--   time (in seconds and nanoseconds) since an unspecified point in the
--   past (for example, system start-up time, or the Epoch). This point
--   does not change after system start-up time. Note that the absolute
--   value of the monotonic clock is meaningless (because its origin is
--   arbitrary), and thus there is no need to set it. Furthermore, realtime
--   applications can rely on the fact that the value of this clock is
--   never set.
Monotonic :: Clock

-- | The identifier of the system-wide clock measuring real time. For this
--   clock, the value returned by getTime represents the amount of time (in
--   seconds and nanoseconds) since the Epoch.
Realtime :: Clock

-- | The identifier of the CPU-time clock associated with the calling
--   process. For this clock, the value returned by getTime represents the
--   amount of execution time of the current process.
ProcessCPUTime :: Clock

-- | The identifier of the CPU-time clock associated with the calling OS
--   thread. For this clock, the value returned by getTime represents the
--   amount of execution time of the current OS thread.
ThreadCPUTime :: Clock

-- | TimeSpec structure
data TimeSpec
TimeSpec :: {-# UNPACK #-} !Int64 -> {-# UNPACK #-} !Int64 -> TimeSpec

-- | seconds
[sec] :: TimeSpec -> {-# UNPACK #-} !Int64

-- | nanoseconds
[nsec] :: TimeSpec -> {-# UNPACK #-} !Int64

-- | The <a>getTime</a> function shall return the current value for the
--   specified clock.
getTime :: Clock -> IO TimeSpec

-- | The <a>getRes</a> function shall return the resolution of any clock.
--   Clock resolutions are implementation-defined and cannot be set by a
--   process.
getRes :: Clock -> IO TimeSpec

-- | Compute the absolute difference.
diffTimeSpec :: TimeSpec -> TimeSpec -> TimeSpec

-- | TimeSpec as nano seconds.
timeSpecAsNanoSecs :: TimeSpec -> Integer
instance GHC.Generics.Selector System.Clock.S1_0_1TimeSpec
instance GHC.Generics.Selector System.Clock.S1_0_0TimeSpec
instance GHC.Generics.Constructor System.Clock.C1_0TimeSpec
instance GHC.Generics.Datatype System.Clock.D1TimeSpec
instance GHC.Generics.Constructor System.Clock.C1_3Clock
instance GHC.Generics.Constructor System.Clock.C1_2Clock
instance GHC.Generics.Constructor System.Clock.C1_1Clock
instance GHC.Generics.Constructor System.Clock.C1_0Clock
instance GHC.Generics.Datatype System.Clock.D1Clock
instance GHC.Show.Show System.Clock.TimeSpec
instance GHC.Read.Read System.Clock.TimeSpec
instance GHC.Generics.Generic System.Clock.TimeSpec
instance GHC.Show.Show System.Clock.Clock
instance GHC.Read.Read System.Clock.Clock
instance GHC.Generics.Generic System.Clock.Clock
instance GHC.Enum.Enum System.Clock.Clock
instance GHC.Classes.Eq System.Clock.Clock
instance Foreign.Storable.Storable System.Clock.TimeSpec
instance GHC.Num.Num System.Clock.TimeSpec
instance GHC.Classes.Eq System.Clock.TimeSpec
instance GHC.Classes.Ord System.Clock.TimeSpec