NAME
lfc_setcomment - add/replace a comment associated with a LFC
file/directory in the name server
SYNOPSIS
#include <sys/types.h>
#include "lfc_api.h"
int lfc_setcomment (const char *path, char *comment)
DESCRIPTION
lfc_setcomment adds/replaces a comment associated with a LFC
file/directory in the name server.
path specifies the logical pathname relative to the current LFC
directory or the full LFC pathname.
RETURN VALUE
This routine returns 0 if the operation was successful or -1 if the
operation failed. In the latter case, serrno is set appropriately.
ERRORS
EPERM The effective user ID does not match the owner of the
directory and does not have ADMIN privilege in the Cupv
database.
ENOENT The named directory does not exist or is a null pathname.
EACCES Search permission is denied on a component of the path
prefix or write permission on the file/directory itself is
denied.
EFAULT path or comment is a NULL pointer.
EINVAL The length of comment exceeds CA_MAXCOMMENTLEN.
ENAMETOOLONG The length of path exceeds CA_MAXPATHLEN or the length of
a path component exceeds CA_MAXNAMELEN.
SENOSHOST Host unknown.
SENOSSERV Service unknown.
SECOMERR Communication error.
ENSNACT Name server is not running or is being shutdown.
SEE ALSO
Castor_limits(4), lfc_chdir(3), Cupvlist(1)
AUTHOR
LCG Grid Deployment Team