lsb_getallocFromHhostfile

Read the specified hostfile and return the host list.

If path is NULL then read the hostfile specified by LSB_DJOB_HOSTFILE. The hostfile is assumed to be in simple format of one host per line. A host can be repeated.

This function will allocate the memory for hostlist. It is the responsibility of the caller to free the lists when no longer needed. On success hostlist will be a list of strings. Before freeing hostlist the individual elements must be freed.

#include <lsf/lsbatch.h>

int lsb_getallocFromHhostfile(char ***hostlist, char *path)

Parameters:

	***hostlist	[OUT] A null-terminated list of host names
	*path	[IN] path to hostfile, if NULL check LSB_DJOB_HOSTFILE

Data Structures:

: none

Define Statements:

: none

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

Errors:

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

Equivalent line command:

: none

Files:

: none

See also:: none