·  Home
+   man pages
 -> Linux -> FreeBSD -> OpenBSD -> NetBSD -> Tru64 Unix -> HP-UX 11i -> IRIX
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

man pages->OpenBSD man pages -> RSA_generate_key (3)
 Title
 Content
 Arch
 Section All Sections 1 - General Commands 2 - System Calls 3 - Subroutines 4 - Special Files 5 - File Formats 6 - Games 7 - Macros and Conventions 8 - Maintenance Commands 9 - Kernel Interface n - New Commands

## RSA_GENERATE_KEY(3)

### NAME[Toc][Back]

RSA_generate_key - generate RSA key pair

### SYNOPSIS[Toc][Back]

#include <openssl/rsa.h>

RSA *RSA_generate_key(int num, unsigned long e,
void (*callback)(int,int,void *), void *cb_arg);

### DESCRIPTION[Toc][Back]

RSA_generate_key() generates a key pair and returns it in
a newly allocated RSA structure. The pseudo-random number
generator must be seeded prior to calling RSA_gener-
ate_key().

The modulus size will be num bits, and the public exponent
will be e. Key sizes with num < 1024 should be considered
insecure.  The exponent is an odd number, typically 3, 17
or 65537.

A callback function may be used to provide feedback about
the progress of the key generation. If callback is not
NULL, it will be called as follows:

o   While a random prime number is generated, it is called
as described in BN_generate_prime(3).

o   When the n-th randomly generated prime is rejected as
not suitable for the key, callback(2, n, cb_arg) is
called.

o   When a random p has been found with p-1 relatively
prime to e, it is called as callback(3, 0, cb_arg).

The process is then repeated for prime q with callback(3,
1, cb_arg).

### RETURN VALUE[Toc][Back]

If key generation fails, RSA_generate_key() returns NULL;
the error codes can be obtained by ERR_get_error(3).

### BUGS[Toc][Back]

callback(2, x, cb_arg) is used with two different meanings.

RSA_generate_key() goes into an infinite loop for illegal
input values.

ERR_get_error(3), rand(3), rsa(3), RSA_free(3)

### HISTORY[Toc][Back]

The cb_arg argument was added in SSLeay 0.9.0.

OpenBSD 3.6                 2003-05-11                          1
[ Back ]
Similar pages
 Name OS Title DSA_generate_key Tru64 Generate DSA key pair DSA_generate_key OpenBSD generate DSA key pair DSA_generate_key NetBSD generate DSA key pair GenerateKeyPair Tru64 Generate an asymmetric key pair (CDSA) CSSM_GenerateKeyPair Tru64 Generate an asymmetric key pair (CDSA) CSP_GenerateKeyPair Tru64 Generate an asymmetric key pair (CDSA) GenerateKeyPairP Tru64 Generate an asymmetric key pair with privilege (CDSA) BIO_set_write_buf_size Tru64 BIO pair BIO BIO_shutdown_wr Tru64 BIO pair BIO BIO_s_bio Tru64 BIO pair BIO