summaryrefslogtreecommitdiff
path: root/libraries/libfaketime/README
blob: 75c5be370501daf347f821edfa662ca597f2122c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
libfaketime intercepts various system calls which programs use to
retrieve the current date and time. It can then report faked dates and
times (as specified by you, the user) to these programs. This means
you can modify the system time a program sees without having to change
the time system-wide.

libfaketime allows you to specify both absolute dates (e.g.,
01/01/2004) and relative dates (e.g., 10 days ago).

libfaketime might be used for various purposes, for example

- running legacy software with y2k bugs
- testing software for year-2038 compliance
- debugging time-related issues, such as expired SSL certificates
- running software which ceases to run outside a certain timeframe
- using different system-wide date and time settings, e.g., on OpenVZ-
  based virtual machines running on the same host
- deterministic build processes.