Manual Pages for UNIX Operating System command usage for man wsreg_initialize

Product Install Registry Library Functions
                                         wsreg_initialize(3WSREG)



NAME
     wsreg_initialize - initialize wsreg library

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

     int wsreg_initialize(Wsreg_init_level level, const char *alternate_root);


DESCRIPTION
     The  wsreg_initialize()  function  initializes   the   wsreg
     library.


     The level argument can be one of the following:

     WSREG_INIT_NORMAL           If  an  old  registry  file   is
                                 present,  attempt  to  perform a
                                 conversion.


     WSREG_INIT_NO_CONVERSION    If an  old  conversion  file  is
                                 present,   do  not  perform  the
                                 conversion,  but  indicate  that
                                 the conversion is recommended.



     The alternate_root argument can be used to  specify  a  root
     prefix.  If NULL is specified, no root prefix is used.

RETURN VALUES
     The wsreg_initialize() function can return one of  the  fol-
     lowing:

     WSREG_SUCCESS

         The  initialization  was  successful  and  no   registry
         conversion is necessary.


     WSREG_CONVERSION_RECOMMENDED

         An old registry file exists and should be converted.



     A conversion is attempted  if  the  init_level  argument  is
     WSREG_INIT_NORMAL  and  a registry file from a previous ver-
     sion  of  the  product  install  registry  exists.   If  the



SunOS 5.11          Last change: 22 Sep 2000                    1






Product Install Registry Library Functions
                                         wsreg_initialize(3WSREG)



     wsreg_initialize()              function             returns
     WSREG_CONVERSION_RECOMMENDED, the user either does not  have
     permission  to  update  the product install registry or does
     not have read/write access to the previous registry file.

USAGE
     The wsreg_initialize() function must be  called  before  any
     other wsreg library functions.


     The registry conversion can take some time to complete.  The
     registry  conversion can also be performed using the graphi-
     cal registry viewer /usr/bin/prodreg or by the registry con-
     verter /usr/bin/regconvert.

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



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


SEE ALSO
     prodreg(1M),    wsreg_can_access_registry(3WSREG),    attri-
     butes(5)























SunOS 5.11          Last change: 22 Sep 2000                    2






Product Install Registry Library Functions
                                         wsreg_initialize(3WSREG)






















































SunOS 5.11          Last change: 22 Sep 2000                    3