summaryrefslogtreecommitdiff
path: root/README.OSX
diff options
context:
space:
mode:
authorMichael D. Stemle, Jr <themanchicken@gmail.com>2019-11-27 14:32:15 -0500
committerMichael D. Stemle, Jr <themanchicken@gmail.com>2019-11-27 14:32:15 -0500
commitf92d919fb0635768bc95b5bc2d45a73411c52deb (patch)
tree751832f032c0a3f0dd0f12f501bea70dca95a321 /README.OSX
parent150a6cb3b20da7c3499c9650e815a76b0702e82c (diff)
parent826f8b779242cf66b3f6537c1549c2a6b9cd40e4 (diff)
downloadlibfaketime-f92d919fb0635768bc95b5bc2d45a73411c52deb.tar.gz
Merged master in and cleaned up.
We no longer need the OSX-specific test. Tests are passing, too.
Diffstat (limited to 'README.OSX')
-rw-r--r--README.OSX40
1 files changed, 25 insertions, 15 deletions
diff --git a/README.OSX b/README.OSX
index 25d503b..01c7977 100644
--- a/README.OSX
+++ b/README.OSX
@@ -5,16 +5,14 @@ Support for macOS has meanwhile matured and many command line and
GUI applications will run stable.
Developments and tests are done on Mojave currently.
-Use libfaketime 0.9.6 or earlier on OS X (i.e., before Sierra).
-Version 0.9.5 and higher no longer works with OSX <= 10.6 due to
+Version 0.9.5 and higher no longer work with OSX <= 10.6 due to
changes in the underlying system libraries. If you need libfaketime
on OSX <= 10.6, please use libfaketime version 0.9.
-
-Installing and using libfaketime on OS X is slightly different than
+Installing and using libfaketime on macOS is slightly different than
on Linux. Please make sure to read the README file for general
-setup and usage, and refer to this file only about OS X specifics.
+setup and usage, and refer to this file only about macOS specifics.
1) Installing libfaketime on macOS
@@ -33,6 +31,10 @@ Or, if you use Homebrew, install using:
brew install libfaketime
+Please inform the respective package maintainers if the latest release
+is not yet available this way. With homebrew, you can typically use
+"brew install --HEAD" to install from the latest source automatically.
+
Otherwise, you have to compile and install libfaketime manually; this
will require a working installation of Xcode and its command line tools
on your machine.
@@ -60,7 +62,7 @@ system-dependent files by running:
---------------------------------------------------
You will need to set three environment variables. In a Terminal.app
-or iTerm2 session, the following commands can be used:
+or any other CLI session, the following commands can be used:
export DYLD_FORCE_FLAT_NAMESPACE=1
export DYLD_INSERT_LIBRARIES=/path/to/libfaketime.1.dylib
@@ -81,7 +83,7 @@ for help and use "man faketime" for details.
--------------------------------------------
Given the limited number of system calls libfaketime intercepts,
-it may not work too well with specific GUI applications on OS X.
+it may not work too well with specific GUI applications on macOS.
This can result in crashes after a seemingly random time, or an
application will not or at least not always see the faked time,
and so on.
@@ -132,13 +134,20 @@ time-related system calls that need to be intercepted on macOS.
https://github.com/wolfcw/libfaketime/issues
-Important: When reporting non-working applications, please make
-sure that your issue is not related to SIP (system integrity
-protection). For example, on a SIP-enabled, default macOS installation,
-libfaketime will not work for programs like /bin/bash because
-the path /bin is SIP-protected. Copy your application to a
-non-SIP-protected path, and if libfaketime still does not work,
-feel free to report it.
+However, there are two important aspects:
+
+- When reporting non-working applications, please make sure that your issue is
+ not related to SIP (system integrity protection). For example, on a
+ SIP-enabled, default macOS installation, libfaketime will not work for
+ programs like /bin/bash because the path /bin is SIP-protected. Copy your
+ application to a non-SIP-protected path, and if libfaketime still does not
+ work, feel free to report it.
+
+- We cannot and will not help with using libfaketime for proprietary or
+ commercial software unless you are its developer trying to integrate
+ libfaketime. Please contact the developers or the vendor directly if
+ you have problems using libfaketime with non-free / not open sourced
+ macOS applications.
4) Notes for developers of macOS applications
@@ -146,4 +155,5 @@ feel free to report it.
The environment variable FAKETIME can be changed at application run-time
and always takes precedence over other user-controlled settings. It can
-be re-set to 0 (zero) to work around potential incompatibilities.
+be re-set to 0 (zero) to work around potential incompatibilities or if
+you do not want libfaketime applied to your software.