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

NAME

6       lfc_getcomment  -  get the comment associated with a LFC file/directory
7       in the name server
8

SYNOPSIS

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

DESCRIPTION

16       lfc_getcomment gets the comment associated with a LFC file/directory in
17       the name server.
18
19       path   specifies  the  logical  pathname  relative  to  the current LFC
20              directory or the full LFC pathname.
21
22       comment
23              points at a buffer to receive the comment.  The buffer  must  be
24              at least CA_MAXCOMMENTLEN+1 characters long.
25

RETURN VALUE

27       This  routine  returns  0  if the operation was successful or -1 if the
28       operation failed. In the latter case, serrno is set appropriately.
29

ERRORS

31       ENOENT       The named directory does not exist or is a  null  pathname
32                    or there is no comment associated with this path.
33
34       EACCES       Search  permission  is  denied  on a component of the path
35                    prefix or the caller effective user ID does not match  the
36                    owner ID of the file or read permission on the file/direc‐
37                    tory itself is denied.
38
39       EFAULT       path or comment is a NULL pointer.
40
41       ENAMETOOLONG The length of path exceeds CA_MAXPATHLEN or the length  of
42                    a path component exceeds CA_MAXNAMELEN.
43
44       SENOSHOST    Host unknown.
45
46       SENOSSERV    Service unknown.
47
48       SECOMERR     Communication error.
49
50       ENSNACT      Name server is not running or is being shutdown.
51

SEE ALSO

53       Castor_limits(4), lfc_chdir(3)
54

AUTHOR

56       LCG Grid Deployment Team
57
58
59
60LFC          $Date: 2010-12-13 11:48:43 +0100 (Mon, 13 Dec 201L0F)C_$GETCOMMENT(3)