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

.SH NAME
gfarm_url_section_replicate_from_to \- Create a file replica of a file section
.SH SYNOPSIS
.sp
\fB#include <gfarm/gfarm.h>
.sp
char *gfarm_url_section_replicate_from_to (const char *\fIgfarm_url\fB, char *\fIsection\fB, char *\fIsrchost\fB, char *\fIdsthost\fB);
\fR
.SH "DESCRIPTION"
.PP
\fBgfarm_url_section_replicate_from_to()\fR
creates a file replica of a file section
\fIsection\fR of a file
\fIgfarm_url\fR from a source host
\fIsrchost\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.  
.PP
When there is no file copy on a host specified by
\fIsrchost\fR,
\fBgfarm_url_section_replicate_from_to()\fR returns
error.  
.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, or a file copy does
not exist on the specified source host.
.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_to\fR(3),
\fBgfarm_url_fragments_replicate\fR(3)