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)