sg_clear_error(3) sets the error condition

Other Alias

sg_set_error, sg_set_error_with_errno, sg_set_error_with_errno_code

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.