sun.com | docs.sun.com |  | How To Buy | My Sun | Worldwide Sites |

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 Interface | cmm_mastership_release(3CMM)

- NAME
- SYNOPSIS
- DESCRIPTION
- RETURN VALUES
- ATTRIBUTES
- SEE ALSO

## 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 TYPE | ATTRIBUTE VALUE
> --- | ---
> Architecture | SPARC
> Availability | SUNWnhcmd
> Interface Stability | Evolving
> MT-Level | MT-Safe
> Cancel-Safety | Deferred-Cancel-Safe Asynchronous-Cancel-Unsafe

## SEE ALSO

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

Netra HAS FS 2.1 | Go To Top | Last Changed September 2004

Company Info | Contact | Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.