Loading doc/apps/s_client.pod +8 −0 Original line number Diff line number Diff line Loading @@ -32,6 +32,7 @@ B<openssl> B<s_client> [B<-no_tls1>] [B<-bugs>] [B<-cipher cipherlist>] [B<-engine id>] =head1 DESCRIPTION Loading Loading @@ -156,6 +157,13 @@ the server determines which cipher suite is used it should take the first supported cipher in the list sent by the client. See the B<ciphers> command for more information. =item B<-engine id> specifying an engine (by it's unique B<id> string) will cause B<s_client> to attempt to obtain a functional reference to the specified engine, thus initialising it if needed. The engine will then be set as the default for all available algorithms. =back =head1 CONNECTED COMMANDS Loading doc/apps/s_server.pod +8 −0 Original line number Diff line number Diff line Loading @@ -39,6 +39,7 @@ B<openssl> B<s_client> [B<-hack>] [B<-www>] [B<-WWW>] [B<-engine id>] =head1 DESCRIPTION Loading Loading @@ -186,6 +187,13 @@ emulates a simple web server. Pages will be resolved relative to the current directory, for example if the URL https://myhost/page.html is requested the file ./page.html will be loaded. =item B<-engine id> specifying an engine (by it's unique B<id> string) will cause B<s_server> to attempt to obtain a functional reference to the specified engine, thus initialising it if needed. The engine will then be set as the default for all available algorithms. =back =head1 CONNECTED COMMANDS Loading doc/apps/speed.pod +12 −0 Original line number Diff line number Diff line Loading @@ -7,6 +7,7 @@ speed - test library performance =head1 SYNOPSIS B<openssl speed> [B<-engine id>] [B<md2>] [B<mdc2>] [B<md5>] Loading Loading @@ -39,6 +40,17 @@ This command is used to test the performance of cryptographic algorithms. =head1 OPTIONS =over 4 =item B<-engine id> specifying an engine (by it's unique B<id> string) will cause B<speed> to attempt to obtain a functional reference to the specified engine, thus initialising it if needed. The engine will then be set as the default for all available algorithms. =item B<[zero or more test algorithms]> If any options are given, B<speed> tests those algorithms, otherwise all of the above are tested. Loading doc/crypto/DH_set_method.pod +36 −21 Original line number Diff line number Diff line Loading @@ -2,20 +2,21 @@ =head1 NAME DH_set_default_method, DH_get_default_method, DH_set_method, DH_new_method, DH_OpenSSL - select DH method DH_set_default_openssl_method, DH_get_default_openssl_method, DH_set_method, DH_new_method, DH_OpenSSL - select DH method =head1 SYNOPSIS #include <openssl/dh.h> #include <openssl/engine.h> void DH_set_default_method(DH_METHOD *meth); void DH_set_default_openssl_method(DH_METHOD *meth); DH_METHOD *DH_get_default_method(void); DH_METHOD *DH_get_default_openssl_method(void); DH_METHOD *DH_set_method(DH *dh, DH_METHOD *meth); int DH_set_method(DH *dh, ENGINE *engine); DH *DH_new_method(DH_METHOD *meth); DH *DH_new_method(ENGINE *engine); DH_METHOD *DH_OpenSSL(void); Loading @@ -28,17 +29,26 @@ such as hardware accelerators may be used. Initially, the default is to use the OpenSSL internal implementation. DH_OpenSSL() returns a pointer to that method. DH_set_default_method() makes B<meth> the default method for all B<DH> structures created later. DH_set_default_openssl_method() makes B<meth> the default method for all DH structures created later. B<NB:> This is true only whilst the default engine for Diffie-Hellman operations remains as "openssl". ENGINEs provide an encapsulation for implementations of one or more algorithms, and all the DH functions mentioned here operate within the scope of the default "openssl" engine. DH_get_default_method() returns a pointer to the current default method. DH_get_default_openssl_method() returns a pointer to the current default method for the "openssl" engine. DH_set_method() selects B<meth> for all operations using the structure B<dh>. DH_set_method() selects B<engine> as the engine that will be responsible for all operations using the structure B<dh>. If this function completes successfully, then the B<dh> structure will have its own functional reference of B<engine>, so the caller should remember to free their own reference to B<engine> when they are finished with it. NB: An ENGINE's DH_METHOD can be retrieved (or set) by ENGINE_get_DH() or ENGINE_set_DH(). DH_new_method() allocates and initializes a B<DH> structure so that B<method> will be used for the DH operations. If B<method> is B<NULL>, the default method is used. DH_new_method() allocates and initializes a DH structure so that B<engine> will be used for the DH operations. If B<engine> is NULL, the default engine for Diffie-Hellman opertaions is used. =head1 THE DH_METHOD STRUCTURE Loading Loading @@ -73,16 +83,16 @@ the default method is used. =head1 RETURN VALUES DH_OpenSSL() and DH_get_default_method() return pointers to the respective B<DH_METHOD>s. DH_METHODs. DH_set_default_method() returns no value. DH_set_default_openssl_method() returns no value. DH_set_method() returns a pointer to the B<DH_METHOD> previously associated with B<dh>. DH_set_method() returns non-zero if the ENGINE associated with B<dh> was successfully changed to B<engine>. DH_new_method() returns B<NULL> and sets an error code that can be obtained by L<ERR_get_error(3)|ERR_get_error(3)> if the allocation fails. Otherwise it returns a pointer to the newly allocated structure. DH_new_method() returns NULL and sets an error code that can be obtained by L<ERR_get_error(3)|ERR_get_error(3)> if the allocation fails. Otherwise it returns a pointer to the newly allocated structure. =head1 SEE ALSO Loading @@ -93,4 +103,9 @@ L<dh(3)|dh(3)>, L<DH_new(3)|DH_new(3)> DH_set_default_method(), DH_get_default_method(), DH_set_method(), DH_new_method() and DH_OpenSSL() were added in OpenSSL 0.9.4. DH_set_default_openssl_method() and DH_get_default_openssl_method() replaced DH_set_default_method() and DH_get_default_method() respectively, and DH_set_method() and DH_new_method() were altered to use B<ENGINE>s rather than B<DH_METHOD>s during development of OpenSSL 0.9.6. =cut doc/crypto/DSA_set_method.pod +31 −22 Original line number Diff line number Diff line Loading @@ -2,20 +2,21 @@ =head1 NAME DSA_set_default_method, DSA_get_default_method, DSA_set_method, DSA_new_method, DSA_OpenSSL - select DSA method DSA_set_default_openssl_method, DSA_get_default_openssl_method, DSA_set_method, DSA_new_method, DSA_OpenSSL - select DSA method =head1 SYNOPSIS #include <openssl/dsa.h> #include <openssl/engine.h> void DSA_set_default_method(DSA_METHOD *meth); void DSA_set_default_openssl_method(DSA_METHOD *meth); DSA_METHOD *DSA_get_default_method(void); DSA_METHOD *DSA_get_default_openssl_method(void); DSA_METHOD *DSA_set_method(DSA *dsa, DSA_METHOD *meth); int DSA_set_method(DSA *dsa, ENGINE *engine); DSA *DSA_new_method(DSA_METHOD *meth); DSA *DSA_new_method(ENGINE *engine); DSA_METHOD *DSA_OpenSSL(void); Loading @@ -28,17 +29,21 @@ such as hardware accelerators may be used. Initially, the default is to use the OpenSSL internal implementation. DSA_OpenSSL() returns a pointer to that method. DSA_set_default_method() makes B<meth> the default method for all B<DSA> structures created later. DSA_set_default_openssl_method() makes B<meth> the default method for all DSA structures created later. B<NB:> This is true only whilst the default engine for DSA operations remains as "openssl". ENGINEs provide an encapsulation for implementations of one or more algorithms at a time, and all the DSA functions mentioned here operate within the scope of the default "openssl" engine. DSA_get_default_method() returns a pointer to the current default method. DSA_get_default_openssl_method() returns a pointer to the current default method for the "openssl" engine. DSA_set_method() selects B<meth> for all operations using the structure B<dsa>. DSA_set_method() selects B<engine> for all operations using the structure B<dsa>. DSA_new_method() allocates and initializes a B<DSA> structure so that B<method> will be used for the DSA operations. If B<method> is B<NULL>, the default method is used. DSA_new_method() allocates and initializes a DSA structure so that B<engine> will be used for the DSA operations. If B<engine> is NULL, the default engine for DSA operations is used. =head1 THE DSA_METHOD STRUCTURE Loading Loading @@ -84,18 +89,17 @@ struct =head1 RETURN VALUES DSA_OpenSSL() and DSA_get_default_method() return pointers to the respective B<DSA_METHOD>s. DSA_OpenSSL() and DSA_get_default_openssl_method() return pointers to the respective DSA_METHODs. DSA_set_default_method() returns no value. DSA_set_default_openssl_method() returns no value. DSA_set_method() returns a pointer to the B<DSA_METHOD> previously associated with B<dsa>. DSA_set_method() returns non-zero if the ENGINE associated with B<dsa> was successfully changed to B<engine>. DSA_new_method() returns B<NULL> and sets an error code that can be DSA_new_method() returns NULL and sets an error code that can be obtained by L<ERR_get_error(3)|ERR_get_error(3)> if the allocation fails. Otherwise it returns a pointer to the newly allocated structure. fails. Otherwise it returns a pointer to the newly allocated structure. =head1 SEE ALSO Loading @@ -106,4 +110,9 @@ L<dsa(3)|dsa(3)>, L<DSA_new(3)|DSA_new(3)> DSA_set_default_method(), DSA_get_default_method(), DSA_set_method(), DSA_new_method() and DSA_OpenSSL() were added in OpenSSL 0.9.4. DSA_set_default_openssl_method() and DSA_get_default_openssl_method() replaced DSA_set_default_method() and DSA_get_default_method() respectively, and DSA_set_method() and DSA_new_method() were altered to use B<ENGINE>s rather than B<DSA_METHOD>s during development of OpenSSL 0.9.6. =cut Loading
doc/apps/s_client.pod +8 −0 Original line number Diff line number Diff line Loading @@ -32,6 +32,7 @@ B<openssl> B<s_client> [B<-no_tls1>] [B<-bugs>] [B<-cipher cipherlist>] [B<-engine id>] =head1 DESCRIPTION Loading Loading @@ -156,6 +157,13 @@ the server determines which cipher suite is used it should take the first supported cipher in the list sent by the client. See the B<ciphers> command for more information. =item B<-engine id> specifying an engine (by it's unique B<id> string) will cause B<s_client> to attempt to obtain a functional reference to the specified engine, thus initialising it if needed. The engine will then be set as the default for all available algorithms. =back =head1 CONNECTED COMMANDS Loading
doc/apps/s_server.pod +8 −0 Original line number Diff line number Diff line Loading @@ -39,6 +39,7 @@ B<openssl> B<s_client> [B<-hack>] [B<-www>] [B<-WWW>] [B<-engine id>] =head1 DESCRIPTION Loading Loading @@ -186,6 +187,13 @@ emulates a simple web server. Pages will be resolved relative to the current directory, for example if the URL https://myhost/page.html is requested the file ./page.html will be loaded. =item B<-engine id> specifying an engine (by it's unique B<id> string) will cause B<s_server> to attempt to obtain a functional reference to the specified engine, thus initialising it if needed. The engine will then be set as the default for all available algorithms. =back =head1 CONNECTED COMMANDS Loading
doc/apps/speed.pod +12 −0 Original line number Diff line number Diff line Loading @@ -7,6 +7,7 @@ speed - test library performance =head1 SYNOPSIS B<openssl speed> [B<-engine id>] [B<md2>] [B<mdc2>] [B<md5>] Loading Loading @@ -39,6 +40,17 @@ This command is used to test the performance of cryptographic algorithms. =head1 OPTIONS =over 4 =item B<-engine id> specifying an engine (by it's unique B<id> string) will cause B<speed> to attempt to obtain a functional reference to the specified engine, thus initialising it if needed. The engine will then be set as the default for all available algorithms. =item B<[zero or more test algorithms]> If any options are given, B<speed> tests those algorithms, otherwise all of the above are tested. Loading
doc/crypto/DH_set_method.pod +36 −21 Original line number Diff line number Diff line Loading @@ -2,20 +2,21 @@ =head1 NAME DH_set_default_method, DH_get_default_method, DH_set_method, DH_new_method, DH_OpenSSL - select DH method DH_set_default_openssl_method, DH_get_default_openssl_method, DH_set_method, DH_new_method, DH_OpenSSL - select DH method =head1 SYNOPSIS #include <openssl/dh.h> #include <openssl/engine.h> void DH_set_default_method(DH_METHOD *meth); void DH_set_default_openssl_method(DH_METHOD *meth); DH_METHOD *DH_get_default_method(void); DH_METHOD *DH_get_default_openssl_method(void); DH_METHOD *DH_set_method(DH *dh, DH_METHOD *meth); int DH_set_method(DH *dh, ENGINE *engine); DH *DH_new_method(DH_METHOD *meth); DH *DH_new_method(ENGINE *engine); DH_METHOD *DH_OpenSSL(void); Loading @@ -28,17 +29,26 @@ such as hardware accelerators may be used. Initially, the default is to use the OpenSSL internal implementation. DH_OpenSSL() returns a pointer to that method. DH_set_default_method() makes B<meth> the default method for all B<DH> structures created later. DH_set_default_openssl_method() makes B<meth> the default method for all DH structures created later. B<NB:> This is true only whilst the default engine for Diffie-Hellman operations remains as "openssl". ENGINEs provide an encapsulation for implementations of one or more algorithms, and all the DH functions mentioned here operate within the scope of the default "openssl" engine. DH_get_default_method() returns a pointer to the current default method. DH_get_default_openssl_method() returns a pointer to the current default method for the "openssl" engine. DH_set_method() selects B<meth> for all operations using the structure B<dh>. DH_set_method() selects B<engine> as the engine that will be responsible for all operations using the structure B<dh>. If this function completes successfully, then the B<dh> structure will have its own functional reference of B<engine>, so the caller should remember to free their own reference to B<engine> when they are finished with it. NB: An ENGINE's DH_METHOD can be retrieved (or set) by ENGINE_get_DH() or ENGINE_set_DH(). DH_new_method() allocates and initializes a B<DH> structure so that B<method> will be used for the DH operations. If B<method> is B<NULL>, the default method is used. DH_new_method() allocates and initializes a DH structure so that B<engine> will be used for the DH operations. If B<engine> is NULL, the default engine for Diffie-Hellman opertaions is used. =head1 THE DH_METHOD STRUCTURE Loading Loading @@ -73,16 +83,16 @@ the default method is used. =head1 RETURN VALUES DH_OpenSSL() and DH_get_default_method() return pointers to the respective B<DH_METHOD>s. DH_METHODs. DH_set_default_method() returns no value. DH_set_default_openssl_method() returns no value. DH_set_method() returns a pointer to the B<DH_METHOD> previously associated with B<dh>. DH_set_method() returns non-zero if the ENGINE associated with B<dh> was successfully changed to B<engine>. DH_new_method() returns B<NULL> and sets an error code that can be obtained by L<ERR_get_error(3)|ERR_get_error(3)> if the allocation fails. Otherwise it returns a pointer to the newly allocated structure. DH_new_method() returns NULL and sets an error code that can be obtained by L<ERR_get_error(3)|ERR_get_error(3)> if the allocation fails. Otherwise it returns a pointer to the newly allocated structure. =head1 SEE ALSO Loading @@ -93,4 +103,9 @@ L<dh(3)|dh(3)>, L<DH_new(3)|DH_new(3)> DH_set_default_method(), DH_get_default_method(), DH_set_method(), DH_new_method() and DH_OpenSSL() were added in OpenSSL 0.9.4. DH_set_default_openssl_method() and DH_get_default_openssl_method() replaced DH_set_default_method() and DH_get_default_method() respectively, and DH_set_method() and DH_new_method() were altered to use B<ENGINE>s rather than B<DH_METHOD>s during development of OpenSSL 0.9.6. =cut
doc/crypto/DSA_set_method.pod +31 −22 Original line number Diff line number Diff line Loading @@ -2,20 +2,21 @@ =head1 NAME DSA_set_default_method, DSA_get_default_method, DSA_set_method, DSA_new_method, DSA_OpenSSL - select DSA method DSA_set_default_openssl_method, DSA_get_default_openssl_method, DSA_set_method, DSA_new_method, DSA_OpenSSL - select DSA method =head1 SYNOPSIS #include <openssl/dsa.h> #include <openssl/engine.h> void DSA_set_default_method(DSA_METHOD *meth); void DSA_set_default_openssl_method(DSA_METHOD *meth); DSA_METHOD *DSA_get_default_method(void); DSA_METHOD *DSA_get_default_openssl_method(void); DSA_METHOD *DSA_set_method(DSA *dsa, DSA_METHOD *meth); int DSA_set_method(DSA *dsa, ENGINE *engine); DSA *DSA_new_method(DSA_METHOD *meth); DSA *DSA_new_method(ENGINE *engine); DSA_METHOD *DSA_OpenSSL(void); Loading @@ -28,17 +29,21 @@ such as hardware accelerators may be used. Initially, the default is to use the OpenSSL internal implementation. DSA_OpenSSL() returns a pointer to that method. DSA_set_default_method() makes B<meth> the default method for all B<DSA> structures created later. DSA_set_default_openssl_method() makes B<meth> the default method for all DSA structures created later. B<NB:> This is true only whilst the default engine for DSA operations remains as "openssl". ENGINEs provide an encapsulation for implementations of one or more algorithms at a time, and all the DSA functions mentioned here operate within the scope of the default "openssl" engine. DSA_get_default_method() returns a pointer to the current default method. DSA_get_default_openssl_method() returns a pointer to the current default method for the "openssl" engine. DSA_set_method() selects B<meth> for all operations using the structure B<dsa>. DSA_set_method() selects B<engine> for all operations using the structure B<dsa>. DSA_new_method() allocates and initializes a B<DSA> structure so that B<method> will be used for the DSA operations. If B<method> is B<NULL>, the default method is used. DSA_new_method() allocates and initializes a DSA structure so that B<engine> will be used for the DSA operations. If B<engine> is NULL, the default engine for DSA operations is used. =head1 THE DSA_METHOD STRUCTURE Loading Loading @@ -84,18 +89,17 @@ struct =head1 RETURN VALUES DSA_OpenSSL() and DSA_get_default_method() return pointers to the respective B<DSA_METHOD>s. DSA_OpenSSL() and DSA_get_default_openssl_method() return pointers to the respective DSA_METHODs. DSA_set_default_method() returns no value. DSA_set_default_openssl_method() returns no value. DSA_set_method() returns a pointer to the B<DSA_METHOD> previously associated with B<dsa>. DSA_set_method() returns non-zero if the ENGINE associated with B<dsa> was successfully changed to B<engine>. DSA_new_method() returns B<NULL> and sets an error code that can be DSA_new_method() returns NULL and sets an error code that can be obtained by L<ERR_get_error(3)|ERR_get_error(3)> if the allocation fails. Otherwise it returns a pointer to the newly allocated structure. fails. Otherwise it returns a pointer to the newly allocated structure. =head1 SEE ALSO Loading @@ -106,4 +110,9 @@ L<dsa(3)|dsa(3)>, L<DSA_new(3)|DSA_new(3)> DSA_set_default_method(), DSA_get_default_method(), DSA_set_method(), DSA_new_method() and DSA_OpenSSL() were added in OpenSSL 0.9.4. DSA_set_default_openssl_method() and DSA_get_default_openssl_method() replaced DSA_set_default_method() and DSA_get_default_method() respectively, and DSA_set_method() and DSA_new_method() were altered to use B<ENGINE>s rather than B<DSA_METHOD>s during development of OpenSSL 0.9.6. =cut
