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

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

## NAME

> cmm_config_reload - reload the cluster node table

## SYNOPSIS

>     cc [ flag... ] file...  lcgha_cmm  -lrt

>     #include <cmm.h>

> `cmm_error_t cmm_config_reload( );`

## DESCRIPTION

> The cmm_config_reload() function forces the `nhcmmd`(1M) daemon to reload the cluster node table. When a node is added to or removed from this table, the `nhcmmd` daemon must be informed. There are two ways to inform the `nhcmmd` daemon of the changes to the cluster node table: call the cmm_config_reload() function or type one of the following:

> >     pkill  -HUP nhcmmd
> >     nhcmmstat--creload

> >     kill  -HUP <CMM process Id>

> This function can only be called from the master node. If it is called from a non-master node it returns a `CMM_EPERM` error. As a result of this call, notifications are sent indicating the modifications occurring in the cluster because of the new configuration read from the cluster node table. See the Netra High Availability Suite Foundation Services 2.1 6/03 CMM Programming Guide for information on notifications. The supported operations are add a node and remove a node, with the node powered off. The attributes of a node must not be changed.

> To remove a node from the cluster, ensure that the node is powered off before changing the cluster nodes table. Only after a node has been powered off should you perform a cmm_config_reload().

## RETURN VALUES

> The cmm_config_reload() 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_ECONN`

>   No `nhcmmd` is accessible on the current node.

> `CMM_ENOCLUSTER`

>   Calling node is not yet in a cluster.

> `CMM_ENOTSUP`

>   Unexpected service error.

> `CMM_EPERM`

>   Permission denied. The function was not called from the master node.

> `CMM_ETIMEDOUT`

>   The call 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), `nhcmmd`(1M)

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.