varmod-gmtime.mk revision 1.11 1 1.11 rillig # $NetBSD: varmod-gmtime.mk,v 1.11 2023/05/09 08:26:14 rillig Exp $
2 1.1 rillig #
3 1.2 rillig # Tests for the :gmtime variable modifier, which formats a timestamp
4 1.6 rillig # using strftime(3) in UTC.
5 1.11 rillig #
6 1.11 rillig # See also:
7 1.11 rillig # varmod-localtime.mk
8 1.1 rillig
9 1.8 rillig .if ${TZ:Uundefined} != "undefined" # see unit-tests/Makefile
10 1.8 rillig . error
11 1.8 rillig .endif
12 1.2 rillig
13 1.3 rillig # Test for the default time format, %c. Since the time always varies, it's
14 1.3 rillig # only possible to check for the general format here. The names of the
15 1.3 rillig # month and weekday are always in English, independent from the locale.
16 1.3 rillig # Example: Thu Oct 29 18:56:41 2020
17 1.3 rillig .if ${:U:gmtime:tW:M??? ??? ?? ??\:??\:?? ????} == ""
18 1.3 rillig . error
19 1.3 rillig .endif
20 1.3 rillig
21 1.6 rillig
22 1.7 rillig # modifier name too short, falling back to the SysV modifier.
23 1.7 rillig .if ${%Y:L:gmtim=1593536400} != "%Y"
24 1.7 rillig . error
25 1.7 rillig .endif
26 1.7 rillig
27 1.7 rillig
28 1.7 rillig # 2020-07-01T00:00:00Z
29 1.7 rillig .if ${%Y:L:gmtime=1593536400} != "2020"
30 1.7 rillig . error
31 1.7 rillig .endif
32 1.7 rillig
33 1.7 rillig
34 1.7 rillig # modifier name too long, falling back to the SysV modifier.
35 1.7 rillig .if ${%Y:L:gmtimer=1593536400} != "%Y"
36 1.7 rillig . error
37 1.7 rillig .endif
38 1.7 rillig
39 1.7 rillig
40 1.7 rillig # If the modifier name is not matched exactly, fall back to the
41 1.7 rillig # :from=to modifier.
42 1.7 rillig .if ${gmtime:L:gm%=local%} != "localtime"
43 1.7 rillig . error
44 1.7 rillig .endif
45 1.7 rillig
46 1.7 rillig
47 1.7 rillig # As of 2020-08-16, it is not possible to pass the seconds via a
48 1.7 rillig # variable expression. This is because parsing of the :gmtime
49 1.7 rillig # modifier stops at the '$' and returns to ApplyModifiers.
50 1.7 rillig #
51 1.7 rillig # There, a colon would be skipped but not a dollar.
52 1.7 rillig # Parsing therefore continues at the '$' of the ${:U159...}, looking
53 1.7 rillig # for an ordinary variable modifier.
54 1.7 rillig #
55 1.7 rillig # At this point, the ${:U} is expanded and interpreted as a variable
56 1.7 rillig # modifier, which results in the error message "Unknown modifier '1'".
57 1.7 rillig #
58 1.7 rillig # If ApplyModifier_Gmtime were to pass its argument through
59 1.7 rillig # ParseModifierPart, this would work.
60 1.7 rillig .if ${%Y:L:gmtime=${:U1593536400}} != "mtime=11593536400}"
61 1.7 rillig . error
62 1.7 rillig .endif
63 1.7 rillig
64 1.7 rillig
65 1.7 rillig # Before var.c 1.631 from 2020-10-31 21:40:20, it was possible to pass
66 1.7 rillig # negative time stamps to the :gmtime modifier, resulting in dates before
67 1.7 rillig # 1970. Going back 50 years in the past is not a practical use case for
68 1.7 rillig # make. Therefore, since var.c 1.631, negative time stamps produce a
69 1.7 rillig # parse error.
70 1.7 rillig .if ${:L:gmtime=-1} != ""
71 1.7 rillig . error
72 1.7 rillig .else
73 1.7 rillig . error
74 1.7 rillig .endif
75 1.7 rillig
76 1.7 rillig
77 1.10 rillig # Spaces were allowed before var.c 1.631 from 2020-10-31 21:40:20, not
78 1.10 rillig # because it would make sense but just as a side-effect from using strtoul.
79 1.7 rillig .if ${:L:gmtime= 1} != ""
80 1.7 rillig . error
81 1.11 rillig .else
82 1.11 rillig . error
83 1.7 rillig .endif
84 1.7 rillig
85 1.7 rillig
86 1.7 rillig # 0 means now; this differs from GNode.mtime, where a 0 means nonexistent.
87 1.7 rillig # Since "now" constantly changes, the strongest possible test is to match the
88 1.7 rillig # resulting pattern.
89 1.7 rillig .if !${:L:gmtime=0:tW:M??? ??? ?? ??\:??\:?? 20??}
90 1.7 rillig . error
91 1.7 rillig .endif
92 1.7 rillig
93 1.7 rillig
94 1.7 rillig .if ${:L:gmtime=1} != "Thu Jan 1 00:00:01 1970"
95 1.7 rillig . error
96 1.7 rillig .endif
97 1.7 rillig
98 1.7 rillig
99 1.7 rillig # INT32_MAX
100 1.7 rillig .if ${:L:gmtime=2147483647} != "Tue Jan 19 03:14:07 2038"
101 1.7 rillig . error
102 1.7 rillig .endif
103 1.7 rillig
104 1.7 rillig
105 1.7 rillig .if ${:L:gmtime=2147483648} == "Tue Jan 19 03:14:08 2038"
106 1.7 rillig # All systems that have unsigned time_t or 64-bit time_t.
107 1.10 rillig .elif ${:L:gmtime=2147483648} == "Fri Dec 13 20:45:52 1901"
108 1.10 rillig # FreeBSD-12.0-i386 still has 32-bit signed time_t, see
109 1.10 rillig # sys/x86/include/_types.h, __LP64__.
110 1.10 rillig #
111 1.10 rillig # Linux on 32-bit systems may still have 32-bit signed time_t, see
112 1.10 rillig # sysdeps/unix/sysv/linux/generic/bits/typesizes.h, __TIMESIZE.
113 1.7 rillig .else
114 1.7 rillig . error
115 1.7 rillig .endif
116 1.7 rillig
117 1.7 rillig
118 1.7 rillig # Integer overflow, at least before var.c 1.631 from 2020-10-31.
119 1.7 rillig # Because this modifier is implemented using strtoul, the parsed time was
120 1.7 rillig # ULONG_MAX, which got converted to -1. This resulted in a time stamp of
121 1.7 rillig # the second before 1970.
122 1.7 rillig #
123 1.11 rillig # Since var.c 1.631 from 2020-10-31, the overflow is detected and produces a
124 1.11 rillig # parse error.
125 1.7 rillig .if ${:L:gmtime=10000000000000000000000000000000} != ""
126 1.7 rillig . error
127 1.7 rillig .else
128 1.7 rillig . error
129 1.7 rillig .endif
130 1.7 rillig
131 1.9 rillig # Before var.c 1.631 from 2020-10-31, there was no error handling while
132 1.10 rillig # parsing the :gmtime modifier, thus no error message was printed. Parsing
133 1.7 rillig # stopped after the '=', and the remaining string was parsed for more variable
134 1.7 rillig # modifiers. Because of the unknown modifier 'e' from the 'error', the whole
135 1.7 rillig # variable value was discarded and thus not printed.
136 1.7 rillig .if ${:L:gmtime=error} != ""
137 1.7 rillig . error
138 1.7 rillig .else
139 1.7 rillig . error
140 1.7 rillig .endif
141 1.6 rillig
142 1.11 rillig # Before var.c 1.TODO from XXXX-XX-XX, the timestamp could be directly
143 1.11 rillig # followed by the next modifier, without a ':' separator. This is the same
144 1.11 rillig # bug as for the ':L' and ':P' modifiers.
145 1.11 rillig .if ${%Y:L:gmtime=100000S,1970,bad,} != "bad"
146 1.11 rillig . error
147 1.11 rillig .endif
148 1.6 rillig
149 1.7 rillig all:
150