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.