gerrit commit ids are not required for this repo
[openafs-wiki.git] / JavaAdminAPI / ACL.Entry.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN""http://www.w3.org/TR/REC-html40/loose.dtd">
2 <!--NewPage-->
3 <HTML>
4 <HEAD>
5 <!-- Generated by javadoc on Mon Jun 09 15:53:36 PDT 2003 -->
6 <TITLE>
7 ACL.Entry (Java AFS API)
8 </TITLE>
9 <META NAME="keywords" CONTENT="org.openafs.jafs.ACL.Entry,ACL.Entry class">
10 <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
11 </HEAD>
12 <SCRIPT>
13 function asd()
14 {
15 parent.document.title="ACL.Entry (Java AFS API)";
16 }
17 </SCRIPT>
18 <BODY BGCOLOR="white" onload="asd();">
19
20 <!-- ========== START OF NAVBAR ========== -->
21 <A NAME="navbar_top"><!-- --></A>
22 <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
23 <TR>
24 <TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
25 <A NAME="navbar_top_firstrow"><!-- --></A>
26 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
27   <TR ALIGN="center" VALIGN="top">
28   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
29   <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
30   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/ACL.Entry.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
31   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
32   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
33   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
34   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
35   </TR>
36 </TABLE>
37 </TD>
38 <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
39 <B>JAFS API v2</B></EM>
40 </TD>
41 </TR>
42
43 <TR>
44 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
45 &nbsp;<A HREF="../../../org/openafs/jafs/ACL.html"><B>PREV CLASS</B></A>&nbsp;
46 &nbsp;<A HREF="../../../org/openafs/jafs/AFSLibraryLoader.html"><B>NEXT CLASS</B></A></FONT></TD>
47 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
48   <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
49 &nbsp;<A HREF="ACL.Entry.html" TARGET="_top"><B>NO FRAMES</B></A>  &nbsp;
50 &nbsp;
51 <SCRIPT>
52   <!--
53   if(window==top) {
54     document.writeln('<A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>');
55   }
56   //-->
57 </SCRIPT>
58 <NOSCRIPT>
59 <A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>
60 </NOSCRIPT>
61 </FONT></TD>
62 </TR>
63 <TR>
64 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
65   SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
66 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
67 DETAIL:&nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
68 </TR>
69 </TABLE>
70 <!-- =========== END OF NAVBAR =========== -->
71
72 <HR>
73 <!-- ======== START OF CLASS DATA ======== -->
74 <H2>
75 <FONT SIZE="-1">
76 org.openafs.jafs</FONT>
77 <BR>
78 Class ACL.Entry</H2>
79 <PRE>
80 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html">java.lang.Object</A>
81   |
82   +--<B>org.openafs.jafs.ACL.Entry</B>
83 </PRE>
84 <DL>
85 <DT><B>All Implemented Interfaces:</B> <DD><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/Serializable.html">Serializable</A></DD>
86 </DL>
87 <DL>
88 <DT><B>Enclosing class:</B><DD><A HREF="../../../org/openafs/jafs/ACL.html">ACL</A></DD>
89 </DL>
90 <HR>
91 <DL>
92 <DT>public static final class <B>ACL.Entry</B><DT>extends <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html">Object</A><DT>implements <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/Serializable.html">Serializable</A></DL>
93
94 <P>
95 AFS ACL Entry Class.
96
97  <p> Documentation reference: 
98  <A HREF="http://www.transarc.com/Library/documentation/afs/3.6/unix/en_US/HTML/AdminGd/auagd020.htm#HDRWQ772">Managing Access Control Lists</A>
99 <P>
100
101 <P>
102 <DL>
103 <DT><B>Version:</B></DT>
104   <DD>2.0, 04/18/2001 - Completely revised class for efficiency., 3.0, 05/01/2002 - Converted class to an inner class.</DD>
105 <DT><B>See Also:</B><DD><A HREF="../../../serialized-form.html" TARGET="org.openafs.jafs.ACL.Entry">Serialized Form</A></DL>
106 <HR>
107
108 <P>
109 <!-- ======== NESTED CLASS SUMMARY ======== -->
110
111
112 <!-- =========== FIELD SUMMARY =========== -->
113
114 <A NAME="field_summary"><!-- --></A>
115 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
116 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
117 <TD COLSPAN=2><FONT SIZE="+2">
118 <B>Field Summary</B></FONT></TD>
119 </TR>
120 <TR BGCOLOR="white" CLASS="TableRowColor">
121 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
122 <CODE>static&nbsp;int</CODE></FONT></TD>
123 <TD><CODE><B><A HREF="../../../org/openafs/jafs/ACL.Entry.html#ADMIN">ADMIN</A></B></CODE>
124
125 <BR>
126 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ACL Mask administer constant</TD>
127 </TR>
128 <TR BGCOLOR="white" CLASS="TableRowColor">
129 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
130 <CODE>static&nbsp;int</CODE></FONT></TD>
131 <TD><CODE><B><A HREF="../../../org/openafs/jafs/ACL.Entry.html#DELETE">DELETE</A></B></CODE>
132
133 <BR>
134 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ACL Mask delete constant</TD>
135 </TR>
136 <TR BGCOLOR="white" CLASS="TableRowColor">
137 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
138 <CODE>static&nbsp;int</CODE></FONT></TD>
139 <TD><CODE><B><A HREF="../../../org/openafs/jafs/ACL.Entry.html#INSERT">INSERT</A></B></CODE>
140
141 <BR>
142 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ACL Mask insert constant</TD>
143 </TR>
144 <TR BGCOLOR="white" CLASS="TableRowColor">
145 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
146 <CODE>static&nbsp;int</CODE></FONT></TD>
147 <TD><CODE><B><A HREF="../../../org/openafs/jafs/ACL.Entry.html#LOCK">LOCK</A></B></CODE>
148
149 <BR>
150 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ACL Mask lock constant</TD>
151 </TR>
152 <TR BGCOLOR="white" CLASS="TableRowColor">
153 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
154 <CODE>static&nbsp;int</CODE></FONT></TD>
155 <TD><CODE><B><A HREF="../../../org/openafs/jafs/ACL.Entry.html#LOOKUP">LOOKUP</A></B></CODE>
156
157 <BR>
158 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ACL Mask lookup constant</TD>
159 </TR>
160 <TR BGCOLOR="white" CLASS="TableRowColor">
161 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
162 <CODE>static&nbsp;int</CODE></FONT></TD>
163 <TD><CODE><B><A HREF="../../../org/openafs/jafs/ACL.Entry.html#READ">READ</A></B></CODE>
164
165 <BR>
166 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ACL Mask read constant</TD>
167 </TR>
168 <TR BGCOLOR="white" CLASS="TableRowColor">
169 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
170 <CODE>static&nbsp;int</CODE></FONT></TD>
171 <TD><CODE><B><A HREF="../../../org/openafs/jafs/ACL.Entry.html#WRITE">WRITE</A></B></CODE>
172
173 <BR>
174 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ACL Mask write constant</TD>
175 </TR>
176 </TABLE>
177 &nbsp;
178 <!-- ======== CONSTRUCTOR SUMMARY ======== -->
179
180 <A NAME="constructor_summary"><!-- --></A>
181 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
182 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
183 <TD COLSPAN=2><FONT SIZE="+2">
184 <B>Constructor Summary</B></FONT></TD>
185 </TR>
186 <TR BGCOLOR="white" CLASS="TableRowColor">
187 <TD><CODE><B><A HREF="../../../org/openafs/jafs/ACL.Entry.html#ACL.Entry()">ACL.Entry</A></B>()</CODE>
188
189 <BR>
190 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Constructs a new ACL entry with all permission bits set to <code>false</code>.</TD>
191 </TR>
192 <TR BGCOLOR="white" CLASS="TableRowColor">
193 <TD><CODE><B><A HREF="../../../org/openafs/jafs/ACL.Entry.html#ACL.Entry(int)">ACL.Entry</A></B>(int&nbsp;permissionsMask)</CODE>
194
195 <BR>
196 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Constructs a new ACL entry setting each permission bit to its appropriate 
197  value according to the <code>permissionsMask</code> specified.</TD>
198 </TR>
199 <TR BGCOLOR="white" CLASS="TableRowColor">
200 <TD><CODE><B><A HREF="../../../org/openafs/jafs/ACL.Entry.html#ACL.Entry(java.lang.String)">ACL.Entry</A></B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;user)</CODE>
201
202 <BR>
203 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Constructs a new ACL entry with all permission bits set to <code>false</code>
204  and sets the associated user or group name.</TD>
205 </TR>
206 <TR BGCOLOR="white" CLASS="TableRowColor">
207 <TD><CODE><B><A HREF="../../../org/openafs/jafs/ACL.Entry.html#ACL.Entry(java.lang.String, int)">ACL.Entry</A></B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;user,
208           int&nbsp;permissionsMask)</CODE>
209
210 <BR>
211 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Constructs a new ACL entry setting each permission bit to its appropriate 
212  value according to the <code>permissionsMask</code> specified
213  and sets the associated user or group name.</TD>
214 </TR>
215 </TABLE>
216 &nbsp;
217 <!-- ========== METHOD SUMMARY =========== -->
218
219 <A NAME="method_summary"><!-- --></A>
220 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
221 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
222 <TD COLSPAN=2><FONT SIZE="+2">
223 <B>Method Summary</B></FONT></TD>
224 </TR>
225 <TR BGCOLOR="white" CLASS="TableRowColor">
226 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
227 <CODE>&nbsp;boolean</CODE></FONT></TD>
228 <TD><CODE><B><A HREF="../../../org/openafs/jafs/ACL.Entry.html#canAdmin()">canAdmin</A></B>()</CODE>
229
230 <BR>
231 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<IMG SRC="folder.gif" ALT="Directory Permission" WIDTH="16" HEIGHT="16" BORDER="0"> Tests whether the ACL permits <code>administer</code> access.
232
233  </TD>
234 </TR>
235 <TR BGCOLOR="white" CLASS="TableRowColor">
236 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
237 <CODE>&nbsp;boolean</CODE></FONT></TD>
238 <TD><CODE><B><A HREF="../../../org/openafs/jafs/ACL.Entry.html#canDelete()">canDelete</A></B>()</CODE>
239
240 <BR>
241 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<IMG SRC="folder.gif" ALT="Directory Permission" WIDTH="16" HEIGHT="16" BORDER="0"> Tests whether the ACL permits <code>delete</code> access.
242
243  </TD>
244 </TR>
245 <TR BGCOLOR="white" CLASS="TableRowColor">
246 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
247 <CODE>&nbsp;boolean</CODE></FONT></TD>
248 <TD><CODE><B><A HREF="../../../org/openafs/jafs/ACL.Entry.html#canInsert()">canInsert</A></B>()</CODE>
249
250 <BR>
251 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<IMG SRC="folder.gif" ALT="Directory Permission" WIDTH="16" HEIGHT="16" BORDER="0"> Tests whether the ACL permits <code>insert</code> access.
252
253  </TD>
254 </TR>
255 <TR BGCOLOR="white" CLASS="TableRowColor">
256 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
257 <CODE>&nbsp;boolean</CODE></FONT></TD>
258 <TD><CODE><B><A HREF="../../../org/openafs/jafs/ACL.Entry.html#canLock()">canLock</A></B>()</CODE>
259
260 <BR>
261 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<IMG SRC="file.gif" ALT="File Permission" WIDTH="16" HEIGHT="16" BORDER="0"> Tests whether the ACL permits the <code>lock</code> authority.
262
263  </TD>
264 </TR>
265 <TR BGCOLOR="white" CLASS="TableRowColor">
266 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
267 <CODE>&nbsp;boolean</CODE></FONT></TD>
268 <TD><CODE><B><A HREF="../../../org/openafs/jafs/ACL.Entry.html#canLookup()">canLookup</A></B>()</CODE>
269
270 <BR>
271 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<IMG SRC="folder.gif" ALT="Directory Permission" WIDTH="16" HEIGHT="16" BORDER="0"> Tests whether the ACL permits lookup access.
272
273  </TD>
274 </TR>
275 <TR BGCOLOR="white" CLASS="TableRowColor">
276 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
277 <CODE>&nbsp;boolean</CODE></FONT></TD>
278 <TD><CODE><B><A HREF="../../../org/openafs/jafs/ACL.Entry.html#canRead()">canRead</A></B>()</CODE>
279
280 <BR>
281 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<IMG SRC="file.gif" ALT="File Permission" WIDTH="16" HEIGHT="16" BORDER="0"> Tests whether the ACL permits <code>read</code> access.
282
283  </TD>
284 </TR>
285 <TR BGCOLOR="white" CLASS="TableRowColor">
286 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
287 <CODE>&nbsp;boolean</CODE></FONT></TD>
288 <TD><CODE><B><A HREF="../../../org/openafs/jafs/ACL.Entry.html#canWrite()">canWrite</A></B>()</CODE>
289
290 <BR>
291 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<IMG SRC="file.gif" ALT="File Permission" WIDTH="16" HEIGHT="16" BORDER="0"> Tests whether the ACL permits <code>write</code> access.
292
293  </TD>
294 </TR>
295 <TR BGCOLOR="white" CLASS="TableRowColor">
296 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
297 <CODE>&nbsp;boolean</CODE></FONT></TD>
298 <TD><CODE><B><A HREF="../../../org/openafs/jafs/ACL.Entry.html#equals(org.openafs.jafs.ACL.Entry)">equals</A></B>(<A HREF="../../../org/openafs/jafs/ACL.Entry.html">ACL.Entry</A>&nbsp;entry)</CODE>
299
300 <BR>
301 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Tests whether two <code>ACL.Entry</code> objects are equal, based on associated
302  username and permission bits.</TD>
303 </TR>
304 <TR BGCOLOR="white" CLASS="TableRowColor">
305 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
306 <CODE>&nbsp;int</CODE></FONT></TD>
307 <TD><CODE><B><A HREF="../../../org/openafs/jafs/ACL.Entry.html#getPermissionsMask()">getPermissionsMask</A></B>()</CODE>
308
309 <BR>
310 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns this entry's permission mask.
311
312  </TD>
313 </TR>
314 <TR BGCOLOR="white" CLASS="TableRowColor">
315 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
316 <CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A></CODE></FONT></TD>
317 <TD><CODE><B><A HREF="../../../org/openafs/jafs/ACL.Entry.html#getUser()">getUser</A></B>()</CODE>
318
319 <BR>
320 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the user <B>or</B> group name associated with this ACL entry.</TD>
321 </TR>
322 <TR BGCOLOR="white" CLASS="TableRowColor">
323 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
324 <CODE>&nbsp;void</CODE></FONT></TD>
325 <TD><CODE><B><A HREF="../../../org/openafs/jafs/ACL.Entry.html#setAdmin(boolean)">setAdmin</A></B>(boolean&nbsp;flag)</CODE>
326
327 <BR>
328 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets the ACL permission to accomodate <code>administer</code> rights for directories.</TD>
329 </TR>
330 <TR BGCOLOR="white" CLASS="TableRowColor">
331 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
332 <CODE>&nbsp;void</CODE></FONT></TD>
333 <TD><CODE><B><A HREF="../../../org/openafs/jafs/ACL.Entry.html#setDelete(boolean)">setDelete</A></B>(boolean&nbsp;flag)</CODE>
334
335 <BR>
336 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets the ACL permission to accomodate <code>delete</code> access for directories.</TD>
337 </TR>
338 <TR BGCOLOR="white" CLASS="TableRowColor">
339 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
340 <CODE>&nbsp;void</CODE></FONT></TD>
341 <TD><CODE><B><A HREF="../../../org/openafs/jafs/ACL.Entry.html#setInsert(boolean)">setInsert</A></B>(boolean&nbsp;flag)</CODE>
342
343 <BR>
344 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets the ACL permission to accomodate <code>insert</code> access for directories.</TD>
345 </TR>
346 <TR BGCOLOR="white" CLASS="TableRowColor">
347 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
348 <CODE>&nbsp;void</CODE></FONT></TD>
349 <TD><CODE><B><A HREF="../../../org/openafs/jafs/ACL.Entry.html#setLock(boolean)">setLock</A></B>(boolean&nbsp;flag)</CODE>
350
351 <BR>
352 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets the ACL permission to accomodate <code>lock</code> access for files.</TD>
353 </TR>
354 <TR BGCOLOR="white" CLASS="TableRowColor">
355 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
356 <CODE>&nbsp;void</CODE></FONT></TD>
357 <TD><CODE><B><A HREF="../../../org/openafs/jafs/ACL.Entry.html#setLookup(boolean)">setLookup</A></B>(boolean&nbsp;flag)</CODE>
358
359 <BR>
360 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets the ACL permission to accomodate <code>lookup</code> access for directories.</TD>
361 </TR>
362 <TR BGCOLOR="white" CLASS="TableRowColor">
363 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
364 <CODE>&nbsp;void</CODE></FONT></TD>
365 <TD><CODE><B><A HREF="../../../org/openafs/jafs/ACL.Entry.html#setPermissions(int)">setPermissions</A></B>(int&nbsp;permissionsMask)</CODE>
366
367 <BR>
368 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set this entry's permission bits according to the value of the 
369  <code>permissionsMask</code> specified.</TD>
370 </TR>
371 <TR BGCOLOR="white" CLASS="TableRowColor">
372 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
373 <CODE>&nbsp;void</CODE></FONT></TD>
374 <TD><CODE><B><A HREF="../../../org/openafs/jafs/ACL.Entry.html#setRead(boolean)">setRead</A></B>(boolean&nbsp;flag)</CODE>
375
376 <BR>
377 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets the ACL permission to accomodate <code>read</code> access for files.</TD>
378 </TR>
379 <TR BGCOLOR="white" CLASS="TableRowColor">
380 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
381 <CODE>&nbsp;void</CODE></FONT></TD>
382 <TD><CODE><B><A HREF="../../../org/openafs/jafs/ACL.Entry.html#setUser(java.lang.String)">setUser</A></B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;user)</CODE>
383
384 <BR>
385 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets the user <B>or</B> group name associated with this ACL entry.</TD>
386 </TR>
387 <TR BGCOLOR="white" CLASS="TableRowColor">
388 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
389 <CODE>&nbsp;void</CODE></FONT></TD>
390 <TD><CODE><B><A HREF="../../../org/openafs/jafs/ACL.Entry.html#setWrite(boolean)">setWrite</A></B>(boolean&nbsp;flag)</CODE>
391
392 <BR>
393 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets the ACL permission to accomodate <code>write</code> access for files.</TD>
394 </TR>
395 <TR BGCOLOR="white" CLASS="TableRowColor">
396 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
397 <CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A></CODE></FONT></TD>
398 <TD><CODE><B><A HREF="../../../org/openafs/jafs/ACL.Entry.html#toString()">toString</A></B>()</CODE>
399
400 <BR>
401 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns a String representation of this <CODE>ACL.Entry</CODE></TD>
402 </TR>
403 </TABLE>
404 &nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
405 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
406 <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
407 <TD><B>Methods inherited from class java.lang.<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html">Object</A></B></TD>
408 </TR>
409 <TR BGCOLOR="white" CLASS="TableRowColor">
410 <TD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#clone()">clone</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#equals(java.lang.Object)">equals</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#finalize()">finalize</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#getClass()">getClass</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#hashCode()">hashCode</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#notify()">notify</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#notifyAll()">notifyAll</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#wait()">wait</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#wait(long)">wait</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#wait(long, int)">wait</A></CODE></TD>
411 </TR>
412 </TABLE>
413 &nbsp;
414 <P>
415
416 <!-- ============ FIELD DETAIL =========== -->
417
418 <A NAME="field_detail"><!-- --></A>
419 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
420 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
421 <TD COLSPAN=1><FONT SIZE="+2">
422 <B>Field Detail</B></FONT></TD>
423 </TR>
424 </TABLE>
425
426 <A NAME="READ"><!-- --></A><H3>
427 READ</H3>
428 <PRE>
429 public static final int <B>READ</B></PRE>
430 <DL>
431 <DD>ACL Mask read constant
432 <P>
433 <DL>
434 <DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#org.openafs.jafs.ACL.Entry.READ">Constant Field Values</A></DL>
435 </DL>
436 <HR>
437
438 <A NAME="WRITE"><!-- --></A><H3>
439 WRITE</H3>
440 <PRE>
441 public static final int <B>WRITE</B></PRE>
442 <DL>
443 <DD>ACL Mask write constant
444 <P>
445 <DL>
446 <DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#org.openafs.jafs.ACL.Entry.WRITE">Constant Field Values</A></DL>
447 </DL>
448 <HR>
449
450 <A NAME="INSERT"><!-- --></A><H3>
451 INSERT</H3>
452 <PRE>
453 public static final int <B>INSERT</B></PRE>
454 <DL>
455 <DD>ACL Mask insert constant
456 <P>
457 <DL>
458 <DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#org.openafs.jafs.ACL.Entry.INSERT">Constant Field Values</A></DL>
459 </DL>
460 <HR>
461
462 <A NAME="LOOKUP"><!-- --></A><H3>
463 LOOKUP</H3>
464 <PRE>
465 public static final int <B>LOOKUP</B></PRE>
466 <DL>
467 <DD>ACL Mask lookup constant
468 <P>
469 <DL>
470 <DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#org.openafs.jafs.ACL.Entry.LOOKUP">Constant Field Values</A></DL>
471 </DL>
472 <HR>
473
474 <A NAME="DELETE"><!-- --></A><H3>
475 DELETE</H3>
476 <PRE>
477 public static final int <B>DELETE</B></PRE>
478 <DL>
479 <DD>ACL Mask delete constant
480 <P>
481 <DL>
482 <DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#org.openafs.jafs.ACL.Entry.DELETE">Constant Field Values</A></DL>
483 </DL>
484 <HR>
485
486 <A NAME="LOCK"><!-- --></A><H3>
487 LOCK</H3>
488 <PRE>
489 public static final int <B>LOCK</B></PRE>
490 <DL>
491 <DD>ACL Mask lock constant
492 <P>
493 <DL>
494 <DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#org.openafs.jafs.ACL.Entry.LOCK">Constant Field Values</A></DL>
495 </DL>
496 <HR>
497
498 <A NAME="ADMIN"><!-- --></A><H3>
499 ADMIN</H3>
500 <PRE>
501 public static final int <B>ADMIN</B></PRE>
502 <DL>
503 <DD>ACL Mask administer constant
504 <P>
505 <DL>
506 <DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#org.openafs.jafs.ACL.Entry.ADMIN">Constant Field Values</A></DL>
507 </DL>
508
509 <!-- ========= CONSTRUCTOR DETAIL ======== -->
510
511 <A NAME="constructor_detail"><!-- --></A>
512 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
513 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
514 <TD COLSPAN=1><FONT SIZE="+2">
515 <B>Constructor Detail</B></FONT></TD>
516 </TR>
517 </TABLE>
518
519 <A NAME="ACL.Entry()"><!-- --></A><H3>
520 ACL.Entry</H3>
521 <PRE>
522 public <B>ACL.Entry</B>()</PRE>
523 <DL>
524 <DD>Constructs a new ACL entry with all permission bits set to <code>false</code>.
525 <P>
526 </DL>
527 <HR>
528
529 <A NAME="ACL.Entry(java.lang.String)"><!-- --></A><H3>
530 ACL.Entry</H3>
531 <PRE>
532 public <B>ACL.Entry</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;user)</PRE>
533 <DL>
534 <DD>Constructs a new ACL entry with all permission bits set to <code>false</code>
535  and sets the associated user or group name.
536 <P>
537 <DT><B>Parameters:</B><DD><CODE>user</CODE> - The user or group name associated with this entry</DL>
538 <HR>
539
540 <A NAME="ACL.Entry(int)"><!-- --></A><H3>
541 ACL.Entry</H3>
542 <PRE>
543 public <B>ACL.Entry</B>(int&nbsp;permissionsMask)</PRE>
544 <DL>
545 <DD>Constructs a new ACL entry setting each permission bit to its appropriate 
546  value according to the <code>permissionsMask</code> specified.
547 <P>
548 <DT><B>Parameters:</B><DD><CODE>permissionsMask</CODE> - An integer representation of the permissoin 
549                                 rights of this entry<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/ACL.Entry.html#canRead()"><CODE>canRead()</CODE></A>, 
550 <A HREF="../../../org/openafs/jafs/ACL.Entry.html#canWrite()"><CODE>canWrite()</CODE></A>, 
551 <A HREF="../../../org/openafs/jafs/ACL.Entry.html#canInsert()"><CODE>canInsert()</CODE></A>, 
552 <A HREF="../../../org/openafs/jafs/ACL.Entry.html#canLookup()"><CODE>canLookup()</CODE></A>, 
553 <A HREF="../../../org/openafs/jafs/ACL.Entry.html#canDelete()"><CODE>canDelete()</CODE></A>, 
554 <A HREF="../../../org/openafs/jafs/ACL.Entry.html#canLock()"><CODE>canLock()</CODE></A>, 
555 <A HREF="../../../org/openafs/jafs/ACL.Entry.html#canAdmin()"><CODE>canAdmin()</CODE></A></DL>
556 <HR>
557
558 <A NAME="ACL.Entry(java.lang.String, int)"><!-- --></A><H3>
559 ACL.Entry</H3>
560 <PRE>
561 public <B>ACL.Entry</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;user,
562                  int&nbsp;permissionsMask)</PRE>
563 <DL>
564 <DD>Constructs a new ACL entry setting each permission bit to its appropriate 
565  value according to the <code>permissionsMask</code> specified
566  and sets the associated user or group name.
567 <P>
568 <DT><B>Parameters:</B><DD><CODE>permissionsMask</CODE> - An integer representation of the permissoin 
569                                 rights of this entry<DD><CODE>user</CODE> - The username or group associated with this entry<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/ACL.Entry.html#canRead()"><CODE>canRead()</CODE></A>, 
570 <A HREF="../../../org/openafs/jafs/ACL.Entry.html#canWrite()"><CODE>canWrite()</CODE></A>, 
571 <A HREF="../../../org/openafs/jafs/ACL.Entry.html#canInsert()"><CODE>canInsert()</CODE></A>, 
572 <A HREF="../../../org/openafs/jafs/ACL.Entry.html#canLookup()"><CODE>canLookup()</CODE></A>, 
573 <A HREF="../../../org/openafs/jafs/ACL.Entry.html#canDelete()"><CODE>canDelete()</CODE></A>, 
574 <A HREF="../../../org/openafs/jafs/ACL.Entry.html#canLock()"><CODE>canLock()</CODE></A>, 
575 <A HREF="../../../org/openafs/jafs/ACL.Entry.html#canAdmin()"><CODE>canAdmin()</CODE></A>, 
576 <A HREF="../../../org/openafs/jafs/ACL.Entry.html#setUser(java.lang.String)"><CODE>setUser(java.lang.String)</CODE></A></DL>
577
578 <!-- ============ METHOD DETAIL ========== -->
579
580 <A NAME="method_detail"><!-- --></A>
581 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
582 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
583 <TD COLSPAN=1><FONT SIZE="+2">
584 <B>Method Detail</B></FONT></TD>
585 </TR>
586 </TABLE>
587
588 <A NAME="setPermissions(int)"><!-- --></A><H3>
589 setPermissions</H3>
590 <PRE>
591 public void <B>setPermissions</B>(int&nbsp;permissionsMask)</PRE>
592 <DL>
593 <DD>Set this entry's permission bits according to the value of the 
594  <code>permissionsMask</code> specified.
595 <P>
596 <DD><DL>
597 </DL>
598 </DD>
599 <DD><DL>
600 <DT><B>Parameters:</B><DD><CODE>permissionsMask</CODE> - An integer representation of the permissoin 
601                                 rights of this entry<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/ACL.Entry.html#getPermissionsMask()"><CODE>getPermissionsMask()</CODE></A></DL>
602 </DD>
603 </DL>
604 <HR>
605
606 <A NAME="getPermissionsMask()"><!-- --></A><H3>
607 getPermissionsMask</H3>
608 <PRE>
609 public int <B>getPermissionsMask</B>()</PRE>
610 <DL>
611 <DD>Returns this entry's permission mask.
612
613  <p> <B>Permission Mask</B><BR>
614  01 - READ  <BR>
615  02 - WRITE <BR>
616  04 - INSERT<BR>
617  08 - LOOKUP<BR>
618  16 - DELETE<BR>
619  32 - LOCK  <BR>
620  64 - ADMIN <BR>
621
622  <p> Any combination of the above mask values would equate to a valid combination of 
623  permission settings.  For example, if the permission mask was <B>11</B>, the ACL permissions
624  would be as follows: <code>read</code> (1), <code>write</code> (2), and <code>lookup</code> (8).<BR>
625  [1 + 2 + 8 = 11]
626 <P>
627 <DD><DL>
628 </DL>
629 </DD>
630 <DD><DL>
631
632 <DT><B>Returns:</B><DD>An integer representation (mask) of the permissoin rights of this entry</DL>
633 </DD>
634 </DL>
635 <HR>
636
637 <A NAME="getUser()"><!-- --></A><H3>
638 getUser</H3>
639 <PRE>
640 public <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> <B>getUser</B>()</PRE>
641 <DL>
642 <DD>Returns the user <B>or</B> group name associated with this ACL entry.
643 <P>
644 <DD><DL>
645 </DL>
646 </DD>
647 <DD><DL>
648
649 <DT><B>Returns:</B><DD>String representation of the user or group name associated with this entry.</DL>
650 </DD>
651 </DL>
652 <HR>
653
654 <A NAME="setUser(java.lang.String)"><!-- --></A><H3>
655 setUser</H3>
656 <PRE>
657 public void <B>setUser</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;user)</PRE>
658 <DL>
659 <DD>Sets the user <B>or</B> group name associated with this ACL entry.
660 <P>
661 <DD><DL>
662 </DL>
663 </DD>
664 <DD><DL>
665 <DT><B>Parameters:</B><DD><CODE>user</CODE> - representation of the user or group name associated with this entry.</DL>
666 </DD>
667 </DL>
668 <HR>
669
670 <A NAME="canRead()"><!-- --></A><H3>
671 canRead</H3>
672 <PRE>
673 public boolean <B>canRead</B>()</PRE>
674 <DL>
675 <DD><IMG SRC="file.gif" ALT="File Permission" WIDTH="16" HEIGHT="16" BORDER="0"> Tests whether the ACL permits <code>read</code> access.
676
677  <p> This permission enables a user to read the contents of files in the directory 
678  and to obtain complete status information for the files (read/retrieve the file 
679  attributes).
680
681  <p><FONT COLOR="666699"><IMG SRC="file.gif" ALT="File Permission" WIDTH="16" HEIGHT="16" BORDER="0"> <U><B>File Permission</B></U></FONT><BR>
682  This permission is meaningful with respect to files in 
683  a directory, rather than the directory itself or its subdirectories. 
684
685  <p> Documentation reference: 
686  <A HREF="http://www.transarc.com/Library/documentation/afs/3.6/unix/en_US/HTML/AdminGd/auagd020.htm#HDRWQ782">The AFS ACL Permissions</A>
687 <P>
688 <DD><DL>
689 </DL>
690 </DD>
691 <DD><DL>
692
693 <DT><B>Returns:</B><DD><code>true</code> if and only if the ACL permits <code>read</code> access of
694           files; <code>false</code> otherwise</DL>
695 </DD>
696 </DL>
697 <HR>
698
699 <A NAME="setRead(boolean)"><!-- --></A><H3>
700 setRead</H3>
701 <PRE>
702 public void <B>setRead</B>(boolean&nbsp;flag)</PRE>
703 <DL>
704 <DD>Sets the ACL permission to accomodate <code>read</code> access for files.
705 <P>
706 <DD><DL>
707 </DL>
708 </DD>
709 <DD><DL>
710 <DT><B>Parameters:</B><DD><CODE>flag</CODE> - boolean flag that denotes the permission bit for <code>read</code> access.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/ACL.Entry.html#canRead()"><CODE>canRead()</CODE></A></DL>
711 </DD>
712 </DL>
713 <HR>
714
715 <A NAME="canLookup()"><!-- --></A><H3>
716 canLookup</H3>
717 <PRE>
718 public boolean <B>canLookup</B>()</PRE>
719 <DL>
720 <DD><IMG SRC="folder.gif" ALT="Directory Permission" WIDTH="16" HEIGHT="16" BORDER="0"> Tests whether the ACL permits lookup access.
721
722  <p> This permission functions as something of a gate keeper for access to the directory 
723  and its files, because a user must have it in order to exercise any other permissions. 
724  In particular, a user must have this permission to access anything in the directory's 
725  subdirectories, even if the ACL on a subdirectory grants extensive permissions.
726
727  <p> This permission enables a user to list the names of the files and subdirectories in 
728  the directory (this does not permit read access to its respective entries), obtain 
729  complete status information for the directory element itself, and examine the directory's 
730  ACL.
731
732  <p> This permission does not enable a user to read the contents of a file in the 
733  directory.
734
735  <p> Similarly, this permission does not enable a user to lookup the contents of, 
736  obtain complete status information for, or examine the ACL of the subdirectory of 
737  the directory. Those operations require the <code>lookup</code> permission on the ACL
738  of the subdirectory itself.
739
740  <p><FONT COLOR="666699"><IMG SRC="folder.gif" ALT="Directory Permission" WIDTH="16" HEIGHT="16" BORDER="0"> <U><B>Directory Permission</B></U></FONT><BR>
741  This permission is meaningful with respect to the 
742  directory itself. For example, the <code>insert</code> permission (see: <A HREF="../../../org/openafs/jafs/ACL.Entry.html#canInsert()"><CODE>canInsert()</CODE></A>)
743  does not control addition of data to a file, but rather creation of a new file or 
744  subdirectory. 
745
746  <p> Documentation reference: 
747  <A HREF="http://www.transarc.com/Library/documentation/afs/3.6/unix/en_US/HTML/AdminGd/auagd020.htm#HDRWQ782">The AFS ACL Permissions</A>
748 <P>
749 <DD><DL>
750 </DL>
751 </DD>
752 <DD><DL>
753
754 <DT><B>Returns:</B><DD><code>true</code> if and only if the ACL permits <code>lookup</code> access for
755           directories; <code>false</code> otherwise</DL>
756 </DD>
757 </DL>
758 <HR>
759
760 <A NAME="setLookup(boolean)"><!-- --></A><H3>
761 setLookup</H3>
762 <PRE>
763 public void <B>setLookup</B>(boolean&nbsp;flag)</PRE>
764 <DL>
765 <DD>Sets the ACL permission to accomodate <code>lookup</code> access for directories.
766 <P>
767 <DD><DL>
768 </DL>
769 </DD>
770 <DD><DL>
771 <DT><B>Parameters:</B><DD><CODE>flag</CODE> - boolean flag that denotes the permission bit for <code>lookup</code> access.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/ACL.Entry.html#canLookup()"><CODE>canLookup()</CODE></A></DL>
772 </DD>
773 </DL>
774 <HR>
775
776 <A NAME="canInsert()"><!-- --></A><H3>
777 canInsert</H3>
778 <PRE>
779 public boolean <B>canInsert</B>()</PRE>
780 <DL>
781 <DD><IMG SRC="folder.gif" ALT="Directory Permission" WIDTH="16" HEIGHT="16" BORDER="0"> Tests whether the ACL permits <code>insert</code> access.
782
783  <p> This permission enables a user to add new files to the directory, either by creating 
784  or copying, and to create new subdirectories. It does not extend into any subdirectories,
785  which are protected by their own ACLs.
786
787  <p><FONT COLOR="666699"><IMG SRC="folder.gif" ALT="Directory Permission" WIDTH="16" HEIGHT="16" BORDER="0"> <U><B>Directory Permission</B></U></FONT><BR>
788  This permission is meaningful with respect to the 
789  directory itself. For example, the <code>insert</code> permission (see: <A HREF="../../../org/openafs/jafs/ACL.Entry.html#canInsert()"><CODE>canInsert()</CODE></A>)
790  does not control addition of data to a file, but rather creation of a new file or 
791  subdirectory. 
792
793  <p> Documentation reference: 
794  <A HREF="http://www.transarc.com/Library/documentation/afs/3.6/unix/en_US/HTML/AdminGd/auagd020.htm#HDRWQ782">The AFS ACL Permissions</A>
795 <P>
796 <DD><DL>
797 </DL>
798 </DD>
799 <DD><DL>
800
801 <DT><B>Returns:</B><DD><code>true</code> if and only if the ACL permits <code>insert</code> access for
802           directories; <code>false</code> otherwise</DL>
803 </DD>
804 </DL>
805 <HR>
806
807 <A NAME="setInsert(boolean)"><!-- --></A><H3>
808 setInsert</H3>
809 <PRE>
810 public void <B>setInsert</B>(boolean&nbsp;flag)</PRE>
811 <DL>
812 <DD>Sets the ACL permission to accomodate <code>insert</code> access for directories.
813 <P>
814 <DD><DL>
815 </DL>
816 </DD>
817 <DD><DL>
818 <DT><B>Parameters:</B><DD><CODE>flag</CODE> - boolean flag that denotes the permission bit for <code>insert</code> access.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/ACL.Entry.html#canInsert()"><CODE>canInsert()</CODE></A></DL>
819 </DD>
820 </DL>
821 <HR>
822
823 <A NAME="canDelete()"><!-- --></A><H3>
824 canDelete</H3>
825 <PRE>
826 public boolean <B>canDelete</B>()</PRE>
827 <DL>
828 <DD><IMG SRC="folder.gif" ALT="Directory Permission" WIDTH="16" HEIGHT="16" BORDER="0"> Tests whether the ACL permits <code>delete</code> access.
829
830  <p> This permission enables a user to remove files and subdirectories from the directory 
831  or move them into other directories (assuming that the user has the <code>insert</code>
832  (see: <A HREF="../../../org/openafs/jafs/ACL.Entry.html#canInsert()"><CODE>canInsert()</CODE></A>) permission on the ACL of the other directories).
833
834  <p><FONT COLOR="666699"><IMG SRC="folder.gif" ALT="Directory Permission" WIDTH="16" HEIGHT="16" BORDER="0"> <U><B>Directory Permission</B></U></FONT><BR>
835  This permission is meaningful with respect to the 
836  directory itself. For example, the <code>insert</code> permission (see: <A HREF="../../../org/openafs/jafs/ACL.Entry.html#canInsert()"><CODE>canInsert()</CODE></A>)
837  does not control addition of data to a file, but rather creation of a new file or 
838  subdirectory. 
839
840  <p> Documentation reference: 
841  <A HREF="http://www.transarc.com/Library/documentation/afs/3.6/unix/en_US/HTML/AdminGd/auagd020.htm#HDRWQ782">The AFS ACL Permissions</A>
842 <P>
843 <DD><DL>
844 </DL>
845 </DD>
846 <DD><DL>
847
848 <DT><B>Returns:</B><DD><code>true</code> if and only if the ACL permits <code>delete</code> access for
849           directories; <code>false</code> otherwise</DL>
850 </DD>
851 </DL>
852 <HR>
853
854 <A NAME="setDelete(boolean)"><!-- --></A><H3>
855 setDelete</H3>
856 <PRE>
857 public void <B>setDelete</B>(boolean&nbsp;flag)</PRE>
858 <DL>
859 <DD>Sets the ACL permission to accomodate <code>delete</code> access for directories.
860 <P>
861 <DD><DL>
862 </DL>
863 </DD>
864 <DD><DL>
865 <DT><B>Parameters:</B><DD><CODE>flag</CODE> - boolean flag that denotes the permission bit for <code>delete</code> rights.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/ACL.Entry.html#canDelete()"><CODE>canDelete()</CODE></A></DL>
866 </DD>
867 </DL>
868 <HR>
869
870 <A NAME="canWrite()"><!-- --></A><H3>
871 canWrite</H3>
872 <PRE>
873 public boolean <B>canWrite</B>()</PRE>
874 <DL>
875 <DD><IMG SRC="file.gif" ALT="File Permission" WIDTH="16" HEIGHT="16" BORDER="0"> Tests whether the ACL permits <code>write</code> access.
876
877  <p> This permission enables a user to modify the contents of files in the directory 
878  and to change their operating system specific mode bits. 
879
880  <p><FONT COLOR="666699"><IMG SRC="file.gif" ALT="File Permission" WIDTH="16" HEIGHT="16" BORDER="0"> <U><B>File Permission</B></U></FONT><BR>
881  This permission is meaningful with respect to files in 
882  a directory, rather than the directory itself or its subdirectories. 
883
884  <p> Documentation reference: 
885  <A HREF="http://www.transarc.com/Library/documentation/afs/3.6/unix/en_US/HTML/AdminGd/auagd020.htm#HDRWQ782">The AFS ACL Permissions</A>
886 <P>
887 <DD><DL>
888 </DL>
889 </DD>
890 <DD><DL>
891
892 <DT><B>Returns:</B><DD><code>true</code> if and only if the ACL permits <code>write</code> access for
893           files; <code>false</code> otherwise</DL>
894 </DD>
895 </DL>
896 <HR>
897
898 <A NAME="setWrite(boolean)"><!-- --></A><H3>
899 setWrite</H3>
900 <PRE>
901 public void <B>setWrite</B>(boolean&nbsp;flag)</PRE>
902 <DL>
903 <DD>Sets the ACL permission to accomodate <code>write</code> access for files.
904 <P>
905 <DD><DL>
906 </DL>
907 </DD>
908 <DD><DL>
909 <DT><B>Parameters:</B><DD><CODE>flag</CODE> - boolean flag that denotes the permission bit for <code>write</code> access.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/ACL.Entry.html#canWrite()"><CODE>canWrite()</CODE></A></DL>
910 </DD>
911 </DL>
912 <HR>
913
914 <A NAME="canLock()"><!-- --></A><H3>
915 canLock</H3>
916 <PRE>
917 public boolean <B>canLock</B>()</PRE>
918 <DL>
919 <DD><IMG SRC="file.gif" ALT="File Permission" WIDTH="16" HEIGHT="16" BORDER="0"> Tests whether the ACL permits the <code>lock</code> authority.
920
921  <p> This permission enables the user to run programs that issue system calls to 
922  lock files in the directory. 
923
924  <p><FONT COLOR="666699"><IMG SRC="file.gif" ALT="File Permission" WIDTH="16" HEIGHT="16" BORDER="0"> <U><B>File Permission</B></U></FONT><BR>
925  This permission is meaningful with respect to files in 
926  a directory, rather than the directory itself or its subdirectories. 
927
928  <p> Documentation reference: 
929  <A HREF="http://www.transarc.com/Library/documentation/afs/3.6/unix/en_US/HTML/AdminGd/auagd020.htm#HDRWQ782">The AFS ACL Permissions</A>
930 <P>
931 <DD><DL>
932 </DL>
933 </DD>
934 <DD><DL>
935
936 <DT><B>Returns:</B><DD><code>true</code> if and only if the ACL permits <code>lock</code> authority for
937           files; <code>false</code> otherwise</DL>
938 </DD>
939 </DL>
940 <HR>
941
942 <A NAME="setLock(boolean)"><!-- --></A><H3>
943 setLock</H3>
944 <PRE>
945 public void <B>setLock</B>(boolean&nbsp;flag)</PRE>
946 <DL>
947 <DD>Sets the ACL permission to accomodate <code>lock</code> access for files.
948 <P>
949 <DD><DL>
950 </DL>
951 </DD>
952 <DD><DL>
953 <DT><B>Parameters:</B><DD><CODE>flag</CODE> - boolean flag that denotes the permission bit for <code>lock</code> rights.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/ACL.Entry.html#canLock()"><CODE>canLock()</CODE></A></DL>
954 </DD>
955 </DL>
956 <HR>
957
958 <A NAME="canAdmin()"><!-- --></A><H3>
959 canAdmin</H3>
960 <PRE>
961 public boolean <B>canAdmin</B>()</PRE>
962 <DL>
963 <DD><IMG SRC="folder.gif" ALT="Directory Permission" WIDTH="16" HEIGHT="16" BORDER="0"> Tests whether the ACL permits <code>administer</code> access.
964
965  <p> This permission enables a user to change the directory's ACL. Members of the 
966  <code>system:administrators</code> group implicitly have this permission on every 
967  directory (that is, even if that group does not appear on the ACL). Similarly, the 
968  owner of a directory implicitly has this permission on its ACL and those of all 
969  directories below it that he or she owns. 
970
971  <p><FONT COLOR="666699"><IMG SRC="folder.gif" ALT="Directory Permission" WIDTH="16" HEIGHT="16" BORDER="0"> <U><B>Directory Permission</B></U></FONT><BR>
972  This permission is meaningful with respect to the 
973  directory itself. For example, the <code>insert</code> permission (see: <A HREF="../../../org/openafs/jafs/ACL.Entry.html#canInsert()"><CODE>canInsert()</CODE></A>)
974  does not control addition of data to a file, but rather creation of a new file or 
975  subdirectory. 
976
977  <p> Documentation reference: 
978  <A HREF="http://www.transarc.com/Library/documentation/afs/3.6/unix/en_US/HTML/AdminGd/auagd020.htm#HDRWQ782">The AFS ACL Permissions</A>
979 <P>
980 <DD><DL>
981 </DL>
982 </DD>
983 <DD><DL>
984
985 <DT><B>Returns:</B><DD><code>true</code> if and only if the ACL permits <code>administer</code> access for
986           directories; <code>false</code> otherwise</DL>
987 </DD>
988 </DL>
989 <HR>
990
991 <A NAME="setAdmin(boolean)"><!-- --></A><H3>
992 setAdmin</H3>
993 <PRE>
994 public void <B>setAdmin</B>(boolean&nbsp;flag)</PRE>
995 <DL>
996 <DD>Sets the ACL permission to accomodate <code>administer</code> rights for directories.
997 <P>
998 <DD><DL>
999 </DL>
1000 </DD>
1001 <DD><DL>
1002 <DT><B>Parameters:</B><DD><CODE>flag</CODE> - boolean flag that denotes the permission bit for <code>administer</code> rights.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/ACL.Entry.html#canAdmin()"><CODE>canAdmin()</CODE></A></DL>
1003 </DD>
1004 </DL>
1005 <HR>
1006
1007 <A NAME="equals(org.openafs.jafs.ACL.Entry)"><!-- --></A><H3>
1008 equals</H3>
1009 <PRE>
1010 public boolean <B>equals</B>(<A HREF="../../../org/openafs/jafs/ACL.Entry.html">ACL.Entry</A>&nbsp;entry)</PRE>
1011 <DL>
1012 <DD>Tests whether two <code>ACL.Entry</code> objects are equal, based on associated
1013  username and permission bits.
1014 <P>
1015 <DD><DL>
1016 </DL>
1017 </DD>
1018 <DD><DL>
1019 <DT><B>Parameters:</B><DD><CODE>entry</CODE> - the ACL.Entry to test
1020 <DT><B>Returns:</B><DD>whether the specifed ACL.Entry is the same as this ACL.Entry</DL>
1021 </DD>
1022 </DL>
1023 <HR>
1024
1025 <A NAME="toString()"><!-- --></A><H3>
1026 toString</H3>
1027 <PRE>
1028 public <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> <B>toString</B>()</PRE>
1029 <DL>
1030 <DD>Returns a String representation of this <CODE>ACL.Entry</CODE>
1031 <P>
1032 <DD><DL>
1033 <DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#toString()">toString</A></CODE> in class <CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html">Object</A></CODE></DL>
1034 </DD>
1035 <DD><DL>
1036
1037 <DT><B>Returns:</B><DD>a String representation of this <CODE>ACL.Entry</CODE></DL>
1038 </DD>
1039 </DL>
1040 <!-- ========= END OF CLASS DATA ========= -->
1041 <HR>
1042
1043 <!-- ========== START OF NAVBAR ========== -->
1044 <A NAME="navbar_bottom"><!-- --></A>
1045 <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
1046 <TR>
1047 <TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
1048 <A NAME="navbar_bottom_firstrow"><!-- --></A>
1049 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
1050   <TR ALIGN="center" VALIGN="top">
1051   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
1052   <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
1053   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/ACL.Entry.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
1054   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
1055   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
1056   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
1057   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
1058   </TR>
1059 </TABLE>
1060 </TD>
1061 <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
1062 <B>JAFS API v2</B></EM>
1063 </TD>
1064 </TR>
1065
1066 <TR>
1067 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
1068 &nbsp;<A HREF="../../../org/openafs/jafs/ACL.html"><B>PREV CLASS</B></A>&nbsp;
1069 &nbsp;<A HREF="../../../org/openafs/jafs/AFSLibraryLoader.html"><B>NEXT CLASS</B></A></FONT></TD>
1070 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
1071   <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
1072 &nbsp;<A HREF="ACL.Entry.html" TARGET="_top"><B>NO FRAMES</B></A>  &nbsp;
1073 &nbsp;
1074 <SCRIPT>
1075   <!--
1076   if(window==top) {
1077     document.writeln('<A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>');
1078   }
1079   //-->
1080 </SCRIPT>
1081 <NOSCRIPT>
1082 <A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>
1083 </NOSCRIPT>
1084 </FONT></TD>
1085 </TR>
1086 <TR>
1087 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
1088   SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
1089 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
1090 DETAIL:&nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
1091 </TR>
1092 </TABLE>
1093 <!-- =========== END OF NAVBAR =========== -->
1094
1095 <HR>
1096
1097 </BODY>
1098 </HTML>