1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
|
Since 0.9.9:
- automatically try to decide about FORCE_MONOTONIC_FIX
at run-time when not set as a compile-time flag
- improved macOS Monterey support through dyld interposing
- changed interception hooks for stat() and similar functions,
refactored to use a common handler (@sirainen)
- added support for timespec_get, timerfd_{get,set} (@sliquister)
- generic syscall() interception for selected syscalls (@dkg)
- improved testing system (@dkg)
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.
|
