lsb_readrankfile

Read the specified rank file and return the host list.

If path is NULL then read the rank file specified by LSB_DJOB_RANKFILE. The rankfile is assumed to be in simple format of one host per line. A host can appear in the list more than once and in any order.

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_readrankfile(char ***hostlist, char *path)

Parameters:

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

Data Structures:

: none

Define Statements:

: none

Returns:: > 0
Function successful. Returns 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 commands:

: none

Files:

: none

See also:: none