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