This node argument should list one of the slave nodes, not the master. The master is considered to be always up.
On error, it will return -1 and set errno appropriately.
The possible states are:
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.
The node is running but is currently unavailable to users. Nodes are only in this state if set that way explicitly by the administrator.
There is a problem with the node. Nodes are assigned this state if booting is unsuccessful.
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.
The node was told to reboot and has not come back up yet.
The node was told to halt and is still down.
The node was told to poweroff and is still down.
The node is in the process of coming up (running the node_up script).