1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN""http://www.w3.org/TR/REC-html40/loose.dtd">
5 <!-- Generated by javadoc on Mon Jun 09 15:53:37 PDT 2003 -->
9 <META NAME="keywords" CONTENT="org.openafs.jafs.Group,Group class">
10 <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
15 parent.document.title="Group (Java AFS API)";
18 <BODY BGCOLOR="white" onload="asd();">
20 <!-- ========== START OF NAVBAR ========== -->
21 <A NAME="navbar_top"><!-- --></A>
22 <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
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> </TD>
29 <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
30 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/Group.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
31 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
32 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
33 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
34 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
38 <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
39 <B>JAFS API v2</B></EM>
44 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
45 <A HREF="../../../org/openafs/jafs/FileOutputStream.html"><B>PREV CLASS</B></A>
46 <A HREF="../../../org/openafs/jafs/Key.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>
49 <A HREF="Group.html" TARGET="_top"><B>NO FRAMES</B></A>
54 document.writeln('<A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>');
59 <A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>
64 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
65 SUMMARY: NESTED | <A HREF="#field_summary">FIELD</A> | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
66 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
67 DETAIL: <A HREF="#field_detail">FIELD</A> | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
70 <!-- =========== END OF NAVBAR =========== -->
73 <!-- ======== START OF CLASS DATA ======== -->
76 org.openafs.jafs</FONT>
80 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html">java.lang.Object</A>
82 +--<B>org.openafs.jafs.Group</B>
85 <DT><B>All Implemented Interfaces:</B> <DD><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Comparable.html">Comparable</A>, <A HREF="../../../org/openafs/jafs/PTSEntry.html">PTSEntry</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/Serializable.html">Serializable</A></DD>
89 <DT>public class <B>Group</B><DT>extends <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html">Object</A><DT>implements <A HREF="../../../org/openafs/jafs/PTSEntry.html">PTSEntry</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/Serializable.html">Serializable</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Comparable.html">Comparable</A></DL>
92 An abstract representation of an AFS group. It holds information about
93 the group, such as what groups it owns.<BR><BR>
95 Constructing an instance of a <code>Group</code> does not mean an actual
96 AFS group is created in a cell -- usually a <code>Group</code>
97 object is a representation of an already existing AFS group. If,
98 however, the <code>Group</code> is constructed with the name of a
99 group that does not exist in the cell represented by the provided
100 <code>Cell</code>, a new group with that name can be
101 created in that cell by calling the <A HREF="../../../org/openafs/jafs/Group.html#create(java.lang.String, int)"><CODE>create(String, int)</CODE></A> or
102 <A HREF="../../../org/openafs/jafs/Group.html#create(java.lang.String)"><CODE>create(String)</CODE></A> method. If such a group does already exist when
103 one of these methods is called, an exception will be thrown.<BR><BR>
105 Each <code>Group</code> object has its own individual set of
106 <code>Group</code>s that it owns and <code>User</code>s that belong
107 to it. These represents the properties and attributes
108 of an actual AFS group.
111 <!--Information on how member values are set-->
113 Associated with an AFS group are many attributes, such as whether or not
114 who is allowed to list the members of this group. The <code>Group</code>
115 class has many "set" methods to indicate values for these attributes (i.e.
116 <A HREF="../../../org/openafs/jafs/Group.html#setListMembership(int)"><CODE>setListMembership(int)</CODE></A>. However, in order for these values to be
117 written to the actual AFS group, the <A HREF="../../../org/openafs/jafs/Group.html#flushInfo()"><CODE>flushInfo()</CODE></A> method needs to
118 be called. This writes all user attributes set through this API to AFS.
119 This is done to minimize calls through JNI.<BR><BR>
121 <!--Example of how to use class-->
122 The following is a simple example of how to construct and use a
123 <code>Group</code> object. It lists the name and owner of a specified
127 import org.openafs.jafs.Cell;
128 import org.openafs.jafs.AFSException;
129 import org.openafs.jafs.Partition;
130 import org.openafs.jafs.Group;
138 public static void main(String[] args) throws Exception
140 String username = arg[0];
141 String password = arg[1];
142 String cellName = arg[2];
143 String groupName = arg[3];
145 token = new Token(username, password, cellName);
146 cell = new Cell(token);
147 group = new Group(groupName, cell);
149 System.out.println("Owner of group " + group.getName() + " is "
150 + group.getOwnerName());
160 <DT><B>See Also:</B><DD><A HREF="../../../serialized-form.html" TARGET="org.openafs.jafs.Group">Serialized Form</A></DL>
164 <!-- ======== NESTED CLASS SUMMARY ======== -->
167 <!-- =========== FIELD SUMMARY =========== -->
169 <A NAME="field_summary"><!-- --></A>
170 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
171 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
172 <TD COLSPAN=2><FONT SIZE="+2">
173 <B>Field Summary</B></FONT></TD>
175 <TR BGCOLOR="white" CLASS="TableRowColor">
176 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
177 <CODE>protected boolean</CODE></FONT></TD>
178 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#cachedInfo">cachedInfo</A></B></CODE>
181 Whether or not the information fields of this group have been filled.</TD>
183 <TR BGCOLOR="white" CLASS="TableRowColor">
184 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
185 <CODE>protected <A HREF="../../../org/openafs/jafs/Cell.html">Cell</A></CODE></FONT></TD>
186 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#cell">cell</A></B></CODE>
189 </TD>
191 <TR BGCOLOR="white" CLASS="TableRowColor">
192 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
193 <CODE>protected int</CODE></FONT></TD>
194 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#cellHandle">cellHandle</A></B></CODE>
197 </TD>
199 <TR BGCOLOR="white" CLASS="TableRowColor">
200 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
201 <CODE>protected <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A></CODE></FONT></TD>
202 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#creator">creator</A></B></CODE>
205 </TD>
207 <TR BGCOLOR="white" CLASS="TableRowColor">
208 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
209 <CODE>protected int</CODE></FONT></TD>
210 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#creatorUID">creatorUID</A></B></CODE>
213 </TD>
215 <TR BGCOLOR="white" CLASS="TableRowColor">
216 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
217 <CODE>static int</CODE></FONT></TD>
218 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#GROUP_ANYUSER_ACCESS">GROUP_ANYUSER_ACCESS</A></B></CODE>
221 Any user has access</TD>
223 <TR BGCOLOR="white" CLASS="TableRowColor">
224 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
225 <CODE>static int</CODE></FONT></TD>
226 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#GROUP_GROUP_ACCESS">GROUP_GROUP_ACCESS</A></B></CODE>
229 Members of the group have access</TD>
231 <TR BGCOLOR="white" CLASS="TableRowColor">
232 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
233 <CODE>static int</CODE></FONT></TD>
234 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#GROUP_OWNER_ACCESS">GROUP_OWNER_ACCESS</A></B></CODE>
237 Only the owner of the group has access</TD>
239 <TR BGCOLOR="white" CLASS="TableRowColor">
240 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
241 <CODE>protected <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/util/ArrayList.html">ArrayList</A></CODE></FONT></TD>
242 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#groupsOwned">groupsOwned</A></B></CODE>
245 </TD>
247 <TR BGCOLOR="white" CLASS="TableRowColor">
248 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
249 <CODE>protected <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/util/ArrayList.html">ArrayList</A></CODE></FONT></TD>
250 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#groupsOwnedNames">groupsOwnedNames</A></B></CODE>
253 </TD>
255 <TR BGCOLOR="white" CLASS="TableRowColor">
256 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
257 <CODE>protected int</CODE></FONT></TD>
258 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#listAdd">listAdd</A></B></CODE>
261 who is allowed to execute PTS adduser for this group. </TD>
263 <TR BGCOLOR="white" CLASS="TableRowColor">
264 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
265 <CODE>protected int</CODE></FONT></TD>
266 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#listDelete">listDelete</A></B></CODE>
269 who is allowed to execute PTS removeuser for this group. </TD>
271 <TR BGCOLOR="white" CLASS="TableRowColor">
272 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
273 <CODE>protected int</CODE></FONT></TD>
274 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#listGroupsOwned">listGroupsOwned</A></B></CODE>
277 who is allowed to execute PTS examine for this group. </TD>
279 <TR BGCOLOR="white" CLASS="TableRowColor">
280 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
281 <CODE>protected int</CODE></FONT></TD>
282 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#listMembership">listMembership</A></B></CODE>
285 who is allowed to execute PTS listowned for this group. </TD>
287 <TR BGCOLOR="white" CLASS="TableRowColor">
288 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
289 <CODE>protected int</CODE></FONT></TD>
290 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#listStatus">listStatus</A></B></CODE>
293 who is allowed to execute PTS examine for this group. </TD>
295 <TR BGCOLOR="white" CLASS="TableRowColor">
296 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
297 <CODE>protected <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/util/ArrayList.html">ArrayList</A></CODE></FONT></TD>
298 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#memberNames">memberNames</A></B></CODE>
301 </TD>
303 <TR BGCOLOR="white" CLASS="TableRowColor">
304 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
305 <CODE>protected <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/util/ArrayList.html">ArrayList</A></CODE></FONT></TD>
306 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#members">members</A></B></CODE>
309 </TD>
311 <TR BGCOLOR="white" CLASS="TableRowColor">
312 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
313 <CODE>protected int</CODE></FONT></TD>
314 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#membershipCount">membershipCount</A></B></CODE>
317 </TD>
319 <TR BGCOLOR="white" CLASS="TableRowColor">
320 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
321 <CODE>protected <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A></CODE></FONT></TD>
322 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#name">name</A></B></CODE>
325 </TD>
327 <TR BGCOLOR="white" CLASS="TableRowColor">
328 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
329 <CODE>protected int</CODE></FONT></TD>
330 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#nameUID">nameUID</A></B></CODE>
333 </TD>
335 <TR BGCOLOR="white" CLASS="TableRowColor">
336 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
337 <CODE>protected <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A></CODE></FONT></TD>
338 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#owner">owner</A></B></CODE>
341 </TD>
343 <TR BGCOLOR="white" CLASS="TableRowColor">
344 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
345 <CODE>protected int</CODE></FONT></TD>
346 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#ownerUID">ownerUID</A></B></CODE>
349 </TD>
352 <A NAME="fields_inherited_from_class_org.openafs.jafs.PTSEntry"><!-- --></A>
353 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
354 <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
355 <TD><B>Fields inherited from interface org.openafs.jafs.<A HREF="../../../org/openafs/jafs/PTSEntry.html">PTSEntry</A></B></TD>
357 <TR BGCOLOR="white" CLASS="TableRowColor">
358 <TD><CODE><A HREF="../../../org/openafs/jafs/PTSEntry.html#PTS_GROUP">PTS_GROUP</A>, <A HREF="../../../org/openafs/jafs/PTSEntry.html#PTS_USER">PTS_USER</A></CODE></TD>
362 <!-- ======== CONSTRUCTOR SUMMARY ======== -->
364 <A NAME="constructor_summary"><!-- --></A>
365 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
366 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
367 <TD COLSPAN=2><FONT SIZE="+2">
368 <B>Constructor Summary</B></FONT></TD>
370 <TR BGCOLOR="white" CLASS="TableRowColor">
371 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
372 <CODE>(package private)</CODE></FONT></TD>
373 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#Group(org.openafs.jafs.Cell)">Group</A></B>(<A HREF="../../../org/openafs/jafs/Cell.html">Cell</A> cell)</CODE>
376 Creates a blank <code>Group</code> given the cell to which the group
379 <TR BGCOLOR="white" CLASS="TableRowColor">
380 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
381 <CODE> </CODE></FONT></TD>
382 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#Group(java.lang.String, org.openafs.jafs.Cell)">Group</A></B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> name,
383 <A HREF="../../../org/openafs/jafs/Cell.html">Cell</A> cell)</CODE>
386 Constructs a new <code>Group</code> object instance given the name
387 of the AFS group and the AFS cell, represented by
388 <CODE>cell</CODE>, to which it belongs. </TD>
390 <TR BGCOLOR="white" CLASS="TableRowColor">
391 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
392 <CODE> </CODE></FONT></TD>
393 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#Group(java.lang.String, org.openafs.jafs.Cell, boolean)">Group</A></B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> name,
394 <A HREF="../../../org/openafs/jafs/Cell.html">Cell</A> cell,
395 boolean preloadAllMembers)</CODE>
398 Constructs a new <code>Group</code> object instance given the name
399 of the AFS group and the AFS cell, represented by
400 <CODE>cell</CODE>, to which it belongs. </TD>
404 <!-- ========== METHOD SUMMARY =========== -->
406 <A NAME="method_summary"><!-- --></A>
407 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
408 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
409 <TD COLSPAN=2><FONT SIZE="+2">
410 <B>Method Summary</B></FONT></TD>
412 <TR BGCOLOR="white" CLASS="TableRowColor">
413 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
414 <CODE>protected static void</CODE></FONT></TD>
415 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#addMember(int, java.lang.String, java.lang.String)">addMember</A></B>(int cellHandle,
416 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> groupName,
417 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> userName)</CODE>
420 Adds a user to the specified group.</TD>
422 <TR BGCOLOR="white" CLASS="TableRowColor">
423 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
424 <CODE> void</CODE></FONT></TD>
425 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#addMember(org.openafs.jafs.User)">addMember</A></B>(<A HREF="../../../org/openafs/jafs/User.html">User</A> theUser)</CODE>
428 Add the specified member to this group.</TD>
430 <TR BGCOLOR="white" CLASS="TableRowColor">
431 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
432 <CODE> void</CODE></FONT></TD>
433 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#changeOwner(org.openafs.jafs.Group)">changeOwner</A></B>(<A HREF="../../../org/openafs/jafs/Group.html">Group</A> theOwner)</CODE>
436 Change the owner of this group.</TD>
438 <TR BGCOLOR="white" CLASS="TableRowColor">
439 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
440 <CODE>protected static void</CODE></FONT></TD>
441 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#changeOwner(int, java.lang.String, java.lang.String)">changeOwner</A></B>(int cellHandle,
442 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> groupName,
443 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> ownerName)</CODE>
446 Change the owner of the specified group.</TD>
448 <TR BGCOLOR="white" CLASS="TableRowColor">
449 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
450 <CODE> void</CODE></FONT></TD>
451 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#changeOwner(org.openafs.jafs.User)">changeOwner</A></B>(<A HREF="../../../org/openafs/jafs/User.html">User</A> theOwner)</CODE>
454 Change the owner of this group.</TD>
456 <TR BGCOLOR="white" CLASS="TableRowColor">
457 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
458 <CODE> int</CODE></FONT></TD>
459 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#compareTo(org.openafs.jafs.Group)">compareTo</A></B>(<A HREF="../../../org/openafs/jafs/Group.html">Group</A> group)</CODE>
462 Compares two Group objects respective to their names and does not
463 factor any other attribute. </TD>
465 <TR BGCOLOR="white" CLASS="TableRowColor">
466 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
467 <CODE> int</CODE></FONT></TD>
468 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#compareTo(java.lang.Object)">compareTo</A></B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html">Object</A> obj)</CODE>
471 Comparable interface method.</TD>
473 <TR BGCOLOR="white" CLASS="TableRowColor">
474 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
475 <CODE>protected static void</CODE></FONT></TD>
476 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#create(int, java.lang.String, java.lang.String, int)">create</A></B>(int cellHandle,
477 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> groupName,
478 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> ownerName,
482 Creates the PTS entry for a new group. </TD>
484 <TR BGCOLOR="white" CLASS="TableRowColor">
485 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
486 <CODE> void</CODE></FONT></TD>
487 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#create(java.lang.String)">create</A></B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> ownerName)</CODE>
490 Creates the PTS entry for a new group in this cell. </TD>
492 <TR BGCOLOR="white" CLASS="TableRowColor">
493 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
494 <CODE> void</CODE></FONT></TD>
495 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#create(java.lang.String, int)">create</A></B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> ownerName,
499 Creates the PTS entry for a new group in this cell.</TD>
501 <TR BGCOLOR="white" CLASS="TableRowColor">
502 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
503 <CODE> void</CODE></FONT></TD>
504 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#delete()">delete</A></B>()</CODE>
507 Deletes the PTS entry for a group in this cell. </TD>
509 <TR BGCOLOR="white" CLASS="TableRowColor">
510 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
511 <CODE>protected static void</CODE></FONT></TD>
512 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#delete(int, java.lang.String)">delete</A></B>(int cellHandle,
513 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> groupName)</CODE>
516 Deletes the PTS entry for a group. </TD>
518 <TR BGCOLOR="white" CLASS="TableRowColor">
519 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
520 <CODE> boolean</CODE></FONT></TD>
521 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#equals(org.openafs.jafs.Group)">equals</A></B>(<A HREF="../../../org/openafs/jafs/Group.html">Group</A> otherGroup)</CODE>
524 Tests whether two <code>Group</code> objects are equal, based on their
527 <TR BGCOLOR="white" CLASS="TableRowColor">
528 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
529 <CODE> void</CODE></FONT></TD>
530 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#flushInfo()">flushInfo</A></B>()</CODE>
533 Flushes the current information of this <code>Group</code> object to disk.
536 <TR BGCOLOR="white" CLASS="TableRowColor">
537 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
538 <CODE> <A HREF="../../../org/openafs/jafs/Cell.html">Cell</A></CODE></FONT></TD>
539 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#getCell()">getCell</A></B>()</CODE>
542 Returns the Cell this group belongs to.</TD>
544 <TR BGCOLOR="white" CLASS="TableRowColor">
545 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
546 <CODE> <A HREF="../../../org/openafs/jafs/PTSEntry.html">PTSEntry</A></CODE></FONT></TD>
547 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#getCreator()">getCreator</A></B>()</CODE>
550 PTS: Returns the creator of this group in the form of a <A HREF="../../../org/openafs/jafs/PTSEntry.html"><CODE>PTSEntry</CODE></A>.
554 <TR BGCOLOR="white" CLASS="TableRowColor">
555 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
556 <CODE>protected static void</CODE></FONT></TD>
557 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#getGroupInfo(int, java.lang.String, org.openafs.jafs.Group)">getGroupInfo</A></B>(int cellHandle,
558 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> name,
559 <A HREF="../../../org/openafs/jafs/Group.html">Group</A> group)</CODE>
562 Fills in the information fields of the provided <code>Group</code>.
565 <TR BGCOLOR="white" CLASS="TableRowColor">
566 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
567 <CODE>protected static int</CODE></FONT></TD>
568 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#getGroupMembersBegin(int, java.lang.String)">getGroupMembersBegin</A></B>(int cellHandle,
569 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> name)</CODE>
572 Begin the process of getting the users that belong to the group. </TD>
574 <TR BGCOLOR="white" CLASS="TableRowColor">
575 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
576 <CODE>protected static void</CODE></FONT></TD>
577 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#getGroupMembersDone(int)">getGroupMembersDone</A></B>(int iterationId)</CODE>
580 Signals that the iteration is complete and will not be accessed anymore.</TD>
582 <TR BGCOLOR="white" CLASS="TableRowColor">
583 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
584 <CODE>protected static int</CODE></FONT></TD>
585 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#getGroupMembersNext(int, int, org.openafs.jafs.User)">getGroupMembersNext</A></B>(int cellHandle,
586 int iterationId,
587 <A HREF="../../../org/openafs/jafs/User.html">User</A> theUser)</CODE>
590 Fills the next user object belonging to that group. </TD>
592 <TR BGCOLOR="white" CLASS="TableRowColor">
593 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
594 <CODE>protected static <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A></CODE></FONT></TD>
595 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#getGroupMembersNextString(int)">getGroupMembersNextString</A></B>(int iterationId)</CODE>
598 Returns the next members that belongs to the group. </TD>
600 <TR BGCOLOR="white" CLASS="TableRowColor">
601 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
602 <CODE> <A HREF="../../../org/openafs/jafs/Group.html">Group</A>[]</CODE></FONT></TD>
603 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#getGroupsOwned()">getGroupsOwned</A></B>()</CODE>
606 Returns an array of the <code>Group</code> objects this group owns.</TD>
608 <TR BGCOLOR="white" CLASS="TableRowColor">
609 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
610 <CODE> <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>[]</CODE></FONT></TD>
611 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#getGroupsOwnedNames()">getGroupsOwnedNames</A></B>()</CODE>
614 Returns an array of the group names this group owns.
617 <TR BGCOLOR="white" CLASS="TableRowColor">
618 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
619 <CODE>protected <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A></CODE></FONT></TD>
620 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#getInfo()">getInfo</A></B>()</CODE>
623 Returns a <code>String</code> representation of this <code>Group</code>.
626 <TR BGCOLOR="white" CLASS="TableRowColor">
627 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
628 <CODE> int</CODE></FONT></TD>
629 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#getListAdd()">getListAdd</A></B>()</CODE>
632 Returns who can add members (pts adduser) to this group.
635 <TR BGCOLOR="white" CLASS="TableRowColor">
636 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
637 <CODE> int</CODE></FONT></TD>
638 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#getListDelete()">getListDelete</A></B>()</CODE>
641 Returns who can delete members (pts removemember) from this group.
644 <TR BGCOLOR="white" CLASS="TableRowColor">
645 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
646 <CODE> int</CODE></FONT></TD>
647 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#getListGroupsOwned()">getListGroupsOwned</A></B>()</CODE>
650 Returns who can list the groups owned (pts listowned) by this group.
653 <TR BGCOLOR="white" CLASS="TableRowColor">
654 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
655 <CODE> int</CODE></FONT></TD>
656 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#getListMembership()">getListMembership</A></B>()</CODE>
659 Returns who can list the users (pts membership) that belong to this group.
662 <TR BGCOLOR="white" CLASS="TableRowColor">
663 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
664 <CODE> int</CODE></FONT></TD>
665 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#getListStatus()">getListStatus</A></B>()</CODE>
668 Returns who can list the status (pts examine) of this group.
671 <TR BGCOLOR="white" CLASS="TableRowColor">
672 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
673 <CODE> <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>[]</CODE></FONT></TD>
674 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#getMemberNames()">getMemberNames</A></B>()</CODE>
677 Returns an array of the member names of this group.</TD>
679 <TR BGCOLOR="white" CLASS="TableRowColor">
680 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
681 <CODE> <A HREF="../../../org/openafs/jafs/User.html">User</A>[]</CODE></FONT></TD>
682 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#getMembers()">getMembers</A></B>()</CODE>
685 Returns an array of the <code>User</code> object members of this group.</TD>
687 <TR BGCOLOR="white" CLASS="TableRowColor">
688 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
689 <CODE> int</CODE></FONT></TD>
690 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#getMembershipCount()">getMembershipCount</A></B>()</CODE>
693 Returns the number of members of this group.</TD>
695 <TR BGCOLOR="white" CLASS="TableRowColor">
696 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
697 <CODE> <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A></CODE></FONT></TD>
698 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#getName()">getName</A></B>()</CODE>
701 Returns the name of this group.</TD>
703 <TR BGCOLOR="white" CLASS="TableRowColor">
704 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
705 <CODE> <A HREF="../../../org/openafs/jafs/PTSEntry.html">PTSEntry</A></CODE></FONT></TD>
706 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#getOwner()">getOwner</A></B>()</CODE>
709 PTS: Returns the owner of this group in the form of a <A HREF="../../../org/openafs/jafs/PTSEntry.html"><CODE>PTSEntry</CODE></A>.
713 <TR BGCOLOR="white" CLASS="TableRowColor">
714 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
715 <CODE> short</CODE></FONT></TD>
716 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#getType()">getType</A></B>()</CODE>
719 Returns the type of <A HREF="../../../org/openafs/jafs/PTSEntry.html"><CODE>PTSEntry</CODE></A> this object represents.
723 <TR BGCOLOR="white" CLASS="TableRowColor">
724 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
725 <CODE> int</CODE></FONT></TD>
726 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#getUID()">getUID</A></B>()</CODE>
729 Returns the numeric AFS id of this group.</TD>
731 <TR BGCOLOR="white" CLASS="TableRowColor">
732 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
733 <CODE>protected static void</CODE></FONT></TD>
734 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#reclaimGroupMemory()">reclaimGroupMemory</A></B>()</CODE>
737 Reclaims all memory being saved by the group portion of the native
741 <TR BGCOLOR="white" CLASS="TableRowColor">
742 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
743 <CODE> void</CODE></FONT></TD>
744 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#refresh()">refresh</A></B>()</CODE>
747 Refreshes the properties of this Group object instance with values from
748 the AFS group it represents. </TD>
750 <TR BGCOLOR="white" CLASS="TableRowColor">
751 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
752 <CODE>protected void</CODE></FONT></TD>
753 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#refresh(boolean)">refresh</A></B>(boolean all)</CODE>
756 Refreshes the properties of this Group object instance with values from
757 the AFS group it represents. </TD>
759 <TR BGCOLOR="white" CLASS="TableRowColor">
760 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
761 <CODE>protected void</CODE></FONT></TD>
762 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#refreshGroupsOwned()">refreshGroupsOwned</A></B>()</CODE>
765 Refreshes the current information about the <code>Group</code> objects the
768 <TR BGCOLOR="white" CLASS="TableRowColor">
769 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
770 <CODE>protected void</CODE></FONT></TD>
771 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#refreshGroupsOwnedNames()">refreshGroupsOwnedNames</A></B>()</CODE>
774 Refreshes the current information about the names of groups the group
777 <TR BGCOLOR="white" CLASS="TableRowColor">
778 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
779 <CODE>protected void</CODE></FONT></TD>
780 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#refreshInfo()">refreshInfo</A></B>()</CODE>
783 Refreshes the information fields of this <code>Group</code> to reflect
784 the current state of the AFS group. </TD>
786 <TR BGCOLOR="white" CLASS="TableRowColor">
787 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
788 <CODE>protected void</CODE></FONT></TD>
789 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#refreshMemberNames()">refreshMemberNames</A></B>()</CODE>
792 Refreshes the current information about the names of members belonging
795 <TR BGCOLOR="white" CLASS="TableRowColor">
796 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
797 <CODE>protected void</CODE></FONT></TD>
798 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#refreshMembers()">refreshMembers</A></B>()</CODE>
801 Refreshes the current information about the <code>User</code> objects
802 belonging to this group. </TD>
804 <TR BGCOLOR="white" CLASS="TableRowColor">
805 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
806 <CODE>protected static void</CODE></FONT></TD>
807 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#removeMember(int, java.lang.String, java.lang.String)">removeMember</A></B>(int cellHandle,
808 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> groupName,
809 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> userName)</CODE>
812 Removes a user from the specified group.</TD>
814 <TR BGCOLOR="white" CLASS="TableRowColor">
815 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
816 <CODE> void</CODE></FONT></TD>
817 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#removeMember(org.openafs.jafs.User)">removeMember</A></B>(<A HREF="../../../org/openafs/jafs/User.html">User</A> theUser)</CODE>
820 Remove the specified member from this group.</TD>
822 <TR BGCOLOR="white" CLASS="TableRowColor">
823 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
824 <CODE>protected static void</CODE></FONT></TD>
825 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#rename(int, java.lang.String, java.lang.String)">rename</A></B>(int cellHandle,
826 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> oldGroupName,
827 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> newGroupName)</CODE>
830 Change the name of the specified group.</TD>
832 <TR BGCOLOR="white" CLASS="TableRowColor">
833 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
834 <CODE> void</CODE></FONT></TD>
835 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#rename(java.lang.String)">rename</A></B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> newName)</CODE>
838 Change the name of this group.</TD>
840 <TR BGCOLOR="white" CLASS="TableRowColor">
841 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
842 <CODE>protected static void</CODE></FONT></TD>
843 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#setGroupInfo(int, java.lang.String, org.openafs.jafs.Group)">setGroupInfo</A></B>(int cellHandle,
844 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> name,
845 <A HREF="../../../org/openafs/jafs/Group.html">Group</A> theGroup)</CODE>
848 Sets the information values of this AFS group to be the parameter values.</TD>
850 <TR BGCOLOR="white" CLASS="TableRowColor">
851 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
852 <CODE> void</CODE></FONT></TD>
853 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#setListAdd(int)">setListAdd</A></B>(int value)</CODE>
856 Sets who can add members (pts adduser) to this group.
859 <TR BGCOLOR="white" CLASS="TableRowColor">
860 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
861 <CODE> void</CODE></FONT></TD>
862 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#setListDelete(int)">setListDelete</A></B>(int value)</CODE>
865 Sets who can delete members (pts removemember) from this group.
868 <TR BGCOLOR="white" CLASS="TableRowColor">
869 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
870 <CODE> void</CODE></FONT></TD>
871 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#setListGroupsOwned(int)">setListGroupsOwned</A></B>(int value)</CODE>
874 Sets who can list the groups owned (pts listowned) by this group.
877 <TR BGCOLOR="white" CLASS="TableRowColor">
878 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
879 <CODE> void</CODE></FONT></TD>
880 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#setListMembership(int)">setListMembership</A></B>(int value)</CODE>
883 Sets who can list the users (pts membership) that belong to this group.
886 <TR BGCOLOR="white" CLASS="TableRowColor">
887 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
888 <CODE> void</CODE></FONT></TD>
889 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#setListStatus(int)">setListStatus</A></B>(int value)</CODE>
892 Sets who can list the status (pts examine) of this group.
895 <TR BGCOLOR="white" CLASS="TableRowColor">
896 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
897 <CODE> <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A></CODE></FONT></TD>
898 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#toString()">toString</A></B>()</CODE>
901 Returns the name of this <CODE>Group</CODE></TD>
904 <A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
905 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
906 <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
907 <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>
909 <TR BGCOLOR="white" CLASS="TableRowColor">
910 <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>
916 <!-- ============ FIELD DETAIL =========== -->
918 <A NAME="field_detail"><!-- --></A>
919 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
920 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
921 <TD COLSPAN=1><FONT SIZE="+2">
922 <B>Field Detail</B></FONT></TD>
926 <A NAME="GROUP_OWNER_ACCESS"><!-- --></A><H3>
927 GROUP_OWNER_ACCESS</H3>
929 public static final int <B>GROUP_OWNER_ACCESS</B></PRE>
931 <DD>Only the owner of the group has access
934 <DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#org.openafs.jafs.Group.GROUP_OWNER_ACCESS">Constant Field Values</A></DL>
938 <A NAME="GROUP_GROUP_ACCESS"><!-- --></A><H3>
939 GROUP_GROUP_ACCESS</H3>
941 public static final int <B>GROUP_GROUP_ACCESS</B></PRE>
943 <DD>Members of the group have access
946 <DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#org.openafs.jafs.Group.GROUP_GROUP_ACCESS">Constant Field Values</A></DL>
950 <A NAME="GROUP_ANYUSER_ACCESS"><!-- --></A><H3>
951 GROUP_ANYUSER_ACCESS</H3>
953 public static final int <B>GROUP_ANYUSER_ACCESS</B></PRE>
955 <DD>Any user has access
958 <DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#org.openafs.jafs.Group.GROUP_ANYUSER_ACCESS">Constant Field Values</A></DL>
962 <A NAME="cell"><!-- --></A><H3>
965 protected <A HREF="../../../org/openafs/jafs/Cell.html">Cell</A> <B>cell</B></PRE>
972 <A NAME="cellHandle"><!-- --></A><H3>
975 protected int <B>cellHandle</B></PRE>
982 <A NAME="name"><!-- --></A><H3>
985 protected <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> <B>name</B></PRE>
992 <A NAME="membershipCount"><!-- --></A><H3>
995 protected int <B>membershipCount</B></PRE>
1002 <A NAME="nameUID"><!-- --></A><H3>
1005 protected int <B>nameUID</B></PRE>
1012 <A NAME="ownerUID"><!-- --></A><H3>
1015 protected int <B>ownerUID</B></PRE>
1022 <A NAME="creatorUID"><!-- --></A><H3>
1025 protected int <B>creatorUID</B></PRE>
1032 <A NAME="owner"><!-- --></A><H3>
1035 protected <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> <B>owner</B></PRE>
1042 <A NAME="creator"><!-- --></A><H3>
1045 protected <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> <B>creator</B></PRE>
1052 <A NAME="listStatus"><!-- --></A><H3>
1055 protected int <B>listStatus</B></PRE>
1057 <DD>who is allowed to execute PTS examine for this group. Valid values are:
1059 <li><A HREF="../../../org/openafs/jafs/Group.html#GROUP_OWNER_ACCESS"><CODE>GROUP_OWNER_ACCESS</CODE></A> -- only the owner has permission</li>
1060 <li><A HREF="../../../org/openafs/jafs/Group.html#GROUP_GROUP_ACCESS"><CODE>GROUP_GROUP_ACCESS</CODE></A>
1061 -- only members of the group have permission</li>
1062 <li><A HREF="../../../org/openafs/jafs/Group.html#GROUP_ANYUSER_ACCESS"><CODE>GROUP_ANYUSER_ACCESS</CODE></A> -- any user has permission</li></ul>
1069 <A NAME="listGroupsOwned"><!-- --></A><H3>
1070 listGroupsOwned</H3>
1072 protected int <B>listGroupsOwned</B></PRE>
1074 <DD>who is allowed to execute PTS examine for this group. Valid values are:
1076 <li><A HREF="../../../org/openafs/jafs/Group.html#GROUP_OWNER_ACCESS"><CODE>GROUP_OWNER_ACCESS</CODE></A> -- only the owner has permission</li>
1077 <li><A HREF="../../../org/openafs/jafs/Group.html#GROUP_GROUP_ACCESS"><CODE>GROUP_GROUP_ACCESS</CODE></A>
1078 -- only members of the group have permission</li>
1079 <li><A HREF="../../../org/openafs/jafs/Group.html#GROUP_ANYUSER_ACCESS"><CODE>GROUP_ANYUSER_ACCESS</CODE></A> -- any user has permission</li></ul>
1086 <A NAME="listMembership"><!-- --></A><H3>
1089 protected int <B>listMembership</B></PRE>
1091 <DD>who is allowed to execute PTS listowned for this group. Valid values are:
1093 <li><A HREF="../../../org/openafs/jafs/Group.html#GROUP_OWNER_ACCESS"><CODE>GROUP_OWNER_ACCESS</CODE></A> -- only the owner has permission</li>
1094 <li><A HREF="../../../org/openafs/jafs/Group.html#GROUP_GROUP_ACCESS"><CODE>GROUP_GROUP_ACCESS</CODE></A>
1095 -- only members of the group have permission</li>
1096 <li><A HREF="../../../org/openafs/jafs/Group.html#GROUP_ANYUSER_ACCESS"><CODE>GROUP_ANYUSER_ACCESS</CODE></A> -- any user has permission</li></ul>
1103 <A NAME="listAdd"><!-- --></A><H3>
1106 protected int <B>listAdd</B></PRE>
1108 <DD>who is allowed to execute PTS adduser for this group. Valid values are:
1110 <li><A HREF="../../../org/openafs/jafs/Group.html#GROUP_OWNER_ACCESS"><CODE>GROUP_OWNER_ACCESS</CODE></A> -- only the owner has permission</li>
1111 <li><A HREF="../../../org/openafs/jafs/Group.html#GROUP_GROUP_ACCESS"><CODE>GROUP_GROUP_ACCESS</CODE></A>
1112 -- only members of the group have permission</li>
1113 <li><A HREF="../../../org/openafs/jafs/Group.html#GROUP_ANYUSER_ACCESS"><CODE>GROUP_ANYUSER_ACCESS</CODE></A> -- any user has permission</li></ul>
1120 <A NAME="listDelete"><!-- --></A><H3>
1123 protected int <B>listDelete</B></PRE>
1125 <DD>who is allowed to execute PTS removeuser for this group. Valid
1128 <li><A HREF="../../../org/openafs/jafs/Group.html#GROUP_OWNER_ACCESS"><CODE>GROUP_OWNER_ACCESS</CODE></A> -- only the owner has permission</li>
1129 <li><A HREF="../../../org/openafs/jafs/Group.html#GROUP_GROUP_ACCESS"><CODE>GROUP_GROUP_ACCESS</CODE></A>
1130 -- only members of the group have permission</li>
1131 <li><A HREF="../../../org/openafs/jafs/Group.html#GROUP_ANYUSER_ACCESS"><CODE>GROUP_ANYUSER_ACCESS</CODE></A> -- any user has permission</li></ul>
1138 <A NAME="members"><!-- --></A><H3>
1141 protected <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/util/ArrayList.html">ArrayList</A> <B>members</B></PRE>
1148 <A NAME="memberNames"><!-- --></A><H3>
1151 protected <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/util/ArrayList.html">ArrayList</A> <B>memberNames</B></PRE>
1158 <A NAME="groupsOwned"><!-- --></A><H3>
1161 protected <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/util/ArrayList.html">ArrayList</A> <B>groupsOwned</B></PRE>
1168 <A NAME="groupsOwnedNames"><!-- --></A><H3>
1169 groupsOwnedNames</H3>
1171 protected <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/util/ArrayList.html">ArrayList</A> <B>groupsOwnedNames</B></PRE>
1178 <A NAME="cachedInfo"><!-- --></A><H3>
1181 protected boolean <B>cachedInfo</B></PRE>
1183 <DD>Whether or not the information fields of this group have been filled.
1189 <!-- ========= CONSTRUCTOR DETAIL ======== -->
1191 <A NAME="constructor_detail"><!-- --></A>
1192 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
1193 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
1194 <TD COLSPAN=1><FONT SIZE="+2">
1195 <B>Constructor Detail</B></FONT></TD>
1199 <A NAME="Group(java.lang.String, org.openafs.jafs.Cell)"><!-- --></A><H3>
1202 public <B>Group</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> name,
1203 <A HREF="../../../org/openafs/jafs/Cell.html">Cell</A> cell)
1204 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1206 <DD>Constructs a new <code>Group</code> object instance given the name
1207 of the AFS group and the AFS cell, represented by
1208 <CODE>cell</CODE>, to which it belongs. This does not actually
1209 create a new AFS group, it just represents one.
1210 If <code>name</code> is not an actual AFS group, exceptions
1211 will be thrown during subsequent method invocations on this
1212 object, unless the <A HREF="../../../org/openafs/jafs/Group.html#create(java.lang.String, int)"><CODE>create(String, int)</CODE></A> or <A HREF="../../../org/openafs/jafs/Group.html#create(java.lang.String)"><CODE>create(String)</CODE></A>
1213 method is explicitly called to create it.
1215 <DT><B>Parameters:</B><DD><CODE>name</CODE> - the name of the group to represent<DD><CODE>cell</CODE> - the cell to which the group belongs.
1217 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1220 <A NAME="Group(java.lang.String, org.openafs.jafs.Cell, boolean)"><!-- --></A><H3>
1223 public <B>Group</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> name,
1224 <A HREF="../../../org/openafs/jafs/Cell.html">Cell</A> cell,
1225 boolean preloadAllMembers)
1226 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1228 <DD>Constructs a new <code>Group</code> object instance given the name
1229 of the AFS group and the AFS cell, represented by
1230 <CODE>cell</CODE>, to which it belongs. This does not actually
1231 create a new AFS group, it just represents one.
1232 If <code>name</code> is not an actual AFS group, exceptions
1233 will be thrown during subsequent method invocations on this
1234 object, unless the <A HREF="../../../org/openafs/jafs/Group.html#create(java.lang.String, int)"><CODE>create(String, int)</CODE></A> or <A HREF="../../../org/openafs/jafs/Group.html#create(java.lang.String)"><CODE>create(String)</CODE></A>
1235 method is explicitly called to create it. Note that if the process
1236 doesn't exist and <code>preloadAllMembers</code> is true, an exception
1239 <P> This constructor is ideal for point-in-time representation and
1240 transient applications. It ensures all data member values are set and
1241 available without calling back to the filesystem at the first request
1242 for them. Use the <A HREF="../../../org/openafs/jafs/Group.html#refresh()"><CODE>refresh()</CODE></A> method to address any coherency
1245 <DT><B>Parameters:</B><DD><CODE>name</CODE> - the name of the group to represent<DD><CODE>cell</CODE> - the cell to which the group belongs.<DD><CODE>preloadAllMembers</CODE> - true will ensure all object members are
1246 set upon construction;
1247 otherwise members will be set upon access,
1248 which is the default behavior.
1250 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/Group.html#refresh()"><CODE>refresh()</CODE></A></DL>
1253 <A NAME="Group(org.openafs.jafs.Cell)"><!-- --></A><H3>
1256 <B>Group</B>(<A HREF="../../../org/openafs/jafs/Cell.html">Cell</A> cell)
1257 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1259 <DD>Creates a blank <code>Group</code> given the cell to which the group
1260 belongs. Other methods cvan then be used to fill the fields of this
1263 <DT><B>Parameters:</B><DD><CODE>cell</CODE> - the cell to which the group belongs.
1265 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1267 <!-- ============ METHOD DETAIL ========== -->
1269 <A NAME="method_detail"><!-- --></A>
1270 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
1271 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
1272 <TD COLSPAN=1><FONT SIZE="+2">
1273 <B>Method Detail</B></FONT></TD>
1277 <A NAME="create(java.lang.String)"><!-- --></A><H3>
1280 public void <B>create</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> ownerName)
1281 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1283 <DD>Creates the PTS entry for a new group in this cell. Automatically assigns
1290 <DT><B>Parameters:</B><DD><CODE>ownerName</CODE> - the owner of this group
1291 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE></DL>
1296 <A NAME="create(java.lang.String, int)"><!-- --></A><H3>
1299 public void <B>create</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> ownerName,
1301 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1303 <DD>Creates the PTS entry for a new group in this cell.
1309 <DT><B>Parameters:</B><DD><CODE>ownerName</CODE> - the owner of this group<DD><CODE>gid</CODE> - the group id to assign to the new group
1311 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1316 <A NAME="delete()"><!-- --></A><H3>
1319 public void <B>delete</B>()
1320 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1322 <DD>Deletes the PTS entry for a group in this cell. Deletes this group
1323 from the membership list of the user that belonged to it, but does not
1324 delete the groups owned by this group. Also nullifies the Java object.
1332 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1337 <A NAME="flushInfo()"><!-- --></A><H3>
1340 public void <B>flushInfo</B>()
1341 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1343 <DD>Flushes the current information of this <code>Group</code> object to disk.
1344 This will update the information of the actual AFS group to match the
1345 settings that have been modified in this <code>Group</code> object.
1346 This function must be called before any changes made to the information
1347 fields of this group will be seen by the AFS system.
1355 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1360 <A NAME="addMember(org.openafs.jafs.User)"><!-- --></A><H3>
1363 public void <B>addMember</B>(<A HREF="../../../org/openafs/jafs/User.html">User</A> theUser)
1364 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1366 <DD>Add the specified member to this group.
1374 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1379 <A NAME="removeMember(org.openafs.jafs.User)"><!-- --></A><H3>
1382 public void <B>removeMember</B>(<A HREF="../../../org/openafs/jafs/User.html">User</A> theUser)
1383 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1385 <DD>Remove the specified member from this group.
1393 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1398 <A NAME="changeOwner(org.openafs.jafs.User)"><!-- --></A><H3>
1401 public void <B>changeOwner</B>(<A HREF="../../../org/openafs/jafs/User.html">User</A> theOwner)
1402 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1404 <DD>Change the owner of this group.
1412 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1417 <A NAME="changeOwner(org.openafs.jafs.Group)"><!-- --></A><H3>
1420 public void <B>changeOwner</B>(<A HREF="../../../org/openafs/jafs/Group.html">Group</A> theOwner)
1421 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1423 <DD>Change the owner of this group.
1431 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1436 <A NAME="rename(java.lang.String)"><!-- --></A><H3>
1439 public void <B>rename</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> newName)
1440 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1442 <DD>Change the name of this group.
1448 <DT><B>Parameters:</B><DD><CODE>newName</CODE> - the new name for this group
1450 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1455 <A NAME="refresh()"><!-- --></A><H3>
1458 public void <B>refresh</B>()
1459 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1461 <DD>Refreshes the properties of this Group object instance with values from
1462 the AFS group it represents. All properties that have been initialized
1463 and/or accessed will be renewed according to the values of the AFS group
1464 this <code>Group</code> object instance represents.
1466 <P>Since in most environments administrative changes can be administered
1467 from an AFS command-line program or an alternate GUI application, this
1468 method provides a means to refresh the Java object representation and
1469 thereby ascertain any possible modifications that may have been made
1470 from such alternate administrative programs. Using this method before
1471 an associated instance accessor will ensure the highest level of
1472 representative accuracy, accommodating changes made external to the
1473 Java application space. If administrative changes to the underlying AFS
1474 system are only allowed via this API, then the use of this method is
1483 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1488 <A NAME="refresh(boolean)"><!-- --></A><H3>
1491 protected void <B>refresh</B>(boolean all)
1492 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1494 <DD>Refreshes the properties of this Group object instance with values from
1495 the AFS group it represents. If <CODE>all</CODE> is <CODE>true</CODE>
1496 then <U>all</U> of the properties of this Group object instance will be
1497 set, or renewed, according to the values of the AFS group it represents,
1498 disregarding any previously set properties.
1500 <P> Thus, if <CODE>all</CODE> is <CODE>false</CODE> then properties that
1501 are currently set will be refreshed and properties that are not set will
1502 remain uninitialized. See <A HREF="../../../org/openafs/jafs/Group.html#refresh()"><CODE>refresh()</CODE></A> for more information.
1508 <DT><B>Parameters:</B><DD><CODE>all</CODE> - if true set or renew all object properties; otherwise renew
1511 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/Group.html#refresh()"><CODE>refresh()</CODE></A></DL>
1516 <A NAME="refreshInfo()"><!-- --></A><H3>
1519 protected void <B>refreshInfo</B>()
1520 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1522 <DD>Refreshes the information fields of this <code>Group</code> to reflect
1523 the current state of the AFS group. Does not refresh the members that
1524 belong to the group, nor the groups the group owns.
1532 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1537 <A NAME="refreshMembers()"><!-- --></A><H3>
1540 protected void <B>refreshMembers</B>()
1541 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1543 <DD>Refreshes the current information about the <code>User</code> objects
1544 belonging to this group. Does not refresh the information fields of
1545 the group or groups owned.
1553 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1558 <A NAME="refreshMemberNames()"><!-- --></A><H3>
1559 refreshMemberNames</H3>
1561 protected void <B>refreshMemberNames</B>()
1562 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1564 <DD>Refreshes the current information about the names of members belonging
1565 to this group. Does not refresh the information fields of the group
1574 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1579 <A NAME="refreshGroupsOwned()"><!-- --></A><H3>
1580 refreshGroupsOwned</H3>
1582 protected void <B>refreshGroupsOwned</B>()
1583 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1585 <DD>Refreshes the current information about the <code>Group</code> objects the
1586 group owns. Does not refresh the information fields of the group or
1595 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1600 <A NAME="refreshGroupsOwnedNames()"><!-- --></A><H3>
1601 refreshGroupsOwnedNames</H3>
1603 protected void <B>refreshGroupsOwnedNames</B>()
1604 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1606 <DD>Refreshes the current information about the names of groups the group
1607 owns. Does not refresh the information fields of the group or members.
1615 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1620 <A NAME="getName()"><!-- --></A><H3>
1623 public <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> <B>getName</B>()</PRE>
1625 <DD>Returns the name of this group.
1628 <DT><B>Specified by:</B><DD><CODE><A HREF="../../../org/openafs/jafs/PTSEntry.html#getName()">getName</A></CODE> in interface <CODE><A HREF="../../../org/openafs/jafs/PTSEntry.html">PTSEntry</A></CODE></DL>
1632 <DT><B>Returns:</B><DD>the name of this group</DL>
1637 <A NAME="getUID()"><!-- --></A><H3>
1640 public int <B>getUID</B>()
1641 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1643 <DD>Returns the numeric AFS id of this group.
1646 <DT><B>Specified by:</B><DD><CODE><A HREF="../../../org/openafs/jafs/PTSEntry.html#getUID()">getUID</A></CODE> in interface <CODE><A HREF="../../../org/openafs/jafs/PTSEntry.html">PTSEntry</A></CODE></DL>
1650 <DT><B>Returns:</B><DD>the AFS id of this group
1652 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1657 <A NAME="getCell()"><!-- --></A><H3>
1660 public <A HREF="../../../org/openafs/jafs/Cell.html">Cell</A> <B>getCell</B>()</PRE>
1662 <DD>Returns the Cell this group belongs to.
1665 <DT><B>Specified by:</B><DD><CODE><A HREF="../../../org/openafs/jafs/PTSEntry.html#getCell()">getCell</A></CODE> in interface <CODE><A HREF="../../../org/openafs/jafs/PTSEntry.html">PTSEntry</A></CODE></DL>
1669 <DT><B>Returns:</B><DD>the Cell this group belongs to</DL>
1674 <A NAME="getMembers()"><!-- --></A><H3>
1677 public <A HREF="../../../org/openafs/jafs/User.html">User</A>[] <B>getMembers</B>()
1678 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1680 <DD>Returns an array of the <code>User</code> object members of this group.
1687 <DT><B>Returns:</B><DD>an array of the members of this group
1689 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1694 <A NAME="getMemberNames()"><!-- --></A><H3>
1697 public <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>[] <B>getMemberNames</B>()
1698 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1700 <DD>Returns an array of the member names of this group.
1707 <DT><B>Returns:</B><DD>an array of the member names of this group
1709 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1714 <A NAME="getGroupsOwned()"><!-- --></A><H3>
1717 public <A HREF="../../../org/openafs/jafs/Group.html">Group</A>[] <B>getGroupsOwned</B>()
1718 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1720 <DD>Returns an array of the <code>Group</code> objects this group owns.
1727 <DT><B>Returns:</B><DD>an array of the <code>Groups</code> this group owns
1729 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1734 <A NAME="getGroupsOwnedNames()"><!-- --></A><H3>
1735 getGroupsOwnedNames</H3>
1737 public <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>[] <B>getGroupsOwnedNames</B>()
1738 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1740 <DD>Returns an array of the group names this group owns.
1741 Contains <code>String</code> objects.
1748 <DT><B>Returns:</B><DD>an array of the group names this group owns
1750 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1755 <A NAME="getMembershipCount()"><!-- --></A><H3>
1756 getMembershipCount</H3>
1758 public int <B>getMembershipCount</B>()
1759 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1761 <DD>Returns the number of members of this group.
1768 <DT><B>Returns:</B><DD>the membership count
1770 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1775 <A NAME="getOwner()"><!-- --></A><H3>
1778 public <A HREF="../../../org/openafs/jafs/PTSEntry.html">PTSEntry</A> <B>getOwner</B>()
1779 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1781 <DD>PTS: Returns the owner of this group in the form of a <A HREF="../../../org/openafs/jafs/PTSEntry.html"><CODE>PTSEntry</CODE></A>.
1783 <P>The returning object could be either a <A HREF="../../../org/openafs/jafs/User.html"><CODE>User</CODE></A> or <A HREF="../../../org/openafs/jafs/Group.html"><CODE>Group</CODE></A>;
1784 to determine what type of object the <A HREF="../../../org/openafs/jafs/PTSEntry.html"><CODE>PTSEntry</CODE></A> represents,
1785 call the <A HREF="../../../org/openafs/jafs/PTSEntry.html#getType()"><CODE>PTSEntry.getType()</CODE></A> method.
1788 <DT><B>Specified by:</B><DD><CODE><A HREF="../../../org/openafs/jafs/PTSEntry.html#getOwner()">getOwner</A></CODE> in interface <CODE><A HREF="../../../org/openafs/jafs/PTSEntry.html">PTSEntry</A></CODE></DL>
1792 <DT><B>Returns:</B><DD>the owner of this group
1794 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/PTSEntry.html"><CODE>PTSEntry</CODE></A>,
1795 <A HREF="../../../org/openafs/jafs/PTSEntry.html#getType()"><CODE>PTSEntry.getType()</CODE></A>,
1796 <A HREF="../../../org/openafs/jafs/Group.html#refresh()"><CODE>refresh()</CODE></A></DL>
1801 <A NAME="getCreator()"><!-- --></A><H3>
1804 public <A HREF="../../../org/openafs/jafs/PTSEntry.html">PTSEntry</A> <B>getCreator</B>()
1805 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1807 <DD>PTS: Returns the creator of this group in the form of a <A HREF="../../../org/openafs/jafs/PTSEntry.html"><CODE>PTSEntry</CODE></A>.
1809 <P>The returning object could be either a <A HREF="../../../org/openafs/jafs/User.html"><CODE>User</CODE></A> or <A HREF="../../../org/openafs/jafs/Group.html"><CODE>Group</CODE></A>;
1810 to determine what type of object the <A HREF="../../../org/openafs/jafs/PTSEntry.html"><CODE>PTSEntry</CODE></A> represents,
1811 call the <A HREF="../../../org/openafs/jafs/PTSEntry.html#getType()"><CODE>PTSEntry.getType()</CODE></A> method.
1814 <DT><B>Specified by:</B><DD><CODE><A HREF="../../../org/openafs/jafs/PTSEntry.html#getCreator()">getCreator</A></CODE> in interface <CODE><A HREF="../../../org/openafs/jafs/PTSEntry.html">PTSEntry</A></CODE></DL>
1818 <DT><B>Returns:</B><DD>the creator of this group
1820 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/PTSEntry.html"><CODE>PTSEntry</CODE></A>,
1821 <A HREF="../../../org/openafs/jafs/PTSEntry.html#getType()"><CODE>PTSEntry.getType()</CODE></A>,
1822 <A HREF="../../../org/openafs/jafs/Group.html#refresh()"><CODE>refresh()</CODE></A></DL>
1827 <A NAME="getType()"><!-- --></A><H3>
1830 public short <B>getType</B>()</PRE>
1832 <DD>Returns the type of <A HREF="../../../org/openafs/jafs/PTSEntry.html"><CODE>PTSEntry</CODE></A> this object represents.
1834 <P>This method will always return <A HREF="../../../org/openafs/jafs/PTSEntry.html#PTS_GROUP"><CODE>PTSEntry.PTS_GROUP</CODE></A>.
1837 <DT><B>Specified by:</B><DD><CODE><A HREF="../../../org/openafs/jafs/PTSEntry.html#getType()">getType</A></CODE> in interface <CODE><A HREF="../../../org/openafs/jafs/PTSEntry.html">PTSEntry</A></CODE></DL>
1841 <DT><B>Returns:</B><DD>the type of PTSEntry this object represents
1842 (will always return <A HREF="../../../org/openafs/jafs/PTSEntry.html#PTS_GROUP"><CODE>PTSEntry.PTS_GROUP</CODE></A>)<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/PTSEntry.html"><CODE>PTSEntry</CODE></A>,
1843 <A HREF="../../../org/openafs/jafs/PTSEntry.html#getType()"><CODE>PTSEntry.getType()</CODE></A></DL>
1848 <A NAME="getListStatus()"><!-- --></A><H3>
1851 public int <B>getListStatus</B>()
1852 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1854 <DD>Returns who can list the status (pts examine) of this group.
1857 <li><code><A HREF="../../../org/openafs/jafs/Group.html#GROUP_OWNER_ACCESS"><CODE>GROUP_OWNER_ACCESS</CODE></A></code>
1858 -- only the owner has permission</li>
1859 <li><code><A HREF="../../../org/openafs/jafs/Group.html#GROUP_GROUP_ACCESS"><CODE>GROUP_GROUP_ACCESS</CODE></A></code>
1860 -- only members of the group have permission</li>
1861 <li><code><A HREF="../../../org/openafs/jafs/Group.html#GROUP_ANYUSER_ACCESS"><CODE>GROUP_ANYUSER_ACCESS</CODE></A></code>
1862 -- any user has permission</li>
1870 <DT><B>Returns:</B><DD>the status listing permission
1872 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1877 <A NAME="getListGroupsOwned()"><!-- --></A><H3>
1878 getListGroupsOwned</H3>
1880 public int <B>getListGroupsOwned</B>()
1881 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1883 <DD>Returns who can list the groups owned (pts listowned) by this group.
1886 <li><code><A HREF="../../../org/openafs/jafs/Group.html#GROUP_OWNER_ACCESS"><CODE>GROUP_OWNER_ACCESS</CODE></A></code>
1887 -- only the owner has permission</li>
1888 <li><code><A HREF="../../../org/openafs/jafs/Group.html#GROUP_GROUP_ACCESS"><CODE>GROUP_GROUP_ACCESS</CODE></A></code>
1889 -- only members of the group have permission</li>
1890 <li><code><A HREF="../../../org/openafs/jafs/Group.html#GROUP_ANYUSER_ACCESS"><CODE>GROUP_ANYUSER_ACCESS</CODE></A></code>
1891 -- any user has permission</li>
1899 <DT><B>Returns:</B><DD>the groups owned listing permission
1901 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1906 <A NAME="getListMembership()"><!-- --></A><H3>
1907 getListMembership</H3>
1909 public int <B>getListMembership</B>()
1910 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1912 <DD>Returns who can list the users (pts membership) that belong to this group.
1915 <li><code><A HREF="../../../org/openafs/jafs/Group.html#GROUP_OWNER_ACCESS"><CODE>GROUP_OWNER_ACCESS</CODE></A></code>
1916 -- only the owner has permission</li>
1917 <li><code><A HREF="../../../org/openafs/jafs/Group.html#GROUP_GROUP_ACCESS"><CODE>GROUP_GROUP_ACCESS</CODE></A></code>
1918 -- only members of the group have permission</li>
1919 <li><code><A HREF="../../../org/openafs/jafs/Group.html#GROUP_ANYUSER_ACCESS"><CODE>GROUP_ANYUSER_ACCESS</CODE></A></code>
1920 -- any user has permission</li>
1928 <DT><B>Returns:</B><DD>the membership listing permission
1930 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1935 <A NAME="getListAdd()"><!-- --></A><H3>
1938 public int <B>getListAdd</B>()
1939 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1941 <DD>Returns who can add members (pts adduser) to this group.
1944 <li><code><A HREF="../../../org/openafs/jafs/Group.html#GROUP_OWNER_ACCESS"><CODE>GROUP_OWNER_ACCESS</CODE></A></code>
1945 -- only the owner has permission</li>
1946 <li><code><A HREF="../../../org/openafs/jafs/Group.html#GROUP_GROUP_ACCESS"><CODE>GROUP_GROUP_ACCESS</CODE></A></code>
1947 -- only members of the group have permission</li>
1948 <li><code><A HREF="../../../org/openafs/jafs/Group.html#GROUP_ANYUSER_ACCESS"><CODE>GROUP_ANYUSER_ACCESS</CODE></A></code>
1949 -- any user has permission</li>
1957 <DT><B>Returns:</B><DD>the member adding permission
1959 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1964 <A NAME="getListDelete()"><!-- --></A><H3>
1967 public int <B>getListDelete</B>()
1968 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1970 <DD>Returns who can delete members (pts removemember) from this group.
1973 <li><code><A HREF="../../../org/openafs/jafs/Group.html#GROUP_OWNER_ACCESS"><CODE>GROUP_OWNER_ACCESS</CODE></A></code>
1974 -- only the owner has permission</li>
1975 <li><code><A HREF="../../../org/openafs/jafs/Group.html#GROUP_GROUP_ACCESS"><CODE>GROUP_GROUP_ACCESS</CODE></A></code>
1976 -- only members of the group have permission</li>
1977 <li><code><A HREF="../../../org/openafs/jafs/Group.html#GROUP_ANYUSER_ACCESS"><CODE>GROUP_ANYUSER_ACCESS</CODE></A></code>
1978 -- any user has permission</li>
1986 <DT><B>Returns:</B><DD>the member deleting permission
1988 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1993 <A NAME="setListStatus(int)"><!-- --></A><H3>
1996 public void <B>setListStatus</B>(int value)
1997 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1999 <DD>Sets who can list the status (pts examine) of this group.
2002 <li><code><A HREF="../../../org/openafs/jafs/Group.html#GROUP_OWNER_ACCESS"><CODE>GROUP_OWNER_ACCESS</CODE></A></code>
2003 -- only the owner has permission</li>
2004 <li><code><A HREF="../../../org/openafs/jafs/Group.html#GROUP_GROUP_ACCESS"><CODE>GROUP_GROUP_ACCESS</CODE></A></code>
2005 -- only members of the group have permission</li>
2006 <li><code><A HREF="../../../org/openafs/jafs/Group.html#GROUP_ANYUSER_ACCESS"><CODE>GROUP_ANYUSER_ACCESS</CODE></A></code>
2007 -- any user has permission</li>
2014 <DT><B>Parameters:</B><DD><CODE>value</CODE> - the value of the new list membership permission
2016 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - if an error occurs in the native code
2017 <DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - if an invalud argument is provided</DL>
2022 <A NAME="setListGroupsOwned(int)"><!-- --></A><H3>
2023 setListGroupsOwned</H3>
2025 public void <B>setListGroupsOwned</B>(int value)
2026 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
2028 <DD>Sets who can list the groups owned (pts listowned) by this group.
2031 <li><code><A HREF="../../../org/openafs/jafs/Group.html#GROUP_OWNER_ACCESS"><CODE>GROUP_OWNER_ACCESS</CODE></A></code>
2032 -- only the owner has permission</li>
2033 <li><code><A HREF="../../../org/openafs/jafs/Group.html#GROUP_GROUP_ACCESS"><CODE>GROUP_GROUP_ACCESS</CODE></A></code>
2034 -- only members of the group have permission</li>
2035 <li><code><A HREF="../../../org/openafs/jafs/Group.html#GROUP_ANYUSER_ACCESS"><CODE>GROUP_ANYUSER_ACCESS</CODE></A></code>
2036 -- any user has permission</li>
2043 <DT><B>Parameters:</B><DD><CODE>value</CODE> - the value of the new list membership permission
2045 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - if an error occurs in the native code
2046 <DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - if an invalud argument is provided</DL>
2051 <A NAME="setListMembership(int)"><!-- --></A><H3>
2052 setListMembership</H3>
2054 public void <B>setListMembership</B>(int value)
2055 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
2057 <DD>Sets who can list the users (pts membership) that belong to this group.
2060 <li><code><A HREF="../../../org/openafs/jafs/Group.html#GROUP_OWNER_ACCESS"><CODE>GROUP_OWNER_ACCESS</CODE></A></code>
2061 -- only the owner has permission</li>
2062 <li><code><A HREF="../../../org/openafs/jafs/Group.html#GROUP_GROUP_ACCESS"><CODE>GROUP_GROUP_ACCESS</CODE></A></code>
2063 -- only members of the group have permission</li>
2064 <li><code><A HREF="../../../org/openafs/jafs/Group.html#GROUP_ANYUSER_ACCESS"><CODE>GROUP_ANYUSER_ACCESS</CODE></A></code>
2065 -- any user has permission</li>
2072 <DT><B>Parameters:</B><DD><CODE>value</CODE> - the value of the new list membership permission
2074 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - if an error occurs in the native code
2075 <DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - if an invalud argument is provided</DL>
2080 <A NAME="setListAdd(int)"><!-- --></A><H3>
2083 public void <B>setListAdd</B>(int value)
2084 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
2086 <DD>Sets who can add members (pts adduser) to this group.
2089 <li><code><A HREF="../../../org/openafs/jafs/Group.html#GROUP_OWNER_ACCESS"><CODE>GROUP_OWNER_ACCESS</CODE></A></code>
2090 -- only the owner has permission</li>
2091 <li><code><A HREF="../../../org/openafs/jafs/Group.html#GROUP_GROUP_ACCESS"><CODE>GROUP_GROUP_ACCESS</CODE></A></code>
2092 -- only members of the group have permission</li>
2093 <li><code><A HREF="../../../org/openafs/jafs/Group.html#GROUP_ANYUSER_ACCESS"><CODE>GROUP_ANYUSER_ACCESS</CODE></A></code>
2094 -- any user has permission</li>
2101 <DT><B>Parameters:</B><DD><CODE>value</CODE> - the value of the new list membership permission
2103 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - if an invalid value is provided</DL>
2108 <A NAME="setListDelete(int)"><!-- --></A><H3>
2111 public void <B>setListDelete</B>(int value)
2112 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
2114 <DD>Sets who can delete members (pts removemember) from this group.
2117 <li><code><A HREF="../../../org/openafs/jafs/Group.html#GROUP_OWNER_ACCESS"><CODE>GROUP_OWNER_ACCESS</CODE></A></code>
2118 -- only the owner has permission</li>
2119 <li><code><A HREF="../../../org/openafs/jafs/Group.html#GROUP_GROUP_ACCESS"><CODE>GROUP_GROUP_ACCESS</CODE></A></code>
2120 -- only members of the group have permission</li>
2121 <li><code><A HREF="../../../org/openafs/jafs/Group.html#GROUP_ANYUSER_ACCESS"><CODE>GROUP_ANYUSER_ACCESS</CODE></A></code>
2122 -- any user has permission</li>
2129 <DT><B>Parameters:</B><DD><CODE>value</CODE> - the value of the new list membership permission
2131 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - if an invalid value is provided</DL>
2136 <A NAME="getInfo()"><!-- --></A><H3>
2139 protected <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> <B>getInfo</B>()</PRE>
2141 <DD>Returns a <code>String</code> representation of this <code>Group</code>.
2142 Contains the information fields and members.
2149 <DT><B>Returns:</B><DD>a <code>String</code> representation of the <code>Group</code></DL>
2154 <A NAME="compareTo(org.openafs.jafs.Group)"><!-- --></A><H3>
2157 public int <B>compareTo</B>(<A HREF="../../../org/openafs/jafs/Group.html">Group</A> group)</PRE>
2159 <DD>Compares two Group objects respective to their names and does not
2160 factor any other attribute. Alphabetic case is significant in
2167 <DT><B>Parameters:</B><DD><CODE>group</CODE> - The Group object to be compared to this Group instance
2168 <DT><B>Returns:</B><DD>Zero if the argument is equal to this Group's name, a
2169 value less than zero if this Group's name is
2170 lexicographically less than the argument, or a value greater
2171 than zero if this Group's name is lexicographically
2172 greater than the argument</DL>
2177 <A NAME="compareTo(java.lang.Object)"><!-- --></A><H3>
2180 public int <B>compareTo</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html">Object</A> obj)</PRE>
2182 <DD>Comparable interface method.
2185 <DT><B>Specified by:</B><DD><CODE>compareTo</CODE> in interface <CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Comparable.html">Comparable</A></CODE></DL>
2188 <DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/Group.html#compareTo(org.openafs.jafs.Group)"><CODE>compareTo(Group)</CODE></A></DL>
2193 <A NAME="equals(org.openafs.jafs.Group)"><!-- --></A><H3>
2196 public boolean <B>equals</B>(<A HREF="../../../org/openafs/jafs/Group.html">Group</A> otherGroup)</PRE>
2198 <DD>Tests whether two <code>Group</code> objects are equal, based on their
2205 <DT><B>Parameters:</B><DD><CODE>otherGroup</CODE> - the Group to test
2206 <DT><B>Returns:</B><DD>whether the specifed Group is the same as this Group</DL>
2211 <A NAME="toString()"><!-- --></A><H3>
2214 public <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> <B>toString</B>()</PRE>
2216 <DD>Returns the name of this <CODE>Group</CODE>
2219 <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>
2223 <DT><B>Returns:</B><DD>the name of this <CODE>Group</CODE></DL>
2228 <A NAME="create(int, java.lang.String, java.lang.String, int)"><!-- --></A><H3>
2231 protected static void <B>create</B>(int cellHandle,
2232 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> groupName,
2233 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> ownerName,
2235 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
2237 <DD>Creates the PTS entry for a new group. Pass in 0 for the uid if PTS is to
2238 automatically assign the group id.
2244 <DT><B>Parameters:</B><DD><CODE>cellHandle</CODE> - the handle of the cell to which the group belongs<DD><CODE>groupName</CODE> - the name of the group to create<DD><CODE>ownerName</CODE> - the owner of this group<DD><CODE>gid</CODE> - the group id to assign to the group (0 to have one
2245 automatically assigned)
2247 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/Cell.html#getCellHandle()"><CODE>Cell.getCellHandle()</CODE></A></DL>
2252 <A NAME="delete(int, java.lang.String)"><!-- --></A><H3>
2255 protected static void <B>delete</B>(int cellHandle,
2256 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> groupName)
2257 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
2259 <DD>Deletes the PTS entry for a group. Deletes this group from the
2260 membership list of the users that belonged to it, but does not delete
2261 the groups owned by this group.
2267 <DT><B>Parameters:</B><DD><CODE>cellHandle</CODE> - the handle of the cell to which the group belongs<DD><CODE>groupName</CODE> - the name of the group to delete
2269 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/Cell.html#getCellHandle()"><CODE>Cell.getCellHandle()</CODE></A></DL>
2274 <A NAME="getGroupInfo(int, java.lang.String, org.openafs.jafs.Group)"><!-- --></A><H3>
2277 protected static void <B>getGroupInfo</B>(int cellHandle,
2278 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> name,
2279 <A HREF="../../../org/openafs/jafs/Group.html">Group</A> group)
2280 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
2282 <DD>Fills in the information fields of the provided <code>Group</code>.
2283 Fills in values based on the current PTS information of the group.
2289 <DT><B>Parameters:</B><DD><CODE>cellHandle</CODE> - the handle of the cell to which the group belongs<DD><CODE>name</CODE> - the name of the group for which to get the information<DD><CODE>group</CODE> - the <code>Group</code> object in which to fill in the
2292 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/Cell.html#getCellHandle()"><CODE>Cell.getCellHandle()</CODE></A>,
2293 <A HREF="../../../org/openafs/jafs/Group.html"><CODE>Group</CODE></A></DL>
2298 <A NAME="setGroupInfo(int, java.lang.String, org.openafs.jafs.Group)"><!-- --></A><H3>
2301 protected static void <B>setGroupInfo</B>(int cellHandle,
2302 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> name,
2303 <A HREF="../../../org/openafs/jafs/Group.html">Group</A> theGroup)
2304 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
2306 <DD>Sets the information values of this AFS group to be the parameter values.
2312 <DT><B>Parameters:</B><DD><CODE>cellHandle</CODE> - the handle of the cell to which the user belongs<DD><CODE>name</CODE> - the name of the user for which to set the information<DD><CODE>theGroup</CODE> - the group object containing the desired information
2314 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/Cell.html#getCellHandle()"><CODE>Cell.getCellHandle()</CODE></A></DL>
2319 <A NAME="getGroupMembersBegin(int, java.lang.String)"><!-- --></A><H3>
2320 getGroupMembersBegin</H3>
2322 protected static int <B>getGroupMembersBegin</B>(int cellHandle,
2323 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> name)
2324 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
2326 <DD>Begin the process of getting the users that belong to the group. Returns
2327 an iteration ID to be used by subsequent calls to
2328 <code>getGroupMembersNext</code> and <code>getGroupMembersDone</code>.
2334 <DT><B>Parameters:</B><DD><CODE>cellHandle</CODE> - the handle of the cell to which the group belongs<DD><CODE>name</CODE> - the name of the group for which to get the members
2335 <DT><B>Returns:</B><DD>an iteration ID
2337 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/Cell.html#getCellHandle()"><CODE>Cell.getCellHandle()</CODE></A></DL>
2342 <A NAME="getGroupMembersNextString(int)"><!-- --></A><H3>
2343 getGroupMembersNextString</H3>
2345 protected static <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> <B>getGroupMembersNextString</B>(int iterationId)
2346 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
2348 <DD>Returns the next members that belongs to the group. Returns
2349 <code>null</code> if there are no more members.
2355 <DT><B>Parameters:</B><DD><CODE>iterationId</CODE> - the iteration ID of this iteration
2356 <DT><B>Returns:</B><DD>the name of the next member
2358 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/Group.html#getGroupMembersBegin(int, java.lang.String)"><CODE>getGroupMembersBegin(int, java.lang.String)</CODE></A></DL>
2363 <A NAME="getGroupMembersNext(int, int, org.openafs.jafs.User)"><!-- --></A><H3>
2364 getGroupMembersNext</H3>
2366 protected static int <B>getGroupMembersNext</B>(int cellHandle,
2367 int iterationId,
2368 <A HREF="../../../org/openafs/jafs/User.html">User</A> theUser)
2369 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
2371 <DD>Fills the next user object belonging to that group. Returns 0 if there
2372 are no more users, != 0 otherwise.
2378 <DT><B>Parameters:</B><DD><CODE>cellHandle</CODE> - the handle of the cell to which the users belong<DD><CODE>iterationId</CODE> - the iteration ID of this iteration<DD><CODE>theUser</CODE> - a User object to be populated with the values of the
2380 <DT><B>Returns:</B><DD>0 if there are no more users, != 0 otherwise
2382 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/Cell.html#getCellHandle()"><CODE>Cell.getCellHandle()</CODE></A>,
2383 <A HREF="../../../org/openafs/jafs/Group.html#getGroupMembersBegin(int, java.lang.String)"><CODE>getGroupMembersBegin(int, java.lang.String)</CODE></A></DL>
2388 <A NAME="getGroupMembersDone(int)"><!-- --></A><H3>
2389 getGroupMembersDone</H3>
2391 protected static void <B>getGroupMembersDone</B>(int iterationId)
2392 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
2394 <DD>Signals that the iteration is complete and will not be accessed anymore.
2400 <DT><B>Parameters:</B><DD><CODE>iterationId</CODE> - the iteration ID of this iteration
2402 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/Group.html#getGroupMembersBegin(int, java.lang.String)"><CODE>getGroupMembersBegin(int, java.lang.String)</CODE></A></DL>
2407 <A NAME="addMember(int, java.lang.String, java.lang.String)"><!-- --></A><H3>
2410 protected static void <B>addMember</B>(int cellHandle,
2411 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> groupName,
2412 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> userName)
2413 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
2415 <DD>Adds a user to the specified group.
2421 <DT><B>Parameters:</B><DD><CODE>cellHandle</CODE> - the handle of the cell to which the group belongs<DD><CODE>groupName</CODE> - the name of the group to which to add a member<DD><CODE>userName</CODE> - the name of the user to add
2423 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/Cell.html#getCellHandle()"><CODE>Cell.getCellHandle()</CODE></A></DL>
2428 <A NAME="removeMember(int, java.lang.String, java.lang.String)"><!-- --></A><H3>
2431 protected static void <B>removeMember</B>(int cellHandle,
2432 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> groupName,
2433 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> userName)
2434 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
2436 <DD>Removes a user from the specified group.
2442 <DT><B>Parameters:</B><DD><CODE>cellHandle</CODE> - the handle of the cell to which the group belongs<DD><CODE>groupName</CODE> - the name of the group from which to remove a
2443 member<DD><CODE>userName</CODE> - the name of the user to remove
2445 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/Cell.html#getCellHandle()"><CODE>Cell.getCellHandle()</CODE></A></DL>
2450 <A NAME="changeOwner(int, java.lang.String, java.lang.String)"><!-- --></A><H3>
2453 protected static void <B>changeOwner</B>(int cellHandle,
2454 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> groupName,
2455 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> ownerName)
2456 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
2458 <DD>Change the owner of the specified group.
2464 <DT><B>Parameters:</B><DD><CODE>cellHandle</CODE> - the handle of the cell to which the group belongs<DD><CODE>groupName</CODE> - the name of the group of which to change the
2465 owner<DD><CODE>ownerName</CODE> - the name of the new owner
2467 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/Cell.html#getCellHandle()"><CODE>Cell.getCellHandle()</CODE></A></DL>
2472 <A NAME="rename(int, java.lang.String, java.lang.String)"><!-- --></A><H3>
2475 protected static void <B>rename</B>(int cellHandle,
2476 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> oldGroupName,
2477 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> newGroupName)
2478 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
2480 <DD>Change the name of the specified group.
2486 <DT><B>Parameters:</B><DD><CODE>cellHandle</CODE> - the handle of the cell to which the group belongs<DD><CODE>oldGroupName</CODE> - the old name of the group<DD><CODE>newGroupName</CODE> - the new name for the group
2488 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/Cell.html#getCellHandle()"><CODE>Cell.getCellHandle()</CODE></A></DL>
2493 <A NAME="reclaimGroupMemory()"><!-- --></A><H3>
2494 reclaimGroupMemory</H3>
2496 protected static void <B>reclaimGroupMemory</B>()</PRE>
2498 <DD>Reclaims all memory being saved by the group portion of the native
2500 This method should be called when no more <code>Groups</code> are expected
2510 <!-- ========= END OF CLASS DATA ========= -->
2513 <!-- ========== START OF NAVBAR ========== -->
2514 <A NAME="navbar_bottom"><!-- --></A>
2515 <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
2517 <TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
2518 <A NAME="navbar_bottom_firstrow"><!-- --></A>
2519 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
2520 <TR ALIGN="center" VALIGN="top">
2521 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
2522 <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
2523 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/Group.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
2524 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
2525 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
2526 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
2527 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
2531 <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
2532 <B>JAFS API v2</B></EM>
2537 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
2538 <A HREF="../../../org/openafs/jafs/FileOutputStream.html"><B>PREV CLASS</B></A>
2539 <A HREF="../../../org/openafs/jafs/Key.html"><B>NEXT CLASS</B></A></FONT></TD>
2540 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
2541 <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>
2542 <A HREF="Group.html" TARGET="_top"><B>NO FRAMES</B></A>
2547 document.writeln('<A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>');
2552 <A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>
2557 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
2558 SUMMARY: NESTED | <A HREF="#field_summary">FIELD</A> | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
2559 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
2560 DETAIL: <A HREF="#field_detail">FIELD</A> | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
2563 <!-- =========== END OF NAVBAR =========== -->