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 descriptive, 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/⟩