Content-type: text/html Man page of LCG_SD

LCG_SD

Section: Library Functions (3)
Updated: $Date: 2008/05/07 12:40:28 $
Index Return to Main Contents

 

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

 

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