sync with OpenBSD -current
This commit is contained in:
parent
efa57bf0d2
commit
d178ff6848
153 changed files with 982 additions and 11182 deletions
|
@ -1,4 +1,4 @@
|
|||
.\" $OpenBSD: BIO_printf.3,v 1.3 2018/03/22 17:11:04 schwarze Exp $
|
||||
.\" $OpenBSD: BIO_printf.3,v 1.4 2024/03/02 09:18:28 tb Exp $
|
||||
.\" OpenSSL 2ca2e917 Mon Mar 20 16:25:22 2017 -0400
|
||||
.\"
|
||||
.\" Copyright (c) 2017 Ingo Schwarze <schwarze@openbsd.org>
|
||||
|
@ -15,14 +15,11 @@
|
|||
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
|
||||
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
||||
.\"
|
||||
.Dd $Mdocdate: March 22 2018 $
|
||||
.Dd $Mdocdate: March 2 2024 $
|
||||
.Dt BIO_PRINTF 3
|
||||
.Os
|
||||
.Sh NAME
|
||||
.Nm BIO_printf ,
|
||||
.Nm BIO_vprintf ,
|
||||
.Nm BIO_snprintf ,
|
||||
.Nm BIO_vsnprintf
|
||||
.Nm BIO_printf
|
||||
.Nd formatted output to a BIO
|
||||
.Sh SYNOPSIS
|
||||
.In openssl/bio.h
|
||||
|
@ -32,66 +29,18 @@
|
|||
.Fa "const char *format"
|
||||
.Fa ...
|
||||
.Fc
|
||||
.Ft int
|
||||
.Fo BIO_vprintf
|
||||
.Fa "BIO *bio"
|
||||
.Fa "const char *format"
|
||||
.Fa "va_list args"
|
||||
.Fc
|
||||
.Ft int
|
||||
.Fo BIO_snprintf
|
||||
.Fa "char *buf"
|
||||
.Fa "size_t n"
|
||||
.Fa "const char *format"
|
||||
.Fa ...
|
||||
.Fc
|
||||
.Ft int
|
||||
.Fo BIO_vsnprintf
|
||||
.Fa "char *buf"
|
||||
.Fa "size_t n"
|
||||
.Fa "const char *format"
|
||||
.Fa "va_list args"
|
||||
.Fc
|
||||
.Sh DESCRIPTION
|
||||
.Fn BIO_vprintf
|
||||
.Fn BIO_printf
|
||||
is a wrapper around
|
||||
.Xr vfprintf 3 ,
|
||||
sending the output to the specified
|
||||
.Fa bio .
|
||||
.Pp
|
||||
.Fn BIO_printf
|
||||
is a wrapper around
|
||||
.Fn BIO_vprintf .
|
||||
.Pp
|
||||
.Fn BIO_snprintf
|
||||
and
|
||||
.Fn BIO_vsnprintf
|
||||
are wrappers around
|
||||
.Xr vsnprintf 3 .
|
||||
.Sh RETURN VALUES
|
||||
These functions return the number of bytes written,
|
||||
or -1 if an error occurs.
|
||||
.Pp
|
||||
In contrast to
|
||||
.Xr snprintf 3
|
||||
and
|
||||
.Xr vsnprintf 3 ,
|
||||
.Fn BIO_snprintf
|
||||
and
|
||||
.Fn BIO_vsnprintf
|
||||
also return -1 if
|
||||
.Fa n
|
||||
is too small to hold the complete output.
|
||||
.Sh SEE ALSO
|
||||
.Xr BIO_new 3
|
||||
.Sh HISTORY
|
||||
.Fn BIO_printf
|
||||
first appeared in SSLeay 0.6.5 and has been available since
|
||||
.Ox 2.4 .
|
||||
.Pp
|
||||
.Fn BIO_vprintf ,
|
||||
.Fn BIO_snprintf ,
|
||||
and
|
||||
.Fn BIO_vsnprintf
|
||||
first appeared in OpenSSL 0.9.6 and have been available since
|
||||
.Ox 2.9 .
|
||||
|
|
|
@ -1,4 +1,4 @@
|
|||
.\" $OpenBSD: CMAC_Init.3,v 1.5 2023/12/25 15:52:18 schwarze Exp $
|
||||
.\" $OpenBSD: CMAC_Init.3,v 1.6 2024/03/02 09:30:21 tb Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 2020 Ingo Schwarze <schwarze@openbsd.org>
|
||||
.\"
|
||||
|
@ -14,7 +14,7 @@
|
|||
.\" 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 25 2023 $
|
||||
.Dd $Mdocdate: March 2 2024 $
|
||||
.Dt CMAC_INIT 3
|
||||
.Os
|
||||
.Sh NAME
|
||||
|
@ -22,7 +22,6 @@
|
|||
.Nm CMAC_Init ,
|
||||
.Nm CMAC_Update ,
|
||||
.Nm CMAC_Final ,
|
||||
.Nm CMAC_resume ,
|
||||
.Nm CMAC_CTX_copy ,
|
||||
.Nm CMAC_CTX_get0_cipher_ctx ,
|
||||
.Nm CMAC_CTX_cleanup ,
|
||||
|
@ -52,13 +51,6 @@
|
|||
.Fa "unsigned char *out_mac"
|
||||
.Fa "size_t *out_len"
|
||||
.Fc
|
||||
.Ft int
|
||||
.Fn CMAC_resume "CMAC_CTX *ctx"
|
||||
.Ft int
|
||||
.Fo CMAC_CTX_copy
|
||||
.Fa "CMAC_CTX *out_ctx"
|
||||
.Fa "CMAC_CTX *in_ctx"
|
||||
.Fc
|
||||
.Ft EVP_CIPHER_CTX *
|
||||
.Fn CMAC_CTX_get0_cipher_ctx "CMAC_CTX *ctx"
|
||||
.Ft void
|
||||
|
@ -183,19 +175,6 @@ resulting message authentication code to
|
|||
.Fa out_mac .
|
||||
The caller is responsible for providing a buffer of sufficient size.
|
||||
.Pp
|
||||
Calling
|
||||
.Fn CMAC_resume
|
||||
after
|
||||
.Fn CMAC_Final
|
||||
allows the user to subsequently append additional data with
|
||||
.Fn CMAC_Update .
|
||||
Otherwise, unless
|
||||
.Fn CMAC_Init
|
||||
is called to start from scratch,
|
||||
.Fn CMAC_Update
|
||||
can no longer be used after
|
||||
.Fn CMAC_Final .
|
||||
.Pp
|
||||
.Fn CMAC_CTX_copy
|
||||
performs a deep copy of the already initialized
|
||||
.Fa in_ctx
|
||||
|
@ -235,7 +214,6 @@ It succeeds unless memory is exhausted.
|
|||
.Fn CMAC_Init ,
|
||||
.Fn CMAC_Update ,
|
||||
.Fn CMAC_Final ,
|
||||
.Fn CMAC_resume ,
|
||||
and
|
||||
.Fn CMAC_CTX_copy
|
||||
return 1 on success or 0 on failure.
|
||||
|
|
|
@ -1,4 +1,4 @@
|
|||
# $OpenBSD: Makefile,v 1.281 2024/01/22 13:44:59 job Exp $
|
||||
# $OpenBSD: Makefile,v 1.282 2024/03/02 11:04:51 tb Exp $
|
||||
|
||||
.include <bsd.own.mk>
|
||||
|
||||
|
@ -432,7 +432,6 @@ MAN= \
|
|||
i2d_CMS_bio_stream.3 \
|
||||
i2d_PKCS7_bio_stream.3 \
|
||||
lh_new.3 \
|
||||
lh_stats.3 \
|
||||
openssl.cnf.5 \
|
||||
s2i_ASN1_INTEGER.3 \
|
||||
x509v3.cnf.5
|
||||
|
|
|
@ -1,4 +1,4 @@
|
|||
.\" $OpenBSD: lh_new.3,v 1.10 2024/01/24 14:02:52 jsing Exp $
|
||||
.\" $OpenBSD: lh_new.3,v 1.11 2024/03/02 11:04:51 tb Exp $
|
||||
.\" full merge up to:
|
||||
.\" OpenSSL doc/crypto/lhash.pod 1bc74519 May 20 08:11:46 2016 -0400
|
||||
.\" selective merge up to:
|
||||
|
@ -118,7 +118,7 @@
|
|||
.\" copied and put under another distribution licence
|
||||
.\" [including the GNU Public Licence.]
|
||||
.\"
|
||||
.Dd $Mdocdate: January 24 2024 $
|
||||
.Dd $Mdocdate: March 2 2024 $
|
||||
.Dt LH_NEW 3
|
||||
.Os
|
||||
.Sh NAME
|
||||
|
@ -520,7 +520,6 @@ rather it would be used in the function passed to
|
|||
.Fn lh_<type>_new .
|
||||
.Sh SEE ALSO
|
||||
.Xr crypto 3 ,
|
||||
.Xr lh_stats 3
|
||||
.Sh HISTORY
|
||||
.Fn lh_new ,
|
||||
.Fn lh_free ,
|
||||
|
|
|
@ -1,206 +0,0 @@
|
|||
.\" $OpenBSD: lh_stats.3,v 1.7 2020/03/29 17:05:02 schwarze Exp $
|
||||
.\" OpenSSL e2f92610 May 18 11:44:05 2016 -0400
|
||||
.\"
|
||||
.\" --------------------------------------------------------------------------
|
||||
.\" Major patches to this file were contributed by
|
||||
.\" Ulf Moeller <ulf@openssl.org>.
|
||||
.\" --------------------------------------------------------------------------
|
||||
.\" Copyright (c) 2000 The OpenSSL Project. All rights reserved.
|
||||
.\"
|
||||
.\" Redistribution and use in source and binary forms, with or without
|
||||
.\" modification, are permitted provided that the following conditions
|
||||
.\" are met:
|
||||
.\"
|
||||
.\" 1. Redistributions of source code must retain the above copyright
|
||||
.\" notice, this list of conditions and the following disclaimer.
|
||||
.\"
|
||||
.\" 2. Redistributions in binary form must reproduce the above copyright
|
||||
.\" notice, this list of conditions and the following disclaimer in
|
||||
.\" the documentation and/or other materials provided with the
|
||||
.\" distribution.
|
||||
.\"
|
||||
.\" 3. All advertising materials mentioning features or use of this
|
||||
.\" software must display the following acknowledgment:
|
||||
.\" "This product includes software developed by the OpenSSL Project
|
||||
.\" for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
|
||||
.\"
|
||||
.\" 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
|
||||
.\" endorse or promote products derived from this software without
|
||||
.\" prior written permission. For written permission, please contact
|
||||
.\" openssl-core@openssl.org.
|
||||
.\"
|
||||
.\" 5. Products derived from this software may not be called "OpenSSL"
|
||||
.\" nor may "OpenSSL" appear in their names without prior written
|
||||
.\" permission of the OpenSSL Project.
|
||||
.\"
|
||||
.\" 6. Redistributions of any form whatsoever must retain the following
|
||||
.\" acknowledgment:
|
||||
.\" "This product includes software developed by the OpenSSL Project
|
||||
.\" for use in the OpenSSL Toolkit (http://www.openssl.org/)"
|
||||
.\"
|
||||
.\" THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
|
||||
.\" EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
||||
.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
|
||||
.\" ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
||||
.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
|
||||
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
||||
.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
||||
.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
||||
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
|
||||
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
|
||||
.\"
|
||||
.\" --------------------------------------------------------------------------
|
||||
.\" Parts of this file are derived from SSLeay documentation,
|
||||
.\" which is covered by the following Copyright and license:
|
||||
.\" --------------------------------------------------------------------------
|
||||
.\"
|
||||
.\" Copyright (C) 1995-1998 Tim Hudson (tjh@cryptsoft.com)
|
||||
.\" All rights reserved.
|
||||
.\"
|
||||
.\" This package is an SSL implementation written
|
||||
.\" by Eric Young (eay@cryptsoft.com).
|
||||
.\" The implementation was written so as to conform with Netscapes SSL.
|
||||
.\"
|
||||
.\" This library is free for commercial and non-commercial use as long as
|
||||
.\" the following conditions are aheared to. The following conditions
|
||||
.\" apply to all code found in this distribution, be it the RC4, RSA,
|
||||
.\" lhash, DES, etc., code; not just the SSL code. The SSL documentation
|
||||
.\" included with this distribution is covered by the same copyright terms
|
||||
.\" except that the holder is Tim Hudson (tjh@cryptsoft.com).
|
||||
.\"
|
||||
.\" Copyright remains Eric Young's, and as such any Copyright notices in
|
||||
.\" the code are not to be removed.
|
||||
.\" If this package is used in a product, Eric Young should be given
|
||||
.\" attribution as the author of the parts of the library used.
|
||||
.\" This can be in the form of a textual message at program startup or
|
||||
.\" in documentation (online or textual) provided with the package.
|
||||
.\"
|
||||
.\" Redistribution and use in source and binary forms, with or without
|
||||
.\" modification, are permitted provided that the following conditions
|
||||
.\" are met:
|
||||
.\" 1. Redistributions of source code must retain the copyright
|
||||
.\" notice, this list of conditions and the following disclaimer.
|
||||
.\" 2. Redistributions in binary form must reproduce the above copyright
|
||||
.\" notice, this list of conditions and the following disclaimer in the
|
||||
.\" documentation and/or other materials provided with the distribution.
|
||||
.\" 3. All advertising materials mentioning features or use of this software
|
||||
.\" must display the following acknowledgement:
|
||||
.\" "This product includes cryptographic software written by
|
||||
.\" Eric Young (eay@cryptsoft.com)"
|
||||
.\" The word 'cryptographic' can be left out if the rouines from the
|
||||
.\" library being used are not cryptographic related :-).
|
||||
.\" 4. If you include any Windows specific code (or a derivative thereof)
|
||||
.\" from the apps directory (application code) you must include an
|
||||
.\" acknowledgement: "This product includes software written by
|
||||
.\" Tim Hudson (tjh@cryptsoft.com)"
|
||||
.\"
|
||||
.\" THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
|
||||
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
||||
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
|
||||
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
||||
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
||||
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
||||
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
||||
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
||||
.\" SUCH DAMAGE.
|
||||
.\"
|
||||
.\" The licence and distribution terms for any publically available version or
|
||||
.\" derivative of this code cannot be changed. i.e. this code cannot simply be
|
||||
.\" copied and put under another distribution licence
|
||||
.\" [including the GNU Public Licence.]
|
||||
.\"
|
||||
.Dd $Mdocdate: March 29 2020 $
|
||||
.Dt LH_STATS 3
|
||||
.Os
|
||||
.Sh NAME
|
||||
.Nm lh_stats ,
|
||||
.Nm lh_node_stats ,
|
||||
.Nm lh_node_usage_stats ,
|
||||
.Nm lh_stats_bio ,
|
||||
.Nm lh_node_stats_bio ,
|
||||
.Nm lh_node_usage_stats_bio
|
||||
.Nd LHASH statistics
|
||||
.Sh SYNOPSIS
|
||||
.In openssl/lhash.h
|
||||
.Ft void
|
||||
.Fo lh_stats
|
||||
.Fa "LHASH *table"
|
||||
.Fa "FILE *out"
|
||||
.Fc
|
||||
.Ft void
|
||||
.Fo lh_node_stats
|
||||
.Fa "LHASH *table"
|
||||
.Fa "FILE *out"
|
||||
.Fc
|
||||
.Ft void
|
||||
.Fo lh_node_usage_stats
|
||||
.Fa "LHASH *table"
|
||||
.Fa "FILE *out"
|
||||
.Fc
|
||||
.Ft void
|
||||
.Fo lh_stats_bio
|
||||
.Fa "LHASH *table"
|
||||
.Fa "BIO *out"
|
||||
.Fc
|
||||
.Ft void
|
||||
.Fo lh_node_stats_bio
|
||||
.Fa "LHASH *table"
|
||||
.Fa "BIO *out"
|
||||
.Fc
|
||||
.Ft void
|
||||
.Fo lh_node_usage_stats_bio
|
||||
.Fa "LHASH *table"
|
||||
.Fa "BIO *out"
|
||||
.Fc
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.Vt LHASH
|
||||
structure records statistics about most aspects of accessing the hash
|
||||
table.
|
||||
.Pp
|
||||
.Fn lh_stats
|
||||
prints out statistics on the size of the hash table, how many entries
|
||||
are in it, and the number and result of calls to the routines in this
|
||||
library.
|
||||
.Pp
|
||||
.Fn lh_node_stats
|
||||
prints the number of entries for each 'bucket' in the hash table.
|
||||
.Pp
|
||||
.Fn lh_node_usage_stats
|
||||
prints out a short summary of the state of the hash table.
|
||||
It prints the 'load' and the 'actual load'.
|
||||
The load is the average number of data items per 'bucket' in the hash
|
||||
table.
|
||||
The 'actual load' is the average number of items per 'bucket', but only
|
||||
for buckets which contain entries.
|
||||
So the 'actual load' is the average number of searches that will need to
|
||||
find an item in the hash table, while the 'load' is the average number
|
||||
that will be done to record a miss.
|
||||
.Pp
|
||||
.Fn lh_stats_bio ,
|
||||
.Fn lh_node_stats_bio ,
|
||||
and
|
||||
.Fn lh_node_usage_stats_bio
|
||||
are the same as the above, except that the output goes to a
|
||||
.Vt BIO .
|
||||
.Sh SEE ALSO
|
||||
.Xr BIO_new 3 ,
|
||||
.Xr lh_new 3
|
||||
.Sh HISTORY
|
||||
.Fn lh_stats ,
|
||||
.Fn lh_node_stats ,
|
||||
.Fn lh_node_usage_stats
|
||||
appeared in SSLeay 0.4.
|
||||
.Fn lh_stats_bio ,
|
||||
.Fn lh_node_stats_bio ,
|
||||
and
|
||||
.Fn lh_node_usage_stats_bio
|
||||
first appeared in SSLeay 0.6.0.
|
||||
These functions have been available since
|
||||
.Ox 2.4 .
|
||||
.Sh AUTHORS
|
||||
.An Eric Young
|
Loading…
Add table
Add a link
Reference in a new issue