Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ASN1_TIME_PARSE(3)     FreeBSD Library Functions Manual	    ASN1_TIME_PARSE(3)

NAME
     ASN1_time_parse, ASN1_time_tm_cmp,	ASN1_TIME_set_tm -- LibreSSL utilities
     for ASN.1 time types

SYNOPSIS
     #include <openssl/asn1.h>

     int
     ASN1_time_parse(const char	*bytes,	size_t len, struct tm *tm, int mode);

     int
     ASN1_time_tm_cmp(struct tm	*tm1, struct tm	*tm2);

     ASN1_TIME *
     ASN1_TIME_set_tm(ASN1_TIME	*s, struct tm *tm);

DESCRIPTION
     The ASN1_time_parse() function parses an ASN.1 time string	of len bytes
     starting at bytes.	 The resulting time is stored in tm if tm is not NULL.

     The mode parameter	must be	one of

	 +o   0 to parse	a time as specified in RFC 5280	for an X509 object,
	     which may be either a UTC time or a Generalized time.

	 +o   V_ASN1_UTCTIME to parse an	RFC 5280 format	UTC time.

	 +o   V_ASN1_GENERALIZEDTIME to parse an	RFC 5280 format	Generalized
	     time.

     The ASN1_time_tm_cmp() function compares two times	in tm1 and tm2.

     The function ASN1_TIME_set_tm() sets the ASN1_TIME	structure s to the
     time represented by the struct tm value pointed to	by tm.	If s is	NULL,
     a new ASN1_TIME structure is allocated and	returned.

RETURN VALUES
     ASN1_parse_time() returns

	 +o   -1	if the string was invalid for the mode specified.

	 +o   V_ASN1_UTCTIME if the string parsed as a valid UTC	time.

	 +o   V_ASN1_GENERALIZEDTIME if the string parsed as a valid General-
	     ized time.

     ASN1_time_tm_cmp()	returns

	 +o   -1	if tm1 is less than tm2.

	 +o   1 if tm1 is greater than tm2.

	 +o   0 if tm1 is the same as tm2.

     ASN1_TIME_set_tm()	returns	a pointer to an	ASN1_TIME structure or NULL if
     an	error occurred.

SEE ALSO
     ASN1_TIME_new(3), ASN1_TIME_set(3), X509_cmp_time(3)

HISTORY
     ASN1_time_parse() and ASN1_time_tm_cmp() first appeared in	OpenBSD	6.1
     and ASN1_TIME_set_tm() in OpenBSD 6.2.

FreeBSD	13.0			 June 6, 2019			  FreeBSD 13.0

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | SEE ALSO | HISTORY

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=ASN1_time_parse&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help