The branch master has been updated via 2ca2e9175d54dc66a66fe2a51ff5dd9b3bc899dc (commit) from cdd6c8c5785f44026d58b542431674598db18493 (commit)
- Log ----------------------------------------------------------------- commit 2ca2e9175d54dc66a66fe2a51ff5dd9b3bc899dc Author: Rich Salz <rs...@openssl.org> Date: Mon Mar 20 16:25:22 2017 -0400 Document BIO_printf family Also fix an error in UI_STRING (typo; wrong case). Reviewed-by: Richard Levitte <levi...@openssl.org> (Merged from https://github.com/openssl/openssl/pull/2999) ----------------------------------------------------------------------- Summary of changes: doc/man3/BIO_printf.pod | 50 +++++++++++++++++++++++++++++++++++++++++++++++++ doc/man3/UI_STRING.pod | 2 +- 2 files changed, 51 insertions(+), 1 deletion(-) create mode 100644 doc/man3/BIO_printf.pod diff --git a/doc/man3/BIO_printf.pod b/doc/man3/BIO_printf.pod new file mode 100644 index 0000000..8045b64 --- /dev/null +++ b/doc/man3/BIO_printf.pod @@ -0,0 +1,50 @@ +=pod + +=head1 NAME + +BIO_printf, BIO_vprintf, BIO_snprintf, BIO_vsnprintf +- formatted output to a BIO + +=head1 SYNOPSIS + + #include <openssl/bio.h> + + int BIO_printf(BIO *bio, const char *format, ...) + int BIO_vprintf(BIO *bio, const char *format, va_list args) + + int BIO_snprintf(char *buf, size_t n, const char *format, ...) + int BIO_vsnprintf(char *buf, size_t n, const char *format, va_list args) + +=head1 DESCRIPTION + +BIO_printf() is similar to the standard C printf() function, except that +the output is sent to the specified BIO, B<bio>, rather than standard +output. All common format specifiers are supported. + +BIO_vprintf() is similar to the vprintf() function found on many platforms, +the output is sent to the specified BIO, B<bio>, rather than standard +output. All common format specifiers are supported. The argument +list B<args> is a stdarg argument list. + +BIO_snprintf() is for platforms that do not have the common snprintf() +function. It is like sprintf() except that the size parameter, B<n>, +specifies the size of the output buffer. + +BIO_vsnprintf() is to BIO_snprintf() as BIO_vprintf() is to BIO_printf(). + +=head1 RETURN VALUES + +All functions return the number of bytes written, or -1 on error. +For BIO_snprintf() and BIO_vsnprintf() this includes when the output +buffer is too small. + +=head1 COPYRIGHT + +Copyright 2017 The OpenSSL Project Authors. All Rights Reserved. + +Licensed under the OpenSSL license (the "License"). You may not use +this file except in compliance with the License. You can obtain a copy +in the file LICENSE in the source distribution or at +L<https://www.openssl.org/source/license.html>. + +=cut diff --git a/doc/man3/UI_STRING.pod b/doc/man3/UI_STRING.pod index abd2cfc..12d5a40 100644 --- a/doc/man3/UI_STRING.pod +++ b/doc/man3/UI_STRING.pod @@ -58,7 +58,7 @@ output (prompt, info, error, ...). UI_get0_action_string() is used to retrieve the action description associated with a B<UIT_BOOLEAN> type B<UI_STRING>. For all other B<UI_STRING> types, NULL is returned. -See L<UI_Add_input_boolean(3)>. +See L<UI_add_input_boolean(3)>. UI_get0_result_string() is used to retrieve the result of a prompt. This is only useful for B<UIT_PROMPT> and B<UIT_VERIFY> type strings. _____ openssl-commits mailing list To unsubscribe: https://mta.openssl.org/mailman/listinfo/openssl-commits