NAME

       sg_set_error,  sg_set_error_with_errno,  sg_set_error_with_errno_code,  sg_clear_error  -  sets the error
       condition

SYNOPSIS

       #include <statgrab.h>

       sg_error sg_set_error (sg_error code, const char *arg);

       sg_error sg_set_error_with_errno (sg_error code, const char *arg);

       sg_error sg_set_error_with_errno_code (sg_error code, const char *arg, int errno_value);

       void sg_clear_error (void);

DESCRIPTION

       sg_set_error() sets the occurred error condition together with an argument. The argument is  usually  de‐
       scriptive, eg.  the file name which failed to open.

       sg_set_error_with_errno()  sets  the  occurred error condition together with an argument and the value of
       the system libraries errno value. The argument is  usually  descriptive,  eg.  the  name  of  the  failed
       sysctl() call.

       sg_set_error_with_errno_code()  sets  the occurred error condition together with an argument and an error
       value of a system library call which doesn't set the errno value (eg. the pthread_* calls). The  argument
       is usually descriptive, eg. the name of the mutex failed to get locked.

       sg_clear_error() clears the current error condition.

SEE ALSO

       statgrab(3)

WEBSITE

       ⟨https://libstatgrab.org/⟩

libstatgrab                                        2019-03-08                                    sg_set_error(3)