Updates needs to be executed at least as often as it is possible for the interface
to generate enough traffic to overflow the kernel interface traffic counter. Otherwise,
-it is possible that some traffic won't be seen. This isn't an issue for 64 bit kernels
+it is possible that some traffic won't be seen. This isn't an issue for 64-bit kernels
but at least one update every hour is always required in order to provide proper input.
-With 32 bit kernels, the maximum time between two updates depends on how fast the
+With 32-bit kernels, the maximum time between two updates depends on how fast the
interface can transfer 4 GiB. Calculated theoretical times are:
.RS
.TS
.RE
However, for 1000 Mbit interfaces updating once every minute is usually a
-useable solution if faster updates can't be used.
+usable solution if faster updates can't be used.
.PP
Estimated traffic values are likely to be somewhat inaccurate if daily
traffic is low because only the MiB counter is used to calculate the
.TP
.B BootVariation
Time in seconds how much the boot time reported by system kernel can variate
-between updates.
+between updates. Value range: 0..300
.TP
.B CheckDiskSpace
.B MaxBandwidth
Maximum bandwidth for all interfaces. If the counted traffic exceeds
the given value then the data is assumed to be invalid and rejected.
-Set to 0 in order to disable the feature. (vnstat and vnstatd only)
+Set to 0 in order to disable the feature. Value range: 0..10000
+(vnstat and vnstatd only)
.TP
.B MaxBW
Same as MaxBandwidth but can be used for setting individual limits
for selected interfaces. The name of the interface is specified directly
after the MaxBW keyword without spaces. For example MaxBWeth0 for eth0
-and MaxBWppp0 for ppp0. (vnstat and vnstatd only)
+and MaxBWppp0 for ppp0. Value range: 0..10000 (vnstat and vnstatd only)
.TP
.B MonthRotate
Day of month that months are expected to change. Usually set to
1 but can be set to alternative values for example for tracking
monthly billed traffic where the billing period doesn't start on
-the first day. (vnstat and vnstatd only)
+the first day. Value range: 1..28 (vnstat and vnstatd only)
.TP
.B OutputStyle
.B QueryMode
Default query mode when no parameters are given. 0 = normal, 1 = days,
2 = months, 3 = top10, 4 = exportdb, 5 = short, 6 = weeks, 7 = hours and
-8 = xml.
-(vnstat only)
+8 = xml. (vnstat only)
.TP
.B RateUnit
.TP
.B Sampletime
-Defines how many seconds the \-tr option will sample traffic. (vnstat only)
+Defines how many seconds the \-tr option will sample traffic.
+Value range: 2..600 (vnstat only)
.TP
.B TrafficlessDays
.TP
.B OfflineSaveInterval
How often in minutes cached interface data is saved to file when all monitored
-interfaces are offline.
+interfaces are offline. Value range:
+.BR SaveInterval "..60"
.TP
.B PidFile
.TP
.B PollInterval
How often in seconds interfaces are checked for status changes.
+Value range: 2..300
.TP
.B SaveInterval
How often in minutes cached interface data is saved to file.
+Value range: (
+.BR UpdateInterval " / 60 )..60"
.TP
.B SaveOnStatusChange
.TP
.B UpdateInterval
-How often in seconds the interface data is updated.
+How often in seconds the interface data is updated. Value range:
+.BR PollInterval "..300"
.TP
.B UseLogging
Updates needs to be executed at least as often as it is possible for the interface
to generate enough traffic to overflow the kernel interface traffic counter. Otherwise,
-it is possible that some traffic won't be seen. This isn't an issue for 64 bit kernels
+it is possible that some traffic won't be seen. This isn't an issue for 64-bit kernels
but at least one update every hour is always required in order to provide proper input.
-With 32 bit kernels, the maximum time between two updates depends on how fast the
+With 32-bit kernels, the maximum time between two updates depends on how fast the
interface can transfer 4 GiB. Calculated theoretical times are:
.RS
.TS
.RE
However, for 1000 Mbit interfaces updating once every minute is usually a
-useable solution if faster updates can't be used.
+usable solution if faster updates can't be used.
.PP
Virtual and aliased interfaces cannot be monitored because the kernel doesn't
provide traffic information for that type of interfaces. Such interfaces are
printe(PT_Config);
}
- if (cfg.sampletime<0 || cfg.sampletime>600) {
+ if (cfg.sampletime<2 || cfg.sampletime>600) {
cfg.sampletime = DEFSAMPTIME;
snprintf(errorstring, 512, "Invalid value for Sampletime, resetting to \"%d\".", cfg.sampletime);
printe(PT_Config);