The default capture buffer size is, in fact, *nominally* 1MB; however,
authorguy <guy@f5534014-38df-0310-8fa8-9805f1628bb7>
Sat, 8 May 2010 00:39:07 +0000 (00:39 +0000)
committerguy <guy@f5534014-38df-0310-8fa8-9805f1628bb7>
Sat, 8 May 2010 00:39:07 +0000 (00:39 +0000)
libpcap/WinPcap and the capture mechanism atop which they run might
either silently limit the buffer size to a smaller value or raise it to
a higher value - that's the part that's platform-dependent.

git-svn-id: http://anonsvn.wireshark.org/wireshark/trunk@32718 f5534014-38df-0310-8fa8-9805f1628bb7

doc/dumpcap.pod
doc/tshark.pod
dumpcap.c
gtk/main.c
tshark.c

index f08bd66488efd432057650d8cd86b20b43775033..64cde86c15207c7c784a82b862445c743575d94b 100644 (file)
@@ -100,10 +100,13 @@ to specify two criterion, each must be preceded by the B<-b> option.
 
 =item -B  E<lt>capture buffer sizeE<gt>
 
-Set capture buffer size (in MB; default is platform-dependent).  This is
-used by the the capture driver to buffer packet data until that data can
-be written to disk.  If you encounter packet drops while capturing, try
-to increase this size.
+Set capture buffer size (in MB, default is 1MB).  This is used by the
+the capture driver to buffer packet data until that data can be written
+to disk.  If you encounter packet drops while capturing, try to increase
+this size.  Note that, while B<Dumpcap> attempts to set the buffer size
+to 1MB by default, and can be told to set it to a larger value, the
+system or interface on which you're capturing might silently limit the
+capture buffer size to a lower value or raise it to a higher value.
 
 This is available on on UNIX systems with libpcap 1.0.0 or later and on
 Windows.  It is not available on UNIX systems with earlier versions of
index 01dc1ec46f54fc05af6e769769194fe9ca7b17f6..5b57653cb596275da55eaddd6b6bcbe828af964f 100644 (file)
@@ -181,10 +181,13 @@ to specify two criterion, each must be preceded by the B<-b> option.
 
 =item -B  E<lt>capture buffer sizeE<gt>
 
-Set capture buffer size (in MB; default is platform-dependent).  This is
-used by the the capture driver to buffer packet data until that data can
-be written to disk.  If you encounter packet drops while capturing, try
-to increase this size.
+Set capture buffer size (in MB, default is 1MB).  This is used by the
+the capture driver to buffer packet data until that data can be written
+to disk.  If you encounter packet drops while capturing, try to increase
+this size.  Note that, while B<Tshark> attempts to set the buffer size
+to 1MB by default, and can be told to set it to a larger value, the
+system or interface on which you're capturing might silently limit the
+capture buffer size to a lower value or raise it to a higher value.
 
 This is available on on UNIX systems with libpcap 1.0.0 or later and on
 Windows.  It is not available on UNIX systems with earlier versions of
index 545ee1732520f0603618a2e4a66e8d7308fde331..dbc948fb36ffb468d506f141d5357003bd2e6c40 100644 (file)
--- a/dumpcap.c
+++ b/dumpcap.c
@@ -331,7 +331,7 @@ print_usage(gboolean print_ver) {
   fprintf(output, "  -I                       capture in monitor mode, if available\n");
 #endif
 #if defined(_WIN32) || defined(HAVE_PCAP_CREATE)
-  fprintf(output, "  -B <buffer size>         size of kernel buffer (def: platform-dependent)\n");
+  fprintf(output, "  -B <buffer size>         size of kernel buffer (def: 1MB)\n");
 #endif
   fprintf(output, "  -y <link type>           link layer type (def: first appropriate)\n");
   fprintf(output, "  -D                       print list of interfaces and exit\n");
index 832556c617b5232e2e3a6c4c0e8f797979cb4444..d983f13a6ae8fc0200d52996eb6b05b44a12da43 100644 (file)
@@ -1164,7 +1164,7 @@ print_usage(gboolean print_ver) {
   fprintf(output, "  -S                       update packet display when new packets are captured\n");
   fprintf(output, "  -l                       turn on automatic scrolling while -S is in use\n");
 #if defined(_WIN32) || defined(HAVE_PCAP_CREATE)
-  fprintf(output, "  -B <buffer size>         size of kernel buffer (def: platform-dependent)\n");
+  fprintf(output, "  -B <buffer size>         size of kernel buffer (def: 1MB)\n");
 #endif
   fprintf(output, "  -y <link type>           link layer type (def: first appropriate)\n");
   fprintf(output, "  -D                       print list of interfaces and exit\n");
index f4802bcb644af61c2463fd571e63de9b1d7ec27b..9852925e9ffd05638f1eff6a830d9090ef11f602 100644 (file)
--- a/tshark.c
+++ b/tshark.c
@@ -238,7 +238,7 @@ print_usage(gboolean print_ver)
   fprintf(output, "  -I                       capture in monitor mode, if available\n");
 #endif
 #if defined(_WIN32) || defined(HAVE_PCAP_CREATE)
-  fprintf(output, "  -B <buffer size>         size of kernel buffer (def: platform-dependent)\n");
+  fprintf(output, "  -B <buffer size>         size of kernel buffer (def: 1MB)\n");
 #endif
   fprintf(output, "  -y <link type>           link layer type (def: first appropriate)\n");
   fprintf(output, "  -D                       print list of interfaces and exit\n");