PICL Plug-In Library Functions   picldpluginregister(3PICLTRE)



NAME
     picldpluginregister - register plug-in with the daemon

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

     int picldpluginregister(picldpluginregt  *regp);


DESCRIPTION
     The picldpluginregister() function is the function used by
     a  plug-in  module  to  register itself with the PICL daemon
     upon initialization. The plug-in provides its name  and  the
     entry  points  of the initialization and cleanup routines in
     the regp argument.

       typedef struct {
           int   version;               /* PICLDPLUGINVERSION */
           int   critical;              /* is plug-in critical? */
           char  *name;                 /* name of the plugin module */
           void  (*plugininit)(void);  /* init/reinit function */
           void  (*pluginfini)(void);  /* fini/cleanup function */
       } picldpluginregt;



     The plug-in module also specifies whether it is  a  critical
     module  for  the proper system operation. The critical field
     in    the    registration    information    is    set     to
     PICLDPLUGINONCRITICAL  by  plug-in  modules that are not
     critical   to   system   operation,   and    is    set    to
     PICLDPLUGINCRITICAL  by  plug-in modules that are critical
     to the system  operation.  An  environment  control  plug-in
     module  is  an  example  for a PICLDPLUGINCRITICAL type of
     plug-in module.


     The PICL daemon saves the information passed  during  regis-
     tration   in  regp  in  the  order  in  which  the  plug-ins
     registered.


     Upon   initialization,   the   PICL   daemon   invokes   the
     plugininit()  routine  of  each  of  the registered plug-in
     modules in the order in  which  they  registered.  In  their
     plugininit()  routines,  the  plug-in  modules  collect the
     platform configuration data and add  it  to  the  PICL  tree
     using PICLTRE interfaces (3PICLTRE).






SunOS 5.11          Last change: 19 Sep 2001                    1






PICL Plug-In Library Functions   picldpluginregister(3PICLTRE)



     On   reinitialization,   the   PICL   daemon   invokes   the
     pluginfini()  routines of the registered plug-in modules in
     the reverse order of registration. Then,  the  plugininit()
     entry  points  are  invoked  again in the order in which the
     plug-ins registered.

RETURN VALUES
     Upon successful completion, 0 is  returned.  On  failure,  a
     negative value is returned.

ERORS
     PICLNOTSUPORTED    Version not supported


     PICLFAILURE         General system failure


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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Evolving                    
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     libpicltree(3PICLTRE), attributes(5)





















SunOS 5.11          Last change: 19 Sep 2001                    2