NAME    [Toc]    [Back]

       ERR_get_error,     ERR_peek_error,     ERR_get_error_line,
       ERR_peek_error_line,              ERR_get_error_line_data,
       ERR_peek_error_line_data - Obtain error code and data

SYNOPSIS    [Toc]    [Back]

       #include <openssl/err.h>

       unsigned long ERR_get_error(
               void ); unsigned long ERR_peek_error(
               void ); unsigned long ERR_get_error_line(
               unsigned  long  const  char  **file,  int *line );
       unsigned long ERR_peek_error_line(
               const char **file,  int  *line  );  unsigned  long
       ERR_get_error_line_data(
               const  char  **file, int *line, const char **data,
       int *flags ); unsigned long ERR_peek_error_line_data(
               const char **file, int *line, const  char  **data,
       int *flags );

DESCRIPTION    [Toc]    [Back]

       The  ERR_get_error()  function returns the last 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.

       The ERR_peek_error() function returns the last error  code
       from the thread's error queue without modifying it.

       See ERR_GET_LIB(3) for information about location and reason
 of the error, and ERR_error_string(3) for  human-readable
 error messages.

       The  ERR_get_error_line()  and ERR_peek_error_line() functions
 are the same as the above, but they also  store  the
       file  name  and  line  number  where the error occurred in
       *file and *line, unless these are NULL.

       The             ERR_get_error_line_data()              and
       ERR_peek_error_line_data() functions store additional data
       and flags associated with the  error  code  in  *data  and
       *flags, unless these are NULL. The *data contains a string
       if *flags&ERR_TXT_STRING.  If it  has  been  allocated  by
       OPENSSL_malloc(), *flags&ERR_TXT_MALLOCED is true.

RETURN VALUES    [Toc]    [Back]

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

HISTORY    [Toc]    [Back]

       The           ERR_get_error(),           ERR_peek_error(),
       ERR_get_error_line(), and ERR_peek_error_line()  functions
       are  available  in all versions of SSLeay and OpenSSL. The
       ERR_get_error_line_data()  and  ERR_peek_error_line_data()
       functions were added in SSLeay 0.9.0.

SEE ALSO    [Toc]    [Back]

       Functions: err(3), ERR_error_string(3), ERR_GET_LIB(3)



                                                 ERR_get_error(3)