NEWS

Since 0.9.8:
    - When compiled with the CFLAG FAKE_RANDOM set,
      libfaketime will intercept calls to getrandom()
      and return pseudorandom numbers for determinism.
      The mechanism needs to be activated by setting
      the environment variable FAKERANDOM_SEED to a
      64-bit seed value, e.g., "0x12345678DEADBEEF".
      Please note that this completely breaks the
      security of random numbers for cryptographic
      purposes and should only be used for deterministic
      tests. Never use this in production!
    - When the environment variable FAKETIME_TIMESTAMP_FILE is
      set, points to a writeable (creatable) custom config file
      and the environment variable FAKETIME_UPDATE_TIMESTAMP_FILE
      is "1", then the file also is updated on each call. By
      this, a common "virtual time" can be shared by several
      processes, where each can adjust the time for all.
    - Additional link-time LDFLAGS can be passed via the
      environment variable FAKETIME_LINK_FLAGS when
      running 'make'.
    - Compile-time CFLAG FAKE_SETTIME can be enabled to
      intercept calls to clock_settime(), settimeofday(), and
      adjtime(). (suggested and prototyped by @ojura)
    - Additional compile-time CFLAGs can be passed via the
      environment variable FAKETIME_COMPILE_CFLAGS when
      running 'make'.
    - src/Makefile CFLAG FORCE_PTHREAD_NONVER should be set on
      systems that hang on CLOCK_REALTIME, or that hang on
      CLOCK_MONOTONIC where FORCE_MONOTONIC_FIX is not sufficient.

Since 0.9.7:
    - Passthrough for unknown clock ids to avoid error messages
    - Fixes for multithreaded operations (mliertzer, qnox)
    - glibc-related fixes (jprjr) and gcc8 support (tpetazzoni)
    - Improved error message output on parsing errors
    - fix file stat() faking when 'i' modifier is used for determinism
    - Use FAKETIME="%" to take FAKETIME setting from a file as
      specified in FAKETIME_FOLLOW_FILE
    - Added FAKETIME_DONT_RESET environment variable to avoid
      faketime resets when subprocesses are started (similar to
      the old v0.9.6 behavior)
    - Added FAKETIME_XRESET to avoid large clock jumps when
      the 'x' modifier is used and changed during run-time
    - Do not fake time during libfaketime initialization to
      improve compatibility with memory allocation libraries that
      use time-related functions themselves
    - Fixes for shared memory related issues, especially when
      not using the faketime wrapper
    - Updated glibc compatibility settings for various platforms
    - Support for clock_nanosleep() with realtime and monotonic clocks
    - Support for epoll_wait(), epoll_pwait(), and pselect()
    - src/Makefile CFLAG FORCE_MONOTONIC_FIX should be set (only) on
      platforms where the test program hangs forever at the
      CLOCK_MONOTONIC test.

Since 0.9.6:
    - Julien Gilli added an option to disable monotonic time faking
    - Azat Khuzhin added support for COARSE clocks
    - Preliminary support for CLOCK_BOOTTIME (Linux)
    - Fixed compilation on macOS (High) Sierra and various compiler warnings
    - Support for select() call added by Hitoshi Harada (umitanuki)
    - Updated documentation

Since 0.9.5:
    - fixed crashes that happened when other LD_PRELOAD libraries were used
    - fixed passing through of return values when using the faketime wrapper
    - fixed compile-time issues with CLOCK_MONOTONIC_RAW on some platforms
    - rbalint added Filter commands: FAKETIME_ONLY_CMDS and
      FAKETIME_SKIP_CMDS control which (sub-)processes libfaketime
      is applied to.

Since 0.9:
    - ryandesign at MacPorts provided a Portfile for MacPorts and
      fixed various build issues on OSX.
    - Balint Reczey added support for nanosecond resolution, saving
      timestamps to files, speeding up and slowing down per-process
      timers, CLOCK_MONOTONIC and CLOCK_MONOTONIC_RAW, faketime
      support for system calls such as sleep() and alarm().
    - Applied a patch by Gerardo Malazdrewicz and Toni G to restore
      compatibility with newer versions of glibc.
    - Balint Reczey added an option to use the same global clock setting
      for all libfaketime-spawned processes.
    - Balint Reczey has rewritten the faketime wrapper shell script in C
      and refactored libfaketime.
    - Balint Reczey added support for advancing the time with each time-
      related system call ("deterministic time").
    - Added "timeprivacy" wrapper by adrelanos; it ensures that programs
      are started with unique timestamps.
    - Code and documentation cleanup by Tomi Ollila.
    - Reworked Makefiles for more flexible installation, including fixes
      by Lukas Fleischner, Daniel Kahm Gillmor, and Hugues Andreux.
    - Fixed license issues as pointed out by Paul Wouters.
    - Mac OS X support has been improved for OS X 10.7 and 10.8; due to
      changes to the underlying libraries on OS X, libfaketime 0.9.5 will
      no longer work with OS X < 10.6; use libfaketime 0.9(.1) for older
      OS X installations.
    - Don Fong has contributed a new framework for functional tests.
      Petr Salinger ensured its compatibility with GNU/kFreeBSD.

Since 0.8.2:
    - Added support for "limited faking".
      You can optionally specify when libfaketime starts to fake the
      returned timestamps and when it shall stop doing so. For example,
      a program can be started regularly, and after 5 minutes run-time
      it will be sent two years into the future. Those limiting
      start and stop times can be specified in seconds or as the
      number of any time-related function calls within the program.
    - Added a feature to spawn an external process after x seconds
      or y time-related system calls. This can, for example, be used
      to execute an arbitrary shell script x seconds after a program
      has been started.

Since 0.8.1:
    - Added a MacOS port.
      Thanks to Daria Phoebe Brashear!
    - Added a functional test framework that aids in automatically
      determining whether libfaketime works properly on the current
      machine. Thanks to Don Fong!

Since 0.8:
    - Changed directory layout and Makefile structure.
      Thanks to Lukas Fleischer!

Since 0.7:
    - Added support for fstatat() and fstatat64() which were introduced in
      Linux kernel 2.6.16 and used in recent coreutils.
      Thanks to Daniel Kahn Gillmor for the report!
      This can be disabled by passing -DNO_ATFILE in the Makefile.
    - Added a simple wrapper shell script and a man page for it. Makes it
      easier to run commands under faked system times. It assumes that the
      libraries will be copied to /usr/lib/faketime during installation,
      please adjust this path if necessary. The "install" target in the
      Makefile has been adapted accordingly.
    - Added support for fractional time offsets, such as FAKETIME="+1,5h".
      Please note that either , or . has to be used as a delimiter
      depending on your locale. Thanks to Karl Chen!
    - Added support for speeding the clock up or slowing it down. For
      example, FAKETIME="+5d x2,0" will set the faked time 5 days into
      the future and make the clock run twice as fast for the specified
      program. Slowing it down can be done e.g. by using FAKETIME="+0 x0,5".
      Again, the delimiter to use for the fraction depends on your locale.
      Thanks to Karl Chen!

Since 0.6:
    Main version 0.7 contributions by David North, TDI:
    - Added ability to 'start clock at' a specific time.
    - Added pthread synchronization support
    - Added a 2 second delay to timetest.c so one can observe if the
      clock is relative or absolute
    - Added test.sh example of 'start clock at'
    - Added ability to disable the FAKE_STAT functionality at library-start
      in the case that the library was compiled -DFAKE_STAT, and added another
      test case for demonstrating this
    - Repaired a bug w.r.t. strptime/mktime wherein 'isdst' was uninitialized
      which led to pseudorandom +/- 1 hour results being returned in 'start at'
      or absolute time modes

    Other enhancements:
    - Fixed missing interceptions to libc-internal functions and added notes
      about a workaround for running Java programs with faked times in the
      future (they worked properly, but often locked up at exiting). Thanks to
      Jamie Cameron of Google for in-depth analysis and prototype solution!

Since 0.5:
    - Performance enhancements by means of caching the data read
      e.g. from $HOME/.faketimerc for 10 seconds.
    - Several file timestamp related system calls such as fstat() will be
      intercepted now. See the README file on how to turn this off if you
      do not need it. Thanks to Philipp Hachtmann!
    - A system-wide /etc/faketimerc file will now be used if no FAKETIME
      environment variable has been set and no $HOME/.faketimerc is present.
      Thanks to David Burley, Jacob Moorman, and Wayne Davison of
      SourceForge, Inc.!
    - Added trivial Makefile targets clean/distclean/install
    - Changed Makefile target test to run new test.sh script
    - Added new test cases to timetest.c

Since 0.4:
    - Allow "y" for years of offset specification. Thanks to Bas ten Berge!

Since 0.3:
    - Support for FAKETIME_FMT environment variable. Thanks to Moreno Baricevic!

Since 0.2:
    - Intercept clock_gettime(). Thanks to Andreas Thienemann!

Since 0.1:
    - Fixed segfault when calling time(NULL). Thanks to Andres Ojamaa!
    - Added additional sanity checks.