beostat_is_node_available

Name

beostat_is_node_available – determine if a given user/group can run on a given node

Synopsis

#include <sys/beostat.h>
int beostat_is_node_available (int node, uid_t uid, gid_t *gid_list, int gid_size);

Arguments

node

The node of interest

uid

The user identifier number

gid_list

A pointer to a list of group identifier numbers

gid_size

The number of elements in the previous arguments array

Description

beostat_is_node_available executes on the master node and determines if the given user with specified UID and belonging to the groups in gid_list has permission to run on a given node.

See the manual page for beostat_get_avail_nodes_by_id for a example of a similar function.

Return Value

Returns 1 if the node can be used, 0 if not, and -1 if an error occurs.

Errors

This function relies on the Beostat subsystem, which consists of the proc filesystem on the remote node, the sendstats daemon on the remote node, the recvstats daemon on the master node, and two shared memory files in the directory /var/shm. If any part of the system breaks down, this function could fail.