From 562e8f183f09e20c530500594f9b122cdf0a8315 Mon Sep 17 00:00:00 2001 From: fyodor Date: Mon, 14 Jul 2008 01:07:18 +0000 Subject: [PATCH] more updates from careful review of installation chapter. Regenerated Windows cmd.exe screenshot from 2003 --- docs/nmap-install.xml | 87 +++++++++++++++++++++++++++---------------- 1 file changed, 55 insertions(+), 32 deletions(-) diff --git a/docs/nmap-install.xml b/docs/nmap-install.xml index 42e34d9e0..c212ecfdb 100644 --- a/docs/nmap-install.xml +++ b/docs/nmap-install.xml @@ -682,31 +682,46 @@ on Unix. Here are some known limitations: Windowslimitations of -You cannot generally scan your own machine from itself (using a loopbackloopback interface IP such as 127.0.0.1 or any of its registered IP addresses). This is a Windows limitation that we haven't yet worked around. If you really want to do this, use a TCP connect scan without pinging () as that uses the high level socket API rather than sending raw packets. -Nmap only supports ethernet interfaces (including many 802.11 wireless cards) unless you use the options. RAS connections (such as PPP dialups) are not supported. This support was dropped when Microsoft removed raw TCP/IP socket support in Windows XP SP2. Now Nmap must send lower-level ethernet frames instead. + +You cannot generally scan your own machine from itself +(using a loopbackloopback +interface IP such as 127.0.0.1 or any of its +registered IP addresses). This is a Windows limitation that we +haven't yet worked around. If you really want to do this, use a TCP +connect scan without pinging () as that uses +the high level socket API rather than sending raw +packets. + +Nmap only supports ethernet interfaces (including most +802.11 wireless cards and many VPN clients) for raw packet scans. +Unless you use the options, RAS connections +(such as PPP dialups) and certain VPN clients are not supported. This +support was dropped when Microsoft removed raw TCP/IP socket support +in Windows XP SP2. Now Nmap must send lower-level ethernet frames +instead. + Windowsperformance of Scans speeds on Windows are generally comparable to those on Unix, though the latter often has a slight performance edge. One exception to this is connect scan (), which is -often much slower than on Unix because of deficiencies in the Windows +often much slower on Windows because of deficiencies in the Windows networking API. This is a shame, since that is the one TCP scan that works against localhost and over all networking types (not just ethernet, like the raw packet scans). Connect scan performance can be improved substantially by applying the Registry changes in the -nmap_performance.reg file included with Nmap. It +nmap_performance.reg file included with Nmap. By default these changes are applied for you by the Nmap executable installer. This registry file is in the nmap-version directory of the Windows binary zip file, and nmap-version/mswin32 in the source tarball (where version is the version number of the specific release). These changes increase the number of ephemeral ports reserved for user applications (such as -Nmap) and decreases the amount of time before a closed connection can -be reused. Apply the by double-clicking on -nmap_performance.reg, or run the command -regedt32 nmap_performance.reg. Or you can make the -changes by hand. Simply add these three Registry DWORD values to +Nmap) and reduce the time delay before a closed connection can +be reused. Most people simply check the box to apply these changes in the executable Nmap installer, but you can also apply them by double-clicking on +nmap_performance.reg, or by running the command +regedt32 nmap_performance.reg. To make the changes by hand, add these three Registry DWORD values to the CurrentControlSet\Services\Tcpip\Parameters entry under HKEY_LOCAL_MACHINE\SYSTEM: @@ -732,18 +747,18 @@ download page at . Windows Self-installer Windowsself-installer -Every major “stable” Nmap release comes with Windows +Every Nmap release includes a Windows self-installer named nmap-version-setup.exe (where version is the version number of the specific release). Most Nmap users choose this option since it is so -easy. Simply run the installer file and let it walk you through +easy. Another advantage of the self-installer is that it provides the option to install the Zenmap GUI. Simply run the installer file and let it walk you through panels for choosing an install path and installing WinPcap. The installer was created with the open-source Nullsoft Scriptable Install System. After it completes, read for instructions on executing Nmap on the -command-line. +command-line or through Zenmap. @@ -782,14 +797,21 @@ alternatives are Winzip and changes discussed previously. Nmap requires the free WinPcap packet capture library. -Obtain and install the latest version from . They distribute an executable -installer which makes this easy. You must have version 4 or -later. +We build our own WinPcap installer which is available in the zip file +as winpcap-nmap-version.exe, +where version is the Nmap version rather +than the WinPcap version. Alternatively, you can obtain and install +the latest version from . You +must install version 4 or later. + +Due to the way Nmap is compiled, it requires the +Microsoft Visual C++ 2008 Redistributable Package of runtime +components. Many systems already have this installed from othher +packages, but you should run vcredist_x86.exe +from the zip file just in case you need it. Instructions for executing your compiled Nmap are -given in . Take special note of the -WinPcap requirement. +given in . @@ -802,24 +824,24 @@ WinPcap requirement. Most Windows users prefer to use the Nmap binary self-installer, but compilation from source code is an option, particularly if you plan to help with Nmap development. Compilation requires -Microsoft Visual C++ 2008, which is part of their commercial Visual Studio suite. Any of the VS editions should work. - -Microsoft also distributes a free application named Visual C++ 2008 Express which also works for Nmap compilation. +Microsoft Visual C++ 2008, which is part of their commercial Visual Studio suite. Any of the Visual Studio editions should wor, including the free Visual C++ 2008 Express. Compiling Nmap on Windows from Source Download the latest Nmap source distribution from . It has the name nmap-version.tar.bz2 or nmap-version.tgz. Those are the same tar file compressed using gzip or bzip2, respectively. The bzip2-compressed version is smaller. -Uncompress the source code file you just downloaded. Recent releases of the free Cygwin distributionCygwin can handle both the .tar.bz2 and .tgz. Use the command tar xvjf nmap-version.tar.bz2 or tar xvzf nmap-version.tgz, respectively. Alternatively, the common Winzip application can decompress the .tgz version. +Uncompress the source code file you just downloaded. Recent releases of the free Cygwin distributionCygwin can handle both the .tar.bz2 and .tgz formats. Use the command tar xvjf nmap-version.tar.bz2 or tar xvzf nmap-version.tgz, respectively. Alternatively, the common Winzip application can decompress the .tgz version. Open Visual Studio and the Nmap solution file ( nmap-version/mswin32/nmap.sln). Choose Build Solution from the Build Menu. Nmap should begin compiling, and end with the line -- Done -- saying that all projects built successfully and there were 0 failures. + The executable and data files can be found in nmap-version/mswin32/Release/. You can copy them to a preferred directory as long as they are all kept together. +Ensure that you have WinPcap installed. You can obtain it by installing our binary self-installer or executing winpcap-nmap-version.exe from our zip package. Alternatively, you can obtain the official installer at . + Instructions for executing your compiled Nmap are -given in . Take special note of the -WinPcapWinPcap requirement. +given in the next section. @@ -835,11 +857,12 @@ Cygwin. Windowsrunning Nmap on Nmap releases now include the -Zenmap graphical user interface for Nmap. If -you used the Nmap installer and left the Zenmap field checked, there -should be a new Zenmap entry on your desktop and Start Menu. Click this -to get started. While many users love Zenmap, others prefer the -traditional command-line approach to executing Nmap. Here are +Zenmap graphical user interface for Nmap. +If you used the Nmap installer and left the Zenmap field checked, +there should be a new Zenmap entry on your desktop and Start Menu. +Click this to get started. Zenmap is fully documented in +. While many users love Zenmap, others prefer +the traditional command-line approach to executing Nmap. Here are detailed instructions for users who are unfamiliar with command-line interfaces: @@ -864,10 +887,10 @@ cd "\Program Files\Nmap" - + - +