diff --git a/docs/nmap-install.xml b/docs/nmap-install.xml index c212ecfdb..b171f1d5e 100644 --- a/docs/nmap-install.xml +++ b/docs/nmap-install.xml @@ -939,7 +939,7 @@ command such as nmap scanme.nmap.org from any directory.Christensen, Steven does an excellent job of maintaining -Nmap packages over at . Instructions are +Nmap packages at for all modern Solaris versions and architectures. Instructions are on his site, and are generally very simple: download the appropriate Nmap package for your version of Solaris, decompress it, and then run pkgadd -d packagename. @@ -958,25 +958,24 @@ you have more flexibility in the build process. Thanks to several people graciously donating shell accounts on their Mac OS X boxes, Nmap usually compiles on that platform without problems. Because not everyone has the development tools necessary to -compile from source, there is an executable installer as well. -Additionally Nmap is available through some of the systems that package -Unix software for Mac OS X. +compile from source, there is an executable installer as well. Nmap +is also available through systems such as MacPorts and Fink which +package Unix software for Mac OS X. Executable Installer Mac OS Xexecutable installer The easiest way to install Nmap and Zenmap on Mac OS X is to use -the installer. In the +our installer. The Mac OS X section of -the Nmap download page there is a file called +the Nmap download page provides a file named nmap-version.dmg, where version is the version number of the most recent release. The .dmg.dmg (Mac OS X disk image)disk image (Mac OS X) file is known as a -disk image. This is the process for installing from the -disk image. +disk image. Installation instructions follow: Download the file @@ -984,11 +983,11 @@ disk image. Double-click the icon to open it. (Depending on how you downloaded the file, it may be opened automatically.) The contents of the disk image will be displayed. One of -the files will be +the files will be a Mac meta-package file named nmap-version.mpkg. Double-click it to start the installer. Follow the instructions in the -installer. You will be asked for your password. +installer. You will be asked for your password since Nmap installs in a system directory. Once the installer is finished, eject the disk image by control-clicking on its icon and selecting Eject. The disk image may now be placed in @@ -996,10 +995,10 @@ the trash. See the instructions in for -help on running Nmap and Zenmap once they have been installed. +help on running Nmap and Zenmap after they are installed. The programs installed by the installer are universal binaries -that will run on Mac OS X 10.4 or later. Users of earlier versions will +that will run on Mac OS X 10.4 (Tiger) or later. Users of earlier versions will have to compile from source or use a third-party package. @@ -1016,7 +1015,7 @@ on other platforms once a proper build environment is in place. Compiling Nmap on Mac OS X requires Xcode,Xcode Apple's developer tools that include GCC and the rest of the usual build -system. Xcode is not installed by default but it is available as an +system. Xcode is not installed by default, but is available as an optional install on the Mac OS X installation discs. If you do not have the installation discs or if you want a newer version, you can download Xcode free of charge by following these steps. @@ -1039,7 +1038,7 @@ log in with your account credentials. These exact steps may change, but it is hoped that this general approach will continue to work. -Once you have installed Xcode, you can follow the compilation instructions found in . Note that on some older versions of Mac OS X, you may have to replace the command ./configure with ./configure CPP=/usr/bin/cpp. +Once you have installed Xcode, follow the compilation instructions found in . Note that on some older versions of Mac OS X, you may have to replace the command ./configure with ./configure CPP=/usr/bin/cpp. @@ -1047,7 +1046,7 @@ approach will continue to work. Zenmapdependencies of Zenmap depends on some external libraries that do not come with -Mac OS X, such as GTK+ and PyGTK. These libraries have many dependencies +Mac OS X, including GTK+ and PyGTK. These libraries have many dependencies of their own. A convenient way to install all of them is to use a third-party packaging system as described in . Once the dependencies are @@ -1060,22 +1059,22 @@ install Zenmap as usual. Mac OS Xinstalling from third-party packages Third-party Packages -A further option for installing Nmap is to use one of the systems -that packages Unix software for Mac OS X. The two discussed here are +Another option for installing Nmap is to use a system +which packages Unix software for Mac OS X. The two discussed here are Fink and MacPorts. See the respective projects' web sites for installation instructions. Fink -To install using Fink, use the command fink install +To install using Fink, run the command fink install nmap. Nmap will be installed as /sw/bin/nmap. To uninstall use the command fink remove nmap. MacPorts -To install using MacPorts, use the command sudo port +To install using MacPorts, run sudo port install nmap. Nmap will be installed as -/opt/local/bin/nmap. To uninstall use the command +/opt/local/bin/nmap. To uninstall, run sudo port uninstall nmap. @@ -1084,9 +1083,9 @@ install nmap. Nmap will be installed as Executing Nmap on Mac OS X The terminal emulator in Mac OS X is called -Terminal, and it is located in the directory -/Applications/Utilities. Open it and you will see a -terminal window. This is where you will type your commands. +Terminal, and is located in the directory +/Applications/Utilities. Open it and a +terminal window appears. This is where you will type your commands. By default the root user is disabled on Mac OS X. To run a scan with @@ -1106,8 +1105,8 @@ type your password. Users with administrator privilegesprivileged users may enter their password to allow Zenmap to run as the root user and run more advanced -scans. To run Zenmap in unprivileged mode, just select the -Cancel button on this dialog. +scans. To run Zenmap in unprivileged mode, select the +Cancel button on this authentication dialog. @@ -1138,7 +1137,7 @@ FAQ contains detailed instructions for each method. Here is a summary: Installation using binary packages Choose a mirror from . FTP in and grab the Nmap +url="http://www.openbsd.org/ftp.html" />, then FTP in and grab the Nmap package from /pub/OpenBSD/version/packages/platform/nmap-version.tgz. Or obtain it from the OpenBSD distribution CD-ROM. @@ -1167,7 +1166,7 @@ processes. A brief summary of the process follows. with the argument if you want the X-Window front-end. If you wish to obtain the package manually instead, retrieve it from and or +url="http://freshports.org/security/nmap" /> and or the CDROM and run pkg_add packagename.tgz. @@ -1188,7 +1187,7 @@ chapter referenced above. NetBSD Binary Package Instructions NetBSD, installing on -NetBSD has packaged Nmap for an enormous number of platforms, from the normal i386 to PlayStation 2, PowerPC, VAX, SPARC, MIPS, Amiga, ARM, and several platforms that I have never even heard of! Unfortunately they are not very up-to-date. A list of NetBSD Nmap packages is available from and a description of using their package system to install applications is available at . +NetBSD has packaged Nmap for an enormous number of platforms, from the normal i386 to PlayStation 2, PowerPC, VAX, SPARC, MIPS, Amiga, ARM, and several platforms that I have never even heard of! Unfortunately they are not very up-to-date. A list of NetBSD Nmap packages is available from and a description of using their package system to install applications is available at . @@ -1200,10 +1199,10 @@ chapter referenced above. One of the wonders of Open Source development is that resources -are often biased towards what people find exciting rather than having +are often directed towards what people find exciting rather than having an exclusive focus on profits as most corporations do. It is along those lines that the Amiga port came about. -Diego CasorranCasorran, Diegoperformed +Diego CasorranCasorran, Diego performed most of the work and sent in a clean patch which was integrated into the main Nmap distribution. In general, AmigaOS users should be able to simply follow the source compilation instructions in Nmap supports many proprietary Unix flavors such as HP-UX and SGI IRIX. The Nmap project mostly depends on the user community to maintain adequate support for these systems. If you have trouble, try -sending a report with full details to the nmap-dev mailing list -(nmap-dev@insecure.org).nmap-dev mailing list -If you develop a patch which -improves support on your platform, please email it to nmap-dev or to me at fyodor@insecure.org. +sending a report with full details to the nmap-dev mailing listnmap-dev mailing list, as described in . Also let us know if +you develop a patch which +improves support on your platform so we can incorporate it into Nmap. Removing Nmap @@ -1243,6 +1241,8 @@ zenmap as root. Analogous options are offered by most other package managers—consult their documentation for further information. +If you installed Nmap from the Windows, simply open the Control Panel, select Add or Remove Programs and select the Remove button for Nmap. You can also remove WinPcap unless you need it for other applications such as Wireshark. + If you installed Nmap from source code, removal is slightly more difficult. If you still have the build directory available (where you initially ran make @@ -1251,7 +1251,7 @@ running make uninstall. If you no longer have that build directory, type nmap -V to obtain the Nmap version number. Then download that source tarball for that version of -Nmap from . +Nmap from or . Uncompress the tarball and change into the newly created directory (nmap-version). Run ./configure, including any install-path options that you specified