1LFC_SETCOMMENT(3)            LFC Library Functions           LFC_SETCOMMENT(3)
2
3
4

NAME

6       lfc_setcomment   -   add/replace   a  comment  associated  with  a  LFC
7       file/directory in the name server
8

SYNOPSIS

10       #include <sys/types.h>
11       #include "lfc_api.h"
12
13       int lfc_setcomment (const char *path, char *comment)
14

DESCRIPTION

16       lfc_setcomment  adds/replaces  a  comment   associated   with   a   LFC
17       file/directory in the name server.
18
19       path   specifies  the  logical  pathname  relative  to  the current LFC
20              directory or the full LFC pathname.
21

RETURN VALUE

23       This routine returns 0 if the operation was successful  or  -1  if  the
24       operation failed. In the latter case, serrno is set appropriately.
25

ERRORS

27       ENOENT       The named directory does not exist or is a null pathname.
28
29       EACCES       Search  permission  is  denied  on a component of the path
30                    prefix or the caller effective user ID does not match  the
31                    owner   ID   of  the  file  or  write  permission  on  the
32                    file/directory itself is denied.
33
34       EFAULT       path or comment is a NULL pointer.
35
36       EINVAL       The length of comment exceeds CA_MAXCOMMENTLEN.
37
38       ENAMETOOLONG The length of path exceeds CA_MAXPATHLEN or the length  of
39                    a path component exceeds CA_MAXNAMELEN.
40
41       SENOSHOST    Host unknown.
42
43       SENOSSERV    Service unknown.
44
45       SECOMERR     Communication error.
46
47       ENSNACT      Name server is not running or is being shutdown.
48

SEE ALSO

50       Castor_limits(4), lfc_chdir(3), Cupvlist(1)
51

AUTHOR

53       LCG Grid Deployment Team
54
55
56
57LFC          $Date: 2010-12-13 11:48:43 +0100 (Mon, 13 Dec 201L0F)C_$SETCOMMENT(3)