Skip to content
  • Karsten Blees's avatar
    trace: add high resolution timer function to debug performance issues · 148d6771
    Karsten Blees authored and Junio C Hamano's avatar Junio C Hamano committed
    
    
    Add a getnanotime() function that returns nanoseconds since 01/01/1970 as
    unsigned 64-bit integer (i.e. overflows in july 2554). This is easier to
    work with than e.g. struct timeval or struct timespec. Basing the timer on
    the epoch allows using the results with other time-related APIs.
    
    To simplify adaption to different platforms, split the implementation into
    a common getnanotime() and a platform-specific highres_nanos() function.
    
    The common getnanotime() function handles errors, falling back to
    gettimeofday() if highres_nanos() isn't implemented or doesn't work.
    
    getnanotime() is also responsible for normalizing to the epoch. The offset
    to the system clock is calculated only once on initialization, i.e.
    manually setting the system clock has no impact on the timer (except if
    the fallback gettimeofday() is in use). Git processes are typically short
    lived, so we don't need to handle clock drift.
    
    The highres_nanos() function returns monotonically increasing nanoseconds
    relative to some arbitrary point in time (e.g. system boot), or 0 on
    failure. Providing platform-specific implementations should be relatively
    easy, e.g. adapting to clock_gettime() as defined by the POSIX realtime
    extensions is seven lines of code.
    
    This version includes highres_nanos() implementations for:
     * Linux: using clock_gettime(CLOCK_MONOTONIC)
     * Windows: using QueryPerformanceCounter()
    
    Todo:
     * enable clock_gettime() on more platforms
     * add Mac OSX version, e.g. using mach_absolute_time + mach_timebase_info
    
    Signed-off-by: default avatarKarsten Blees <blees@dcon.de>
    Signed-off-by: default avatarJunio C Hamano <gitster@pobox.com>
    148d6771