Deleted Added
full compact
SSL_CTX_set_client_CA_list.3 (206048) SSL_CTX_set_client_CA_list.3 (215698)
1.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.37
1.\" Automatically generated by Pod::Man 2.22 (Pod::Simple 3.07)
2.\"
3.\" Standard preamble:
4.\" ========================================================================
2.\"
3.\" Standard preamble:
4.\" ========================================================================
5.de Sh \" Subsection heading
6.br
7.if t .Sp
8.ne 5
9.PP
10\fB\\$1\fR
11.PP
12..
13.de Sp \" Vertical space (when we can't use .PP)
14.if t .sp .5v
15.if n .sp
16..
17.de Vb \" Begin verbatim text
18.ft CW
19.nf
20.ne \\$1
21..
22.de Ve \" End verbatim text
23.ft R
24.fi
25..
26.\" Set up some character translations and predefined strings. \*(-- will
27.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
5.de Sp \" Vertical space (when we can't use .PP)
6.if t .sp .5v
7.if n .sp
8..
9.de Vb \" Begin verbatim text
10.ft CW
11.nf
12.ne \\$1
13..
14.de Ve \" End verbatim text
15.ft R
16.fi
17..
18.\" Set up some character translations and predefined strings. \*(-- will
19.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
28.\" double quote, and \*(R" will give a right double quote. | will give a
29.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to
30.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C'
31.\" expand to `' in nroff, nothing in troff, for use with C<>.
32.tr \(*W-|\(bv\*(Tr
20.\" double quote, and \*(R" will give a right double quote. \*(C+ will
21.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
22.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
23.\" nothing in troff, for use with C<>.
24.tr \(*W-
33.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
34.ie n \{\
35. ds -- \(*W-
36. ds PI pi
37. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
38. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
39. ds L" ""
40. ds R" ""
41. ds C` ""
42. ds C' ""
43'br\}
44.el\{\
45. ds -- \|\(em\|
46. ds PI \(*p
47. ds L" ``
48. ds R" ''
49'br\}
50.\"
25.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
26.ie n \{\
27. ds -- \(*W-
28. ds PI pi
29. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
30. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
31. ds L" ""
32. ds R" ""
33. ds C` ""
34. ds C' ""
35'br\}
36.el\{\
37. ds -- \|\(em\|
38. ds PI \(*p
39. ds L" ``
40. ds R" ''
41'br\}
42.\"
43.\" Escape single quotes in literal strings from groff's Unicode transform.
44.ie \n(.g .ds Aq \(aq
45.el .ds Aq '
46.\"
51.\" If the F register is turned on, we'll generate index entries on stderr for
47.\" If the F register is turned on, we'll generate index entries on stderr for
52.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
48.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
53.\" entries marked with X<> in POD. Of course, you'll have to process the
54.\" output yourself in some meaningful fashion.
49.\" entries marked with X<> in POD. Of course, you'll have to process the
50.\" output yourself in some meaningful fashion.
55.if \nF \{\
51.ie \nF \{\
56. de IX
57. tm Index:\\$1\t\\n%\t"\\$2"
58..
59. nr % 0
60. rr F
61.\}
52. de IX
53. tm Index:\\$1\t\\n%\t"\\$2"
54..
55. nr % 0
56. rr F
57.\}
58.el \{\
59. de IX
60..
61.\}
62.\"
62.\"
63.\" For nroff, turn off justification. Always turn off hyphenation; it makes
64.\" way too many mistakes in technical documents.
65.hy 0
66.if n .na
67.\"
68.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
69.\" Fear. Run. Save yourself. No user-serviceable parts.
70. \" fudge factors for nroff and troff
71.if n \{\
72. ds #H 0
73. ds #V .8m
74. ds #F .3m
75. ds #[ \f1

--- 48 unchanged lines hidden (view full) ---

124. ds Th \o'LP'
125. ds ae ae
126. ds Ae AE
127.\}
128.rm #[ #] #H #V #F C
129.\" ========================================================================
130.\"
131.IX Title "SSL_CTX_set_client_CA_list 3"
63.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
64.\" Fear. Run. Save yourself. No user-serviceable parts.
65. \" fudge factors for nroff and troff
66.if n \{\
67. ds #H 0
68. ds #V .8m
69. ds #F .3m
70. ds #[ \f1

--- 48 unchanged lines hidden (view full) ---

119. ds Th \o'LP'
120. ds ae ae
121. ds Ae AE
122.\}
123.rm #[ #] #H #V #F C
124.\" ========================================================================
125.\"
126.IX Title "SSL_CTX_set_client_CA_list 3"
132.TH SSL_CTX_set_client_CA_list 3 "2010-03-24" "0.9.8n" "OpenSSL"
127.TH SSL_CTX_set_client_CA_list 3 "2010-11-16" "0.9.8p" "OpenSSL"
128.\" For nroff, turn off justification. Always turn off hyphenation; it makes
129.\" way too many mistakes in technical documents.
130.if n .ad l
131.nh
133.SH "NAME"
134SSL_CTX_set_client_CA_list, SSL_set_client_CA_list, SSL_CTX_add_client_CA,
135SSL_add_client_CA \- set list of CAs sent to the client when requesting a
136client certificate
137.SH "SYNOPSIS"
138.IX Header "SYNOPSIS"
139.Vb 1
140\& #include <openssl/ssl.h>
132.SH "NAME"
133SSL_CTX_set_client_CA_list, SSL_set_client_CA_list, SSL_CTX_add_client_CA,
134SSL_add_client_CA \- set list of CAs sent to the client when requesting a
135client certificate
136.SH "SYNOPSIS"
137.IX Header "SYNOPSIS"
138.Vb 1
139\& #include <openssl/ssl.h>
141.Ve
142.PP
143.Vb 4
140\&
144\& void SSL_CTX_set_client_CA_list(SSL_CTX *ctx, STACK_OF(X509_NAME) *list);
145\& void SSL_set_client_CA_list(SSL *s, STACK_OF(X509_NAME) *list);
146\& int SSL_CTX_add_client_CA(SSL_CTX *ctx, X509 *cacert);
147\& int SSL_add_client_CA(SSL *ssl, X509 *cacert);
148.Ve
149.SH "DESCRIPTION"
150.IX Header "DESCRIPTION"
151\&\fISSL_CTX_set_client_CA_list()\fR sets the \fBlist\fR of CAs sent to the client when

--- 35 unchanged lines hidden (view full) ---

187These functions are only useful for \s-1TLS/SSL\s0 servers.
188.SH "RETURN VALUES"
189.IX Header "RETURN VALUES"
190\&\fISSL_CTX_set_client_CA_list()\fR and \fISSL_set_client_CA_list()\fR do not return
191diagnostic information.
192.PP
193\&\fISSL_CTX_add_client_CA()\fR and \fISSL_add_client_CA()\fR have the following return
194values:
141\& void SSL_CTX_set_client_CA_list(SSL_CTX *ctx, STACK_OF(X509_NAME) *list);
142\& void SSL_set_client_CA_list(SSL *s, STACK_OF(X509_NAME) *list);
143\& int SSL_CTX_add_client_CA(SSL_CTX *ctx, X509 *cacert);
144\& int SSL_add_client_CA(SSL *ssl, X509 *cacert);
145.Ve
146.SH "DESCRIPTION"
147.IX Header "DESCRIPTION"
148\&\fISSL_CTX_set_client_CA_list()\fR sets the \fBlist\fR of CAs sent to the client when

--- 35 unchanged lines hidden (view full) ---

184These functions are only useful for \s-1TLS/SSL\s0 servers.
185.SH "RETURN VALUES"
186.IX Header "RETURN VALUES"
187\&\fISSL_CTX_set_client_CA_list()\fR and \fISSL_set_client_CA_list()\fR do not return
188diagnostic information.
189.PP
190\&\fISSL_CTX_add_client_CA()\fR and \fISSL_add_client_CA()\fR have the following return
191values:
195.IP "1" 4
196.IX Item "1"
192.IP "1." 4
197The operation succeeded.
193The operation succeeded.
198.IP "0" 4
194.IP "2." 4
199A failure while manipulating the \s-1STACK_OF\s0(X509_NAME) object occurred or
200the X509_NAME could not be extracted from \fBcacert\fR. Check the error stack
201to find out the reason.
202.SH "EXAMPLES"
203.IX Header "EXAMPLES"
204Scan all certificates in \fBCAfile\fR and list them as acceptable CAs:
205.PP
206.Vb 1
207\& SSL_CTX_set_client_CA_list(ctx,SSL_load_client_CA_file(CAfile));
208.Ve
209.SH "SEE ALSO"
210.IX Header "SEE ALSO"
211\&\fIssl\fR\|(3),
212\&\fISSL_get_client_CA_list\fR\|(3),
213\&\fISSL_load_client_CA_file\fR\|(3),
214\&\fISSL_CTX_load_verify_locations\fR\|(3)
195A failure while manipulating the \s-1STACK_OF\s0(X509_NAME) object occurred or
196the X509_NAME could not be extracted from \fBcacert\fR. Check the error stack
197to find out the reason.
198.SH "EXAMPLES"
199.IX Header "EXAMPLES"
200Scan all certificates in \fBCAfile\fR and list them as acceptable CAs:
201.PP
202.Vb 1
203\& SSL_CTX_set_client_CA_list(ctx,SSL_load_client_CA_file(CAfile));
204.Ve
205.SH "SEE ALSO"
206.IX Header "SEE ALSO"
207\&\fIssl\fR\|(3),
208\&\fISSL_get_client_CA_list\fR\|(3),
209\&\fISSL_load_client_CA_file\fR\|(3),
210\&\fISSL_CTX_load_verify_locations\fR\|(3)
211.SH "POD ERRORS"
212.IX Header "POD ERRORS"
213Hey! \fBThe above document had some coding errors, which are explained below:\fR
214.IP "Around line 73:" 4
215.IX Item "Around line 73:"
216You have '=item 0' instead of the expected '=item 2'