Index for Section 3

Alphabetical listing for V

Bottom of page

versw(3)
NAME
  versw - Checks the status of an operating system version switch on a single
  cluster member to determine whether the calling application can enable new
  features that are incompatible with the old version.

LIBRARY
  Standard C Library (libc.so, libc.a)

SYNOPSIS
  #include <sys/versw.h>

  #include <sys/clu.h>

  int versw (
	  ulong high_vers,
	  ulong low_vers );

PARAMETERS
  high_vers Most significant ulong of new version ID.


  low_vers  Least significant ulong of new version ID.

DESCRIPTION
  The versw function checks the status of an operating system version switch
  on a single cluster member to determine whether the calling application can
  enable new features that are incompatible with the old version.
  Applications use the versw function to enable new features on cluster
  members participating in a rolling upgrade.

  The versw function examines the versw_transition kernel attribute of the
  generic subsystem and compares the specified high_vers and low_vers
  parameters to the new version of the running kernel. It then compares these
  parameters to the active version of the running kernel.

RETURN VALUES
  Upon completion, the versw function returns one of the following values:

  VERSW_DISABLE
	    A version switch is in progress and the specified new version is
	    greater than the active version of the running kernel.
	    Applications should disable new, incompatible functionality and
	    respond to all requests for such functionality with an error
	    condition.

  VERSW_ENABLE
	    A version switch is in progess and the specified new version is
	    less than or equal to new version of the running kernel, or a
	    version switch is not in progress and the specified new version
	    is less than or equal to the active version of the running
	    kernel. It is safe for applications to enable, and entertain
	    requests for, all new functionality.

  VERSW_TRANSITION
	    A version switch is in progress  and the specified new version is
	    greater than the active version of the running kernel.
	    Applications should disable new, incompatible functionality.
	    Although applications should respond to all requests for such
	    functionality originating on the local member with an error
	    condition, they should be prepared to handle requests for new,
	    incompatible functions originating from other cluster members
	    with grace and elan.

FILES
  /var/adm/versw
	    Rolling upgrade blocking conditions directory.

RELATED INFORMATION
  Functions: clu_is_member(3), clu_get_info(3)

  Commands: versw(8)

Index for Section 3

Alphabetical listing for V

Top of page