[patch] Update documentation on port specification

[Daniel Miller <bonsaiviking () gmail com>]

List,

I just had a conversation in IRC with a user who expressed confusion 
over the S: in the example port specification in the Nmap man page. I 
checked, and the documentation mentions T: and U:, but not S: and P:, 
which are valid for SCTP and IP Protocol specifications, respectively. 
The patch below will fix this. I'll commit it if there are no objections 
by tomorrow morning.

diff --git a/docs/nmap.1 b/docs/nmap.1
index 2302d11..4b096c8 100644
--- a/docs/nmap.1
+++ b/docs/nmap.1
@@ -986,10 +986,10 @@ This option specifies which ports you want to scan 
and overrides the default\&.
 to scan ports from 1 through 65535\&. Scanning port zero.\" port zero
 is allowed if you specify it explicitly\&. For IP protocol scanning 
(\fB\-sO\fR), this option specifies the protocol numbers you wish to 
scan for (0\(en255)\&.
 .sp
-When scanning both TCP and UDP ports, you can specify a particular 
protocol by preceding the port numbers by
+When scanning a combination of protocols (e.g. TCP and UDP), you can 
specify a particular protocol by preceding the port numbers by
 T:
-or
-U:\&. The qualifier lasts until you specify another qualifier\&. For 
example, the argument
+for TCP, U: for UDP, S: for SCTP, or P: for IP Protocol\&.
+The qualifier lasts until you specify another qualifier\&. For example, 
the argument
 \fB\-p U:53,111,137,T:21\-25,80,139,8080\fR
 would scan UDP ports 53, 111,and 137, as well as the listed TCP 
ports\&. Note that to scan both UDP and TCP, you have to specify
 \fB\-sU\fR
diff --git a/docs/refguide.xml b/docs/refguide.xml
index 39cd173..689576c 100644
--- a/docs/refguide.xml
+++ b/docs/refguide.xml
@@ -1738,9 +1738,11 @@ way.</para>
           specifies the protocol numbers you wish to scan for
           (0&ndash;255).</para>

-          <para>When scanning both TCP and UDP ports, you can specify
-          a particular protocol by preceding the port numbers by 
<literal>T:</literal>
-          or <literal>U:</literal>. The qualifier lasts until you 
specify another
+          <para>When scanning a combination of protocols (e.g. TCP and 
UDP), you can
+          specify a particular protocol by preceding the port numbers by
+          <literal>T:</literal> for TCP, <literal>U:</literal> for UDP,
+          <literal>S:</literal> for SCTP, or <literal>P:</literal> for 
IP Protocol.
+          The qualifier lasts until you specify another
           qualifier. For example, the argument <option>-p
           U:53,111,137,T:21-25,80,139,8080</option> would scan UDP
           ports 53, 111,and 137, as well as the listed TCP ports. Note


Dan
_______________________________________________
Sent through the nmap-dev mailing list
http://cgi.insecure.org/mailman/listinfo/nmap-dev
Archived at http://seclists.org/nmap-dev/