cnodes(1)

NAME

cnodes − display information about specified cluster nodes

SYNOPSIS

cnodes [−almnrsxAC1] [name ...]

DESCRIPTION

cnodes displays information about the cluster nodes described in the /etc/clusterconf file for clustered systems. When no argument is given, all currently active cluster nodes in the cluster are listed. When one or more names are given, information about each named cluster node is displayed.

There are two major listing formats. The format chosen depends on whether the output is going to a terminal, and can also be controlled by option flags. The default format for a terminal is to list cluster node names in multi-column format. If the standard output is not a terminal, the default format is to list one cluster node per line.

In order to determine output formats for multi-column output, cnodes uses the environment variable COLUMNS to determine the number of character positions available on the output line. If this variable is not set, the terminfo(4) database is used to determine the number of columns, based on the environment variable TERM. If this information cannot be obtained, 80 columns is assumed.

Options

cnodes recognizes the following options:

−a List all specified cluster nodes, whether or not the nodes are clustered. If no name is given, cnodes lists all entries in the /etc/clusterconf file. Cluster nodes not currently clustered are displayed with an asterisk (∗) following the cluster node name.

−l List cluster nodes in long format, giving cluster node name, cnode ID, the cnode’s swap server, and whether or not the cnode is a cluster server. If the output is going to a terminal, a header is also displayed.

−m List information about the local cluster node only. If −m is specified, any name arguments are ignored.

−n List cluster node IDs instead of cluster node names.

−r Display information about the cluster server only. If −r is specified, any name arguments are ignored.

−s Suppress all output. This option is useful for testing the exit value.

−x Do not display information about the local cluster node.

−A Same as −a, except cluster nodes currently not clustered do not have an asterisk appended to their names.

−C Force multi-column output.

−1 Force single column output.

EXTERNAL INFLUENCES

Environment Variables

LANG determines the language in which messages are displayed.

If LANG is not specified or is set to the empty string, a default of "C" (see lang(5)) is used instead of LANG. If any internationalization variable contains an invalid setting, cnodes behaves as if all internationalization variables are set to "C". See environ(5).

RETURN VALUE

cnodes exits with a value of 0 if the local machine is a member of a cluster; 1 if not.

DIAGNOSTICS

cnodes writes Machine is not clustered to the standard error output if the specified machine is not currently a member of a cluster and neither the −a nor the −s option was specified.

Machine does not exist is written to the standard error output if the specified machine is not listed in /etc/clusterconf and −s was not specified.

AUTHOR

cnodes was developed by HP.

FILES

/etc/clusterconf

Museum

Related Articles