1 files changed, 159 insertions, 0 deletions
diff --git a/src/lib/libcrypto/man/d2i_DSAPublicKey.3 b/src/lib/libcrypto/man/d2i_DSAPublicKey.3
new file mode 100644
index 0000000000..aff5d0f814
--- /dev/null
+++ b/src/lib/libcrypto/man/d2i_DSAPublicKey.3
@@ -0,0 +1,159 @@
+.Dd $Mdocdate: November 5 2016 $
+.Dt D2I_DSAPUBLICKEY 3
+.Os
+.Sh NAME
+.Nm d2i_DSAPublicKey ,
+.Nm i2d_DSAPublicKey ,
+.Nm d2i_DSAPrivateKey ,
+.Nm i2d_DSAPrivateKey ,
+.Nm d2i_DSA_PUBKEY ,
+.Nm i2d_DSA_PUBKEY ,
+.Nm d2i_DSAparams ,
+.Nm i2d_DSAparams ,
+.Nm d2i_DSA_SIG ,
+.Nm i2d_DSA_SIG
+.Nd DSA key encoding and parsing functions
+.Sh SYNOPSIS
+.In openssl/dsa.h
+.In openssl/x509.h
+.Ft DSA *
+.Fo d2i_DSAPublicKey
+.Fa "DSA **a"
+.Fa "const unsigned char **pp"
+.Fa "long length"
+.Fc
+.Ft int
+.Fo i2d_DSAPublicKey
+.Fa "const DSA *a"
+.Fa "unsigned char **pp"
+.Fc
+.Ft DSA *
+.Fo d2i_DSA_PUBKEY
+.Fa "DSA **a"
+.Fa "const unsigned char **pp"
+.Fa "long length"
+.Fc
+.Ft int
+.Fo i2d_DSA_PUBKEY
+.Fa "const DSA *a"
+.Fa "unsigned char **pp"
+.Fc
+.Ft DSA *
+.Fo d2i_DSAPrivateKey
+.Fa "DSA **a"
+.Fa "const unsigned char **pp"
+.Fa "long length"
+.Fc
+.Ft int
+.Fo i2d_DSAPrivateKey
+.Fa "const DSA *a"
+.Fa "unsigned char **pp"
+.Fc
+.Ft DSA *
+.Fo d2i_DSAparams
+.Fa "DSA **a"
+.Fa "const unsigned char **pp"
+.Fa "long length"
+.Fc
+.Ft int
+.Fo i2d_DSAparams
+.Fa "const DSA *a"
+.Fa "unsigned char **pp"
+.Fc
+.Ft DSA *
+.Fo d2i_DSA_SIG
+.Fa "DSA_SIG **a"
+.Fa "const unsigned char **pp"
+.Fa "long length"
+.Fc
+.Ft int
+.Fo i2d_DSA_SIG
+.Fa "const DSA_SIG *a"
+.Fa "unsigned char **pp"
+.Fc
+.Sh DESCRIPTION
+.Fn d2i_DSAPublicKey
+and
+.Fn i2d_DSAPublicKey
+decode and encode the DSA public key components structure.
+.Pp
+.Fn d2i_DSA_PUBKEY
+and
+.Fn i2d_DSA_PUBKEY
+decode and encode a DSA public key using a SubjectPublicKeyInfo
+(certificate public key) structure.
+.Pp
+.Fn d2i_DSAPrivateKey
+and
+.Fn i2d_DSAPrivateKey
+decode and encode the DSA private key components.
+.Pp
+.Fn d2i_DSAparams
+and
+.Fn i2d_DSAparams
+decode and encode the DSA parameters using a
+.Sy Dss-Parms
+structure as defined in RFC2459.
+.Pp
+.Fn d2i_DSA_SIG
+and
+.Fn i2d_DSA_SIG
+decode and encode a DSA signature using a
+.Sy Dss-Sig-Value
+structure as defined in RFC2459.
+.Pp
+The usage of all of these functions is similar to
+.Xr d2i_X509 3
+and
+.Xr i2d_X509 3 .
+.Pp
+The
+.Vt DSA
+structure passed to the private key encoding functions should have all
+the private key components present.
+.Pp
+The data encoded by the private key functions is unencrypted and
+therefore offers no private key security.
+.Pp
+The
+.Fn *_DSA_PUBKEY
+functions should be used in preference to the
+.Fn *_DSAPublicKey
+functions when encoding public keys because they use a standard format.
+.Pp
+The
+.Fn *_DSAPublicKey
+functions use an non-standard format.
+The actual data encoded depends on the value of
+.Fa a->write_params .
+If
+.Fa a->write_params
+is zero, then only the
+.Fa a->pub_key
+field is encoded as an
+.Sy INTEGER .
+If
+.Fa a->write_params
+is 1, then a
+.Sy SEQUENCE
+consisting of the
+.Fa a->p ,
+.Fa a->q ,
+.Fa a->g ,
+and
+.Fa a->pub_key
+fields is encoded.
+.Pp
+The
+.Fn *_DSAPrivateKey
+functions also use a non-standard structure consisting consisting of a
+SEQUENCE containing the
+.Fa a->p ,
+.Fa a->q ,
+.Fa a->g ,
+.Fa a->pub_key ,
+and
+.Fa a->priv_key
+fields.
+.Sh SEE ALSO
+.Xr d2i_X509 3

diff --git a/src/lib/libcrypto/man/d2i_DSAPublicKey.3 b/src/lib/libcrypto/man/d2i_DSAPublicKey.3 new file mode 100644 index 0000000000..aff5d0f814 --- /dev/null +++ b/src/lib/libcrypto/man/d2i_DSAPublicKey.3
@@ -0,0 +1,159 @@
	1	.Dd $Mdocdate: November 5 2016 $
	2	.Dt D2I_DSAPUBLICKEY 3
	3	.Os
	4	.Sh NAME
	5	.Nm d2i_DSAPublicKey ,
	6	.Nm i2d_DSAPublicKey ,
	7	.Nm d2i_DSAPrivateKey ,
	8	.Nm i2d_DSAPrivateKey ,
	9	.Nm d2i_DSA_PUBKEY ,
	10	.Nm i2d_DSA_PUBKEY ,
	11	.Nm d2i_DSAparams ,
	12	.Nm i2d_DSAparams ,
	13	.Nm d2i_DSA_SIG ,
	14	.Nm i2d_DSA_SIG
	15	.Nd DSA key encoding and parsing functions
	16	.Sh SYNOPSIS
	17	.In openssl/dsa.h
	18	.In openssl/x509.h
	19	.Ft DSA *
	20	.Fo d2i_DSAPublicKey
	21	.Fa "DSA **a"
	22	.Fa "const unsigned char **pp"
	23	.Fa "long length"
	24	.Fc
	25	.Ft int
	26	.Fo i2d_DSAPublicKey
	27	.Fa "const DSA *a"
	28	.Fa "unsigned char **pp"
	29	.Fc
	30	.Ft DSA *
	31	.Fo d2i_DSA_PUBKEY
	32	.Fa "DSA **a"
	33	.Fa "const unsigned char **pp"
	34	.Fa "long length"
	35	.Fc
	36	.Ft int
	37	.Fo i2d_DSA_PUBKEY
	38	.Fa "const DSA *a"
	39	.Fa "unsigned char **pp"
	40	.Fc
	41	.Ft DSA *
	42	.Fo d2i_DSAPrivateKey
	43	.Fa "DSA **a"
	44	.Fa "const unsigned char **pp"
	45	.Fa "long length"
	46	.Fc
	47	.Ft int
	48	.Fo i2d_DSAPrivateKey
	49	.Fa "const DSA *a"
	50	.Fa "unsigned char **pp"
	51	.Fc
	52	.Ft DSA *
	53	.Fo d2i_DSAparams
	54	.Fa "DSA **a"
	55	.Fa "const unsigned char **pp"
	56	.Fa "long length"
	57	.Fc
	58	.Ft int
	59	.Fo i2d_DSAparams
	60	.Fa "const DSA *a"
	61	.Fa "unsigned char **pp"
	62	.Fc
	63	.Ft DSA *
	64	.Fo d2i_DSA_SIG
	65	.Fa "DSA_SIG **a"
	66	.Fa "const unsigned char **pp"
	67	.Fa "long length"
	68	.Fc
	69	.Ft int
	70	.Fo i2d_DSA_SIG
	71	.Fa "const DSA_SIG *a"
	72	.Fa "unsigned char **pp"
	73	.Fc
	74	.Sh DESCRIPTION
	75	.Fn d2i_DSAPublicKey
	76	and
	77	.Fn i2d_DSAPublicKey
	78	decode and encode the DSA public key components structure.
	79	.Pp
	80	.Fn d2i_DSA_PUBKEY
	81	and
	82	.Fn i2d_DSA_PUBKEY
	83	decode and encode a DSA public key using a SubjectPublicKeyInfo
	84	(certificate public key) structure.
	85	.Pp
	86	.Fn d2i_DSAPrivateKey
	87	and
	88	.Fn i2d_DSAPrivateKey
	89	decode and encode the DSA private key components.
	90	.Pp
	91	.Fn d2i_DSAparams
	92	and
	93	.Fn i2d_DSAparams
	94	decode and encode the DSA parameters using a
	95	.Sy Dss-Parms
	96	structure as defined in RFC2459.
	97	.Pp
	98	.Fn d2i_DSA_SIG
	99	and
	100	.Fn i2d_DSA_SIG
	101	decode and encode a DSA signature using a
	102	.Sy Dss-Sig-Value
	103	structure as defined in RFC2459.
	104	.Pp
	105	The usage of all of these functions is similar to
	106	.Xr d2i_X509 3
	107	and
	108	.Xr i2d_X509 3 .
	109	.Pp
	110	The
	111	.Vt DSA
	112	structure passed to the private key encoding functions should have all
	113	the private key components present.
	114	.Pp
	115	The data encoded by the private key functions is unencrypted and
	116	therefore offers no private key security.
	117	.Pp
	118	The
	119	.Fn *_DSA_PUBKEY
	120	functions should be used in preference to the
	121	.Fn *_DSAPublicKey
	122	functions when encoding public keys because they use a standard format.
	123	.Pp
	124	The
	125	.Fn *_DSAPublicKey
	126	functions use an non-standard format.
	127	The actual data encoded depends on the value of
	128	.Fa a->write_params .
	129	If
	130	.Fa a->write_params
	131	is zero, then only the
	132	.Fa a->pub_key
	133	field is encoded as an
	134	.Sy INTEGER .
	135	If
	136	.Fa a->write_params
	137	is 1, then a
	138	.Sy SEQUENCE
	139	consisting of the
	140	.Fa a->p ,
	141	.Fa a->q ,
	142	.Fa a->g ,
	143	and
	144	.Fa a->pub_key
	145	fields is encoded.
	146	.Pp
	147	The
	148	.Fn *_DSAPrivateKey
	149	functions also use a non-standard structure consisting consisting of a
	150	SEQUENCE containing the
	151	.Fa a->p ,
	152	.Fa a->q ,
	153	.Fa a->g ,
	154	.Fa a->pub_key ,
	155	and
	156	.Fa a->priv_key
	157	fields.
	158	.Sh SEE ALSO
	159	.Xr d2i_X509 3