.\" 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_SECTION_REPLICATE_TO" "3" "06 September 2005" "Gfarm" ""

.SH NAME
gfarm_url_section_replicate_to \- Create a file replica of a file section
.SH SYNOPSIS
.sp
\fB#include <gfarm/gfarm.h>
.sp
char *gfarm_url_section_replicate_to (const char *\fIgfarm_url\fB, char *\fIsection\fB, char *\fIdsthost\fB);
\fR
.SH "DESCRIPTION"
.PP
\fBgfarm_url_section_replicate_to()\fR creates a
file replica of a file section \fIsection\fR of a
file \fIgfarm_url\fR to a destination host
\fIdsthost\fR.  
.PP
File section is an architecture name for executable files, or
is a fragment index for a regular file.  Note that a fragment index
needs to be specified in string without any unnecessary space
character and zero padding.  
.SH "RETURN VALUES"
.TP
\fBNULL\fR
The function terminated successfully.
.TP
\fBGFARM_ERR_NO_MEMORY\fR
Insufficient memory was available.
.TP
\fBGFARM_ERR_NO_SUCH_OBJECT\fR
A component used as a directory in
\fIgfarm_url\fR does not exist.
.TP
\fBGFARM_ERR_TEXT_FILE_BUSY\fR
The file \fIgfarm_url\fR cannot be replicated
because it is being updated by another process.
.TP
\fBOthers\fR
An error except the above occurred.  The reason is shown by its
pointed strings.
.SH "SEE ALSO"
.PP
\fBgfarm_url_section_replicate_from_to\fR(3),
\fBgfarm_url_fragments_replicate\fR(3)