Service Configuration Facility Library Functions
                                           scfentrycreate(3SCF)



NAME
     scfentrycreate,    scfentryhandle,    scfentrydestroy,
     scfentrydestroychildren,                 scfentryreset,
     scfentryaddvalue - create and manipulate  transaction  in
     the Service Configuration Facility

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

     scftransactionentryt *scfentrycreate(scfhandlet *handle);


     scfhandlet *scfentryhandle(scftransactionentryt *entry);


     void scfentrydestroy(scftransactionentryt *entry);


     void scfentrydestroychildren(scftransactionentryt *entry);


     void scfentryreset(scftransactionentryt *entry);


     int scfentryaddvalue(scftransactionentryt *entry,
          scfvaluet *value);


DESCRIPTION
     The scfentrycreate() function allocates a new  transaction
     entry  handle. The scfentrydestroy() function destroys the
     transaction entry handle.


     The scfentryhandle() function retrieves the handle associ-
     ated with entry.


     A transaction entry represents a single action on a property
     in  a  property group. If an entry is added to a transaction
     using                    scftransactionpropertynew(3SCF),
     scftransactionpropertychange(3SCF),                    or
     scftransactionpropertychangetype(3SCF),
     scfentryaddvalue()  can  be  called zero or more times to
     set up the set of values for that property. Each value  must
     be  set and of a compatible type to the type associated with
     the entry. When  later  retrieved  from  the  property,  the
     values  will  have  the type of the entry. If the values are
     committed  successfully  with  scftransactioncommit(3SCF),
     they  will be set in the order in which they were added with



SunOS 5.11          Last change: 17 Jul 2008                    1






Service Configuration Facility Library Functions
                                           scfentrycreate(3SCF)



     scfentryaddvalue().


     The scfentryreset() function resets a  transaction  entry,
     disassociating  it  from  any  transaction  it  is a part of
     (invalidating the transaction in the process), and  disasso-
     ciating any values that were added to it.


     The  scfentrydestroychildren()  function   destroys   all
     values  associated  with  the  transaction  entry. The entry
     itself is not destroyed.

RETURN VALUES
     Upon successful completion, scfentrycreate() returns a new
     scftransactionentryt. Otherwise, it returns NUL.


     Upon successful completion, scfentryhandle()  returns  the
     handle  associated with the transaction entry. Otherwise, it
     returns NUL.


     Upon successful completion, scfentryaddvalue() returns 0.
     Otherwise, it returns -1.

ERORS
     The scfentrycreate() function will fail if:

     SCFERORINVALIDARGUMENT    The handle argument is NUL.


     SCFERORNOMEMORY           There is not enough memory  to
                                   allocate                    an
                                   scftransactionentryt.



     The scfentryhandle() function will fail if:

     SCFERORHANDLEDESTROYED    The  handle  associated   with
                                   entry has been destroyed.



     The scfentryaddvalue() function will fail if:

     SCFERORHANDLEMISMATCH     The value and entry  arguments
                                   are  not derived from the same
                                   handle.




SunOS 5.11          Last change: 17 Jul 2008                    2






Service Configuration Facility Library Functions
                                           scfentrycreate(3SCF)



     SCFERORINUSE              The value has  been  added  to
                                   another entry.


     SCFERORINTERNAL            An internal error occurred.


     SCFERORINVALIDARGUMENT    The value argument is not set,
                                   or  the entry was added to the
                                   transaction              using
                                   scftransactionpropertydelete(3SCF).


     SCFERORNOTSET             The transaction entry  is  not
                                   associated with a transaction.


     SCFERORTYPEMISMATCH       The type of the value argument
                                   does  not  match the type that
                                   was         set          using
                                   scftransactionpropertynew(),
                                   scftransactionpropertychange(),
                                   or
                                   scftransactionpropertychangetype().



     The  scferror(3SCF)  function  can  be used to retrieve the
     error value.

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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Committed                   
    
     MT-Level                     Safe                        
    


SEE ALSO
     libscf(3LIB), scferror(3SCF), scftransactioncommit(3SCF),
     scftransactionpropertychange(3SCF),
     scftransactionpropertychangetype(3SCF),
     scftransactionpropertydelete(3SCF),
     scftransactionpropertynew(3SCF),



SunOS 5.11          Last change: 17 Jul 2008                    3






Service Configuration Facility Library Functions
                                           scfentrycreate(3SCF)



     scftransactionreset(3SCF), attributes(5)





















































SunOS 5.11          Last change: 17 Jul 2008                    4






Service Configuration Facility Library Functions
                                           scfentrycreate(3SCF)






















































SunOS 5.11          Last change: 17 Jul 2008                    5