ERRgeterror(3) OpenSSL ERRgeterror(3)

NAME
       ERRgeterror, ERRpeekerror, ERRpeeklasterror, ERRgeterrorline,
       ERRpeekerrorline, ERRpeeklasterrorline, ERRgeterrorlinedata,
       ERRpeekerrorlinedata, ERRpeeklasterrorlinedata - obtain error
       code and data

SYNOPSIS
        #include 

        unsigned long ERRgeterror(void);
        unsigned long ERRpeekerror(void);
        unsigned long ERRpeeklasterror(void);

        unsigned long ERRgeterrorline(const char **file, int *line);
        unsigned long ERRpeekerrorline(const char **file, int *line);
        unsigned long ERRpeeklasterrorline(const char **file, int *line);

        unsigned long ERRgeterrorlinedata(const char **file, int *line,
                const char **data, int *flags);
        unsigned long ERRpeekerrorlinedata(const char **file, int *line,
                const char **data, int *flags);
        unsigned long ERRpeeklasterrorlinedata(const char **file, int *line,
                const char **data, int *flags);

DESCRIPTION
       ERRgeterror() returns the earliest error code from the thread's error
       queue and removes the entry. This function can be called repeatedly
       until there are no more error codes to return.

       ERRpeekerror() returns the earliest error code from the thread's
       error queue without modifying it.

       ERRpeeklasterror() returns the latest error code from the thread's
       error queue without modifying it.

       See ERRGETLIB(3) for obtaining information about location and reason
       of the error, and ERRerrorstring(3) for human-readable error
       messages.

       ERRgeterrorline(), ERRpeekerrorline() and
       ERRpeeklasterrorline() are the same as the above, but they
       additionally store the file name and line number where the error
       occurred in *ffiillee and *lliinnee, unless these are NNUULLLL.

       ERRgeterrorlinedata(), ERRpeekerrorlinedata() and
       ERRgetlasterrorlinedata() store additional data and flags
       associated with the error code in *ddaattaa and *ffllaaggss, unless these are
       NNUULLLL. *ddaattaa contains a string if *ffllaaggss&EERRRRTTXXTTSSTTRRIINNGG. If it has been
       allocated by OPENSSLmalloc(), *ffllaaggss&EERRRRTTXXTTMMAALLLLOOCCEEDD is true.

RETURN VALUES
       The error code, or 0 if there is no error in the queue.

SEE ALSO
       err(3), ERRerrorstring(3), ERRGETLIB(3)

HISTORY       ERRgeterror(), ERRpeekerror(), ERRgeterrorline() and
       ERRpeekerrorline() are available in all versions of SSLeay and
       OpenSSL. ERRgeterrorlinedata() and ERRpeekerrorlinedata() were
       added in SSLeay 0.9.0.  ERRpeeklasterror(),
       ERRpeeklasterrorline() and ERRpeeklasterrorlinedata() were
       added in OpenSSL 0.9.7.



0.9.7l                            2002-11-29                  ERRgeterror(3)