[openssl-commits] [openssl] OpenSSL_1_1_0-stable update

[Rich Salz]

The branch OpenSSL_1_1_0-stable has been updated
       via  201eb73cfdbdb744a8ef767e481ac42436650f41 (commit)
      from  d63f25ff84740b4fd955bc2de4bb5f55b9d79adf (commit)


- Log -----------------------------------------------------------------
commit 201eb73cfdbdb744a8ef767e481ac42436650f41
Author: Rich Salz <rsalz at 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 <levitte at openssl.org>
    (Merged from https://github.com/openssl/openssl/pull/2999)
    (cherry picked from commit 2ca2e9175d54dc66a66fe2a51ff5dd9b3bc899dc)

-----------------------------------------------------------------------

Summary of changes:
 doc/crypto/BIO_printf.pod | 50 +++++++++++++++++++++++++++++++++++++++++++++++
 doc/crypto/UI_STRING.pod  |  2 +-
 2 files changed, 51 insertions(+), 1 deletion(-)
 create mode 100644 doc/crypto/BIO_printf.pod

diff --git a/doc/crypto/BIO_printf.pod b/doc/crypto/BIO_printf.pod
new file mode 100644
index 0000000..8045b64
--- /dev/null
+++ b/doc/crypto/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/crypto/UI_STRING.pod b/doc/crypto/UI_STRING.pod
index abd2cfc..12d5a40 100644
--- a/doc/crypto/UI_STRING.pod
+++ b/doc/crypto/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.