Content-type: text/html
Man page of LCG_RF
LCG_RF
Section: Library Functions (3)
Updated: $Date: 2008/12/18 18:04:43 $
Index
Return to Main Contents
NAME
lcg_rf - register in the LRC (and optionally in the RMC) or the LFC a file residing on an SE
SYNOPSIS
#include "lcg_util.h"
int lcg_rf (char *surl,
char *guid,
char *lfn,
char *vo,
char *conf_file,
int insecure,
int verbose,
char *actual_gid);
int lcg_rft (char *surl,
char *guid,
char *lfn,
char *vo,
char *conf_file,
int insecure,
int verbose,
int timeout,
char *actual_gid);
int lcg_rfx (char *surl,
char *guid,
char *lfn,
char *vo,
char *conf_file,
int insecure,
int verbose,
char *actual_gid,
char *errbuf,
int errbufsz);
int lcg_rfxt (char *surl,
char *guid,
char *lfn,
char *vo,
char *conf_file,
int insecure,
int verbose,
int timeout,
char *actual_gid,
char *errbuf,
int errbufsz);
int lcg_rf3 (char *surl,
char *guid,
char *lfn,
enum se_typedefaulttype,
enum se_typesetype,
int nobdii,
char *vo,
char *conf_file,
int insecure,
int verbose,
int timeout,
char *actual_gid,
char *errbuf,
int errbufsz);
DESCRIPTION
lcg_rf
registers in the LRC (and optionally in the RMC) or the LFC a file residing on an SE.
- surl
-
specifies the site URL of the file to be registered. The scheme can be
sfn:
for a classical SE or
srm:.
- guid
-
specifies the Grid Unique IDentifier. If NULL, a GUID is generated internally.
- lfn
-
specifies the Logical File Name associated with the file. If not NULL, an
entry is added to the Replica Metadata Catalog or the LFC.
- defaulttype
-
specifies the default SE type you want to use. Possible values are
TYPE_NONE,
TYPE_SE,
TYPE_SRM,
TYPE_SRMv2,
for respectively no default type, classic SE, SRMv1, and SRMv2. But if according to the BDII the default type
is not available for this SE, it will use another type.
- setype
-
specifies the SE type you want to use for the SURL. Possible values are
TYPE_NONE,
TYPE_SE,
TYPE_SRM,
TYPE_SRMv2,
for respectively no type, classic SE, SRMv1, and SRMv2. But if according to the BDII the default type
is not available for this SE, it will fail.
- nobdii
-
If set to a non-zero value, it means that you don't want to make BDII calls to get SE type. So, you must provide the type of the SE
for srm: arguments, and full endpoint in SURLs. For SE type,
defaulttype
can be used (it will be used for both source and destination).
- vo
-
specifies the Virtual Organization the user belongs to. If it is not specified,
the environment variable LCG_GFAL_VO will be used.
- conf_file
-
This argument is currently ignored.
- insecure
-
This argument is currently ignored.
The access to the Replica Catalog or the LFC is done according to the endpoints published
in MDS.
- timeout
-
specifies the value of timeout (default 0).
- verbose
-
Verbose level. Here are the possible levels:
-
- 0
-
Only critical errors are displayed on stderr or put into errbuf if not null.
- 1
-
Warnings are displayed on stderr as well as critical errors.
- 2
-
Debug information is displayed as well as warnings and critical errors.
- actual_guid
-
specifies a buffer (minimum 37 bytes) to receive the actual guid.
This pointer can be NULL. In that case the actual guid is not returned.
- errbuf
-
specifies a buffer of size
errbufsz
to receive detailed error messages. If this pointer is NULL, the message goes
to stderr. The pointer should not be NULL if the application is a daemon or is
multi-threaded.
NOTE
The environment variable LCG_GFAL_INFOSYS must point to the BDII, unless
nobdii
is set to a non-zero value.
To use the RLS as catalog instead of the LFC, the environment variable
LCG_CATALOG_TYPE must explicitely be set to "edg". By default, it is set to "lfc".
RETURN VALUE
This routine returns 0 if the operation was successful or -1 if the
operation failed. In the latter case,
errno
is set appropriately.
ERRORS
- ENOENT
-
The named file does not exist.
- EACCES
-
Permission denied.
- EFAULT
-
surl
or
vo
is an invalid pointer.
- EINVAL
-
surl
or
guid
is invalid.
- ECOMM
-
Communication error.
- ENAMETOOLONG
-
lfn
or
vo
is too long.
- EPROTONOSUPPORT
-
Access method not supported.
FILES
/opt/lcg/include/lcg_util.h
- /opt/lcg/lib/liblcg_util.so
-
SEE ALSO
lcg_aa(3),
lcg_cp(3),
lcg_cr(3),
lcg_del(3),
lcg_gt(3),
lcg_la(3),
lcg_lg(3),
lcg_lr(3),
lcg_ra(3),
lcg_rep(3),
lcg_rf(3),
lcg_sd(3),
lcg_stmd(3),
lcg_uf(3)
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- NOTE
-
- RETURN VALUE
-
- ERRORS
-
- FILES
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 14:16:53 GMT, July 14, 2009