Go to main content

man pages section 3: Extended Library Functions, Volume 1

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

ERR_put_error (3openssl)

Name

ERR_put_error - record an error

Synopsis

#include <openssl/err.h>

void ERR_put_error(int lib, int func, int reason, const char *file,
int line);

void ERR_add_error_data(int num, ...);

Description

ERR_put_error(3openssl)             OpenSSL            ERR_put_error(3openssl)



NAME
       ERR_put_error, ERR_add_error_data - record an error

SYNOPSIS
        #include <openssl/err.h>

        void ERR_put_error(int lib, int func, int reason, const char *file,
                int line);

        void ERR_add_error_data(int num, ...);

DESCRIPTION
       ERR_put_error() adds an error code to the thread's error queue. It
       signals that the error of reason code reason occurred in function func
       of library lib, in line number line of file.  This function is usually
       called by a macro.

       ERR_add_error_data() associates the concatenation of its num string
       arguments with the error code added last.

       ERR_load_strings(3) can be used to register error strings so that the
       application can a generate human-readable error messages for the error
       code.

RETURN VALUES
       ERR_put_error() and ERR_add_error_data() return no values.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+--------------------------+
       |ATTRIBUTE TYPE |     ATTRIBUTE VALUE      |
       +---------------+--------------------------+
       |Availability   | library/security/openssl |
       +---------------+--------------------------+
       |Stability      | Pass-through uncommitted |
       +---------------+--------------------------+

SEE ALSO
       err(3), ERR_load_strings(3)

HISTORY
       ERR_put_error() is available in all versions of SSLeay and OpenSSL.
       ERR_add_error_data() was added in SSLeay 0.9.0.



NOTES
       Source code for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This software was built from source available at
       https://github.com/oracle/solaris-userland.  The original community
       source was downloaded from
       https://www.openssl.org/source/openssl-1.0.2ze.tar.gz.

       Further information about this software can be found on the open source
       community website at https://www.openssl.org/.



1.0.2ze                           2022-05-03           ERR_put_error(3openssl)