From 3803e00367413260cbb543c3c4ed13ae2d8fd194 Mon Sep 17 00:00:00 2001 From: Sake Blok Date: Tue, 27 Jun 2017 22:04:33 +0200 Subject: Add option to use wall-clock intervals Add the "interval" option to "-b". Each new capture starts at the exact start of a time interval. For instance, using -b interval:3600 will start a new capture file at each whole hour. Changed the duration option in the GUI interfaces to use the new interval option. Change-Id: I0180c43843f5d2f0c2f50153c9ce42ac7fa5aeae Reviewed-on: https://code.wireshark.org/review/22428 Petri-Dish: Anders Broman Tested-by: Petri Dish Buildbot Reviewed-by: Sake Blok --- doc/dumpcap.pod | 11 +++++++---- doc/tshark.pod | 11 +++++++---- doc/wireshark.pod.template | 11 +++++++---- 3 files changed, 21 insertions(+), 12 deletions(-) (limited to 'doc') diff --git a/doc/dumpcap.pod b/doc/dumpcap.pod index 5753f99075..1c76aa8fc2 100644 --- a/doc/dumpcap.pod +++ b/doc/dumpcap.pod @@ -98,6 +98,9 @@ where I is one of: B:I switch to the next file after I seconds have elapsed, even if the current file is not completely filled up. +B:I switch to the next file when the time is an exact +multiple of I seconds + B:I switch to the next file after it reaches a size of I kB. Note that the filesize is limited to a maximum value of 2 GiB. @@ -105,10 +108,10 @@ B:I begin again with the first file after I number of files were written (form a ring buffer). This value must be less than 100000. Caution should be used when using large numbers of files: some filesystems do not handle many files in a single directory well. The B criterion -requires either B or B to be specified to control when to -go to the next file. It should be noted that each B<-b> parameter takes exactly -one criterion; to specify two criterion, each must be preceded by the B<-b> -option. +requires either B, B or B to be specified to +control when to go to the next file. It should be noted that each B<-b> +parameter takes exactly one criterion; to specify two criterion, each must be +preceded by the B<-b> option. Example: B<-b filesize:1000 -b files:5> results in a ring buffer of five files of size one megabyte each. diff --git a/doc/tshark.pod b/doc/tshark.pod index 9cde4e4fea..664851bafe 100644 --- a/doc/tshark.pod +++ b/doc/tshark.pod @@ -209,6 +209,9 @@ where I is one of: B:I switch to the next file after I seconds have elapsed, even if the current file is not completely filled up. +B:I switch to the next file when the time is an exact +multiple of I seconds + B:I switch to the next file after it reaches a size of I kB. Note that the filesize is limited to a maximum value of 2 GiB. @@ -216,10 +219,10 @@ B:I begin again with the first file after I number of files were written (form a ring buffer). This value must be less than 100000. Caution should be used when using large numbers of files: some filesystems do not handle many files in a single directory well. The B criterion -requires either B or B to be specified to control when to -go to the next file. It should be noted that each B<-b> parameter takes exactly -one criterion; to specify two criterion, each must be preceded by the B<-b> -option. +requires either B, B or B to be specified to +control when to go to the next file. It should be noted that each B<-b> +parameter takes exactly one criterion; to specify two criterion, each must be +preceded by the B<-b> option. Example: B<-b filesize:1000 -b files:5> results in a ring buffer of five files of size one megabyte each. diff --git a/doc/wireshark.pod.template b/doc/wireshark.pod.template index 1213c290bc..d89bf546fc 100644 --- a/doc/wireshark.pod.template +++ b/doc/wireshark.pod.template @@ -272,6 +272,9 @@ where I is one of: B:I switch to the next file after I seconds have elapsed, even if the current file is not completely filled up. +B:I switch to the next file when the time is an exact +multiple of I seconds + B:I switch to the next file after it reaches a size of I kB. Note that the filesize is limited to a maximum value of 2 GiB. @@ -279,10 +282,10 @@ B:I begin again with the first file after I number of files were written (form a ring buffer). This value must be less than 100000. Caution should be used when using large numbers of files: some filesystems do not handle many files in a single directory well. The B criterion -requires either B or B to be specified to control when to -go to the next file. It should be noted that each B<-b> parameter takes exactly -one criterion; to specify two criterion, each must be preceded by the B<-b> -option. +requires either B, B or B to be specified to +control when to go to the next file. It should be noted that each B<-b> +parameter takes exactly one criterion; to specify two criterion, each must be +preceded by the B<-b> option. Example: B<-b filesize:1000 -b files:5> results in a ring buffer of five files of size one megabyte each. -- cgit v1.2.1