+++ /dev/null
-.\" $OpenBSD: ASN1_bn_print.3,v 1.2 2022/12/14 20:27:28 schwarze Exp $
-.\"
-.\" Copyright (c) 2021 Ingo Schwarze <schwarze@openbsd.org>
-.\"
-.\" Permission to use, copy, modify, and distribute this software for any
-.\" purpose with or without fee is hereby granted, provided that the above
-.\" copyright notice and this permission notice appear in all copies.
-.\"
-.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
-.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
-.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
-.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
-.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
-.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
-.\"
-.Dd $Mdocdate: December 14 2022 $
-.Dt ASN1_BN_PRINT 3
-.Os
-.Sh NAME
-.Nm ASN1_bn_print
-.Nd pretty-print a BIGNUM object
-.Sh SYNOPSIS
-.In openssl/asn1.h
-.Ft int
-.Fo ASN1_bn_print
-.Fa "BIO *bio_out"
-.Fa "const char *label"
-.Fa "const BIGNUM *bn"
-.Fa "unsigned char *buffer"
-.Fa "int indent"
-.Fc
-.Sh DESCRIPTION
-.Fn ASN1_bn_print
-prints
-.Fa bn
-to
-.Fa bio_out
-in human-readable form.
-Despite its name and the header file,
-this function has nothing to do with ASN.1.
-.Pp
-The caller is responsible for providing a
-.Fa buffer
-that is at least
-.Fn BN_num_bytes bn
-+ 1 bytes long.
-To avoid a buffer overrun, be careful to not forget the
-.Dq plus one .
-It is unspecified what the buffer may contain after the function returns.
-.Pp
-If
-.Fa indent
-is greater than zero,
-.Fa indent
-space characters are printed first, but not more than 128.
-.Pp
-The NUL-terminated
-.Fa label
-is printed next.
-.Pp
-After that, there are three cases:
-.Bl -bullet
-.It
-If
-.Fa bn
-represents the number zero,
-.Qq 0
-is printed.
-.It
-If
-.Fa bn
-can be represented by the data type
-.Vt unsigned long ,
-it is printed in decimal notation,
-followed by hexadecimal notation in parentheses,
-both optionally preceded by a minus sign.
-.It
-Otherwise, the string
-.Qq Pq 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
-.Fa 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.
-.El
-.Pp
-Finally, a newline character is printed to end the output.
-.Pp
-If
-.Fa bn
-is a
-.Dv NULL
-pointer, all arguments are ignored and nothing is printed.
-.Sh RETURN VALUES
-.Fn ASN1_bn_print
-returns 1
-if successful or if
-.Fa bn
-is a
-.Dv NULL
-pointer.
-It returns 0 if printing fails.
-.Sh SEE ALSO
-.Xr ASN1_buf_print 3 ,
-.Xr BIO_new 3 ,
-.Xr BIO_write 3 ,
-.Xr BN_is_negative 3 ,
-.Xr BN_is_zero 3 ,
-.Xr BN_new 3 ,
-.Xr BN_num_bytes 3 ,
-.Xr BN_print 3
-.Sh HISTORY
-.Fn ASN1_bn_print
-first appeared in OpenSSL 1.0.0 and has been available since
-.Ox 4.9 .
-.\" $OpenBSD: ASN1_buf_print.3,v 1.1 2022/12/14 20:27:28 schwarze Exp $
+.\" $OpenBSD: ASN1_buf_print.3,v 1.2 2023/07/09 06:45:03 tb Exp $
.\"
.\" Copyright (c) 2022 Ingo Schwarze <schwarze@openbsd.org>
.\"
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: December 14 2022 $
+.Dd $Mdocdate: July 9 2023 $
.Dt ASN1_BUF_PRINT 3
.Os
.Sh NAME
.Fn ASN1_buf_print
returns 1 if successful or 0 if printing fails.
.Sh SEE ALSO
-.Xr ASN1_bn_print 3 ,
.Xr ASN1_item_print 3 ,
.Xr ASN1_STRING_print_ex 3 ,
.Xr ASN1_TIME_print 3 ,
-.\" $OpenBSD: BN_bn2bin.3,v 1.15 2021/12/08 21:52:29 schwarze Exp $
+.\" $OpenBSD: BN_bn2bin.3,v 1.16 2023/07/09 06:45:03 tb Exp $
.\" full merge up to: OpenSSL 24a535ea Sep 22 13:14:20 2020 +0100
.\"
.\" This file was written by Ulf Moeller <ulf@openssl.org>
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: December 8 2021 $
+.Dd $Mdocdate: July 9 2023 $
.Dt BN_BN2BIN 3
.Os
.Sh NAME
The error codes can be obtained by
.Xr ERR_get_error 3 .
.Sh SEE ALSO
-.Xr ASN1_bn_print 3 ,
.Xr ASN1_INTEGER_to_BN 3 ,
.Xr BN_new 3 ,
.Xr BN_num_bytes 3 ,
-.\" $OpenBSD: BN_new.3,v 1.27 2023/04/28 16:39:19 schwarze Exp $
+.\" $OpenBSD: BN_new.3,v 1.28 2023/07/09 06:45:03 tb Exp $
.\" full merge up to: OpenSSL man3/BN_new 2457c19d Mar 6 08:43:36 2004 +0000
.\" selective merge up to: man3/BN_new 681acb31 Sep 29 13:10:34 2017 +0200
.\" full merge up to: OpenSSL man7/bn 05ea606a May 20 20:52:46 2016 -0400
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: April 28 2023 $
+.Dd $Mdocdate: July 9 2023 $
.Dt BN_NEW 3
.Os
.Sh NAME
and sets an error code that can be obtained by
.Xr ERR_get_error 3 .
.Sh SEE ALSO
-.Xr ASN1_bn_print 3 ,
.Xr BN_add 3 ,
.Xr BN_add_word 3 ,
.Xr BN_BLINDING_new 3 ,
projects / openbsd / commitdiff