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.