2 files changed, 61 insertions, 1 deletions
diff --git a/src/lib/libssl/man/Makefile b/src/lib/libssl/man/Makefile
index ee742bc720..5fe28e4dc6 100644
--- a/src/lib/libssl/man/Makefile
+++ b/src/lib/libssl/man/Makefile
@@ -1,4 +1,4 @@
-# $OpenBSD: Makefile,v 1.47 2016/12/07 15:14:34 schwarze Exp $
+# $OpenBSD: Makefile,v 1.48 2016/12/07 17:09:07 schwarze Exp $
 .include <bsd.own.mk>
@@ -55,6 +55,7 @@ MAN =	BIO_f_ssl.3 \
        SSL_clear.3 \
        SSL_connect.3 \
        SSL_do_handshake.3 \
+        SSL_dup.3 \
        SSL_dup_CA_list.3 \
        SSL_free.3 \
        SSL_get_SSL_CTX.3 \
diff --git a/src/lib/libssl/man/SSL_dup.3 b/src/lib/libssl/man/SSL_dup.3
new file mode 100644
index 0000000000..47ec2e3976
--- /dev/null
+++ b/src/lib/libssl/man/SSL_dup.3
@@ -0,0 +1,59 @@
+.\"     $OpenBSD: SSL_dup.3,v 1.1 2016/12/07 17:09:07 schwarze Exp $
+.\"
+.\" Copyright (c) 2016 Ingo Schwarze <schwarze@openbsd.org>
+.\"
+.\" Permission to use, copy, modify, and distribute this software for any
+.\" purpose with or without fee is hereby granted, provided that the above
+.\" copyright notice and this permission notice appear in all copies.
+.\"
+.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+.\"
+.Dd $Mdocdate: December 7 2016 $
+.Dt SSL_DUP 3
+.Os
+.Sh NAME
+.Nm SSL_dup
+.Nd deep copy of an SSL object
+.Sh SYNOPSIS
+.In openssl/ssl.h
+.Ft SSL *
+.Fo SSL_dup
+.Fa "SSL *ssl"
+.Fc
+.Sh DESCRIPTION
+.Fn SSL_dup
+constructs a new
+.Vt SSL
+object in the same context as
+.Fa ssl
+and copies much of the contained data from
+.Fa ssl
+to the new
+.Vt SSL
+object, but many fields, for example tlsext data, are not copied.
+.Pp
+As an exception from deep copying, if a session is already established,
+the new object shares
+.Fa ssl->cert
+with the original object.
+.Sh RETURN VALUES
+.Fn SSL_dup
+returns the new
+.Vt SSL
+object or
+.Dv NULL
+on failure.
+.Sh SEE ALSO
+.Xr SSL_clear 3 ,
+.Xr SSL_copy_session_id 3 ,
+.Xr SSL_free 3 ,
+.Xr SSL_new 3
+.Sh HISTORY
+.Fn SSL_dup
+is available in all versions of OpenSSL.

diff --git a/src/lib/libssl/man/Makefile b/src/lib/libssl/man/Makefile index ee742bc720..5fe28e4dc6 100644 --- a/src/lib/libssl/man/Makefile +++ b/src/lib/libssl/man/Makefile
@@ -1,4 +1,4 @@
1	# $OpenBSD: Makefile,v 1.47 2016/12/07 15:14:34 schwarze Exp $	1	# $OpenBSD: Makefile,v 1.48 2016/12/07 17:09:07 schwarze Exp $
2		2
3	.include <bsd.own.mk>	3	.include <bsd.own.mk>
4		4
@@ -55,6 +55,7 @@ MAN = BIO_f_ssl.3 \
55	SSL_clear.3 \	55	SSL_clear.3 \
56	SSL_connect.3 \	56	SSL_connect.3 \
57	SSL_do_handshake.3 \	57	SSL_do_handshake.3 \
		58	SSL_dup.3 \
58	SSL_dup_CA_list.3 \	59	SSL_dup_CA_list.3 \
59	SSL_free.3 \	60	SSL_free.3 \
60	SSL_get_SSL_CTX.3 \	61	SSL_get_SSL_CTX.3 \


diff --git a/src/lib/libssl/man/SSL_dup.3 b/src/lib/libssl/man/SSL_dup.3 new file mode 100644 index 0000000000..47ec2e3976 --- /dev/null +++ b/src/lib/libssl/man/SSL_dup.3
@@ -0,0 +1,59 @@
		1	.\" $OpenBSD: SSL_dup.3,v 1.1 2016/12/07 17:09:07 schwarze Exp $
		2	.\"
		3	.\" Copyright (c) 2016 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: December 7 2016 $
		18	.Dt SSL_DUP 3
		19	.Os
		20	.Sh NAME
		21	.Nm SSL_dup
		22	.Nd deep copy of an SSL object
		23	.Sh SYNOPSIS
		24	.In openssl/ssl.h
		25	.Ft SSL *
		26	.Fo SSL_dup
		27	.Fa "SSL *ssl"
		28	.Fc
		29	.Sh DESCRIPTION
		30	.Fn SSL_dup
		31	constructs a new
		32	.Vt SSL
		33	object in the same context as
		34	.Fa ssl
		35	and copies much of the contained data from
		36	.Fa ssl
		37	to the new
		38	.Vt SSL
		39	object, but many fields, for example tlsext data, are not copied.
		40	.Pp
		41	As an exception from deep copying, if a session is already established,
		42	the new object shares
		43	.Fa ssl->cert
		44	with the original object.
		45	.Sh RETURN VALUES
		46	.Fn SSL_dup
		47	returns the new
		48	.Vt SSL
		49	object or
		50	.Dv NULL
		51	on failure.
		52	.Sh SEE ALSO
		53	.Xr SSL_clear 3 ,
		54	.Xr SSL_copy_session_id 3 ,
		55	.Xr SSL_free 3 ,
		56	.Xr SSL_new 3
		57	.Sh HISTORY
		58	.Fn SSL_dup
		59	is available in all versions of OpenSSL.