lsb_getalloc

Allocates memory for a host list to be used for launching parallel tasks through blaunch and the lsb_launch API.

It is the responsibility of the caller to free the host list when it is no longer needed.On success, the host list will be a list of strings. Before freeing host list, the individual elements must be freed.

An application using the lsb_getalloc API is assumed to be part of an LSF job, and that LSB_MCPU_HOSTS is set in the environment.

#include <lsf/lsbatch.h>

int lsb_getalloc(char ***hostlist)

Parameters:

***hostlist

[OUT] A null-terminated list of host names

Data Structures:

none

Define Statements:

none

Returns:

> 0
Function was successful. Returns length of hostlist, not including the null last element.

< 0
Function failed.

Errors:

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

Equivalent line commands:

none

Files:

none

See also:

none