ERRerrorstring(3) OpenSSL ERRerrorstring(3)

NAME
       ERRerrorstring, ERRerrorstringn, ERRliberrorstring,
       ERRfuncerrorstring, ERRreasonerrorstring - obtain human-readable
       error message

SYNOPSIS
        #include 

        char *ERRerrorstring(unsigned long e, char *buf);
        void ERRerrorstringn(unsigned long e, char *buf, sizet len);

        const char *ERRliberrorstring(unsigned long e);
        const char *ERRfuncerrorstring(unsigned long e);
        const char *ERRreasonerrorstring(unsigned long e);

DESCRIPTION
       ERRerrorstring() generates a human-readable string representing the
       error code e, and places it at buf. buf must be at least 120 bytes
       long. If buf is NNUULLLL, the error string is placed in a static buffer.
       ERRerrorstringn() is a variant of ERRerrorstring() that writes at
       most len characters (including the terminating 0) and truncates the
       string if necessary.  For ERRerrorstringn(), buf may not be NNUULLLL.

       The string will have the following format:

        error:[error code]:[library name]:[function name]:[reason string]

       error code is an 8 digit hexadecimal number, library name, function
       name and reason string are ASCII text.

       ERRliberrorstring(), ERRfuncerrorstring() and
       ERRreasonerrorstring() return the library name, function name and
       reason string respectively.

       The OpenSSL error strings should be loaded by calling
       ERRloadcryptostrings(3) or, for SSL applications,
       SSLloaderrorstrings(3) first.  If there is no text string registered
       for the given error code, the error string will contain the numeric
       code.

       ERRprinterrors(3) can be used to print all error codes currently in
       the queue.

RETURN VALUES
       ERRerrorstring() returns a pointer to a static buffer containing the
       string if buf ==== NNUULLLL, buf otherwise.

       ERRliberrorstring(), ERRfuncerrorstring() and
       ERRreasonerrorstring() return the strings, and NNUULLLL if none is
       registered for the error code.

SEE ALSO
       err(3), ERRgeterror(3), ERRloadcryptostrings(3),
       SSLloaderrorstrings(3) ERRprinterrors(3)

HISTORY       ERRerrorstring() is available in all versions of SSLeay and OpenSSL.
       ERRerrorstringn() was added in OpenSSL 0.9.6.



0.9.7l                            2004-11-14               ERRerrorstring(3)