Content-type: text/html Man page of GFAL_GET_RESULTS

GFAL_GET_RESULTS

Section: Library Functions (3)
Updated: $Date: 2009/04/08 14:16:20 $
Index Return to Main Contents
 

NAME

gfal_get_results - Extracts the results from the 'gfal_internal' object  

SYNOPSIS

import gfal

(int returncode, gfal_internal gfal, listOfDict filestatuses ) gfal_get_results (gfal_internal gfal );

 

DESCRIPTION

gfal_get_results Extracts the results of the last called GFAL function from the gfal_internal object.

gfal
gfal_internal object generated from user parameters.
filestatuses
List of dictionary. See the next section to know the field you can get from it.

 

RESULT DICTIONARY FIELDS

Keep in mind that all fields are not fulfilled by all functions!
string surl
The SURLs concerned. Fulfilled by all functions.
string turl
The TURL associated to the SURL in surl. Fulfilled by gfal_turlsfromsurls_python(3), gfal_getstatuses_python(3).
int status
For almost all function it corresponds to errno values ('0' means that all is ok). But for asynchronous functions, possible values are -1, 0 and 1, what correspond respectively to error, pending and done. Fulfilled by all functions.
string explanation
Error message associated with status. Can be fulfilled by all functions, but only when SRMv2 interface is used.
int pinlifetime
Remaining pin life time for surl. Fulfilled by gfal_turlsfromsurls_python(3), gfal_getstatus_python(3), gfal_bringonline_python(3), gfal_prestagestatus_python(3) when SRMv2 interface is used.
string locality
File locality. Possible values are: ONLINE, NEARLINE, ONLINE_AND_NEARLINE, LOST, NONE, UNAVAILABLE, UNKNOWN.
list stat
Stat information about the surl. Each field of the list corresponds to the same thing than in a system python stat. So the field are respectively st_mode, st_ino, st_dev, st_nlink, st_uid, st_gid, st_size, st_atime, st_mtime, st_ctime. It is ONLY fulfilled by gfal_ls_python(3).
listOfDict subpaths
Information about files in the directory (if there are ones) surl. It is ONLY fulfilled by gfal_ls_python(3) when you define srmv2_lslevels to '1' in the gfal_request object.
int nbsubpaths
Number of elements in subpaths. It is ONLY fulfilled by gfal_ls_python(3) when you define srmv2_lslevels to '1' in the gfal_request object.

 

RETURN VALUE

This routine returns 0 on a success, or -1 in case of error. In the latter case, results is defined to NULL.

 

SEE ALSO

gfal_python(3), gfal_init_python(3), gfal_internal_free_python(3), gfal_deletesurls_python(3), gfal_removedir_python(3), gfal_get_python(3), gfal_getstatus_python(3), gfal_ls_python(3), gfal_pin_python(3), gfal_prestage_python(3), gfal_prestagestatus_python(3), gfal_release_python(3), gfal_abortrequest_python(3), gfal_abortfiles_python(3), gfal_set_xfer_done_python(3), gfal_set_xfer_running_python(3), gfal_turlsfromsurls_python(3), gfal_get_ids_python(3), gfal_set_ids_python(3), gfal_get_results_python(3), gfal_access_python(3), gfal_chmod_python(3), gfal_close_python(3), gfal_closedir_python(3), gfal_creat_python(3), gfal_get_timeout_connect_python(3), gfal_get_timeout_sendreceive_python(3), gfal_get_timeout_bdii_python(3), gfal_get_timeout_srm_python(3), gfal_set_timeout_connect_python(3), gfal_set_timeout_sendreceive_python(3), gfal_set_timeout_bdii_python(3), gfal_set_timeout_srm_python(3), gfal_lseek_python(3), gfal_mkdir_python(3), gfal_open_python(3), gfal_opendir_python(3), gfal_read_python(3), gfal_rename_python(3), gfal_rmdir_python(3), gfal_stat_python(3), gfal_unlink_python(3), gfal_write_python(3), gfal_set_verbose_python(3), gfal_get_errno_python(3),


 

Index

NAME
SYNOPSIS
DESCRIPTION
RESULT DICTIONARY FIELDS
RETURN VALUE
SEE ALSO

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