Manual Pages for UNIX Operating System command usage for man scf_error

Service Configuration Facility Library Functions  scf_error(3SCF)



NAME
     scf_error, scf_strerror - error interface to Service  Confi-
     guration Facility

SYNOPSIS
     cc [ flag... ] file... -lscf [ library... ]
     #include 

     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 pre-
     vious 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, local-
     ized description of the error.


     The error values are as follows:

     SCF_ERROR_BACKEND_ACCESS

         The  storage  mechanism  that  the   repository   server
         (svc.configd(1M)) chose for the operation denied access.


     SCF_ERROR_BACKEND_READONLY

         The  storage  mechanism  that  the   repository   server
         (svc.configd)  chose for the operation is read-only. For
         the  local  filesystem  storage   mechanism   (currently
         /etc/svc/repository.db), this usually occurs because the
         filesystem that contains it is  mounted  read-only.  See
         mount(1M)


     SCF_ERROR_CONNECTION_BROKEN

         The connection to repository is broken.


     SCF_ERROR_CONSTRAINT_VIOLATED

         A required constraint was not met.



SunOS 5.11          Last change: 20 Aug 2007                    1






Service Configuration Facility Library Functions  scf_error(3SCF)



     SCF_ERROR_DELETED

         Object was deleted.


     SCF_ERROR_EXISTS

         The object already exists.


     SCF_ERROR_HANDLE_DESTROYED

         An object was bound to a destroyed handle.


     SCF_ERROR_HANDLE_MISMATCH

         Objects from different SCF handles were used.


     SCF_ERROR_IN_USE

         The object is currently in use.


     SCF_ERROR_INTERNAL

         An internal error occurred.


     SCF_ERROR_INVALID_ARGUMENT

         An argument is invalid.


     SCF_ERROR_NO_MEMORY

         No memory is available.


     SCF_ERROR_NO_RESOURCES

         The repository server is out of resources.


     SCF_ERROR_NO_SERVER

         The repository server is unavailable.


     SCF_ERROR_NONE




SunOS 5.11          Last change: 20 Aug 2007                    2






Service Configuration Facility Library Functions  scf_error(3SCF)



         No error occurred.


     SCF_ERROR_NOT_BOUND

         The handle is not bound.


     SCF_ERROR_NOT_FOUND

         Nothing of that name was found.


     SCF_ERROR_NOT_SET

         Cannot use unset value.


     SCF_ERROR_PERMISSION_DENIED

         The user  lacks  sufficient  authority  to  conduct  the
         requested operation. See smf_security(5).


     SCF_ERROR_TYPE_MISMATCH

         The type does not match value.


     SCF_ERROR_VERSION_MISMATCH

         The SCF version is incompatible.


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  attri-
     butes:












SunOS 5.11          Last change: 20 Aug 2007                    3






Service Configuration Facility Library Functions  scf_error(3SCF)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


SEE ALSO
     svc.configd(1M),        libscf(3LIB),         attributes(5),
     svc.configd(1M)











































SunOS 5.11          Last change: 20 Aug 2007                    4