gfal_get_results_python(3) - Linux man page

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.
string checksumtype
Name of the checksum algorithm (for example ADLER32, MD5 ). It is ONLY filled by gfal_ls_python(3).
string checksum
The checksum value. It is ONLY filled by gfal_ls_python(3).
listOfString spacetokens
The list of space tokens. Filled by gfal_prestage_python(3) when SRMv2 interface is used.

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