gfarm_url_section_replicate_from_to

Name

gfarm_url_section_replicate_from_to -- Create a file replica of a file section

Synopsis

#include <gfarm/gfarm.h>

char *gfarm_url_section_replicate_from_to(const char *gfarm_url, char *section, char *srchost, char *dsthost);

DESCRIPTION

gfarm_url_section_replicate_from_to() creates a file replica of a file section section of a file gfarm_url from a source host srchost to a destination host dsthost.

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.

When there is no file copy on a host specified by srchost, gfarm_url_section_replicate_from_to() returns error.

RETURN VALUES

NULL

The function terminated successfully.

GFARM_ERR_NO_MEMORY

Insufficient memory was available.

GFARM_ERR_NO_SUCH_OBJECT

A component used as a directory in gfarm_url does not exist, or a file copy does not exist on the specified source host.

GFARM_ERR_TEXT_FILE_BUSY

The file gfarm_url cannot be replicated because it is being updated by another process.

Others

An error except the above occurred. The reason is shown by its pointed strings.

SEE ALSO

gfarm_url_section_replicate_to(3), gfarm_url_fragments_replicate(3)