| 
									
										
										
										
											2000-01-23 04:05:23 +08:00
										 |  |  | =pod | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | =head1 NAME | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | DH_new, DH_free - allocate and free DH objects | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | =head1 SYNOPSIS | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |  #include <openssl/dh.h> | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |  DH* DH_new(void); | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2000-01-28 03:31:26 +08:00
										 |  |  |  void DH_free(DH *dh); | 
					
						
							| 
									
										
										
										
											2000-01-23 04:05:23 +08:00
										 |  |  | 
 | 
					
						
							|  |  |  | =head1 DESCRIPTION | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | DH_new() allocates and initializes a B<DH> structure. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | DH_free() frees the B<DH> structure and its components. The values are | 
					
						
							|  |  |  | erased before the memory is returned to the system. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | =head1 RETURN VALUES | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | If the allocation fails, DH_new() returns B<NULL> and sets an error | 
					
						
							| 
									
										
										
										
											2000-01-27 09:25:31 +08:00
										 |  |  | code that can be obtained by L<ERR_get_error(3)|ERR_get_error(3)>. Otherwise it returns | 
					
						
							| 
									
										
										
										
											2000-01-23 04:05:23 +08:00
										 |  |  | a pointer to the newly allocated structure. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | DH_free() returns no value. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | =head1 SEE ALSO | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2002-09-25 21:33:28 +08:00
										 |  |  | L<dh(3)|dh(3)>, L<ERR_get_error(3)|ERR_get_error(3)>, | 
					
						
							| 
									
										
										
										
											2000-01-27 09:25:31 +08:00
										 |  |  | L<DH_generate_parameters(3)|DH_generate_parameters(3)>, | 
					
						
							|  |  |  | L<DH_generate_key(3)|DH_generate_key(3)> | 
					
						
							| 
									
										
										
										
											2000-01-23 04:05:23 +08:00
										 |  |  | 
 | 
					
						
							|  |  |  | =head1 HISTORY | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | DH_new() and DH_free() are available in all versions of SSLeay and OpenSSL. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | =cut |