Content-type: text/html Man page of GFAL_GET

GFAL_GET

Section: Library Functions (3)
Updated: $Date: 2008/06/05 13:09:16 $
Index Return to Main Contents
 

NAME

gfal_get - Asynchronous function to bring list of SURLs on line and get the corresponding TURLs.  

SYNOPSIS

#include "gfal_api.h"

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

DESCRIPTION

gfal_get is an asynchronous function to bring list of SURLs on line and get the corresponding TURLs. It is the asynchronous version of gfal_turlsfromsurls.

To check the status of the request and get the results, you must use gfal_getstatus(3).

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),


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
ERRORS
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 14:16:31 GMT, July 14, 2009