From bd6db2a824f6e59bde0c447e9cb7be4abdc60768 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Michael=20T=C3=BCxen?= Date: Tue, 28 Jun 2011 22:02:43 +0000 Subject: Document the handling of command line parameters with respect to the capturing on multiple interfaces. svn path=/trunk/; revision=37824 --- doc/dumpcap.pod | 44 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 44 insertions(+) (limited to 'doc/dumpcap.pod') diff --git a/doc/dumpcap.pod b/doc/dumpcap.pod index 861db49dde..4d83a3bec3 100644 --- a/doc/dumpcap.pod +++ b/doc/dumpcap.pod @@ -123,6 +123,13 @@ This is available on UNIX systems with libpcap 1.0.0 or later and on Windows. It is not available on UNIX systems with earlier versions of libpcap. +This option can occur multiple times. If used before the first +occurrence of the B<-i> option, it sets the default capture buffer size. +If used after an B<-i> option, it sets the capture buffer size for +the interface specified by the last B<-i> option occurring before +this option. If the capture buffer size is not set specifically, +the default capture buffer size is used if provided. + =item -c Ecapture packet countE Set the maximum number of packets to read when capturing live @@ -160,6 +167,13 @@ Set the capture filter expression. The entire filter expression must be specified as a single argument (which means that if it contains spaces, it must be quoted). +This option can occur multiple times. If used before the first +occurrence of the B<-i> option, it sets the default capture filter expression. +If used after an B<-i> option, it sets the capture filter expression for +the interface specified by the last B<-i> option occurring before +this option. If the capture filter expression is not set specifically, +the default capture filter expression is used if provided. + =item -h Print the version and options and exits. @@ -185,6 +199,9 @@ Pipe names should be either the name of a FIFO (named pipe) or ``-'' to read data from the standard input. Data read from pipes must be in standard libpcap format. +This option can occur multiple times. When capturing from multiple +interfaces, the capture file will be saved in pcap-ng format. + Note: the Win32 version of B doesn't support capturing from pipes or stdin! @@ -200,6 +217,12 @@ files on a network server, or resolving host names or network addresses, if you are capturing in monitor mode and are not connected to another network with another adapter. +This option can occur multiple times. If used before the first +occurrence of the B<-i> option, it enables the monitor mode for all interfaces. +If used after an B<-i> option, it enables the monitor mode for +the interface specified by the last B<-i> option occurring before +this option. + =item -L List the data link types supported by the interface and exit. The reported @@ -224,6 +247,13 @@ traffic sent to or from the machine on which B is running, broadcast traffic, and multicast traffic to addresses received by that machine. +This option can occur multiple times. If used before the first +occurrence of the B<-i> option, no interface will be put into the +promiscuous mode. +If used after an B<-i> option, the interface specified by the last B<-i> +option occurring before this option will not be put into the +promiscuous mode. + =item -P Save files as pcap instead of the default pcap-ng. In situations that require @@ -248,6 +278,13 @@ No more than I bytes of each network packet will be read into memory, or saved to disk. A value of 0 specifies a snapshot length of 65535, so that the full packet is captured; this is the default. +This option can occur multiple times. If used before the first +occurrence of the B<-i> option, it sets the default snapshot length. +If used after an B<-i> option, it sets the snapshot length for +the interface specified by the last B<-i> option occurring before +this option. If the snapshot length is not set specifically, +the default snapshot length is used if provided. + =item -S Print statistics for each interface once every second. @@ -267,6 +304,13 @@ NOTE: The usage of "-" for stdout is not allowed here! Set the data link type to use while capturing packets. The values reported by B<-L> are the values that can be used. +This option can occur multiple times. If used before the first +occurrence of the B<-i> option, it sets the default capture link type. +If used after an B<-i> option, it sets the capture link type for +the interface specified by the last B<-i> option occurring before +this option. If the capture link type is not set specifically, +the default capture link type is used if provided. + =back =head1 CAPTURE FILTER SYNTAX -- cgit v1.2.3