summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--src/lib/libssl/man/SSL_CTX_set_default_passwd_cb.340
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
115Other items in PEM formatting (certificates) can also be encrypted; it is 123Other items in PEM formatting (certificates) can also be encrypted; it is
116however atypical, as certificate information is considered public. 124however atypical, as certificate information is considered public.
125.Sh RETURN VALUES
126.Fn SSL_CTX_get_default_passwd_cb
127returns a function pointer to the password callback currently set in
128.Fa ctx ,
129or
130.Dv NULL
131if none is set.
132.Pp
133.Fn SSL_CTX_get_default_passwd_cb_userdata
134returns a pointer to the userdata currently set in
135.Fa ctx ,
136or
137.Dv NULL
138if none is set.
117.Sh EXAMPLES 139.Sh EXAMPLES
118The following example returns the password provided as 140The 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
142first appeared in OpenSSL 0.9.4 and has been available since 164first 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
168and
169.Fn SSL_CTX_get_default_passwd_cb_userdata
170first appeared in OpenSSL 1.1.0 and have been available since
171.Ox 6.3 .