NAME
ASN1_bn_print —
pretty-print a BIGNUM object
SYNOPSIS
#include
<openssl/asn1.h>
int
ASN1_bn_print(BIO *bio_out,
const char *label, const BIGNUM
*bn, unsigned char *buffer, int
indent);
DESCRIPTION
ASN1_bn_print()
prints bn to bio_out in
human-readable form. Despite its name and the header file, this function has
nothing to do with ASN.1.
The caller is responsible for providing a
buffer that is at least
BN_num_bytes(bn)
+ 1 bytes long. To avoid a buffer overrun, be careful to not forget the
“plus one”. It is unspecified what the buffer may contain
after the function returns.
If indent is greater than zero, indent space characters are printed first, but not more than 128.
The NUL-terminated label is printed next.
After that, there are three cases:
- If bn represents the number zero, "0" is printed.
- If bn can be represented by the data type unsigned long, it is printed in decimal notation, followed by hexadecimal notation in parentheses, both optionally preceded by a minus sign.
- Otherwise, the string "(Negative)" is printed if appropriate, a new output line is started, and the indentation is increased by four space characters. The bytes of the value of bn are then printed in big-endian order, each byte represented by a two-digit hexadecimal number, and each but the last byte followed by a colon. A new output line is started after every group of 15 bytes.
Finally, a newline character is printed to end the output.
If bn is a NULL
pointer, all arguments are ignored and nothing is printed.
RETURN VALUES
ASN1_bn_print() returns 1 if successful or
if bn is a NULL pointer. It
returns 0 if printing fails.
SEE ALSO
BIO_new(3), BIO_write(3), BN_is_negative(3), BN_is_zero(3), BN_new(3), BN_num_bytes(3), BN_print(3)
HISTORY
ASN1_bn_print() first appeared in OpenSSL
1.0.0 and has been available since OpenBSD 4.9.