← Back to branch summary

~csurbhi/ubuntu/maverick/iptables/iptable-fix.600195

« back to all changes in this revision

Viewing changes to extensions/libxt_time.man

  • Committer: Bazaar Package Importer
  • Author(s): Soren Hansen
  • Date: 2008-06-24 15:06:04 UTC
  • mfrom: (5.1.4 upstream)
  • Revision ID: james.westby@ubuntu.com-20080624150604-5t7r1o1kxq0ycz81
Tags: 1.4.0-4ubuntu1
* Merge from debian unstable, remaining changes:
  - Took references to 2.4 kernel out of doc-base control files (Jordan
    Mantha, Malone #25972) (patches/all/091-fix-2.4-references.patch)
  - Use linux-libc-dev instead of local copy of kernel-headers.

Show diffs side-by-side

added added

removed removed

Lines of Context:
extensions/libxt_time.man
 
1
This matches if the packet arrival time/date is within a given range. All
 
2
options are optional, but are ANDed when specified.
 
3
.TP
 
4
\fB--datestart\fR \fIYYYY\fR[\fB-\fR\fIMM\fR[\fB-\fR\fIDD\fR[\fBT\fR\fIhh\fR[\fB:\fR\fImm\fR[\fB:\fR\fIss\fR]]]]]
 
5
.TP
 
6
\fB--datestop\fR \fIYYYY\fR[\fB-\fR\fIMM\fR[\fB-\fR\fIDD\fR[\fBT\fR\fIhh\fR[\fB:\fR\fImm\fR[\fB:\fR\fIss\fR]]]]]
 
7
.IP
 
8
Only match during the given time, which must be in ISO 8601 "T" notation.
 
9
The possible time range is 1970-01-01T00:00:00 to 2038-01-19T04:17:07.
 
10
.IP
 
11
If --datestart or --datestop are not specified, it will default to 1970-01-01
 
12
and 2038-01-19, respectively.
 
13
.TP
 
14
\fB--timestart\fR \fIhh\fR\fB:\fR\fImm\fR[\fB:\fR\fIss\fR]
 
15
.TP
 
16
\fB--timestop\fR \fIhh\fR\fB:\fR\fImm\fR[\fB:\fR\fIss\fR]
 
17
.IP
 
18
Only match during the given daytime. The possible time range is 00:00:00 to
 
19
23:59:59. Leading zeroes are allowed (e.g. "06:03") and correctly interpreted
 
20
as base-10.
 
21
.TP
 
22
[\fB!\fR] \fB--monthday\fR \fIday\fR[\fB,\fR\fIday\fR...]
 
23
.IP
 
24
Only match on the given days of the month. Possible values are \fB1\fR
 
25
to \fB31\fR. Note that specifying \fB31\fR will of course not match
 
26
on months which do not have a 31st day; the same goes for 28- or 29-day
 
27
February.
 
28
.TP
 
29
[\fB!\fR] \fB--weekdays\fR \fIday\fR[\fB,\fR\fIday\fR...]
 
30
.IP
 
31
Only match on the given weekdays. Possible values are \fBMon\fR, \fBTue\fR,
 
32
\fBWed\fR, \fBThu\fR, \fBFri\fR, \fBSat\fR, \fBSun\fR, or values from \fB1\fR
 
33
to \fB7\fR, respectively. You may also use two-character variants (\fBMo\fR,
 
34
\fBTu\fR, etc.).
 
35
.TP
 
36
\fB--utc\fR
 
37
.IP
 
38
Interpret the times given for \fB--datestart\fR, \fB--datestop\fR,
 
39
\fB--timestart\fR and \fB--timestop\fR to be UTC.
 
40
.TP
 
41
\fB--localtz\fR
 
42
.IP
 
43
Interpret the times given for \fB--datestart\fR, \fB--datestop\fR,
 
44
\fB--timestart\fR and \fB--timestop\fR to be local kernel time. (Default)
 
45
.PP
 
46
EXAMPLES. To match on weekends, use:
 
47
.IP
 
48
-m time --weekdays Sa,Su
 
49
.PP
 
50
Or, to match (once) on a national holiday block:
 
51
.IP
 
52
-m time --datestart 2007-12-24 --datestop 2007-12-27
 
53
.PP
 
54
Since the stop time is actually inclusive, you would need the following stop
 
55
time to not match the first second of the new day:
 
56
.IP
 
57
-m time --datestart 2007-01-01T17:00 --datestop 2007-01-01T23:59:59
 
58
.PP
 
59
During lunch hour:
 
60
.IP
 
61
-m time --timestart 12:30 --timestop 13:30
 
62
.PP
 
63
The fourth Friday in the month:
 
64
.IP
 
65
-m time --weekdays Fr --monthdays 22,23,24,25,26,27,28
 
66
.PP
 
67
(Note that this exploits a certain mathematical property. It is not possible to
 
68
say "fourth Thursday OR fourth Friday" in one rule. It is possible with
 
69
multiple rules, though.)