gfal_bringonline(3) - Linux man page

Name

gfal_prestage - Synchronous function to bring on line a list of SURLs.

Synopsis

#include "gfal_api.h"

int gfal_bringonline (gfal_internal gfal, char *errbuf, int errbufsz);

Description

gfal_bringonline is the synchronous function to bring on line a list of SURLs, in order to allow quicker future acces to them.

See gfal_get_results(3) to be able to access results.

gfal
gfal_internal object generated from user parameters.
errbuf
allocated char * pointer in which a detailed error message may be stored.
errbufsz
size allocated ofr the pointer errbuf

Return Value

This routine returns 0 on a success, or -1 in case of error. In the latter case, errno is set appropriately. Moreover, you can get an error message from errbuf , if specified.

Errors

errno indicates the type of error, but for detailled error message, you have to look into errbuf.
EINVAL
The gfal_internal object is incorrect. It may be caused by freeing a user parameter which was in use in it, or by modifying this object by hand.
EPROTONOSUPPORT
You try to make an action with a protocol which is not supported by the system.
ENOMEM
Not enough free memory.

See Also

gfal(3), gfal_request_new(3), gfal_internal_free(3), gfal_init(3), gfal_deletesurls(3), gfal_removedir(3), gfal_turlsfromsurls(3), gfal_ls(3), gfal_get(3), gfal_getstatus(3), gfal_prestage(3), gfal_prestagestatus(3), gfal_pin(3), gfal_release(3), gfal_abortrequest(3), gfal_abortfiles(3), gfal_set_xfer_done(3), gfal_set_xfer_running(3), gfal_get_ids(3), gfal_set_ids(3), gfal_get_results(3),