Series 300 Diskless Only

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.  When no argument is given, all currently active cluster nodes in the cluster are listed.  When one or more name is 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 may 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 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

The options are as follows:

−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 root 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’s root 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 will not have an asterisk appended to their names. 

−C Force multi-column output. 

−1 Force single column output. 

RETURN VALUE

Cnodes exits with a value of 0 if the local machine is a member of a cluster, and 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

SEE ALSO

ccck(1M), cnodeid(2), cnodes(2), terminfo(4), clusterconf(4). 

Hewlett-Packard Company  —  May 11, 2021