Knowledge Center Contents Previous Next |
ls_sharedresourceinfo()
Returns shared resource information in dynamic values.
DESCRIPTION
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.
SYNOPSIS
#include <lsf/lsf.h> LS_SHARED_RESOURCE_INFO_T *ls_sharedresourceinfo( char **resources, int *numResources, char *hostName, int options) typedef struct lsSharedResourceInfo { /* resource name */ char *resourceName; /* number of instances */ int nInstances; /* pointer to the next instance */ LS_SHARED_RESOURCE_INST_T *instances; } LS_SHARED_RESOURCE_INFO_T; typedef struct lsSharedResourceInstance { /* Value associated with the resource */ char *value; int nHosts; /* Hosts associated with the resource. */ char **hostList; } LS_SHARED_RESOURCE_INST_T;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.
RETURN VALUES
pointer:array
The function was successful.
character:NULL
Function failed.
ERRORS
If the function fails, lserrno is set to indicate the error.
SEE ALSO
Related APIs
none
Equivalent line command
none
Files
$LSF_CONFDIR/lsf.shared
$LSF_CONFDIR/lsf.cluster.cluster_name
Platform Computing Inc.
www.platform.com |
Knowledge Center Contents Previous Next |