Sun Microsystems Logo
Products and Services
 
Support and Training
 
 

A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X  Y  Z  
 
Program Interfacecmm_mastership_release(3CMM)


NAME

 cmm_mastership_release - trigger a switchover

SYNOPSIS

 
cc [ flag... ] file...  -lcgha_cmm  -lrt
 
#include <cmm.h>
cmm_error_t cmm_mastership_release( );

DESCRIPTION

The cmm_mastership_release() function triggers a switchover. This function must be called from the master node. If a service or application attempts to call this function from another node, CMM_EPERM is returned.

If the vice-master node is qualified to be master when cmm_mastership_release() is called, then this node becomes master. The calling node remains master until the vice-master node has taken the master role.

If no node is qualified to become master when the cmm_mastership_release() function is called, CMM_ECANCELED is returned.

See the Netra High Availability Suite Foundation Services 2.1 6/03 CMM Programming Guide for information on the notifications returned in different scenarios.

Any program on the master node can execute this function. No authentication is performed.

RETURN VALUES

The cmm_mastership_release() function returns one of the following values:

CMM_EBUSY

The CMM API server is temporarily out of resources to respond to the requested operation. The recommended action is to wait a short time and retry the operation. The length of the waiting must be decided by the user, depending on the application's characteristics.

CMM_ECANCELED

Operation cancelled. There was no vice-master to take the master role.

CMM_ECONN

No nhcmmd is currently accessible on the local node.

CMM_ENOCLUSTER

Not in cluster.

CMM_ENOTSUP

An unexpected service error occurred.

CMM_EPERM

Permission denied as the function was not called from a master node.

CMM_ETIMEDOUT

The timeout expired before the action was completed.

CMM_OK

Operation succeeds.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
ArchitectureSPARC
AvailabilitySUNWnhcmd
Interface StabilityEvolving
MT-LevelMT-Safe
Cancel-SafetyDeferred-Cancel-Safe Asynchronous-Cancel-Unsafe

SEE ALSO

Intro(3CMM), cmm_membership_remove(3CMM), cmm_member_setqualif(3CMM)


Netra HAS FS 2.1Go To TopLast Changed September 2004