ls_sharedresourceinfo

Returns shared resource information in dynamic values.

ls_sharedresourceinfo returns the requested shared resource information in dynamic values. The result of this call is a chained data structure as defined in <lsf/lsf.h>, which contains requested information.

#include <lsf/lsf.h>
lsSharedResourceInfo *ls_sharedresourceinfo(
    char **resources,
    int *numResources, char *hostName,
    int options)

Parameters:

	**resources	resources is an array of NULL terminated strings storing requesting resource names. If set to NULL, the call returns all shared resources defined in the cluster.
	*numResources	numResources is an input/output parameter. On input it indicates how many resources are requested. Value 0 means requesting all shared resources. On return it contains qualified number of resources.
	*hostName	hostName is a string containing a host name. Only shared resource available on the specified host will be returned. If hostName is set to NULL, shared resource available on all hosts will be returned.
	options	options is reserved for future use. Currently, it should be set to 0.

Data Structures:

lsSharedResourceInfo
lsSharedResourceInstance

Define Statements:

none

Returns:

struct lsSharedResourceInfo *:A list of lsSharedResourceInfo structure.
Function was successful.

NULL
Function failed.

Errors:

If the function fails, lserrno is set to indicate the error.

Equivalent line commands:

none

Files:

$LSF_CONFDIR/lsf.shared
$LSF_CONFDIR/lsf.cluster.cluster_name

See also:

none