Knowledge Center         Contents    Previous  Next    
Platform Computing Corp.

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