scf_error(3scf) [opendarwin man page]
scf_error(3SCF) Service Configuration Facility Library Functions scf_error(3SCF) NAME
scf_error, scf_strerror - error interface to Service Configuration Facility SYNOPSIS
cc [ flag... ] file... -lscf [ library... ] #include <libscf.h> scf_error_t scf_error(void); const char *scf_strerror(scf_error_t error); DESCRIPTION
The scf_error() function returns the current libscf(3LIB) error value for the current thread. If the immediately previous call to a libscf function failed, the error value will reflect the reason for that failure. The scf_strerror() function takes an error code previously returned by scf_error() and returns a human-readable, localized description of the error. The error values are as follows: SCF_ERROR_NONE No error occurred. SCF_ERROR_NOT_BOUND The handle is not bound. SCF_ERROR_NOT_SET Cannot use unset value. SCF_ERROR_DELETED Object was deleted. SCF_ERROR_NOT_FOUND Nothing of that name was found. SCF_ERROR_TYPE_MISMATCH The type does not match value. SCF_ERROR_IN_USE The object is currently in use SCF_ERROR_CONNECTION_BROKEN The connection to repository is broken. SCF_ERROR_INVALID_ARGUMENT An argument is invalid. SCF_ERROR_NO_MEMORY No memory is available. SCF_ERROR_CONSTRAINT_VIOLATED A required constraint was not met. SCF_ERROR_EXISTS The object already exists. SCF_ERROR_NO_SERVER The repository server is unavailable SCF_ERROR_NO_RESOURCES The repository server is out of resources SCF_ERROR_PERMISSION_DENIED There are insufficient privileges for action SCF_ERROR_BACKEND_ACCESS Backend refused access. SCF_ERROR_BACKEND_READONLY Backend is read-only. SCF_ERROR_HANDLE_MISMATCH Objects from different SCF handles were used. SCF_ERROR_HANDLE_DESTROYED An object was bound to a destroyed handle. SCF_ERROR_VERSION_MISMATCH The SCF version is incompatible. SCF_ERROR_INTERNAL An internal error occurred. RETURN VALUES
The scf_error() function returns SCF_ERROR_NONE if there have been no calls from libscf functions from the current thread. The return value is undefined if the immediately previous call to a libscf function did not fail. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Evolving | +-----------------------------+-----------------------------+ |MT-Level |MT-Safe | +-----------------------------+-----------------------------+ SEE ALSO
libscf(3LIB), attributes(5) SunOS 5.10 9 Sep 2004 scf_error(3SCF)
Check Out this Related Man Page
scf_error(3SCF) Service Configuration Facility Library Functions scf_error(3SCF) NAME
scf_error, scf_strerror - error interface to Service Configuration Facility SYNOPSIS
cc [ flag... ] file... -lscf [ library... ] #include <libscf.h> scf_error_t scf_error(void); const char *scf_strerror(scf_error_t error); DESCRIPTION
The scf_error() function returns the current libscf(3LIB) error value for the current thread. If the immediately previous call to a libscf function failed, the error value will reflect the reason for that failure. The scf_strerror() function takes an error code previously returned by scf_error() and returns a human-readable, localized description of the error. The error values are as follows: SCF_ERROR_NONE No error occurred. SCF_ERROR_NOT_BOUND The handle is not bound. SCF_ERROR_NOT_SET Cannot use unset value. SCF_ERROR_DELETED Object was deleted. SCF_ERROR_NOT_FOUND Nothing of that name was found. SCF_ERROR_TYPE_MISMATCH The type does not match value. SCF_ERROR_IN_USE The object is currently in use SCF_ERROR_CONNECTION_BROKEN The connection to repository is broken. SCF_ERROR_INVALID_ARGUMENT An argument is invalid. SCF_ERROR_NO_MEMORY No memory is available. SCF_ERROR_CONSTRAINT_VIOLATED A required constraint was not met. SCF_ERROR_EXISTS The object already exists. SCF_ERROR_NO_SERVER The repository server is unavailable SCF_ERROR_NO_RESOURCES The repository server is out of resources SCF_ERROR_PERMISSION_DENIED There are insufficient privileges for action SCF_ERROR_BACKEND_ACCESS Backend refused access. SCF_ERROR_BACKEND_READONLY Backend is read-only. SCF_ERROR_HANDLE_MISMATCH Objects from different SCF handles were used. SCF_ERROR_HANDLE_DESTROYED An object was bound to a destroyed handle. SCF_ERROR_VERSION_MISMATCH The SCF version is incompatible. SCF_ERROR_INTERNAL An internal error occurred. RETURN VALUES
The scf_error() function returns SCF_ERROR_NONE if there have been no calls from libscf functions from the current thread. The return value is undefined if the immediately previous call to a libscf function did not fail. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Evolving | +-----------------------------+-----------------------------+ |MT-Level |MT-Safe | +-----------------------------+-----------------------------+ SEE ALSO
libscf(3LIB), attributes(5) SunOS 5.10 9 Sep 2004 scf_error(3SCF)