summaryrefslogtreecommitdiffstats
path: root/libraries/libfaketime/README
diff options
context:
space:
mode:
Diffstat (limited to 'libraries/libfaketime/README')
-rw-r--r--libraries/libfaketime/README17
1 files changed, 17 insertions, 0 deletions
diff --git a/libraries/libfaketime/README b/libraries/libfaketime/README
new file mode 100644
index 0000000000..cec958c321
--- /dev/null
+++ b/libraries/libfaketime/README
@@ -0,0 +1,17 @@
+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.