Skip to content

Commit 1df1699

Browse files
author
schwarze
committed
new manual page X509_ocspid_print(3)
using input from tb@, and OK tb@ on an earlier version
1 parent 22fd10c commit 1df1699

File tree

3 files changed

+66
-6
lines changed

3 files changed

+66
-6
lines changed

src/lib/libcrypto/man/OCSP_REQUEST_new.3

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
.\" $OpenBSD: OCSP_REQUEST_new.3,v 1.10 2019/06/10 09:49:48 schwarze Exp $
1+
.\" $OpenBSD: OCSP_REQUEST_new.3,v 1.11 2021/08/06 21:45:55 schwarze Exp $
22
.\" OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100
33
.\"
44
.\" This file is a derived work.
@@ -65,7 +65,7 @@
6565
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
6666
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
6767
.\"
68-
.Dd $Mdocdate: June 10 2019 $
68+
.Dd $Mdocdate: August 6 2021 $
6969
.Dt OCSP_REQUEST_NEW 3
7070
.Os
7171
.Sh NAME
@@ -318,7 +318,8 @@ OCSP_REQUEST_free(req);
318318
.Xr OCSP_resp_find_status 3 ,
319319
.Xr OCSP_response_status 3 ,
320320
.Xr OCSP_sendreq_new 3 ,
321-
.Xr OCSP_SERVICELOC_new 3
321+
.Xr OCSP_SERVICELOC_new 3 ,
322+
.Xr X509_ocspid_print 3
322323
.Sh STANDARDS
323324
RFC 6960: X.509 Internet Public Key Infrastructure Online Certificate
324325
Status Protocol, section 4.1: Request Syntax

src/lib/libcrypto/man/OCSP_cert_to_id.3

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
.\" $OpenBSD: OCSP_cert_to_id.3,v 1.10 2019/06/06 01:06:58 schwarze Exp $
1+
.\" $OpenBSD: OCSP_cert_to_id.3,v 1.11 2021/08/06 21:45:55 schwarze Exp $
22
.\" OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100
33
.\"
44
.\" This file is a derived work.
@@ -65,7 +65,7 @@
6565
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
6666
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
6767
.\"
68-
.Dd $Mdocdate: June 6 2019 $
68+
.Dd $Mdocdate: August 6 2021 $
6969
.Dt OCSP_CERT_TO_ID 3
7070
.Os
7171
.Sh NAME
@@ -221,7 +221,8 @@ returns 1 for success or 0 for failure.
221221
.Xr OCSP_response_status 3 ,
222222
.Xr OCSP_sendreq_new 3 ,
223223
.Xr X509_get_issuer_name 3 ,
224-
.Xr X509_NAME_new 3
224+
.Xr X509_NAME_new 3 ,
225+
.Xr X509_ocspid_print 3
225226
.Sh STANDARDS
226227
RFC 6960: X.509 Internet Public Key Infrastructure Online Certificate
227228
Status Protocol, section 4: Details of the Protocol
Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
.\" $OpenBSD: X509_ocspid_print.3,v 1.1 2021/08/06 21:45:55 schwarze Exp $
2+
.\"
3+
.\" Copyright (c) 2021 Ingo Schwarze <schwarze@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: August 6 2021 $
18+
.Dt X509_OCSPID_PRINT 3
19+
.Os
20+
.Sh NAME
21+
.Nm X509_ocspid_print
22+
.Nd pretty-print hashes of subject name and public key
23+
.Sh SYNOPSIS
24+
.In openssl/x509.h
25+
.Ft int
26+
.Fo X509_ocspid_print
27+
.Fa "BIO *bio"
28+
.Fa "X509 *issuer"
29+
.Fc
30+
.Sh DESCRIPTION
31+
.Fn X509_ocspid_print
32+
produces human-readable output to
33+
.Fa bio
34+
containing hexadecimal representations of SHA-1 hashes of the
35+
DER-encoded forms of the subject name and the public key of the
36+
.Fa issuer
37+
certificate, as these hashes appear in OCSP requests.
38+
.Sh RETURN VALUES
39+
.Fn X509_ocspid_print
40+
returns 1 for success or 0 for failure.
41+
.Sh EXAMPLES
42+
This function is used by the
43+
.Fl ocspid
44+
flag of the
45+
.Xr openssl 1
46+
.Cm x509
47+
command.
48+
.Sh SEE ALSO
49+
.Xr EVP_sha1 3 ,
50+
.Xr i2d_X509_NAME 3 ,
51+
.Xr OCSP_cert_to_id 3 ,
52+
.Xr OCSP_REQUEST_new 3 ,
53+
.Xr X509_get_pubkey 3 ,
54+
.Xr X509_get_subject_name 3
55+
.Sh HISTORY
56+
.Fn X509_ocspid_print
57+
first appeared in OpenSSL 0.9.7 and has been available since
58+
.Ox 3.2 .

0 commit comments

Comments
 (0)