From 2b302230de61c32c8fa0d65b279b68d46eccddf6 Mon Sep 17 00:00:00 2001 From: Chris Maynard Date: Thu, 15 Mar 2012 15:03:08 +0000 Subject: Sort the options. svn path=/trunk/; revision=41566 --- doc/text2pcap.pod | 90 +++++++++++++++++++++++++++---------------------------- 1 file changed, 45 insertions(+), 45 deletions(-) diff --git a/doc/text2pcap.pod b/doc/text2pcap.pod index ffd141c982..7288b6ff0f 100644 --- a/doc/text2pcap.pod +++ b/doc/text2pcap.pod @@ -6,20 +6,20 @@ text2pcap - Generate a capture file from an ASCII hexdump of packets =head1 SYNOPSIS B -S<[ B<-h> ]> +S<[ B<-a> ]> S<[ B<-d> ]> -S<[ B<-q> ]> -S<[ B<-o> hex|oct|dec ]> -S<[ B<-l> EtypenumE ]> S<[ B<-e> El3pidE ]> +S<[ B<-h> ]> S<[ B<-i> EprotoE ]> +S<[ B<-l> EtypenumE ]> S<[ B<-m> Emax-packetE ]> -S<[ B<-u> EsrcportE,EdestportE ]> -S<[ B<-T> EsrcportE,EdestportE ]> +S<[ B<-o> hex|oct|dec ]> +S<[ B<-q> ]> S<[ B<-s> EsrcportE,EdestportE,EtagE ]> S<[ B<-S> EsrcportE,EdestportE,EppiE ]> S<[ B<-t> EtimefmtE ]> -S<[ B<-a> ]> +S<[ B<-T> EsrcportE,EdestportE ]> +S<[ B<-u> EsrcportE,EdestportE ]> EIE|- EIE|- @@ -88,33 +88,18 @@ handle these dumps. =over 4 -=item -h +=item -a -Displays a help message. +Enables ASCII text dump identification. It allows to identify the start of +the ASCII text dump and not include it in the packet even if it looks like HEX. + +B Do not enable it if the input file does not contain the ASCII text dump. =item -d Displays debugging information during the process. Can be used multiple times to generate more debugging information. -=item -q - -Be completely quiet during the process. - -=item -o hex|oct|dec - -Specify the radix for the offsets (hex, octal or decimal). Defaults to -hex. This corresponds to the C<-A> option for I. - -=item -l - -Specify the link-layer header type of this packet. Default is Ethernet -(1). See L for the complete list -of possible encapsulations. Note that this option should be used if -your dump is a complete hex dump of an encapsulated packet and you wish -to specify the exact type of encapsulation. Example: I<-l 7> for ARCNet -packets. - =item -e El3pidE Include a dummy Ethernet header before each packet. Specify the L3PID @@ -128,6 +113,10 @@ I<-l 12> does not work for any non-IP Layer 3 packet (e.g. ARP), whereas generating a dummy Ethernet header with I<-e> works for any sort of L3 packet. +=item -h + +Displays a help message. + =item -i EprotoE Include dummy IP headers before each packet. Specify the IP protocol @@ -137,6 +126,15 @@ an IP header with each packet. Note that an appropriate Ethernet header is automatically included with each packet as well. Example: I<-i 46> to specify an RSVP packet (IP protocol 46). +=item -l + +Specify the link-layer header type of this packet. Default is Ethernet +(1). See L for the complete list +of possible encapsulations. Note that this option should be used if +your dump is a complete hex dump of an encapsulated packet and you wish +to specify the exact type of encapsulation. Example: I<-l 7> for ARCNet +packets. + =item -m Emax-packetE Set the maximum packet length, default is 64000. @@ -148,23 +146,14 @@ I will convert from plain datastream format to a sequence of Ethernet TCP packets. -=item -u EsrcportE,EdestportE +=item -o hex|oct|dec -Include dummy UDP headers before each packet. Specify the source and -destination UDP ports for the packet in decimal. Use this option if -your dump is the UDP payload of a packet but does not include any UDP, -IP or Ethernet headers. Note that appropriate Ethernet and IP headers -are automatically also included with each packet. -Example: I<-u1000,69> to make the packets look like TFTP/UDP packets. +Specify the radix for the offsets (hex, octal or decimal). Defaults to +hex. This corresponds to the C<-A> option for I. -=item -T EsrcportE,EdestportE +=item -q -Include dummy TCP headers before each packet. Specify the source and -destination TCP ports for the packet in decimal. Use this option if -your dump is the TCP payload of a packet but does not include any TCP, -IP or Ethernet headers. Note that appropriate Ethernet and IP headers -are automatically also included with each packet. -Sequence numbers will start at 0. +Be completely quiet during the process. =item -s EsrcportE,EdestportE,EtagE @@ -199,12 +188,23 @@ a second. B Date/time fields from the current date/time are used as the default for unspecified fields. -=item -a +=item -T EsrcportE,EdestportE -Enables ASCII text dump identification. It allows to identify the start of -the ASCII text dump and not include it in the packet even if it looks like HEX. +Include dummy TCP headers before each packet. Specify the source and +destination TCP ports for the packet in decimal. Use this option if +your dump is the TCP payload of a packet but does not include any TCP, +IP or Ethernet headers. Note that appropriate Ethernet and IP headers +are automatically also included with each packet. +Sequence numbers will start at 0. -B Do not enable it if the input file does not contain the ASCII text dump. +=item -u EsrcportE,EdestportE + +Include dummy UDP headers before each packet. Specify the source and +destination UDP ports for the packet in decimal. Use this option if +your dump is the UDP payload of a packet but does not include any UDP, +IP or Ethernet headers. Note that appropriate Ethernet and IP headers +are automatically also included with each packet. +Example: I<-u1000,69> to make the packets look like TFTP/UDP packets. =back -- cgit v1.2.3