3 * Copyright © CC Computer Consultants GmbH, 2007
5 * based on ipt_time by Fabrice MARIE <fabrice@netfilter.org>
6 * This is a module which is used for time matching
7 * It is using some modified code from dietlibc (localtime() function)
8 * that you can find at https://www.fefe.de/dietlibc/
9 * This file is distributed under the terms of the GNU General Public
10 * License (GPL). Copies of the GPL can be obtained from gnu.org/gpl.
13 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
15 #include <linux/ktime.h>
16 #include <linux/module.h>
17 #include <linux/skbuff.h>
18 #include <linux/types.h>
19 #include <linux/netfilter/x_tables.h>
20 #include <linux/netfilter/xt_time.h>
23 u_int8_t month
; /* (1-12) */
24 u_int8_t monthday
; /* (1-31) */
25 u_int8_t weekday
; /* (1-7) */
26 u_int8_t hour
; /* (0-23) */
27 u_int8_t minute
; /* (0-59) */
28 u_int8_t second
; /* (0-59) */
32 extern struct timezone sys_tz
; /* ouch */
34 static const u_int16_t days_since_year
[] = {
35 0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334,
38 static const u_int16_t days_since_leapyear
[] = {
39 0, 31, 60, 91, 121, 152, 182, 213, 244, 274, 305, 335,
43 * Since time progresses forward, it is best to organize this array in reverse,
44 * to minimize lookup time.
48 SECONDS_PER_DAY
= 86400,
50 static const u_int16_t days_since_epoch
[] = {
52 25202, 24837, 24472, 24106, 23741, 23376, 23011, 22645, 22280, 21915,
54 21550, 21184, 20819, 20454, 20089, 19723, 19358, 18993, 18628, 18262,
56 17897, 17532, 17167, 16801, 16436, 16071, 15706, 15340, 14975, 14610,
58 14245, 13879, 13514, 13149, 12784, 12418, 12053, 11688, 11323, 10957,
60 10592, 10227, 9862, 9496, 9131, 8766, 8401, 8035, 7670, 7305,
62 6940, 6574, 6209, 5844, 5479, 5113, 4748, 4383, 4018, 3652,
64 3287, 2922, 2557, 2191, 1826, 1461, 1096, 730, 365, 0,
67 static inline bool is_leap(unsigned int y
)
69 return y
% 4 == 0 && (y
% 100 != 0 || y
% 400 == 0);
73 * Each network packet has a (nano)seconds-since-the-epoch (SSTE) timestamp.
74 * Since we match against days and daytime, the SSTE value needs to be
75 * computed back into human-readable dates.
77 * This is done in three separate functions so that the most expensive
78 * calculations are done last, in case a "simple match" can be found earlier.
80 static inline unsigned int localtime_1(struct xtm
*r
, time64_t time
)
84 /* Each day has 86400s, so finding the hour/minute is actually easy. */
85 div_u64_rem(time
, SECONDS_PER_DAY
, &v
);
93 static inline void localtime_2(struct xtm
*r
, time64_t time
)
96 * Here comes the rest (weekday, monthday). First, divide the SSTE
97 * by seconds-per-day to get the number of _days_ since the epoch.
99 r
->dse
= div_u64(time
, SECONDS_PER_DAY
);
102 * 1970-01-01 (w=0) was a Thursday (4).
103 * -1 and +1 map Sunday properly onto 7.
105 r
->weekday
= (4 + r
->dse
- 1) % 7 + 1;
108 static void localtime_3(struct xtm
*r
, time64_t time
)
110 unsigned int year
, i
, w
= r
->dse
;
113 * In each year, a certain number of days-since-the-epoch have passed.
114 * Find the year that is closest to said days.
116 * Consider, for example, w=21612 (2029-03-04). Loop will abort on
117 * dse[i] <= w, which happens when dse[i] == 21550. This implies
118 * year == 2009. w will then be 62.
120 for (i
= 0, year
= DSE_FIRST
; days_since_epoch
[i
] > w
;
124 w
-= days_since_epoch
[i
];
127 * By now we have the current year, and the day of the year.
130 * On to finding the month (like above). In each month, a certain
131 * number of days-since-New Year have passed, and find the closest
134 * Consider w=62 (in a non-leap year). Loop will abort on
135 * dsy[i] < w, which happens when dsy[i] == 31+28 (i == 2).
136 * Concludes i == 2, i.e. 3rd month => March.
138 * (A different approach to use would be to subtract a monthlength
139 * from w repeatedly while counting.)
142 /* use days_since_leapyear[] in a leap year */
143 for (i
= ARRAY_SIZE(days_since_leapyear
) - 1;
144 i
> 0 && days_since_leapyear
[i
] > w
; --i
)
146 r
->monthday
= w
- days_since_leapyear
[i
] + 1;
148 for (i
= ARRAY_SIZE(days_since_year
) - 1;
149 i
> 0 && days_since_year
[i
] > w
; --i
)
151 r
->monthday
= w
- days_since_year
[i
] + 1;
158 time_mt(const struct sk_buff
*skb
, struct xt_action_param
*par
)
160 const struct xt_time_info
*info
= par
->matchinfo
;
161 unsigned int packet_time
;
162 struct xtm current_time
;
166 * We need real time here, but we can neither use skb->tstamp
167 * nor __net_timestamp().
169 * skb->tstamp and skb->skb_mstamp_ns overlap, however, they
170 * use different clock types (real vs monotonic).
172 * Suppose you have two rules:
173 * 1. match before 13:00
174 * 2. match after 13:00
176 * If you match against processing time (ktime_get_real_seconds) it
177 * may happen that the same packet matches both rules if
178 * it arrived at the right moment before 13:00, so it would be
179 * better to check skb->tstamp and set it via __net_timestamp()
180 * if needed. This however breaks outgoing packets tx timestamp,
181 * and causes them to get delayed forever by fq packet scheduler.
183 stamp
= ktime_get_real_seconds();
185 if (info
->flags
& XT_TIME_LOCAL_TZ
)
186 /* Adjust for local timezone */
187 stamp
-= 60 * sys_tz
.tz_minuteswest
;
190 * xt_time will match when _all_ of the following hold:
191 * - 'now' is in the global time range date_start..date_end
192 * - 'now' is in the monthday mask
193 * - 'now' is in the weekday mask
194 * - 'now' is in the daytime range time_start..time_end
195 * (and by default, libxt_time will set these so as to match)
197 * note: info->date_start/stop are unsigned 32-bit values that
198 * can hold values beyond y2038, but not after y2106.
201 if (stamp
< info
->date_start
|| stamp
> info
->date_stop
)
204 packet_time
= localtime_1(¤t_time
, stamp
);
206 if (info
->daytime_start
< info
->daytime_stop
) {
207 if (packet_time
< info
->daytime_start
||
208 packet_time
> info
->daytime_stop
)
211 if (packet_time
< info
->daytime_start
&&
212 packet_time
> info
->daytime_stop
)
215 /** if user asked to ignore 'next day', then e.g.
216 * '1 PM Wed, August 1st' should be treated
217 * like 'Tue 1 PM July 31st'.
220 * 'Monday, "23:00 to 01:00", to match for 2 hours, starting
221 * Monday 23:00 to Tuesday 01:00.
223 if ((info
->flags
& XT_TIME_CONTIGUOUS
) &&
224 packet_time
<= info
->daytime_stop
)
225 stamp
-= SECONDS_PER_DAY
;
228 localtime_2(¤t_time
, stamp
);
230 if (!(info
->weekdays_match
& (1 << current_time
.weekday
)))
233 /* Do not spend time computing monthday if all days match anyway */
234 if (info
->monthdays_match
!= XT_TIME_ALL_MONTHDAYS
) {
235 localtime_3(¤t_time
, stamp
);
236 if (!(info
->monthdays_match
& (1 << current_time
.monthday
)))
243 static int time_mt_check(const struct xt_mtchk_param
*par
)
245 const struct xt_time_info
*info
= par
->matchinfo
;
247 if (info
->daytime_start
> XT_TIME_MAX_DAYTIME
||
248 info
->daytime_stop
> XT_TIME_MAX_DAYTIME
) {
249 pr_info_ratelimited("invalid argument - start or stop time greater than 23:59:59\n");
253 if (info
->flags
& ~XT_TIME_ALL_FLAGS
) {
254 pr_info_ratelimited("unknown flags 0x%x\n",
255 info
->flags
& ~XT_TIME_ALL_FLAGS
);
259 if ((info
->flags
& XT_TIME_CONTIGUOUS
) &&
260 info
->daytime_start
< info
->daytime_stop
)
266 static struct xt_match xt_time_mt_reg __read_mostly
= {
268 .family
= NFPROTO_UNSPEC
,
270 .checkentry
= time_mt_check
,
271 .matchsize
= sizeof(struct xt_time_info
),
275 static int __init
time_mt_init(void)
277 int minutes
= sys_tz
.tz_minuteswest
;
279 if (minutes
< 0) /* east of Greenwich */
280 pr_info("kernel timezone is +%02d%02d\n",
281 -minutes
/ 60, -minutes
% 60);
282 else /* west of Greenwich */
283 pr_info("kernel timezone is -%02d%02d\n",
284 minutes
/ 60, minutes
% 60);
286 return xt_register_match(&xt_time_mt_reg
);
289 static void __exit
time_mt_exit(void)
291 xt_unregister_match(&xt_time_mt_reg
);
294 module_init(time_mt_init
);
295 module_exit(time_mt_exit
);
296 MODULE_AUTHOR("Jan Engelhardt <jengelh@medozas.de>");
297 MODULE_DESCRIPTION("Xtables: time-based matching");
298 MODULE_LICENSE("GPL");
299 MODULE_ALIAS("ipt_time");
300 MODULE_ALIAS("ip6t_time");