Deleted Added
full compact
DH_set_method.3 (206048) DH_set_method.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 "DH_set_method 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 "DH_set_method 3"
132.TH DH_set_method 3 "2010-03-24" "0.9.8n" "OpenSSL"
127.TH DH_set_method 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"
134DH_set_default_method, DH_get_default_method,
135DH_set_method, DH_new_method, DH_OpenSSL \- select DH method
136.SH "SYNOPSIS"
137.IX Header "SYNOPSIS"
138.Vb 2
139\& #include <openssl/dh.h>
140\& #include <openssl/engine.h>
132.SH "NAME"
133DH_set_default_method, DH_get_default_method,
134DH_set_method, DH_new_method, DH_OpenSSL \- select DH method
135.SH "SYNOPSIS"
136.IX Header "SYNOPSIS"
137.Vb 2
138\& #include <openssl/dh.h>
139\& #include <openssl/engine.h>
141.Ve
142.PP
143.Vb 1
140\&
144\& void DH_set_default_method(const DH_METHOD *meth);
141\& void DH_set_default_method(const DH_METHOD *meth);
145.Ve
146.PP
147.Vb 1
142\&
148\& const DH_METHOD *DH_get_default_method(void);
143\& const DH_METHOD *DH_get_default_method(void);
149.Ve
150.PP
151.Vb 1
144\&
152\& int DH_set_method(DH *dh, const DH_METHOD *meth);
145\& int DH_set_method(DH *dh, const DH_METHOD *meth);
153.Ve
154.PP
155.Vb 1
146\&
156\& DH *DH_new_method(ENGINE *engine);
147\& DH *DH_new_method(ENGINE *engine);
157.Ve
158.PP
159.Vb 1
148\&
160\& const DH_METHOD *DH_OpenSSL(void);
161.Ve
162.SH "DESCRIPTION"
163.IX Header "DESCRIPTION"
164A \fB\s-1DH_METHOD\s0\fR specifies the functions that OpenSSL uses for Diffie-Hellman
165operations. By modifying the method, alternative implementations
166such as hardware accelerators may be used. \s-1IMPORTANT:\s0 See the \s-1NOTES\s0 section for
167important information about how these \s-1DH\s0 \s-1API\s0 functions are affected by the use

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

192\&\fIDH_set_default_method()\fR is used.
193.SH "THE DH_METHOD STRUCTURE"
194.IX Header "THE DH_METHOD STRUCTURE"
195.Vb 4
196\& typedef struct dh_meth_st
197\& {
198\& /* name of the implementation */
199\& const char *name;
149\& const DH_METHOD *DH_OpenSSL(void);
150.Ve
151.SH "DESCRIPTION"
152.IX Header "DESCRIPTION"
153A \fB\s-1DH_METHOD\s0\fR specifies the functions that OpenSSL uses for Diffie-Hellman
154operations. By modifying the method, alternative implementations
155such as hardware accelerators may be used. \s-1IMPORTANT:\s0 See the \s-1NOTES\s0 section for
156important information about how these \s-1DH\s0 \s-1API\s0 functions are affected by the use

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

181\&\fIDH_set_default_method()\fR is used.
182.SH "THE DH_METHOD STRUCTURE"
183.IX Header "THE DH_METHOD STRUCTURE"
184.Vb 4
185\& typedef struct dh_meth_st
186\& {
187\& /* name of the implementation */
188\& const char *name;
200.Ve
201.PP
202.Vb 2
189\&
203\& /* generate private and public DH values for key agreement */
204\& int (*generate_key)(DH *dh);
190\& /* generate private and public DH values for key agreement */
191\& int (*generate_key)(DH *dh);
205.Ve
206.PP
207.Vb 2
192\&
208\& /* compute shared secret */
209\& int (*compute_key)(unsigned char *key, BIGNUM *pub_key, DH *dh);
193\& /* compute shared secret */
194\& int (*compute_key)(unsigned char *key, BIGNUM *pub_key, DH *dh);
210.Ve
211.PP
212.Vb 4
195\&
213\& /* compute r = a ^ p mod m (May be NULL for some implementations) */
214\& int (*bn_mod_exp)(DH *dh, BIGNUM *r, BIGNUM *a, const BIGNUM *p,
215\& const BIGNUM *m, BN_CTX *ctx,
216\& BN_MONT_CTX *m_ctx);
196\& /* compute r = a ^ p mod m (May be NULL for some implementations) */
197\& int (*bn_mod_exp)(DH *dh, BIGNUM *r, BIGNUM *a, const BIGNUM *p,
198\& const BIGNUM *m, BN_CTX *ctx,
199\& BN_MONT_CTX *m_ctx);
217.Ve
218.PP
219.Vb 2
200\&
220\& /* called at DH_new */
221\& int (*init)(DH *dh);
201\& /* called at DH_new */
202\& int (*init)(DH *dh);
222.Ve
223.PP
224.Vb 2
203\&
225\& /* called at DH_free */
226\& int (*finish)(DH *dh);
204\& /* called at DH_free */
205\& int (*finish)(DH *dh);
227.Ve
228.PP
229.Vb 1
206\&
230\& int flags;
207\& int flags;
231.Ve
232.PP
233.Vb 1
208\&
234\& char *app_data; /* ?? */
209\& char *app_data; /* ?? */
235.Ve
236.PP
237.Vb 1
210\&
238\& } DH_METHOD;
239.Ve
240.SH "RETURN VALUES"
241.IX Header "RETURN VALUES"
242\&\fIDH_OpenSSL()\fR and \fIDH_get_default_method()\fR return pointers to the respective
243\&\fB\s-1DH_METHOD\s0\fRs.
244.PP
245\&\fIDH_set_default_method()\fR returns no value.

--- 34 unchanged lines hidden ---
211\& } DH_METHOD;
212.Ve
213.SH "RETURN VALUES"
214.IX Header "RETURN VALUES"
215\&\fIDH_OpenSSL()\fR and \fIDH_get_default_method()\fR return pointers to the respective
216\&\fB\s-1DH_METHOD\s0\fRs.
217.PP
218\&\fIDH_set_default_method()\fR returns no value.

--- 34 unchanged lines hidden ---