diff options
Diffstat (limited to 'src/lib/libssl/man')
| -rw-r--r-- | src/lib/libssl/man/SSL_CTX_set_default_passwd_cb.3 | 40 |
1 files changed, 34 insertions, 6 deletions
diff --git a/src/lib/libssl/man/SSL_CTX_set_default_passwd_cb.3 b/src/lib/libssl/man/SSL_CTX_set_default_passwd_cb.3 index 9f5907b32f..7ab9633f5c 100644 --- a/src/lib/libssl/man/SSL_CTX_set_default_passwd_cb.3 +++ b/src/lib/libssl/man/SSL_CTX_set_default_passwd_cb.3 | |||
| @@ -1,8 +1,10 @@ | |||
| 1 | .\" $OpenBSD: SSL_CTX_set_default_passwd_cb.3,v 1.6 2018/03/27 17:35:50 schwarze Exp $ | 1 | .\" $OpenBSD: SSL_CTX_set_default_passwd_cb.3,v 1.7 2018/04/02 02:06:14 schwarze Exp $ |
| 2 | .\" OpenSSL 9b86974e Aug 17 15:21:33 2015 -0400 | 2 | .\" full merge up to: OpenSSL 9b86974e Aug 17 15:21:33 2015 -0400 |
| 3 | .\" selective merge up to: OpenSSL 2947af32 Nov 19 00:10:05 2016 +0100 | ||
| 3 | .\" | 4 | .\" |
| 4 | .\" This file was written by Lutz Jaenicke <jaenicke@openssl.org>. | 5 | .\" This file was written by Lutz Jaenicke <jaenicke@openssl.org> |
| 5 | .\" Copyright (c) 2000, 2001 The OpenSSL Project. All rights reserved. | 6 | .\" and Christian Heimes <cheimes@redhat.com>. |
| 7 | .\" Copyright (c) 2000, 2001, 2016 The OpenSSL Project. All rights reserved. | ||
| 6 | .\" | 8 | .\" |
| 7 | .\" Redistribution and use in source and binary forms, with or without | 9 | .\" Redistribution and use in source and binary forms, with or without |
| 8 | .\" modification, are permitted provided that the following conditions | 10 | .\" modification, are permitted provided that the following conditions |
| @@ -48,20 +50,26 @@ | |||
| 48 | .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED | 50 | .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED |
| 49 | .\" OF THE POSSIBILITY OF SUCH DAMAGE. | 51 | .\" OF THE POSSIBILITY OF SUCH DAMAGE. |
| 50 | .\" | 52 | .\" |
| 51 | .Dd $Mdocdate: March 27 2018 $ | 53 | .Dd $Mdocdate: April 2 2018 $ |
| 52 | .Dt SSL_CTX_SET_DEFAULT_PASSWD_CB 3 | 54 | .Dt SSL_CTX_SET_DEFAULT_PASSWD_CB 3 |
| 53 | .Os | 55 | .Os |
| 54 | .Sh NAME | 56 | .Sh NAME |
| 55 | .Nm SSL_CTX_set_default_passwd_cb , | 57 | .Nm SSL_CTX_set_default_passwd_cb , |
| 56 | .Nm SSL_CTX_set_default_passwd_cb_userdata , | 58 | .Nm SSL_CTX_set_default_passwd_cb_userdata , |
| 59 | .Nm SSL_CTX_get_default_passwd_cb , | ||
| 60 | .Nm SSL_CTX_get_default_passwd_cb_userdata , | ||
| 57 | .Nm pem_password_cb | 61 | .Nm pem_password_cb |
| 58 | .Nd set passwd callback for encrypted PEM file handling | 62 | .Nd set or get passwd callback for encrypted PEM file handling |
| 59 | .Sh SYNOPSIS | 63 | .Sh SYNOPSIS |
| 60 | .In openssl/ssl.h | 64 | .In openssl/ssl.h |
| 61 | .Ft void | 65 | .Ft void |
| 62 | .Fn SSL_CTX_set_default_passwd_cb "SSL_CTX *ctx" "pem_password_cb *cb" | 66 | .Fn SSL_CTX_set_default_passwd_cb "SSL_CTX *ctx" "pem_password_cb *cb" |
| 63 | .Ft void | 67 | .Ft void |
| 64 | .Fn SSL_CTX_set_default_passwd_cb_userdata "SSL_CTX *ctx" "void *u" | 68 | .Fn SSL_CTX_set_default_passwd_cb_userdata "SSL_CTX *ctx" "void *u" |
| 69 | .Ft pem_password_cb * | ||
| 70 | .Fn SSL_CTX_get_default_passwd_cb "SSL_CTX *ctx" | ||
| 71 | .Ft void * | ||
| 72 | .Fn SSL_CTX_get_default_passwd_cb_userdata "SSL_CTX *ctx" | ||
| 65 | .In openssl/pem.h | 73 | .In openssl/pem.h |
| 66 | .Ft typedef int | 74 | .Ft typedef int |
| 67 | .Fn pem_password_cb "char *buf" "int size" "int rwflag" "void *userdata" | 75 | .Fn pem_password_cb "char *buf" "int size" "int rwflag" "void *userdata" |
| @@ -114,6 +122,20 @@ comparison in order to catch typos which would make decryption impossible. | |||
| 114 | .Pp | 122 | .Pp |
| 115 | Other items in PEM formatting (certificates) can also be encrypted; it is | 123 | Other items in PEM formatting (certificates) can also be encrypted; it is |
| 116 | however atypical, as certificate information is considered public. | 124 | however atypical, as certificate information is considered public. |
| 125 | .Sh RETURN VALUES | ||
| 126 | .Fn SSL_CTX_get_default_passwd_cb | ||
| 127 | returns a function pointer to the password callback currently set in | ||
| 128 | .Fa ctx , | ||
| 129 | or | ||
| 130 | .Dv NULL | ||
| 131 | if none is set. | ||
| 132 | .Pp | ||
| 133 | .Fn SSL_CTX_get_default_passwd_cb_userdata | ||
| 134 | returns a pointer to the userdata currently set in | ||
| 135 | .Fa ctx , | ||
| 136 | or | ||
| 137 | .Dv NULL | ||
| 138 | if none is set. | ||
| 117 | .Sh EXAMPLES | 139 | .Sh EXAMPLES |
| 118 | The following example returns the password provided as | 140 | The following example returns the password provided as |
| 119 | .Fa userdata | 141 | .Fa userdata |
| @@ -141,3 +163,9 @@ first appeared in SSLeay 0.6.2 and has been available since | |||
| 141 | .Fn SSL_CTX_set_default_passwd_cb_userdata | 163 | .Fn SSL_CTX_set_default_passwd_cb_userdata |
| 142 | first appeared in OpenSSL 0.9.4 and has been available since | 164 | first appeared in OpenSSL 0.9.4 and has been available since |
| 143 | .Ox 2.6 . | 165 | .Ox 2.6 . |
| 166 | .Pp | ||
| 167 | .Fn SSL_CTX_get_default_passwd_cb | ||
| 168 | and | ||
| 169 | .Fn SSL_CTX_get_default_passwd_cb_userdata | ||
| 170 | first appeared in OpenSSL 1.1.0 and have been available since | ||
| 171 | .Ox 6.3 . | ||
