summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authortb <>2024-03-05 18:30:40 +0000
committertb <>2024-03-05 18:30:40 +0000
commitf00f40684a806cf07c843cf80d4bd3b5495181ac (patch)
tree85167e06d303b96d549223ac726e858741b03c7e
parent718acb4db9804b32fa5d19c4102807c831aca5c8 (diff)
downloadopenbsd-f00f40684a806cf07c843cf80d4bd3b5495181ac.tar.gz
openbsd-f00f40684a806cf07c843cf80d4bd3b5495181ac.tar.bz2
openbsd-f00f40684a806cf07c843cf80d4bd3b5495181ac.zip
Remove ASN1_time_parse documentation
-rw-r--r--src/lib/libcrypto/man/ASN1_STRING_new.35
-rw-r--r--src/lib/libcrypto/man/ASN1_TIME_set.35
-rw-r--r--src/lib/libcrypto/man/ASN1_time_parse.3141
-rw-r--r--src/lib/libcrypto/man/Makefile3
-rw-r--r--src/lib/libcrypto/man/X509_cmp_time.37
-rw-r--r--src/lib/libcrypto/man/X509_get0_notBefore.35
6 files changed, 9 insertions, 157 deletions
diff --git a/src/lib/libcrypto/man/ASN1_STRING_new.3 b/src/lib/libcrypto/man/ASN1_STRING_new.3
index 9500b82df3..19b0ca1161 100644
--- a/src/lib/libcrypto/man/ASN1_STRING_new.3
+++ b/src/lib/libcrypto/man/ASN1_STRING_new.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: ASN1_STRING_new.3,v 1.25 2023/07/28 05:48:33 tb Exp $ 1.\" $OpenBSD: ASN1_STRING_new.3,v 1.26 2024/03/05 18:30:40 tb Exp $
2.\" OpenSSL 99d63d46 Tue Mar 24 07:52:24 2015 -0400 2.\" OpenSSL 99d63d46 Tue Mar 24 07:52:24 2015 -0400
3.\" 3.\"
4.\" Copyright (c) 2017 Ingo Schwarze <schwarze@openbsd.org> 4.\" Copyright (c) 2017 Ingo Schwarze <schwarze@openbsd.org>
@@ -15,7 +15,7 @@
15.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 15.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
16.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 16.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17.\" 17.\"
18.Dd $Mdocdate: July 28 2023 $ 18.Dd $Mdocdate: March 5 2024 $
19.Dt ASN1_STRING_NEW 3 19.Dt ASN1_STRING_NEW 3
20.Os 20.Os
21.Sh NAME 21.Sh NAME
@@ -212,7 +212,6 @@ is returned and an error code can be retrieved with
212.Xr ASN1_PRINTABLE_type 3 , 212.Xr ASN1_PRINTABLE_type 3 ,
213.Xr ASN1_STRING_length 3 , 213.Xr ASN1_STRING_length 3 ,
214.Xr ASN1_STRING_print_ex 3 , 214.Xr ASN1_STRING_print_ex 3 ,
215.Xr ASN1_time_parse 3 ,
216.Xr ASN1_TIME_set 3 , 215.Xr ASN1_TIME_set 3 ,
217.Xr ASN1_TYPE_get 3 , 216.Xr ASN1_TYPE_get 3 ,
218.Xr ASN1_UNIVERSALSTRING_to_string 3 , 217.Xr ASN1_UNIVERSALSTRING_to_string 3 ,
diff --git a/src/lib/libcrypto/man/ASN1_TIME_set.3 b/src/lib/libcrypto/man/ASN1_TIME_set.3
index b5ed51567b..233cb13f2c 100644
--- a/src/lib/libcrypto/man/ASN1_TIME_set.3
+++ b/src/lib/libcrypto/man/ASN1_TIME_set.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: ASN1_TIME_set.3,v 1.22 2024/02/18 16:30:17 tb Exp $ 1.\" $OpenBSD: ASN1_TIME_set.3,v 1.23 2024/03/05 18:30:40 tb Exp $
2.\" full merge up to: OpenSSL 3d0f1cb9 Jul 11 03:01:24 2017 +0800 2.\" full merge up to: OpenSSL 3d0f1cb9 Jul 11 03:01:24 2017 +0800
3.\" selective merge up to: OpenSSL 24a535ea Sep 22 13:14:20 2020 +0100 3.\" selective merge up to: OpenSSL 24a535ea Sep 22 13:14:20 2020 +0100
4.\" 4.\"
@@ -68,7 +68,7 @@
68.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 68.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
69.\" OF THE POSSIBILITY OF SUCH DAMAGE. 69.\" OF THE POSSIBILITY OF SUCH DAMAGE.
70.\" 70.\"
71.Dd $Mdocdate: February 18 2024 $ 71.Dd $Mdocdate: March 5 2024 $
72.Dt ASN1_TIME_SET 3 72.Dt ASN1_TIME_SET 3
73.Os 73.Os
74.Sh NAME 74.Sh NAME
@@ -659,7 +659,6 @@ BIO_free(b);
659.Ed 659.Ed
660.Sh SEE ALSO 660.Sh SEE ALSO
661.Xr ASN1_TIME_new 3 , 661.Xr ASN1_TIME_new 3 ,
662.Xr ASN1_time_parse 3 ,
663.Xr X509_cmp_time 3 662.Xr X509_cmp_time 3
664.Sh STANDARDS 663.Sh STANDARDS
665The usage of the ASN.1 664The usage of the ASN.1
diff --git a/src/lib/libcrypto/man/ASN1_time_parse.3 b/src/lib/libcrypto/man/ASN1_time_parse.3
deleted file mode 100644
index 6ec45e5dcc..0000000000
--- a/src/lib/libcrypto/man/ASN1_time_parse.3
+++ /dev/null
@@ -1,141 +0,0 @@
1.\" $OpenBSD: ASN1_time_parse.3,v 1.9 2020/11/02 17:45:35 tb Exp $
2.\"
3.\" Copyright (c) 2016 Bob Beck <beck@openbsd.org>
4.\"
5.\" Permission to use, copy, modify, and distribute this software for any
6.\" purpose with or without fee is hereby granted, provided that the above
7.\" copyright notice and this permission notice appear in all copies.
8.\"
9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16.\"
17.Dd $Mdocdate: November 2 2020 $
18.Dt ASN1_TIME_PARSE 3
19.Os
20.Sh NAME
21.Nm ASN1_time_parse ,
22.Nm ASN1_time_tm_cmp ,
23.Nm ASN1_TIME_set_tm
24.Nd LibreSSL utilities for ASN.1 time types
25.Sh SYNOPSIS
26.In openssl/asn1.h
27.Ft int
28.Fn ASN1_time_parse "const char *bytes" "size_t len" "struct tm *tm" "int mode"
29.Ft int
30.Fn ASN1_time_tm_cmp "struct tm *tm1" "struct tm *tm2"
31.Ft ASN1_TIME *
32.Fn ASN1_TIME_set_tm "ASN1_TIME *s" "struct tm *tm"
33.Sh DESCRIPTION
34The
35.Fn ASN1_time_parse
36function parses an ASN.1 time string of
37.Ar len
38bytes starting at
39.Ar bytes .
40The resulting time is stored in
41.Ar tm
42if
43.Ar tm
44is not
45.Dv NULL .
46.Pp
47The
48.Ar mode
49parameter must be one of
50.Bl -bullet -offset four
51.It
520 to parse a time as specified in RFC 5280 for an X509 object,
53which may be either a UTC time or a Generalized time.
54.It
55.Dv V_ASN1_UTCTIME
56to parse an RFC 5280 format UTC time.
57.It
58.Dv V_ASN1_GENERALIZEDTIME
59to parse an RFC 5280 format Generalized time.
60.El
61.Pp
62The
63.Fn ASN1_time_tm_cmp
64function compares two times in
65.Ar tm1
66and
67.Ar tm2 .
68.Pp
69The function
70.Fn ASN1_TIME_set_tm
71sets the
72.Vt ASN1_TIME
73structure
74.Fa s
75to the time represented by the
76.Vt struct tm
77value pointed to by
78.Fa tm .
79If
80.Fa s
81is
82.Dv NULL ,
83a new
84.Vt ASN1_TIME
85structure is allocated and returned.
86.Sh RETURN VALUES
87.Fn ASN1_time_parse
88returns
89.Bl -bullet -offset four
90.It
91-1 if the string was invalid for the
92.Ar mode
93specified.
94.It
95.Dv V_ASN1_UTCTIME
96if the string parsed as a valid UTC time.
97.It
98.Dv V_ASN1_GENERALIZEDTIME
99if the string parsed as a valid Generalized time.
100.El
101.Pp
102.Fn ASN1_time_tm_cmp
103returns
104.Bl -bullet -offset four
105.It
106-1 if
107.Ar tm1
108is less than
109.Ar tm2 .
110.It
1111 if
112.Ar tm1
113is greater than
114.Ar tm2 .
115.It
1160 if
117.Ar tm1
118is the same as
119.Ar tm2 .
120.El
121.Pp
122.Fn ASN1_TIME_set_tm
123returns a pointer to an
124.Vt ASN1_TIME
125structure or
126.Dv NULL
127if an error occurred.
128.Sh SEE ALSO
129.Xr ASN1_TIME_new 3 ,
130.Xr ASN1_TIME_set 3 ,
131.Xr X509_cmp_time 3
132.Sh HISTORY
133.Fn ASN1_time_parse
134and
135.Fn ASN1_time_tm_cmp
136first appeared in
137.Ox 6.1
138and
139.Fn ASN1_TIME_set_tm
140in
141.Ox 6.2 .
diff --git a/src/lib/libcrypto/man/Makefile b/src/lib/libcrypto/man/Makefile
index 565f583127..1eec56fd0e 100644
--- a/src/lib/libcrypto/man/Makefile
+++ b/src/lib/libcrypto/man/Makefile
@@ -1,4 +1,4 @@
1# $OpenBSD: Makefile,v 1.284 2024/03/05 17:21:40 tb Exp $ 1# $OpenBSD: Makefile,v 1.285 2024/03/05 18:30:40 tb Exp $
2 2
3.include <bsd.own.mk> 3.include <bsd.own.mk>
4 4
@@ -29,7 +29,6 @@ MAN= \
29 ASN1_mbstring_copy.3 \ 29 ASN1_mbstring_copy.3 \
30 ASN1_parse_dump.3 \ 30 ASN1_parse_dump.3 \
31 ASN1_put_object.3 \ 31 ASN1_put_object.3 \
32 ASN1_time_parse.3 \
33 ASRange_new.3 \ 32 ASRange_new.3 \
34 AUTHORITY_KEYID_new.3 \ 33 AUTHORITY_KEYID_new.3 \
35 BASIC_CONSTRAINTS_new.3 \ 34 BASIC_CONSTRAINTS_new.3 \
diff --git a/src/lib/libcrypto/man/X509_cmp_time.3 b/src/lib/libcrypto/man/X509_cmp_time.3
index 0f2afdad02..bb430dfbb7 100644
--- a/src/lib/libcrypto/man/X509_cmp_time.3
+++ b/src/lib/libcrypto/man/X509_cmp_time.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: X509_cmp_time.3,v 1.11 2021/11/12 14:34:57 schwarze Exp $ 1.\" $OpenBSD: X509_cmp_time.3,v 1.12 2024/03/05 18:30:40 tb Exp $
2.\" full merge up to: OpenSSL 83cf7abf May 29 13:07:08 2018 +0100 2.\" full merge up to: OpenSSL 83cf7abf May 29 13:07:08 2018 +0100
3.\" 3.\"
4.\" This file is a derived work. 4.\" This file is a derived work.
@@ -65,7 +65,7 @@
65.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 65.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
66.\" OF THE POSSIBILITY OF SUCH DAMAGE. 66.\" OF THE POSSIBILITY OF SUCH DAMAGE.
67.\" 67.\"
68.Dd $Mdocdate: November 12 2021 $ 68.Dd $Mdocdate: March 5 2024 $
69.Dt X509_CMP_TIME 3 69.Dt X509_CMP_TIME 3
70.Os 70.Os
71.Sh NAME 71.Sh NAME
@@ -108,8 +108,6 @@
108.Fn X509_cmp_time 108.Fn X509_cmp_time
109parses 109parses
110.Fa asn1_time 110.Fa asn1_time
111with
112.Xr ASN1_time_parse 3
113and compares it to 111and compares it to
114.Fa cmp_time , 112.Fa cmp_time ,
115or to the current time if 113or to the current time if
@@ -182,7 +180,6 @@ structure or
182on error. 180on error.
183.Sh SEE ALSO 181.Sh SEE ALSO
184.Xr ASN1_TIME_new 3 , 182.Xr ASN1_TIME_new 3 ,
185.Xr ASN1_time_parse 3 ,
186.Xr ASN1_TIME_set 3 , 183.Xr ASN1_TIME_set 3 ,
187.Xr time 3 184.Xr time 3
188.Sh HISTORY 185.Sh HISTORY
diff --git a/src/lib/libcrypto/man/X509_get0_notBefore.3 b/src/lib/libcrypto/man/X509_get0_notBefore.3
index 53b18d5991..5e5c08b79a 100644
--- a/src/lib/libcrypto/man/X509_get0_notBefore.3
+++ b/src/lib/libcrypto/man/X509_get0_notBefore.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: X509_get0_notBefore.3,v 1.6 2023/06/06 16:20:13 schwarze Exp $ 1.\" $OpenBSD: X509_get0_notBefore.3,v 1.7 2024/03/05 18:30:40 tb Exp $
2.\" content checked up to: OpenSSL 27b138e9 May 19 00:16:38 2017 +0000 2.\" content checked up to: OpenSSL 27b138e9 May 19 00:16:38 2017 +0000
3.\" 3.\"
4.\" Copyright (c) 2018, 2020 Ingo Schwarze <schwarze@openbsd.org> 4.\" Copyright (c) 2018, 2020 Ingo Schwarze <schwarze@openbsd.org>
@@ -15,7 +15,7 @@
15.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 15.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
16.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 16.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17.\" 17.\"
18.Dd $Mdocdate: June 6 2023 $ 18.Dd $Mdocdate: March 5 2024 $
19.Dt X509_GET0_NOTBEFORE 3 19.Dt X509_GET0_NOTBEFORE 3
20.Os 20.Os
21.Sh NAME 21.Sh NAME
@@ -230,7 +230,6 @@ determining reasons for failure with
230.Xr ERR_get_error 3 . 230.Xr ERR_get_error 3 .
231.Sh SEE ALSO 231.Sh SEE ALSO
232.Xr ASN1_TIME_set 3 , 232.Xr ASN1_TIME_set 3 ,
233.Xr ASN1_TIME_set_tm 3 ,
234.Xr X509_cmp_time 3 , 233.Xr X509_cmp_time 3 ,
235.Xr X509_CRL_get0_by_serial 3 , 234.Xr X509_CRL_get0_by_serial 3 ,
236.Xr X509_CRL_new 3 , 235.Xr X509_CRL_new 3 ,