osf1 man page for versw

Query: versw

OS: osf1

Section: 3

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

versw(3)						     Library Functions Manual							  versw(3)

NAME
versw, VERSW - Check the status of an operating system version switch on a single cluster member to determine whether the calling applica- tion can enable new features that are incompatible with the old version of the operating system
LIBRARY
Standard C Library (libc.so, libc.a)
SYNOPSIS
#include <sys/versw.h> #include <sys/clu.h> int VERSW(); int versw ( ulong high_vers, ulong low_vers );
PARAMETERS
Most significant ulong of new version ID. Least significant ulong of new version ID.
DESCRIPTION
The VERSW() macro and versw() function check the status of a version switch on a single cluster member to determine whether the calling application can enable new features that are incompatible with the old version of the operating system. Applications can use the VERSW() macro to enable new features on cluster members participating in a rolling upgrade. The versw() function examines the versw_transition attribute of the generic subsystem of the member's /etc/sysconfigtab file 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. The VERSW() macro provides a wrapper for the versw() function. Because the VERSW() macro automatically extracts the high and low version values from /usr/sys/conf/version.id, we recommend that you use it rather than call the versw() function directly.
RETURN VALUES
Upon completion, the VERSW() macro and versw() function return one of the following values: A version switch is in progress and the speci- fied new version is greater than the active version of the running kernel. The calling application should disable new, incompatible fea- tures and respond to all requests for such features with an error condition. 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. The application can safely enable, and entertain requests for, all new features. A version switch is in progress and the specified new version is greater than the active version of the running kernel. The application should disable new, incompatible features. Although the application should respond to all requests for such features originating on the local member with an error condition, it should be prepared to handle requests for new, incompatible features originating from other clus- ter members with grace and elan.
EXAMPLES
#include <stdio.h> #include <sys/versw.h> #include <sys/clu.h> main() { if(VERSW() == VERSW_ENABLE) printf("Enable new features "); else printf("Disable new features "); endif }
FILES
Rolling upgrade blocking conditions directory. Version switch header file. High and low version values used by VERSW() macro.
RELATED INFORMATION
Functions: clu_is_member(3), clu_get_info(3) Commands: versw(8) delim off versw(3)
Related Man Pages
feature(3perl) - debian
clu_get_info(3) - osf1
clu_get_memb_by_name(3) - osf1
clu_get_info(8) - osf1
feature5.12(3pm) - osx
Similar Topics in the Unix Linux Community
iPhoto '09: Some features may not work after installing Safari 4