Manual Pages for UNIX Operating System command usage for man wsreg_set_parent

Product Install Registry Library Functions
                                         wsreg_set_parent(3WSREG)



NAME
     wsreg_set_parent, wsreg_get_parent - set or get  the  parent
     of a component

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

     void wsreg_set_parent(Wsreg_component *comp,
          const Wsreg_component *parent);


     Wsreg_component *wsreg_get_parent(const Wsreg_component *comp);


DESCRIPTION
     The wsreg_set_parent() function sets the parent specified by
     parent of the component specified by comp.


     The wsreg_get_parent() function gets the parent of the  com-
     ponent specified by comp.

RETURN VALUES
     The wsreg_get_parent()  function  returns  a  pointer  to  a
     Wsreg_component  structure that represents the parent of the
     specified component.  If the specified  component  does  not
     have  a  parent,  NULL  is returned.  If a non-null value is
     returned, it the  caller's  responsibility  to  release  the
     memory associated with the resulting Wsreg_component pointer
     with    a    call     to     wsreg_free_component().     See
     wsreg_create_component(3WSREG).

USAGE
     The parent of a component is set as a result of  registering
     the parent component.  When a component that has children is
     registered, all of  the  child  components  are  updated  to
     reflect  the  newly  registered  component  as their parent.
     This update only occurs if  the  child  component  does  not
     already have a parent component set.


     The specified parent component is reduced to  a  lightweight
     component  reference  that uniquely identifies the parent in
     the product install registry.   This  lightweight  reference
     includes the parent's uuid and instance number.


     The  parent  must   be   registered   before   a   call   to
     wsreg_set_parent()  can be made, since the parent's instance
     number must be known  at  the  time  the  wsreg_set_parent()



SunOS 5.11          Last change: 22 Sep 2000                    1






Product Install Registry Library Functions
                                         wsreg_set_parent(3WSREG)



     function is called.


     A   process   needing   to   call   wsreg_set_parent()    or
     wsreg_get_parent()  must  have  read  access  to the product
     install registry.

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



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | Unsafe                      |
    |_____________________________|_____________________________|


SEE ALSO
     wsreg_can_access_registry(3WSREG),
     wsreg_create_component(3WSREG),    wsreg_initialize(3WSREG),
     wsreg_register(3WSREG),  wsreg_set_instance(3WSREG),  attri-
     butes(5)





























SunOS 5.11          Last change: 22 Sep 2000                    2






Product Install Registry Library Functions
                                         wsreg_set_parent(3WSREG)






















































SunOS 5.11          Last change: 22 Sep 2000                    3