lcg_uf(3) - Linux man page

Name

lcg_uf - unregister in the LRC or the LFC a file residing on an

SE

Synopsis

#include "lcg_util.h"

int lcg_uf (char *surl, char *guid, char *vo, char *conf_file, int insecure);

int lcg_ufx (char *surl, char *guid, char *vo, char *conf_file, int insecure, char *errbuf, int errbufsz);

int lcg_uf4 (char *surl, char *guid, int nobdii, char *vo, int verbose, char *errbuf, int errbufsz);

Description

lcg_uf unregisters in the LRC or the LFC a file residing on an SE. If it was the last or only valid replica, the entries corresponding to this GUID are also removed from the RMC or the LFC.
surl
specifies the site URL of the file to be unregistered. The scheme can be sfn: for a classical SE or srm:.
guid
specifies the Grid Unique IDentifier.
nobdii
If set to a non-zero value, it means that you don't want to make BDII calls to get LFC endpoint. So, you have to define the environment variable 'LFC_HOST'.
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.
verbose
Verbose level. Here are the possible levels:
  • Only critical errors are displayed on stderr or put into errbuf if not null.
  • Warnings are displayed on stderr as well as critical errors.
  • Debug information is displayed as well as warnings and critical errors.
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, guid or vo is an invalid pointer.
ECOMM
Communication error.
ENAMETOOLONG
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),

Referenced By

lcg_get_checksum(3), lcg_get_checksum_python(3), lcg_set_transfer_callback(3)