diff options
author | Guy Harris <guy@alum.mit.edu> | 2017-08-02 00:39:58 -0700 |
---|---|---|
committer | Guy Harris <guy@alum.mit.edu> | 2017-08-02 07:40:34 +0000 |
commit | 2a17c33928eba4ee0e383ee838b5980748448730 (patch) | |
tree | d00c7be19eecc775962c775eb24a7c4bcb3ecb79 /README.macos | |
parent | c5569cfa0b985b763608231fe4b2fc976422aa33 (diff) |
Move macosx-setup.sh to tools and remove the "x".
The OS is now called just macOS, and the rest of the setup scripts are
in tools, so move this one there as well.
Update the documentation to reflect the change.
Change-Id: I4d9ebf0797ffe8862e82c4bcfdeec1d2eabae6ae
Reviewed-on: https://code.wireshark.org/review/22918
Reviewed-by: Guy Harris <guy@alum.mit.edu>
Diffstat (limited to 'README.macos')
-rw-r--r-- | README.macos | 55 |
1 files changed, 29 insertions, 26 deletions
diff --git a/README.macos b/README.macos index f16f256bbd..cbb3ef82ce 100644 --- a/README.macos +++ b/README.macos @@ -20,18 +20,21 @@ Qt packages and source code from https://www.qt.io/download-open-source/ -or use the macosx-setup.sh script described below. - -The macosx-setup.sh script can be used to download, patch as necessary, -build as necessary, and install those libraries and the libraries on -which they depend; it will, by default, also install other libraries -that can be used by Wireshark and TShark. The versions of libraries to -download are specified by variables set early in the script; you can -comment out the settings of optional libraries if you don't want them -downloaded and installed. Before running the macosx-setup.sh script, -and before attempting to build Wireshark, make sure your PKG_CONFIG_PATH -environment variable's setting includes both /usr/X11/lib/pkgconfig and -/usr/local/lib/pkgconfig. +or use the tools/macos-setup.sh script described below. + +The tools/macos-setup.sh script can be used to download, patch as +necessary, build as necessary, and install those libraries and the +libraries on which they depend; it will, by default, also install other +libraries that can be used by Wireshark and TShark. The versions of +libraries to download are specified by variables set early in the +script; you can comment out the settings of optional libraries if you +don't want them downloaded and installed. Before running the +tools/macos-setup.sh script, and before attempting to build Wireshark, +make sure your PKG_CONFIG_PATH environment variable's setting includes +both /usr/X11/lib/pkgconfig and /usr/local/lib/pkgconfig. + +The tools/macos-setup.sh script must be run from the top-level source +directory. If you wish to build the legacy (GTK+) UI you must have X11 and the X11 developer headers and libraries installed, as well as the Pango, ATK, @@ -81,7 +84,7 @@ un-install them and rebuild them on your current version of macOS, to get Some required and optional libraries require special attention if you install them by building from source code on Snow Leopard and later -releases; the macosx-setup.sh script will handle that for you. +releases; the tools/macos-setup.sh script will handle that for you. GLib - the GLib configuration script determines whether the system's libiconv is GNU iconv or not by checking whether it has libiconv_open(), @@ -89,14 +92,14 @@ and the compile will fail if that test doesn't correctly indicate whether libiconv is GNU iconv. In macOS, libiconv is GNU iconv, but the 64-bit version doesn't have libiconv_open(); a workaround for this is to replace all occurrences of "libiconv_open" with "iconv_open" in the -configure script before running the script. The macosx-setup.sh setup -script will patch GLib to work around this. +configure script before running the script. The tools/macos-setup.sh +setup script will patch GLib to work around this. GTK+ - GTK+ 2.24.10, at least, doesn't build on Mountain Lion with the CUPS printing backend - either the CUPS API changed incompatibly or the backend was depending on non-API implementation details. The -macosx-setup.sh setup script will, on Mountain Lion and later, configure -GTK+ with the CUPS printing backend disabled. +tools/macos-setup.sh setup script will, on Mountain Lion and later, +configure GTK+ with the CUPS printing backend disabled. libgcrypt - the libgcrypt configuration script attempts to determine which flavor of assembler-language routines to use based on the platform @@ -106,25 +109,25 @@ determine the processor type; however, in macOS, uname always reports 64-bit processors, so it will attempt to assemble the 32-bit x86 assembler-language routines, which will fail. The workaround for this is to run the configure script with the --disable-asm argument, so that -the assembler-language routines are not used. The macosx-setup.sh will -configure libgcrypt with that option. +the assembler-language routines are not used. The tools/macos-setup.sh +will configure libgcrypt with that option. PortAudio - when compiling on macOS, the configure script for the pa_stable_v19_20071207 version of PortAudio will cause certain platform-dependent build environment #defines to be set in the Makefile rules, and to cause a universal build to be done; those #defines will be incorrect for all but one of the architectures for which the build is -being done, and that will cause a compile-time error on Snow Leopard. +being done, and that will cause a compile-time error on Snow Leopard. Newer versions don't have this problem, but still fail to build on Lion -if a universal build is attempted. The macosx-setup.sh script downloads -a newer version, and also suppresses the universal build. +if a universal build is attempted. The tools/macos-setup.sh script +downloads a newer version, and also suppresses the universal build. GeoIP - Their man pages "helpfully" have an ISO 8859-1 copyright symbol -in the copyright notice, but macOS's default character encoding is UTF-8. -sed on Mountain Lion barfs at the "illegal character sequence" +in the copyright notice, but macOS's default character encoding is +UTF-8. sed on Mountain Lion barfs at the "illegal character sequence" represented by an ISO 8859-1 copyright symbol, as it's not a valid UTF-8 -sequence. The macosx-setup.sh script uses iconv to convert the man page -files from ISO 8859-1 to UTF-8. +sequence. The tools/macos-setup.sh script uses iconv to convert the man +page files from ISO 8859-1 to UTF-8. If you want to build Wireshark installer packages on a system that doesn't include Xcode 3.x or earlier, you will need to install some |