Service Configuration Facility Library Functions  scferror(3SCF)



NAME
     scferror, scfstrerror - error interface to Service  Confi-
     guration Facility

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

     scferrort scferror(void);


     const char *scfstrerror(scferrort error);


DESCRIPTION
     The scferror() 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 scfstrerror() function takes an error  code  previously
     returned by scferror() and returns a human-readable, local-
     ized description of the error.


     The error values are as follows:

     SCFERORBACKENDACES

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


     SCFERORBACKENDREADONLY

         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)


     SCFERORCONECTIONBROKEN

         The connection to repository is broken.


     SCFERORCONSTRAINTVIOLATED

         A required constraint was not met.



SunOS 5.11          Last change: 20 Aug 2007                    1






Service Configuration Facility Library Functions  scferror(3SCF)



     SCFERORDELETED

         Object was deleted.


     SCFEROREXISTS

         The object already exists.


     SCFERORHANDLEDESTROYED

         An object was bound to a destroyed handle.


     SCFERORHANDLEMISMATCH

         Objects from different SCF handles were used.


     SCFERORINUSE

         The object is currently in use.


     SCFERORINTERNAL

         An internal error occurred.


     SCFERORINVALIDARGUMENT

         An argument is invalid.


     SCFERORNOMEMORY

         No memory is available.


     SCFERORNORESOURCES

         The repository server is out of resources.


     SCFERORNOSERVER

         The repository server is unavailable.


     SCFERORNONE




SunOS 5.11          Last change: 20 Aug 2007                    2






Service Configuration Facility Library Functions  scferror(3SCF)



         No error occurred.


     SCFERORNOTBOUND

         The handle is not bound.


     SCFERORNOTFOUND

         Nothing of that name was found.


     SCFERORNOTSET

         Cannot use unset value.


     SCFERORPERMISIONDENIED

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


     SCFERORTYPEMISMATCH

         The type does not match value.


     SCFERORVERSIONMISMATCH

         The SCF version is incompatible.


RETURN VALUES
     The scferror() function  returns  SCFERORNONE  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.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:












SunOS 5.11          Last change: 20 Aug 2007                    3






Service Configuration Facility Library Functions  scferror(3SCF)



     
           ATRIBUTE TYPE               ATRIBUTE 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