Content-type: text/html
Man page of GFAL_INIT
GFAL_INIT
Section: Library Functions (3)
Updated: $Date: 2009/04/16 13:56:37 $
Index
Return to Main Contents
NAME
gfal_init - generates a 'gfal_internal' object
SYNOPSIS
import gfal
(int returncode,
gfal_internal gfal,
string errmsg
) gfal_init (dict req
);
DESCRIPTION
gfal_init
generates a
gfal_internal
object from user parameters stored in a
gfal_request
object. It is important to note that user parameters must not be freed while
gfal
is needed.
This object can/should be used several times for requests on same files.
It is very important to not modify such an object by hand, it have to be seen as a black box.
- req
-
Python dictionary in which you have to put your parameters. To have the list of available parameters
see the next section
Parameters in req.
- gfal
-
gfal_internal
object to be passed to other functions.
PARAMETERS IN REQ
- listOfString surls
-
Is the list of SURLs on which you want to do actions. It is mandatory in all cases, except
when you want to generate new file names (to create new file on a SE) (see
generatesurls
parameter).
- int generatesurls
-
If set to '1' and
surls
is set to NULL,
gfal_init()
will generate
nbfiles
file names. It is useful when you want to put new files on a SE, and you don't want a specific file name.
But in this case, the parameter
endpoint
must be set to the SE host name on which you want to create files, when to set
generatesurls
to '1'. In all other cases, it is ignored. Moreover, to generate file names, BDII is required
to get the root path, so it is not compatible with
no_bdii_check
parameter.
- string relative_path
-
Is used during file name generation (
generatesurls
is set to '1'), to specify the default sub-directory (in the root path) in which to put files.
In all other cases, it is ignored.
- int oflag
-
Allows to specify if it is a
get
or a
put
action. It is only used by
gfal_turlsfromsurls()
function. By default, the function considers it is a
get
request.
- listOfInt filesizes
-
It is only used and mandatory when
oflag
is set to '1'. It is a table of size
nbfiles
in which there are the sizes of the files what will be put on the SE.
- string defaultsetype
-
Allows to specify the default type of the given SE to be used. The possible values are
none,
se,
srmv1,
srmv2.
They respectively correspond to no default type, Classic SE, SRM v1, SRMv2. If BDII calls are not disabled,
and there no entry for the given SE with this type, but for another type, the latter will be used. By default,
it is set to
none.
- string setype
-
Allows to specify the type of the given SE to be used. The possible values are
none,
se,
srmv1,
srmv2.
They respectively correspond to no default type, Classic SE, SRM v1, SRMv2. If BDII calls are not disabled,
and there no entry for the given SE with this type, it will fails. By default,
it is set to
none.
- int no_bdii_check
-
Disables call to BDII. So the SE type cannot be get from there, what means that you have to specify it either with
defaultsetype
or with
setype.
Moreover, as BDII can't be used to get SE parameters (port number, service path), at least the first SURLs has to
contain the full endpoint (eg. srm://lxdpm104.cern.ch:8446/srm/managerv2?SFN=/dpm/cern.ch/home/dteam/file.test).
It is not compatible with
generatesurls.
- int timeout
-
Specifies the time before which remote servers are considered as down. By default, there is no timeout.
- listOfString protocols
-
Specifies the list of protocols to use to communicate with the SE. By defaut, it will be set to all protocols
understandable by the system (the system has the corresponding library).
- NOTE
-
The following parameters are SRMv2-specific, what means that specifying them will force the type of the SE to SRMv2.
So it is not compatible with setting
setype
to another value than
none
or
srmv2.
- char *srmv2_spacetokendesc
-
Specifies the space token to used with the given SE.
- int srmv2_desiredpintime
-
Specifies the desired pin life time for files on the given SE. It is only used by
gfal_pin(),
gfal_turlsfromsurls,
gfal_get.
- int srmv2_lslevels
-
It is only used by
gfal_ls.
Specifies the number of levels of recursion. Possible values are only '0' (no directory listing) or '1' (one level of directory listing).
- int srmv2_lsoffset
-
It is only used by
gfal_ls.
Specifies the offset from which the listing must begin. In other words, it is the number of file entries to skip.
- int srmv2_lscount
-
It is only used by
gfal_ls.
Specifies the maximum number of files to get. Keep in mind that SEs have also a maximum limit, so whatever you specify here, the number
of files will never be higher than the SE limit.
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
-
One or more parameter in
req
have a wrong value.
- ENOMEM
-
Not enough free memory.
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
-
- PARAMETERS IN REQ
-
- RETURN VALUE
-
- ERRORS
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 14:16:31 GMT, July 14, 2009