|
| 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