Jan Engelhardt | ad326ef | 2007-09-23 15:17:42 +0000 | [diff] [blame] | 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 |
Jan Engelhardt | fea74bf | 2009-01-12 04:53:18 +0100 | [diff] [blame] | 4 | \fB\-\-datestart\fP \fIYYYY\fP[\fB\-\fP\fIMM\fP[\fB\-\fP\fIDD\fP[\fBT\fP\fIhh\fP[\fB:\fP\fImm\fP[\fB:\fP\fIss\fP]]]]] |
Jan Engelhardt | ad326ef | 2007-09-23 15:17:42 +0000 | [diff] [blame] | 5 | .TP |
Jan Engelhardt | fea74bf | 2009-01-12 04:53:18 +0100 | [diff] [blame] | 6 | \fB\-\-datestop\fP \fIYYYY\fP[\fB\-\fP\fIMM\fP[\fB\-\fP\fIDD\fP[\fBT\fP\fIhh\fP[\fB:\fP\fImm\fP[\fB:\fP\fIss\fP]]]]] |
Jan Engelhardt | ad326ef | 2007-09-23 15:17:42 +0000 | [diff] [blame] | 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 |
Jan Engelhardt | fea74bf | 2009-01-12 04:53:18 +0100 | [diff] [blame] | 11 | If \-\-datestart or \-\-datestop are not specified, it will default to 1970-01-01 |
Jan Engelhardt | ad326ef | 2007-09-23 15:17:42 +0000 | [diff] [blame] | 12 | and 2038-01-19, respectively. |
| 13 | .TP |
Jan Engelhardt | fea74bf | 2009-01-12 04:53:18 +0100 | [diff] [blame] | 14 | \fB\-\-timestart\fP \fIhh\fP\fB:\fP\fImm\fP[\fB:\fP\fIss\fP] |
Jan Engelhardt | ad326ef | 2007-09-23 15:17:42 +0000 | [diff] [blame] | 15 | .TP |
Jan Engelhardt | fea74bf | 2009-01-12 04:53:18 +0100 | [diff] [blame] | 16 | \fB\-\-timestop\fP \fIhh\fP\fB:\fP\fImm\fP[\fB:\fP\fIss\fP] |
Jan Engelhardt | ad326ef | 2007-09-23 15:17:42 +0000 | [diff] [blame] | 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 |
Jan Engelhardt | c6775d6 | 2010-07-23 21:23:05 +0200 | [diff] [blame] | 22 | [\fB!\fP] \fB\-\-monthdays\fP \fIday\fP[\fB,\fP\fIday\fP...] |
Jan Engelhardt | ad326ef | 2007-09-23 15:17:42 +0000 | [diff] [blame] | 23 | .IP |
Jan Engelhardt | c6775d6 | 2010-07-23 21:23:05 +0200 | [diff] [blame] | 24 | Only match on the given days of the month. Possible values are \fB1\fP |
| 25 | to \fB31\fP. Note that specifying \fB31\fP will of course not match |
Jan Engelhardt | ad326ef | 2007-09-23 15:17:42 +0000 | [diff] [blame] | 26 | on months which do not have a 31st day; the same goes for 28- or 29-day |
| 27 | February. |
| 28 | .TP |
Jan Engelhardt | c6775d6 | 2010-07-23 21:23:05 +0200 | [diff] [blame] | 29 | [\fB!\fP] \fB\-\-weekdays\fP \fIday\fP[\fB,\fP\fIday\fP...] |
Jan Engelhardt | ad326ef | 2007-09-23 15:17:42 +0000 | [diff] [blame] | 30 | .IP |
Jan Engelhardt | c6775d6 | 2010-07-23 21:23:05 +0200 | [diff] [blame] | 31 | Only match on the given weekdays. Possible values are \fBMon\fP, \fBTue\fP, |
| 32 | \fBWed\fP, \fBThu\fP, \fBFri\fP, \fBSat\fP, \fBSun\fP, or values from \fB1\fP |
| 33 | to \fB7\fP, respectively. You may also use two-character variants (\fBMo\fP, |
| 34 | \fBTu\fP, etc.). |
Jan Engelhardt | ad326ef | 2007-09-23 15:17:42 +0000 | [diff] [blame] | 35 | .TP |
Jan Engelhardt | fea74bf | 2009-01-12 04:53:18 +0100 | [diff] [blame] | 36 | \fB\-\-utc\fP |
Jan Engelhardt | ad326ef | 2007-09-23 15:17:42 +0000 | [diff] [blame] | 37 | .IP |
Jan Engelhardt | fea74bf | 2009-01-12 04:53:18 +0100 | [diff] [blame] | 38 | Interpret the times given for \fB\-\-datestart\fP, \fB\-\-datestop\fP, |
| 39 | \fB\-\-timestart\fP and \fB\-\-timestop\fP to be UTC. |
Jan Engelhardt | ad326ef | 2007-09-23 15:17:42 +0000 | [diff] [blame] | 40 | .TP |
Jan Engelhardt | fea74bf | 2009-01-12 04:53:18 +0100 | [diff] [blame] | 41 | \fB\-\-localtz\fP |
Jan Engelhardt | ad326ef | 2007-09-23 15:17:42 +0000 | [diff] [blame] | 42 | .IP |
Jan Engelhardt | fea74bf | 2009-01-12 04:53:18 +0100 | [diff] [blame] | 43 | Interpret the times given for \fB\-\-datestart\fP, \fB\-\-datestop\fP, |
| 44 | \fB\-\-timestart\fP and \fB\-\-timestop\fP to be local kernel time. (Default) |
Jan Engelhardt | ad326ef | 2007-09-23 15:17:42 +0000 | [diff] [blame] | 45 | .PP |
| 46 | EXAMPLES. To match on weekends, use: |
| 47 | .IP |
Jan Engelhardt | fea74bf | 2009-01-12 04:53:18 +0100 | [diff] [blame] | 48 | \-m time \-\-weekdays Sa,Su |
Jan Engelhardt | ad326ef | 2007-09-23 15:17:42 +0000 | [diff] [blame] | 49 | .PP |
| 50 | Or, to match (once) on a national holiday block: |
| 51 | .IP |
Jan Engelhardt | fea74bf | 2009-01-12 04:53:18 +0100 | [diff] [blame] | 52 | \-m time \-\-datestart 2007\-12\-24 \-\-datestop 2007\-12\-27 |
Jan Engelhardt | ad326ef | 2007-09-23 15:17:42 +0000 | [diff] [blame] | 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 |
Jan Engelhardt | fea74bf | 2009-01-12 04:53:18 +0100 | [diff] [blame] | 57 | \-m time \-\-datestart 2007\-01\-01T17:00 \-\-datestop 2007\-01\-01T23:59:59 |
Jan Engelhardt | ad326ef | 2007-09-23 15:17:42 +0000 | [diff] [blame] | 58 | .PP |
| 59 | During lunch hour: |
| 60 | .IP |
Jan Engelhardt | fea74bf | 2009-01-12 04:53:18 +0100 | [diff] [blame] | 61 | \-m time \-\-timestart 12:30 \-\-timestop 13:30 |
Jan Engelhardt | ad326ef | 2007-09-23 15:17:42 +0000 | [diff] [blame] | 62 | .PP |
| 63 | The fourth Friday in the month: |
| 64 | .IP |
Jan Engelhardt | fea74bf | 2009-01-12 04:53:18 +0100 | [diff] [blame] | 65 | \-m time \-\-weekdays Fr \-\-monthdays 22,23,24,25,26,27,28 |
Jan Engelhardt | ad326ef | 2007-09-23 15:17:42 +0000 | [diff] [blame] | 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.) |