packet-dcerpc: nca_s_fault_sec_pkg_error
[metze/wireshark/wip.git] / README.macos
index baa693f9a9f79e03d2b2456669f9a7d33f928a9f..47f4a6b231c5c0610b4c5f1e12eb1645cac5a2f2 100644 (file)
@@ -1,5 +1,3 @@
-$Id$
-
 This file tries to help building Wireshark for (Mac) OS X (Wireshark
 does not work on earlier versions of Mac OS).
 
@@ -11,32 +9,42 @@ Store.  See
 
        http://guide.macports.org/chunked/installing.xcode.html
 
-for details.
+for details.  For Xcode 4, you will need to install the command-line
+tools; select Preferences from the Xcode menu, select Downloads in the
+Preferences window, and install Command Line Tools.
 
-You must have X11 and the X11 developer headers and libraries installed;
-otherwise, you will not be able to build or install GTK+, and will only
-be able to build TShark.  The X11 and X11 SDK that come with Mac OS X
-releases for releases from Panther to Lion can be used to build and run
-Wireshark.  Mountain Lion does not include X11; you should install X11
-from elsewhere, such as
+You must also have GLib and, if you want to build Wireshark as well as
+TShark, you must have also Qt installed.  You can download precompiled
+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, 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.
+
+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,
+and GTK+ libraries; otherwise, you will not be able to build or install
+GTK+.  The X11 and X11 SDK that come with OS X releases for releases
+from Panther to Lion can be used to build and run Wireshark.  Mountain
+Lion and later do not include X11; you should install X11 from
+elsewhere, such as
 
        http://xquartz.macosforge.org/
 
-You must also have GLib and, if you want to build Wireshark as well as
-TShark, GTK+.  The macosx-setup.sh script can be used to download, patch
-as necessary, build, 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.
-
 After you have installed those libraries:
 
-If you are building from a Subversion tree, rather than from a source
+If you are building from a Git tree, rather than from a source
 distribution tarball, run the autogen.sh script.  This should not be
 necessary if you're building from a source distribution tarball, unless
 you've added new source files to the Wireshark source.
@@ -50,7 +58,7 @@ you do, in the build directory:
     If you are building from a release tarball:
        make distclean
 
-    If you are building from SVN:
+    If you are building from Git:
        make maintainer-clean
        ./autogen.sh
 
@@ -92,7 +100,7 @@ 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
 type determined by standard autoconf code.  That code uses uname to
-determine the processor type; however, in Mac OS X, uname always reports
+determine the processor type; however, in OS X, uname always reports
 "i386" as the processor type on Intel machines, even Intel machines with
 64-bit processors, so it will attempt to assemble the 32-bit x86
 assembler-language routines, which will fail.  The workaround for this
@@ -116,3 +124,17 @@ 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.
+
+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
+additional tools.  From the Xcode menu, select the Open Developer Tool
+menu, and then select More Developer Tools... from that menu.  That will
+open up a page on the Apple Developer Connection Web site; you may need
+a developer account to download the additional tools.  Download the
+Auxiliary Tools for Xcode package; when the dmg opens, drag all its
+contents to the Contents/Applications subdirectory of the Xcode.app
+directory (normally /Applications/Xcode.app/Contents/Applications); then
+copy .../Contents/Applications/PackageMaker.app/Contents/MacOS/PackageMaker
+to /usr/bin/packagemaker (the PackageMaker app, when run from the
+command line rather than as a double-clicked app, is the packagemaker
+command).