1LFC_GETCOMMENT(3)                 LFC      Library      Functions
2LFC_GETCOMMENT(3)
3
4
5
6[1mNAME[0m
7       lfc_getcomment  ‐  get the comment associated with  a  LFC
8file/directory
9       in the name server
10
11[1mSYNOPSIS[0m
12       [1m#include <sys/types.h>[0m
13       [1m#include "lfc_api.h"[0m
14
15       [1mint  lfc_getcomment  (const  char  *[4m[22mpath[24m[1m,
16char *[4m[22mcomment[24m[1m)[0m
17
18[1mDESCRIPTION[0m
19       [1mlfc_getcomment [22mgets the comment associated  with  a
20LFC file/directory in
21       the name server.
22
23       [4mpath[24m    specifies  the  logical  pathname  relative
24to  the current LFC
25              directory or the full LFC pathname.
26
27       [4mcomment[0m
28              points at a buffer to  receive  the  comment.   The
29buffer  must  be
30              at least CA_MAXCOMMENTLEN+1 characters long.
31
32[1mRETURN VALUE[0m
33       This  routine  returns  0  if the operation was successful
34or ‐1 if the
35       operation failed. In the latter case, [1mserrno [22mis set
36appropriately.
37
38[1mERRORS[0m
39       [1mENOENT        [22mThe named directory does not exist or
40is a  null  pathname
41                    or there is no comment associated  with  this
42path.
43
44       [1mEACCES        [22mSearch   permission  is  denied  on a
45component of the [4mpath[0m
46                    prefix or the caller effective user  ID  does
47not match  the
48                    owner  ID  of  the file or read permission on
49the file/direc‐
50                    tory itself is denied.
51
52       [1mEFAULT       [4m[22mpath[24m  or  [4mcomment[24m  is  a
53NULL pointer.
54
55       [1mENAMETOOLONG  [22mThe  length  of  [4mpath[24m  exceeds
56[1mCA_MAXPATHLEN [22mor the length  of
57                    a [4mpath[24m  component  exceeds  [1mCA_MAX‐
58NAMELEN[22m.
59
60       [1mSENOSHOST    [22mHost unknown.
61
62       [1mSENOSSERV    [22mService unknown.
63
64       [1mSECOMERR     [22mCommunication error.
65
66       [1mENSNACT      [22mName server is not running or is being
67shutdown.
68
69[1mSEE ALSO[0m
70       [1mCastor_limits(4)[22m, [1mlfc_chdir(3)[0m
71
72[1mAUTHOR[0m
73       [1mLCG Grid Deployment [22mTeam
74
75
76
77LFC                                                        $Date$
78LFC_GETCOMMENT(3)
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132