]>
Commit | Line | Data |
---|---|---|
dd8dec69 UM |
1 | =pod |
2 | ||
3 | =head1 NAME | |
4 | ||
4d524e10 | 5 | BN_mod_inverse - compute inverse modulo n |
dd8dec69 UM |
6 | |
7 | =head1 SYNOPSIS | |
8 | ||
9 | #include <openssl/bn.h> | |
10 | ||
4d524e10 UM |
11 | BIGNUM *BN_mod_inverse(BIGNUM *r, BIGNUM *a, const BIGNUM *n, |
12 | BN_CTX *ctx); | |
dd8dec69 UM |
13 | |
14 | =head1 DESCRIPTION | |
15 | ||
16 | BN_mod_inverse() computes the inverse of B<a> modulo B<n> | |
17 | places the result in B<r> (C<(a*r)%n==1>). If B<r> is NULL, | |
18 | a new B<BIGNUM> is created. | |
19 | ||
20 | B<ctx> is a previously allocated B<BN_CTX> used for temporary | |
21 | variables. B<r> may be the same B<BIGNUM> as B<a> or B<n>. | |
22 | ||
23 | =head1 RETURN VALUES | |
24 | ||
25 | BN_mod_inverse() returns the B<BIGNUM> containing the inverse, and | |
bb075f88 | 26 | NULL on error. The error codes can be obtained by L<ERR_get_error(3)|ERR_get_error(3)>. |
dd8dec69 UM |
27 | |
28 | =head1 SEE ALSO | |
29 | ||
bb075f88 | 30 | L<bn(3)|bn(3)>, L<err(3)|err(3)>, L<BN_add(3)|BN_add(3)> |
dd8dec69 UM |
31 | |
32 | =head1 HISTORY | |
33 | ||
34 | BN_mod_inverse() is available in all versions of SSLeay and OpenSSL. | |
35 | ||
36 | =cut |