wsreg_add_compatibProductiInstallERegistrywsreg_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 <wsreg.h>
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 con‐
tained 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 ver‐
sions contained in the component specified by comp.
The wsreg_get_compatible_versions() function returns the list of back‐
ward-compatible versions contained in the component 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; oth‐
erwise, 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 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 com‐
promising any of its dependent products. 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 attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │Unsafe │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOprodreg(1M), wsreg_initialize(3WSREG), wsreg_register(3WSREG),
wsreg_set_version(3WSREG), attributes(5)SunOS 5.10 22 Sep 2wsreg_add_compatible_version(3WSREG)