lsb_userinfo

Returns the maximum number of job slots that a user can use simultaneously on any host and in the whole local LSF cluster.

lsb_userinfo gets the maximum number of job slots that a user can use simultaneously on any host and in the whole local LSF cluster, as well as the current number of job slots used by running and suspended jobs or reserved for pending jobs. The maximum numbers of job slots are defined in the LSF configuration file lsb.users (see lsb.users). The reserved user name default, defined in the lsb.users configuration file, matches users not listed in the lsb.users file who have no jobs started in the system.

The returned array will be overwritten by the next call.

#include <lsf/lsbatch.h>

struct userInfoEnt *lsb_userinfo(char **users, int *numUsers)

Parameters:

	**users	An array of user names.
	*numUsers	The number of user names. To get information about all users, set *numUsers = 0; *numUsers will be updated to the actual number of users when this call returns. To get information on the invoker, set users = NULL, *numUsers = 1.

Data Structures:

userInfoEnt

Define Statements:

none

Returns:

struct userInfoEnt *: A static pointer to a struct userInfoEnt.
The function was successful, and *numUsers is set to the number of userInfoEnt structures returned.

NULL
Function failed.

Errors:

If the function fails, lsberrno is set to indicate the error. If lsberrno is LSBE_BAD_USER, (*users)[*numUsers] is not a user known to the LSF system. Otherwise, if *numUsers is less than its original value, *numUsers is the actual number of users found.

Equivalent line commands:

busers

Files:

$LSB_CONFDIR/cluster_name/configdir/lsb.users

See also:

lsb_hostinfo

lsb_queueinfo