.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "GFARM_URL_HOSTS_SCHEDULE" "3" "18 March 2003" "Gfarm" ""
.SH NAME
gfarm_url_hosts_schedule \- schedule filesystem nodes using file-affinity scheduling
.SH SYNOPSIS
.sp
\fB#include <gfarm/gfarm.h>
.sp
char *gfarm_url_hosts_schedule (char * \fIgfarm_url\fB, char * \fIoption\fB, int * \fInhostsp\fB, char *** \fIhostsp\fB);
\fR
.SH "DESCRIPTION"
.PP
The \fBgfarm_url_hosts_schedule()\fR function schedules filesystem
nodes using file-affinity scheduling with a Gfarm file
\fIgfarm_url\fR, and returns an array of filesystem hostnames
\fIhostsp\fR and the number of scheduled hosts \fInhostsp\fR.  The
returned array of hostnames \fIhostsp\fR should be free'ed with
gfarm_strings_free_deeply(3).
.SH "RETURN VALUES"
.TP
\fBNULL\fR
The function terminated successfully.
.TP
\fBGFARM_ERR_NO_MEMORY\fR
Insufficient memory was available.
.TP
\fBOthers\fR
An error except the above occurred.  The reason is shown by its
pointed strings.
.SH "NOTES"
.PP
The argument
\fIoption\fR
is reserved to specify options for scheduling, although it is not used
in the current implementation.