bproc_nodestatus

Name

bproc_nodestatus -- Returns the status of the given node.

Synopsis

#include <sys/bproc.h>
int bproc_nodestatus (int node);

Arguments

node
The node number.

Description

This node argument should list one of the compute nodes, not the master. The master is considered to be always up.

Return Value

On error, it will return -1 and set errno appropriately.

The possible states are:

bproc_node_down
The node is not connected to the master daemon. It may be off or crashed or not far enough along in its boot process to connect to the master daemon.
bproc_node_unavailable
The node is running but is currently unavailable to users. Nodes are only in this state if set that way explicitly by the administrator.
bproc_node_error
There is a problem with the node. Nodes are assigned this state if booting is unsuccessful.
bproc_node_up
The node is up and ready to accept processes. This is the only state in which non-root users can send jobs to the node.
bproc_node_reboot
The node was told to reboot and has not come back up yet.
bproc_node_halt
The node was told to halt and is still down.
bproc_node_pwroff
The node was told to power off and is still down.
bproc_node_boot
The node is in the process of coming up (running the node_up script).

Errors

There was an I/O error.
ENOMEM
Out of memory error.