Manual Pages for UNIX Operating System command usage for man wsreg_get_compatible_versions

Product Install Registry Library Functions
                             wsreg_add_compatible_version(3WSREG)



NAME
     wsreg_add_compatible_version,
     wsreg_remove_compatible_version,
     wsreg_get_compatible_versions - add or  remove  a  backward-
     compatible version

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

     int wsreg_add_compatible_version(Wsreg_component *comp,
          const char *version);


     int wsreg_remove_compatible_version(Wsreg_component *comp,
          const char *version);


     char **wsreg_get_compatible_versions(const Wsreg_component *comp);


DESCRIPTION
     The wsreg_add_compatible_version() function adds the version
     string  specified  by  version  to  the  list  of  backward-
     compatible versions contained in the component specified  by
     comp.


     The wsreg_remove_compatible_version() function  removes  the
     version  string  specified  by  version  from  the  list  of
     backward-compatible  versions  contained  in  the  component
     specified by comp.


     The  wsreg_get_compatible_versions()  function  returns  the
     list  of  backward-compatible versions contained in the com-
     ponent specified by comp.

RETURN VALUES
     The wsreg_add_compatible_version() function returns  a  non-
     zero  value if the specified backward-compatible version was
     successfully added; otherwise, 0 is returned.


     The  wsreg_remove_compatible_version()  function  returns  a
     non-zero  value if the specified backward-compatible version
     was successfully removed; otherwise, 0 is returned.


     The  wsreg_get_compatible_versions()  function   returns   a
     null-terminated  array  of char pointers that represents the



SunOS 5.11          Last change: 22 Sep 2000                    1






Product Install Registry Library Functions
                             wsreg_add_compatible_version(3WSREG)



     specified component's list of backward-compatible  versions.
     If  the  specified  component  has no such versions, NULL is
     returned.  The resulting array  and  its  contents  must  be
     released by the caller.

USAGE
     The list of backward compatible versions is  used  to  allow
     components  that  are  used  by multiple products to upgrade
     successfully without compromising any of its dependent  pro-
     ducts.  The installer that installs such an update can check
     the list of backward-compatible versions and  look  at  what
     versions  are required by all of the dependent components to
     ensure that the upgrade will not result in a broken product.

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



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


SEE ALSO
     prodreg(1M),                       wsreg_initialize(3WSREG),
     wsreg_register(3WSREG),   wsreg_set_version(3WSREG),  attri-
     butes(5)























SunOS 5.11          Last change: 22 Sep 2000                    2






Product Install Registry Library Functions
                             wsreg_add_compatible_version(3WSREG)






















































SunOS 5.11          Last change: 22 Sep 2000                    3