GFARM_URL_HOSTS_SCHEDULE(3)

NAME
gfarm_url_hosts_schedule - schedule filesystem nodes using file-affinity scheduling

SYNOPSIS

#include <gfarm/gfarm.h>

char *gfarm_url_hosts_schedule (char * gfarm_url, char * option, int * nhostsp, char *** hostsp);

DESCRIPTION

The gfarm_url_hosts_schedule() function schedules filesystem nodes using file-affinity scheduling with a Gfarm file gfarm_url, and returns an array of filesystem hostnames hostsp and the number of scheduled hosts nhostsp. The returned array of hostnames hostsp should be free'ed with gfarm_strings_free_deeply(3).

RETURN VALUES

NULL
    The function terminated successfully.

GFARM_ERR_NO_MEMORY
    Insufficient memory was available.

Others
    An error except the above occurred. The reason is shown by its pointed strings.

NOTES

The argument option is reserved to specify options for scheduling, although it is not used in the current implementation.