"Fossies" - the Fresh Open Source Software Archive

Member "libressl-2.9.2/man/BN_zero.3" (4 Dec 2018, 4337 Bytes) of package /linux/misc/libressl-2.9.2.tar.gz:


Caution: As a special service "Fossies" has tried to format the requested manual source page into HTML format but links to other man pages may be missing or even errorneous. Alternatively you can here view or download the uninterpreted manual source code. A member file download can also be achieved by clicking within a package contents listing on the according byte size field.

BN_ZERO(3) BSD Library Functions Manual BN_ZERO(3)

NAME

BN_zero, BN_one, BN_value_one, BN_set_word, BN_get_word — BIGNUM assignment operations

SYNOPSIS

#include <openssl/bn.h>

int

BN_zero(BIGNUM *a);

int

BN_one(BIGNUM *a);

const BIGNUM *

BN_value_one(void);

int

BN_set_word(BIGNUM *a, BN_ULONG w);

BN_ULONG

BN_get_word(BIGNUM *a);

DESCRIPTION

BN_ULONG is a macro that expands to an unsigned integral type optimized for the most efficient implementation on the local platform.

BN_zero(), BN_one(), and BN_set_word() set a to the values 0, 1 and w respectively. BN_zero() and BN_one() are macros.

BN_value_one() returns a BIGNUM constant of value 1. This constant is useful for comparisons and assignments.

RETURN VALUES

BN_get_word() returns the value a, or a number with all bits set if a cannot be represented as a BN_ULONG.

BN_zero(), BN_one(), and BN_set_word() return 1 on success, 0 otherwise. BN_value_one() returns the constant.

SEE ALSO

BN_bn2bin(3), BN_new(3), BN_set_bit(3), BN_set_negative(3)

HISTORY

BN_zero(), BN_one(), BN_value_one(), and BN_set_word() first appeared in SSLeay 0.5.1. BN_get_word() first appeared in SSLeay 0.6.0. All these functions have been available since OpenBSD 2.4.

BUGS

Someone might change the constant.

If the value of a BIGNUM is equal to a BN_ULONG with all bits set, the return value of BN_get_word() collides with return value used to indicate errors.

BN_ULONG should probably be a typedef rather than a macro.

BSD March 27, 2018 BSD