lsb_hostinfo

Returns information about job server hosts.

#include <lsf/lsbatch.h>

struct hostInfoEnt *lsb_hostinfo(char **hosts, int *numHosts)

Parameters:

	**hosts	An array of host or cluster names.
	*numHosts	The number of host names. To get information on all hosts, set *numHosts to 0; *numHosts will be set to the actual number of hostInfoEnt structures when this call returns. If *numHosts is 1 and hosts is NULL, information on the local host is returned.

Data Structures:

hostInfoEnt

Define Statements:

host_status
host_load_BusyReason
host_attributes

Returns:

struct hostInfoEnt *:
An array of hostInfoEnt structures which hold the host information and sets *numHosts to the number of hostInfoEnt structures.
Function was successful.

struct hostInfoEnt *:NULL
Function failed.

Errors:

If the function fails, lsberrno is set to indicate the error. If lsberrno is LSBE_BAD_HOST, (*hosts)[*numHosts] is not a host known to the batch system. Otherwise, if *numHosts is less than its original value, *numHosts is the actual number of hosts found.

Equivalent line commands:

bhosts

Files:

$LSB_CONFDIR/cluster_name/configdir/lsb.hosts

See also:

lsb_hostinfo_ex

ls_info

ls_loadofhosts

lsb_queueinfo

lsb_userinfo