/src/nss/lib/util/dertime.c

Source
/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

#include "prtypes.h"
#include "prtime.h"
#include "secder.h"
#include "prlong.h"
#include "secerr.h"

#define HIDIGIT(v) (((v) / 10) + '0')
#define LODIGIT(v) (((v) % 10) + '0')

#define ISDIGIT(dig) (((dig) >= '0') && ((dig) <= '9'))
#define CAPTURE(var, p, label)                        \
    {                                                 \
        if (!ISDIGIT((p)[0]) || !ISDIGIT((p)[1]))     \
            goto label;                               \
        (var) = ((p)[0] - '0') * 10 + ((p)[1] - '0'); \
        p += 2;                                       \
    }

static const PRTime January1st1 = PR_INT64(0xff23400100d44000);
static const PRTime January1st1950 = PR_INT64(0xfffdc1f8793da000);
static const PRTime January1st2050 = PR_INT64(0x0008f81e1b098000);
static const PRTime January1st10000 = PR_INT64(0x0384440ccc736000);

/* gmttime must contains UTC time in micro-seconds unit */
SECStatus
DER_TimeToUTCTimeArena(PLArenaPool *arenaOpt, SECItem *dst, PRTime gmttime)
{
    PRExplodedTime printableTime;
    unsigned char *d;

    if ((gmttime < January1st1950) || (gmttime >= January1st2050)) {
        PORT_SetError(SEC_ERROR_INVALID_ARGS);
        return SECFailure;
    }

    dst->len = 13;
    if (arenaOpt) {
        dst->data = d = (unsigned char *)PORT_ArenaAlloc(arenaOpt, dst->len);
    } else {
        dst->data = d = (unsigned char *)PORT_Alloc(dst->len);
    }
    dst->type = siUTCTime;
    if (!d) {
        return SECFailure;
    }

    /* Convert a PRTime to a printable format.  */
    PR_ExplodeTime(gmttime, PR_GMTParameters, &printableTime);

    /* The month in UTC time is base one */
    printableTime.tm_month++;

    /* remove the century since it's added to the tm_year by the
       PR_ExplodeTime routine, but is not needed for UTC time */
    printableTime.tm_year %= 100;

    d[0] = HIDIGIT(printableTime.tm_year);
    d[1] = LODIGIT(printableTime.tm_year);
    d[2] = HIDIGIT(printableTime.tm_month);
    d[3] = LODIGIT(printableTime.tm_month);
    d[4] = HIDIGIT(printableTime.tm_mday);
    d[5] = LODIGIT(printableTime.tm_mday);
    d[6] = HIDIGIT(printableTime.tm_hour);
    d[7] = LODIGIT(printableTime.tm_hour);
    d[8] = HIDIGIT(printableTime.tm_min);
    d[9] = LODIGIT(printableTime.tm_min);
    d[10] = HIDIGIT(printableTime.tm_sec);
    d[11] = LODIGIT(printableTime.tm_sec);
    d[12] = 'Z';
    return SECSuccess;
}

SECStatus
DER_TimeToUTCTime(SECItem *dst, PRTime gmttime)
{
    return DER_TimeToUTCTimeArena(NULL, dst, gmttime);
}

static SECStatus /* forward */
der_TimeStringToTime(PRTime *dst, const char *string, int generalized,
                     const char **endptr);

#define GEN_STRING 2 /* TimeString is a GeneralizedTime */
#define UTC_STRING 0 /* TimeString is a UTCTime         */

/* The caller of DER_AsciiToItem MUST ENSURE that either
** a) "string" points to a null-terminated ASCII string, or
** b) "string" points to a buffer containing a valid UTCTime,
**     whether null terminated or not, or
** c) "string" contains at least 19 characters, with or without null char.
** otherwise, this function may UMR and/or crash.
** It suffices to ensure that the input "string" is at least 17 bytes long.
*/
SECStatus
DER_AsciiToTime(PRTime *dst, const char *string)
{
    return der_TimeStringToTime(dst, string, UTC_STRING, NULL);
}

SECStatus
DER_UTCTimeToTime(PRTime *dst, const SECItem *time)
{
    /* Minimum valid UTCTime is yymmddhhmmZ       which is 11 bytes.
    ** Maximum valid UTCTime is yymmddhhmmss+0000 which is 17 bytes.
    ** 20 should be large enough for all valid encoded times.
    */
    unsigned int i;
    char localBuf[20];
    const char *end = NULL;
    SECStatus rv;

    if (!time || !time->data || time->len < 11 || time->len > 17) {
        PORT_SetError(SEC_ERROR_INVALID_TIME);
        return SECFailure;
    }

    for (i = 0; i < time->len; i++) {
        if (time->data[i] == '\0') {
            PORT_SetError(SEC_ERROR_INVALID_TIME);
            return SECFailure;
        }
        localBuf[i] = time->data[i];
    }
    localBuf[i] = '\0';

    rv = der_TimeStringToTime(dst, localBuf, UTC_STRING, &end);
    if (rv == SECSuccess && *end != '\0') {
        PORT_SetError(SEC_ERROR_INVALID_TIME);
        return SECFailure;
    }
    return rv;
}

/*
   gmttime must contains UTC time in micro-seconds unit.
   Note: the caller should make sure that Generalized time
   should only be used for certifiate validities after the
   year 2049.  Otherwise, UTC time should be used.  This routine
   does not check this case, since it can be used to encode
   certificate extension, which does not have this restriction.
 */
SECStatus
DER_TimeToGeneralizedTimeArena(PLArenaPool *arenaOpt, SECItem *dst, PRTime gmttime)
{
    PRExplodedTime printableTime;
    unsigned char *d;

    if ((gmttime < January1st1) || (gmttime >= January1st10000)) {
        PORT_SetError(SEC_ERROR_INVALID_ARGS);
        return SECFailure;
    }
    dst->len = 15;
    if (arenaOpt) {
        dst->data = d = (unsigned char *)PORT_ArenaAlloc(arenaOpt, dst->len);
    } else {
        dst->data = d = (unsigned char *)PORT_Alloc(dst->len);
    }
    dst->type = siGeneralizedTime;
    if (!d) {
        return SECFailure;
    }

    /* Convert a PRTime to a printable format.  */
    PR_ExplodeTime(gmttime, PR_GMTParameters, &printableTime);

    /* The month in Generalized time is base one */
    printableTime.tm_month++;

    d[0] = (printableTime.tm_year / 1000) + '0';
    d[1] = ((printableTime.tm_year % 1000) / 100) + '0';
    d[2] = ((printableTime.tm_year % 100) / 10) + '0';
    d[3] = (printableTime.tm_year % 10) + '0';
    d[4] = HIDIGIT(printableTime.tm_month);
    d[5] = LODIGIT(printableTime.tm_month);
    d[6] = HIDIGIT(printableTime.tm_mday);
    d[7] = LODIGIT(printableTime.tm_mday);
    d[8] = HIDIGIT(printableTime.tm_hour);
    d[9] = LODIGIT(printableTime.tm_hour);
    d[10] = HIDIGIT(printableTime.tm_min);
    d[11] = LODIGIT(printableTime.tm_min);
    d[12] = HIDIGIT(printableTime.tm_sec);
    d[13] = LODIGIT(printableTime.tm_sec);
    d[14] = 'Z';
    return SECSuccess;
}

SECStatus
DER_TimeToGeneralizedTime(SECItem *dst, PRTime gmttime)
{
    return DER_TimeToGeneralizedTimeArena(NULL, dst, gmttime);
}

SECStatus
DER_GeneralizedTimeToTime(PRTime *dst, const SECItem *time)
{
    /* Minimum valid GeneralizedTime is ccyymmddhhmmZ       which is 13 bytes.
    ** Maximum valid GeneralizedTime is ccyymmddhhmmss+0000 which is 19 bytes.
    ** 20 should be large enough for all valid encoded times.
    */
    unsigned int i;
    char localBuf[20];
    const char *end = NULL;
    SECStatus rv;

    if (!time || !time->data || time->len < 13 || time->len > 19) {
        PORT_SetError(SEC_ERROR_INVALID_TIME);
        return SECFailure;
    }

    for (i = 0; i < time->len; i++) {
        if (time->data[i] == '\0') {
            PORT_SetError(SEC_ERROR_INVALID_TIME);
            return SECFailure;
        }
        localBuf[i] = time->data[i];
    }
    localBuf[i] = '\0';

    rv = der_TimeStringToTime(dst, localBuf, GEN_STRING, &end);
    if (rv == SECSuccess && *end != '\0') {
        PORT_SetError(SEC_ERROR_INVALID_TIME);
        return SECFailure;
    }
    return rv;
}

static SECStatus
der_TimeStringToTime(PRTime *dst, const char *string, int generalized,
                     const char **endptr)
{
    PRExplodedTime genTime;
    long hourOff = 0, minOff = 0;
    PRUint16 century;
    char signum;

    if (string == NULL || dst == NULL) {
        PORT_SetError(SEC_ERROR_INVALID_ARGS);
        return SECFailure;
    }

    /* Verify time is formatted properly and capture information */
    memset(&genTime, 0, sizeof genTime);

    if (generalized == UTC_STRING) {
        CAPTURE(genTime.tm_year, string, loser);
        century = (genTime.tm_year < 50) ? 20 : 19;
    } else {
        CAPTURE(century, string, loser);
        CAPTURE(genTime.tm_year, string, loser);
    }
    genTime.tm_year += century * 100;

    CAPTURE(genTime.tm_month, string, loser);
    if ((genTime.tm_month == 0) || (genTime.tm_month > 12))
        goto loser;

    /* NSPR month base is 0 */
    --genTime.tm_month;

    CAPTURE(genTime.tm_mday, string, loser);
    if ((genTime.tm_mday == 0) || (genTime.tm_mday > 31))
        goto loser;

    CAPTURE(genTime.tm_hour, string, loser);
    if (genTime.tm_hour > 23)
        goto loser;

    CAPTURE(genTime.tm_min, string, loser);
    if (genTime.tm_min > 59)
        goto loser;

    if (ISDIGIT(string[0])) {
        CAPTURE(genTime.tm_sec, string, loser);
        if (genTime.tm_sec > 59)
            goto loser;
    }
    signum = *string++;
    if (signum == '+' || signum == '-') {
        CAPTURE(hourOff, string, loser);
        if (hourOff > 23)
            goto loser;
        CAPTURE(minOff, string, loser);
        if (minOff > 59)
            goto loser;
        if (signum == '-') {
            hourOff = -hourOff;
            minOff = -minOff;
        }
    } else if (signum != 'Z') {
        goto loser;
    }

    if (endptr)
        *endptr = string;

    /* Convert the GMT offset to seconds and save it in genTime
     * for the implode time call.
     */
    genTime.tm_params.tp_gmt_offset = (PRInt32)((hourOff * 60L + minOff) * 60L);
    *dst = PR_ImplodeTime(&genTime);
    return SECSuccess;

loser:
    PORT_SetError(SEC_ERROR_INVALID_TIME);
    return SECFailure;
}

Coverage Report

Created: 2026-10-13 06:23

Line	Count	Source
1		/* This Source Code Form is subject to the terms of the Mozilla Public
2		* License, v. 2.0. If a copy of the MPL was not distributed with this
3		* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
4
5		#include "prtypes.h"
6		#include "prtime.h"
7		#include "secder.h"
8		#include "prlong.h"
9		#include "secerr.h"
10
11	0	#define HIDIGIT(v) (((v) / 10) + '0')
12	0	#define LODIGIT(v) (((v) % 10) + '0')
13
14	1.28M	#define ISDIGIT(dig) (((dig) >= '0') && ((dig) <= '9'))
15		#define CAPTURE(var, p, label) \
16	407k	{ \
17	407k	if (!ISDIGIT((p)[0]) \|\| !ISDIGIT((p)[1])) \
18	407k	goto label; \
19	407k	(var) = ((p)[0] - '0') * 10 + ((p)[1] - '0'); \
20	402k	p += 2; \
21	402k	}
22
23		static const PRTime January1st1 = PR_INT64(0xff23400100d44000);
24		static const PRTime January1st1950 = PR_INT64(0xfffdc1f8793da000);
25		static const PRTime January1st2050 = PR_INT64(0x0008f81e1b098000);
26		static const PRTime January1st10000 = PR_INT64(0x0384440ccc736000);
27
28		/* gmttime must contains UTC time in micro-seconds unit */
29		SECStatus
30		DER_TimeToUTCTimeArena(PLArenaPool arenaOpt, SECItem dst, PRTime gmttime)
31	0	{
32	0	PRExplodedTime printableTime;
33	0	unsigned char *d;
34
35	0	if ((gmttime < January1st1950) \|\| (gmttime >= January1st2050)) {
36	0	PORT_SetError(SEC_ERROR_INVALID_ARGS);
37	0	return SECFailure;
38	0	}
39
40	0	dst->len = 13;
41	0	if (arenaOpt) {
42	0	dst->data = d = (unsigned char *)PORT_ArenaAlloc(arenaOpt, dst->len);
43	0	} else {
44	0	dst->data = d = (unsigned char *)PORT_Alloc(dst->len);
45	0	}
46	0	dst->type = siUTCTime;
47	0	if (!d) {
48	0	return SECFailure;
49	0	}
50
51		/* Convert a PRTime to a printable format. */
52	0	PR_ExplodeTime(gmttime, PR_GMTParameters, &printableTime);
53
54		/* The month in UTC time is base one */
55	0	printableTime.tm_month++;
56
57		/* remove the century since it's added to the tm_year by the
58		PR_ExplodeTime routine, but is not needed for UTC time */
59	0	printableTime.tm_year %= 100;
60
61	0	d[0] = HIDIGIT(printableTime.tm_year);
62	0	d[1] = LODIGIT(printableTime.tm_year);
63	0	d[2] = HIDIGIT(printableTime.tm_month);
64	0	d[3] = LODIGIT(printableTime.tm_month);
65	0	d[4] = HIDIGIT(printableTime.tm_mday);
66	0	d[5] = LODIGIT(printableTime.tm_mday);
67	0	d[6] = HIDIGIT(printableTime.tm_hour);
68	0	d[7] = LODIGIT(printableTime.tm_hour);
69	0	d[8] = HIDIGIT(printableTime.tm_min);
70	0	d[9] = LODIGIT(printableTime.tm_min);
71	0	d[10] = HIDIGIT(printableTime.tm_sec);
72	0	d[11] = LODIGIT(printableTime.tm_sec);
73	0	d[12] = 'Z';
74	0	return SECSuccess;
75	0	}
76
77		SECStatus
78		DER_TimeToUTCTime(SECItem *dst, PRTime gmttime)
79	0	{
80	0	return DER_TimeToUTCTimeArena(NULL, dst, gmttime);
81	0	}
82
83		static SECStatus /* forward */
84		der_TimeStringToTime(PRTime dst, const char string, int generalized,
85		const char **endptr);
86
87	16.2k	#define GEN_STRING 2 /* TimeString is a GeneralizedTime */
88	120k	#define UTC_STRING 0 /* TimeString is a UTCTime */
89
90		/* The caller of DER_AsciiToItem MUST ENSURE that either
91		** a) "string" points to a null-terminated ASCII string, or
92		** b) "string" points to a buffer containing a valid UTCTime,
93		** whether null terminated or not, or
94		** c) "string" contains at least 19 characters, with or without null char.
95		** otherwise, this function may UMR and/or crash.
96		** It suffices to ensure that the input "string" is at least 17 bytes long.
97		*/
98		SECStatus
99		DER_AsciiToTime(PRTime dst, const char string)
100	0	{
101	0	return der_TimeStringToTime(dst, string, UTC_STRING, NULL);
102	0	}
103
104		SECStatus
105		DER_UTCTimeToTime(PRTime dst, const SECItem time)
106	52.5k	{
107		/* Minimum valid UTCTime is yymmddhhmmZ which is 11 bytes.
108		** Maximum valid UTCTime is yymmddhhmmss+0000 which is 17 bytes.
109		** 20 should be large enough for all valid encoded times.
110		*/
111	52.5k	unsigned int i;
112	52.5k	char localBuf[20];
113	52.5k	const char *end = NULL;
114	52.5k	SECStatus rv;
115
116	52.5k	if (!time \|\| !time->data \|\| time->len < 11 \|\| time->len > 17) {
117	122	PORT_SetError(SEC_ERROR_INVALID_TIME);
118	122	return SECFailure;
119	122	}
120
121	731k	for (i = 0; i < time->len; i++) {
122	679k	if (time->data[i] == '\0') {
123	357	PORT_SetError(SEC_ERROR_INVALID_TIME);
124	357	return SECFailure;
125	357	}
126	678k	localBuf[i] = time->data[i];
127	678k	}
128	52.0k	localBuf[i] = '\0';
129
130	52.0k	rv = der_TimeStringToTime(dst, localBuf, UTC_STRING, &end);
131	52.0k	if (rv == SECSuccess && *end != '\0') {
132	89	PORT_SetError(SEC_ERROR_INVALID_TIME);
133	89	return SECFailure;
134	89	}
135	51.9k	return rv;
136	52.0k	}
137
138		/*
139		gmttime must contains UTC time in micro-seconds unit.
140		Note: the caller should make sure that Generalized time
141		should only be used for certifiate validities after the
142		year 2049. Otherwise, UTC time should be used. This routine
143		does not check this case, since it can be used to encode
144		certificate extension, which does not have this restriction.
145		*/
146		SECStatus
147		DER_TimeToGeneralizedTimeArena(PLArenaPool arenaOpt, SECItem dst, PRTime gmttime)
148	0	{
149	0	PRExplodedTime printableTime;
150	0	unsigned char *d;
151
152	0	if ((gmttime < January1st1) \|\| (gmttime >= January1st10000)) {
153	0	PORT_SetError(SEC_ERROR_INVALID_ARGS);
154	0	return SECFailure;
155	0	}
156	0	dst->len = 15;
157	0	if (arenaOpt) {
158	0	dst->data = d = (unsigned char *)PORT_ArenaAlloc(arenaOpt, dst->len);
159	0	} else {
160	0	dst->data = d = (unsigned char *)PORT_Alloc(dst->len);
161	0	}
162	0	dst->type = siGeneralizedTime;
163	0	if (!d) {
164	0	return SECFailure;
165	0	}
166
167		/* Convert a PRTime to a printable format. */
168	0	PR_ExplodeTime(gmttime, PR_GMTParameters, &printableTime);
169
170		/* The month in Generalized time is base one */
171	0	printableTime.tm_month++;
172
173	0	d[0] = (printableTime.tm_year / 1000) + '0';
174	0	d[1] = ((printableTime.tm_year % 1000) / 100) + '0';
175	0	d[2] = ((printableTime.tm_year % 100) / 10) + '0';
176	0	d[3] = (printableTime.tm_year % 10) + '0';
177	0	d[4] = HIDIGIT(printableTime.tm_month);
178	0	d[5] = LODIGIT(printableTime.tm_month);
179	0	d[6] = HIDIGIT(printableTime.tm_mday);
180	0	d[7] = LODIGIT(printableTime.tm_mday);
181	0	d[8] = HIDIGIT(printableTime.tm_hour);
182	0	d[9] = LODIGIT(printableTime.tm_hour);
183	0	d[10] = HIDIGIT(printableTime.tm_min);
184	0	d[11] = LODIGIT(printableTime.tm_min);
185	0	d[12] = HIDIGIT(printableTime.tm_sec);
186	0	d[13] = LODIGIT(printableTime.tm_sec);
187	0	d[14] = 'Z';
188	0	return SECSuccess;
189	0	}
190
191		SECStatus
192		DER_TimeToGeneralizedTime(SECItem *dst, PRTime gmttime)
193	0	{
194	0	return DER_TimeToGeneralizedTimeArena(NULL, dst, gmttime);
195	0	}
196
197		SECStatus
198		DER_GeneralizedTimeToTime(PRTime dst, const SECItem time)
199	16.7k	{
200		/* Minimum valid GeneralizedTime is ccyymmddhhmmZ which is 13 bytes.
201		** Maximum valid GeneralizedTime is ccyymmddhhmmss+0000 which is 19 bytes.
202		** 20 should be large enough for all valid encoded times.
203		*/
204	16.7k	unsigned int i;
205	16.7k	char localBuf[20];
206	16.7k	const char *end = NULL;
207	16.7k	SECStatus rv;
208
209	16.7k	if (!time \|\| !time->data \|\| time->len < 13 \|\| time->len > 19) {
210	135	PORT_SetError(SEC_ERROR_INVALID_TIME);
211	135	return SECFailure;
212	135	}
213
214	258k	for (i = 0; i < time->len; i++) {
215	242k	if (time->data[i] == '\0') {
216	372	PORT_SetError(SEC_ERROR_INVALID_TIME);
217	372	return SECFailure;
218	372	}
219	241k	localBuf[i] = time->data[i];
220	241k	}
221	16.2k	localBuf[i] = '\0';
222
223	16.2k	rv = der_TimeStringToTime(dst, localBuf, GEN_STRING, &end);
224	16.2k	if (rv == SECSuccess && *end != '\0') {
225	57	PORT_SetError(SEC_ERROR_INVALID_TIME);
226	57	return SECFailure;
227	57	}
228	16.1k	return rv;
229	16.2k	}
230
231		static SECStatus
232		der_TimeStringToTime(PRTime dst, const char string, int generalized,
233		const char **endptr)
234	68.2k	{
235	68.2k	PRExplodedTime genTime;
236	68.2k	long hourOff = 0, minOff = 0;
237	68.2k	PRUint16 century;
238	68.2k	char signum;
239
240	68.2k	if (string == NULL \|\| dst == NULL) {
241	0	PORT_SetError(SEC_ERROR_INVALID_ARGS);
242	0	return SECFailure;
243	0	}
244
245		/* Verify time is formatted properly and capture information */
246	68.2k	memset(&genTime, 0, sizeof genTime);
247
248	68.2k	if (generalized == UTC_STRING) {
249	52.0k	CAPTURE(genTime.tm_year, string, loser);
250	51.4k	century = (genTime.tm_year < 50) ? 20 : 19;
251	51.4k	} else {
252	16.2k	CAPTURE(century, string, loser);
253	15.7k	CAPTURE(genTime.tm_year, string, loser);
254	15.3k	}
255	66.7k	genTime.tm_year += century * 100;
256
257	66.7k	CAPTURE(genTime.tm_month, string, loser);
258	66.1k	if ((genTime.tm_month == 0) \|\| (genTime.tm_month > 12))
259	341	goto loser;
260
261		/* NSPR month base is 0 */
262	65.8k	--genTime.tm_month;
263
264	65.8k	CAPTURE(genTime.tm_mday, string, loser);
265	65.2k	if ((genTime.tm_mday == 0) \|\| (genTime.tm_mday > 31))
266	259	goto loser;
267
268	129k	CAPTURE(genTime.tm_hour, string, loser);
269	129k	if (genTime.tm_hour > 23)
270	174	goto loser;
271
272	127k	CAPTURE(genTime.tm_min, string, loser);
273	127k	if (genTime.tm_min > 59)
274	178	goto loser;
275
276	63.3k	if (ISDIGIT(string[0])) {
277	60.7k	CAPTURE(genTime.tm_sec, string, loser);
278	60.4k	if (genTime.tm_sec > 59)
279	95	goto loser;
280	60.4k	}
281	62.9k	signum = *string++;
282	62.9k	if (signum == '+' \|\| signum == '-') {
283	622	CAPTURE(hourOff, string, loser);
284	167	if (hourOff > 23)
285	89	goto loser;
286	78	CAPTURE(minOff, string, loser);
287	78	if (minOff > 59)
288	0	goto loser;
289	0	if (signum == '-') {
290	0	hourOff = -hourOff;
291	0	minOff = -minOff;
292	0	}
293	62.3k	} else if (signum != 'Z') {
294	309	goto loser;
295	309	}
296
297	62.0k	if (endptr)
298	62.0k	*endptr = string;
299
300		/* Convert the GMT offset to seconds and save it in genTime
301		* for the implode time call.
302		*/
303	62.0k	genTime.tm_params.tp_gmt_offset = (PRInt32)((hourOff * 60L + minOff) * 60L);
304	62.0k	*dst = PR_ImplodeTime(&genTime);
305	62.0k	return SECSuccess;
306
307	6.26k	loser:
308	6.26k	PORT_SetError(SEC_ERROR_INVALID_TIME);
309	6.26k	return SECFailure;
310	62.9k	}