lcg_sd(3) - Linux man page

Name

lcg_sd - set file status to "Done" for a given SURL in a specified

request

Synopsis

#include "lcg_util.h"

int lcg_sd (char *surl, int reqid, int fileid, char *token, int oflag);

int lcg_sdt (char *surl, int reqid, int fileid, char *token, int oflag, int timeout);

int lcg_sdx (char *surl, int reqid, int fileid, char *token, int oflag, char *errbuf, int errbufsz);

int lcg_sdxt (char *surl, int reqid, int fileid, char *token, int oflag, char *errbuf, int errbufsz, int timeout);

int lcg_sd3 (char *surl, int nobdii, int reqid, int fileid, char *token, char *errbuf, int errbufsz, int timeout);

Description

lcg_sd sets file status to "Done" for a given SURL in a specified request. This is only meaningful if the space is managed by an SRM.

surl: specifies the Site URL. An SURL starts with srm:.
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 full endpoint in SURLs. The SE type is deduced from arguments. If you specify reqtoken (not NULL) it is a SRMv2 endpoint. Else it is a SRMv1 endpoint.
reqid: is the request identifier returned by an SRM v1 get/put request or lcg_gt.
fileid: is the file ordinal returned by an SRM v1 get/put request or lcg_gt.
token: is the token returned by an SRM v2 get/put request or lcg_gt.
oflag: must be zero if the request was an SRM get or if lcg_gt was called, it must be non-zero if the request was an SRM put.
timeout: specifies the value of timeout (default 0).
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.

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: One of the arguments is an invalid pointer.
EINVAL: surl has an invalid syntax.
ECOMM: Communication error.
EPROTONOSUPPORT: Access method not supported.

Files

/opt/lcg/include/lcg_util.h

/opt/lcg/lib/liblcg_util.so

Referenced By

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