summaryrefslogtreecommitdiff
path: root/README.OSX
diff options
context:
space:
mode:
authorWolfgang Hommel <wolf@code-wizards.com>2013-10-11 23:37:50 +0200
committerWolfgang Hommel <wolf@code-wizards.com>2013-10-11 23:37:50 +0200
commitb659b76c0ca513388275d0754060c071b7c191c1 (patch)
tree4cf1c4f3e4b6d288150ee06c2fd4dc395e90cb66 /README.OSX
parent088eb66b249fd2fb1fbc15203e516ec38bcfe318 (diff)
downloadlibfaketime-b659b76c0ca513388275d0754060c071b7c191c1.tar.gz
Updated installation notes for OS X
Diffstat (limited to 'README.OSX')
-rw-r--r--README.OSX40
1 files changed, 27 insertions, 13 deletions
diff --git a/README.OSX b/README.OSX
index a2f5d11..cc8abf3 100644
--- a/README.OSX
+++ b/README.OSX
@@ -7,32 +7,45 @@ command line and GUI applications will run stable.
Developments and tests are done on OSX 10.8+ currently, although the
current version will also work with OSX 10.7.
-Version 0.9.5 no longer works with OSX < 10.6 due to changes in the
-underlying system libraries. If you need libfaketime on OSX < 10.6,
+Version 0.9.5 no longer works 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.
-Compiling and using libfaketime on OS X is slightly different than
+Installing and using libfaketime on OS X 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.
-1) Compiling libfaketime on OS X
---------------------------------
+1) Installing libfaketime on OS X
+---------------------------------
-Use the OSX-specific Makefiles that are provided, e.g.:
+If you use MacPorts, libfaketime can be installed on the command line
+as follows:
-cd src/
-make -f Makefile.MacOS
+ sudo port install libfaketime
-The resulting library will be named libfaketime.1.dylib
+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.
+
+Use the OSX-specific Makefile that is provided:
+
+ make -f Makefile.OSX
+
+The resulting library will be named libfaketime.1.dylib ; to check
+whether it works properly, run the test suite and verify whether its
+output is correct:
+
+ cd test
+ make -f Makefile.OSX
2) Using libfaketime from the command line on OS X
--------------------------------------------------
You will need to set three environment variables. In a Terminal.app
-or iTerm session, the following commands can be used:
+or iTerm2 session, the following commands can be used:
export DYLD_FORCE_FLAT_NAMESPACE=1
export DYLD_INSERT_LIBRARIES=/path/to/libfaketime.1.dylib
@@ -45,7 +58,8 @@ variables that are related to it.
The "faketime" wrapper application has been adapted to OS X;
it offers the same limited libfaketime functionality as on Linux
in a simple-to-use manner without the need to manually set
-those environment variables.
+those environment variables. Run "faketime" without parameters
+for help and use "man faketime" for details.
3) Integrating libfaketime with applications
@@ -89,7 +103,7 @@ use appropriate editing or conversion tools.)
Afterwards, you will probably need to run
-/System/Library/Frameworks/CoreServices.framework/Frameworks/LaunchServices.framework/Support/lsregister -v -f /Applications/ApplicationName.app
+ /System/Library/Frameworks/CoreServices.framework/Frameworks/LaunchServices.framework/Support/lsregister -v -f /Applications/ApplicationName.app
to make sure the change to Info.plist does not go unnoticed.
@@ -99,7 +113,7 @@ such updates, including own new builds when using Xcode.
Please feel free to report non-working applications on the Github
libfaketime issues website. This may help us to identify further
-time-related system calls that need to be intercepted on OSX.
+time-related system calls that need to be intercepted on OS X.
https://github.com/wolfcw/libfaketime/issues