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.

Gfarm                                             18 March 2003                      GFARM_URL_HOSTS_SCHEDULE(3)