archive/JavaAdminAPI/Group.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN""http://www.w3.org/TR/REC-html40/loose.dtd">
   2 <!--NewPage-->
   3 <HTML>
   4 <HEAD>
   5 <!-- Generated by javadoc on Mon Jun 09 15:53:37 PDT 2003 -->
   6 <TITLE>
   7 Group (Java AFS API)
   8 </TITLE>
   9 <META NAME="keywords" CONTENT="org.openafs.jafs.Group,Group class">
  10 <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
  11 </HEAD>
  12 <SCRIPT>
  13 function asd()
  14 {
  15 parent.document.title="Group (Java AFS API)";
  16 }
  17 </SCRIPT>
  18 <BODY BGCOLOR="white" onload="asd();">
  19
  20 <!-- ========== START OF NAVBAR ========== -->
  21 <A NAME="navbar_top"><!-- --></A>
  22 <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
  23 <TR>
  24 <TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
  25 <A NAME="navbar_top_firstrow"><!-- --></A>
  26 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
  27   <TR ALIGN="center" VALIGN="top">
  28   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  29   <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
  30   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/Group.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
  31   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  32   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  33   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  34   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  35   </TR>
  36 </TABLE>
  37 </TD>
  38 <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
  39 <B>JAFS API v2</B></EM>
  40 </TD>
  41 </TR>
  42
  43 <TR>
  44 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  45 &nbsp;<A HREF="../../../org/openafs/jafs/FileOutputStream.html"><B>PREV CLASS</B></A>&nbsp;
  46 &nbsp;<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>  &nbsp;
  49 &nbsp;<A HREF="Group.html" TARGET="_top"><B>NO FRAMES</B></A>  &nbsp;
  50 &nbsp;
  51 <SCRIPT>
  52   <!--
  53   if(window==top) {
  54     document.writeln('<A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>');
  55   }
  56   //-->
  57 </SCRIPT>
  58 <NOSCRIPT>
  59 <A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>
  60 </NOSCRIPT>
  61 </FONT></TD>
  62 </TR>
  63 <TR>
  64 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  65   SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
  66 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  67 DETAIL:&nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
  68 </TR>
  69 </TABLE>
  70 <!-- =========== END OF NAVBAR =========== -->
  71
  72 <HR>
  73 <!-- ======== START OF CLASS DATA ======== -->
  74 <H2>
  75 <FONT SIZE="-1">
  76 org.openafs.jafs</FONT>
  77 <BR>
  78 Class Group</H2>
  79 <PRE>
  80 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html">java.lang.Object</A>
  81   |
  82   +--<B>org.openafs.jafs.Group</B>
  83 </PRE>
  84 <DL>
  85 <DT><B>All Implemented Interfaces:</B> <DD><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/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>
  86 </DL>
  87 <HR>
  88 <DL>
  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>
  90
  91 <P>
  92 An abstract representation of an AFS group.  It holds information about
  93  the group, such as what groups it owns.<BR><BR>
  94
  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>
 104
 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.
 109  <BR><BR>
 110
 111  <!--Information on how member values are set-->
 112
 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>
 120
 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
 124  group.
 125
 126  <PRE>
 127  import org.openafs.jafs.Cell;
 128  import org.openafs.jafs.AFSException;
 129  import org.openafs.jafs.Partition;
 130  import org.openafs.jafs.Group;
 131  ...
 132  public class ...
 133  {
 134    ...
 135    private Cell cell;
 136    private Group group;
 137    ...
 138    public static void main(String[] args) throws Exception
 139    {
 140      String username   = arg[0];
 141      String password   = arg[1];
 142      String cellName   = arg[2];
 143      String groupName  = arg[3];
 144
 145      token = new Token(username, password, cellName);
 146      cell   = new Cell(token);
 147      group = new Group(groupName, cell);
 148
 149      System.out.println("Owner of group " + group.getName() + " is "
 150                         + group.getOwnerName());
 151      ...
 152    }
 153    ...
 154  }
 155  </PRE>
 156 <P>
 157
 158 <P>
 159 <DL>
 160 <DT><B>See Also:</B><DD><A HREF="../../../serialized-form.html" TARGET="org.openafs.jafs.Group">Serialized Form</A></DL>
 161 <HR>
 162
 163 <P>
 164 <!-- ======== NESTED CLASS SUMMARY ======== -->
 165
 166
 167 <!-- =========== FIELD SUMMARY =========== -->
 168
 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>
 174 </TR>
 175 <TR BGCOLOR="white" CLASS="TableRowColor">
 176 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 177 <CODE>protected &nbsp;boolean</CODE></FONT></TD>
 178 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#cachedInfo">cachedInfo</A></B></CODE>
 179
 180 <BR>
 181 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Whether or not the information fields of this group have been filled.</TD>
 182 </TR>
 183 <TR BGCOLOR="white" CLASS="TableRowColor">
 184 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 185 <CODE>protected &nbsp;<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>
 187
 188 <BR>
 189 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
 190 </TR>
 191 <TR BGCOLOR="white" CLASS="TableRowColor">
 192 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 193 <CODE>protected &nbsp;int</CODE></FONT></TD>
 194 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#cellHandle">cellHandle</A></B></CODE>
 195
 196 <BR>
 197 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
 198 </TR>
 199 <TR BGCOLOR="white" CLASS="TableRowColor">
 200 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 201 <CODE>protected &nbsp;<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>
 203
 204 <BR>
 205 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
 206 </TR>
 207 <TR BGCOLOR="white" CLASS="TableRowColor">
 208 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 209 <CODE>protected &nbsp;int</CODE></FONT></TD>
 210 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#creatorUID">creatorUID</A></B></CODE>
 211
 212 <BR>
 213 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
 214 </TR>
 215 <TR BGCOLOR="white" CLASS="TableRowColor">
 216 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 217 <CODE>static&nbsp;int</CODE></FONT></TD>
 218 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#GROUP_ANYUSER_ACCESS">GROUP_ANYUSER_ACCESS</A></B></CODE>
 219
 220 <BR>
 221 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Any user has access</TD>
 222 </TR>
 223 <TR BGCOLOR="white" CLASS="TableRowColor">
 224 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 225 <CODE>static&nbsp;int</CODE></FONT></TD>
 226 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#GROUP_GROUP_ACCESS">GROUP_GROUP_ACCESS</A></B></CODE>
 227
 228 <BR>
 229 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Members of the group have access</TD>
 230 </TR>
 231 <TR BGCOLOR="white" CLASS="TableRowColor">
 232 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 233 <CODE>static&nbsp;int</CODE></FONT></TD>
 234 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#GROUP_OWNER_ACCESS">GROUP_OWNER_ACCESS</A></B></CODE>
 235
 236 <BR>
 237 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Only the owner of the group has access</TD>
 238 </TR>
 239 <TR BGCOLOR="white" CLASS="TableRowColor">
 240 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 241 <CODE>protected &nbsp;<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>
 243
 244 <BR>
 245 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
 246 </TR>
 247 <TR BGCOLOR="white" CLASS="TableRowColor">
 248 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 249 <CODE>protected &nbsp;<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>
 251
 252 <BR>
 253 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
 254 </TR>
 255 <TR BGCOLOR="white" CLASS="TableRowColor">
 256 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 257 <CODE>protected &nbsp;int</CODE></FONT></TD>
 258 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#listAdd">listAdd</A></B></CODE>
 259
 260 <BR>
 261 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;who is allowed to execute PTS adduser for this group.   </TD>
 262 </TR>
 263 <TR BGCOLOR="white" CLASS="TableRowColor">
 264 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 265 <CODE>protected &nbsp;int</CODE></FONT></TD>
 266 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#listDelete">listDelete</A></B></CODE>
 267
 268 <BR>
 269 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;who is allowed to execute PTS removeuser for this group.   </TD>
 270 </TR>
 271 <TR BGCOLOR="white" CLASS="TableRowColor">
 272 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 273 <CODE>protected &nbsp;int</CODE></FONT></TD>
 274 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#listGroupsOwned">listGroupsOwned</A></B></CODE>
 275
 276 <BR>
 277 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;who is allowed to execute PTS examine for this group.  </TD>
 278 </TR>
 279 <TR BGCOLOR="white" CLASS="TableRowColor">
 280 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 281 <CODE>protected &nbsp;int</CODE></FONT></TD>
 282 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#listMembership">listMembership</A></B></CODE>
 283
 284 <BR>
 285 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;who is allowed to execute PTS listowned for this group.  </TD>
 286 </TR>
 287 <TR BGCOLOR="white" CLASS="TableRowColor">
 288 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 289 <CODE>protected &nbsp;int</CODE></FONT></TD>
 290 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#listStatus">listStatus</A></B></CODE>
 291
 292 <BR>
 293 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;who is allowed to execute PTS examine for this group.  </TD>
 294 </TR>
 295 <TR BGCOLOR="white" CLASS="TableRowColor">
 296 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 297 <CODE>protected &nbsp;<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>
 299
 300 <BR>
 301 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
 302 </TR>
 303 <TR BGCOLOR="white" CLASS="TableRowColor">
 304 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 305 <CODE>protected &nbsp;<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>
 307
 308 <BR>
 309 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
 310 </TR>
 311 <TR BGCOLOR="white" CLASS="TableRowColor">
 312 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 313 <CODE>protected &nbsp;int</CODE></FONT></TD>
 314 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#membershipCount">membershipCount</A></B></CODE>
 315
 316 <BR>
 317 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
 318 </TR>
 319 <TR BGCOLOR="white" CLASS="TableRowColor">
 320 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 321 <CODE>protected &nbsp;<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>
 323
 324 <BR>
 325 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
 326 </TR>
 327 <TR BGCOLOR="white" CLASS="TableRowColor">
 328 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 329 <CODE>protected &nbsp;int</CODE></FONT></TD>
 330 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#nameUID">nameUID</A></B></CODE>
 331
 332 <BR>
 333 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
 334 </TR>
 335 <TR BGCOLOR="white" CLASS="TableRowColor">
 336 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 337 <CODE>protected &nbsp;<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>
 339
 340 <BR>
 341 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
 342 </TR>
 343 <TR BGCOLOR="white" CLASS="TableRowColor">
 344 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 345 <CODE>protected &nbsp;int</CODE></FONT></TD>
 346 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#ownerUID">ownerUID</A></B></CODE>
 347
 348 <BR>
 349 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
 350 </TR>
 351 </TABLE>
 352 &nbsp;<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>
 356 </TR>
 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>
 359 </TR>
 360 </TABLE>
 361 &nbsp;
 362 <!-- ======== CONSTRUCTOR SUMMARY ======== -->
 363
 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>
 369 </TR>
 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>&nbsp;cell)</CODE>
 374
 375 <BR>
 376 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates a blank <code>Group</code> given the cell to which the group
 377  belongs. </TD>
 378 </TR>
 379 <TR BGCOLOR="white" CLASS="TableRowColor">
 380 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 381 <CODE>&nbsp;</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>&nbsp;name,
 383       <A HREF="../../../org/openafs/jafs/Cell.html">Cell</A>&nbsp;cell)</CODE>
 384
 385 <BR>
 386 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;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>
 389 </TR>
 390 <TR BGCOLOR="white" CLASS="TableRowColor">
 391 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 392 <CODE>&nbsp;</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>&nbsp;name,
 394       <A HREF="../../../org/openafs/jafs/Cell.html">Cell</A>&nbsp;cell,
 395       boolean&nbsp;preloadAllMembers)</CODE>
 396
 397 <BR>
 398 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;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>
 401 </TR>
 402 </TABLE>
 403 &nbsp;
 404 <!-- ========== METHOD SUMMARY =========== -->
 405
 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>
 411 </TR>
 412 <TR BGCOLOR="white" CLASS="TableRowColor">
 413 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 414 <CODE>protected static&nbsp;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&nbsp;cellHandle,
 416           <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;groupName,
 417           <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;userName)</CODE>
 418
 419 <BR>
 420 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Adds a user to the specified group.</TD>
 421 </TR>
 422 <TR BGCOLOR="white" CLASS="TableRowColor">
 423 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 424 <CODE>&nbsp;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>&nbsp;theUser)</CODE>
 426
 427 <BR>
 428 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Add the specified member to this group.</TD>
 429 </TR>
 430 <TR BGCOLOR="white" CLASS="TableRowColor">
 431 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 432 <CODE>&nbsp;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>&nbsp;theOwner)</CODE>
 434
 435 <BR>
 436 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Change the owner of this group.</TD>
 437 </TR>
 438 <TR BGCOLOR="white" CLASS="TableRowColor">
 439 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 440 <CODE>protected static&nbsp;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&nbsp;cellHandle,
 442             <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;groupName,
 443             <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;ownerName)</CODE>
 444
 445 <BR>
 446 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Change the owner of the specified group.</TD>
 447 </TR>
 448 <TR BGCOLOR="white" CLASS="TableRowColor">
 449 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 450 <CODE>&nbsp;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>&nbsp;theOwner)</CODE>
 452
 453 <BR>
 454 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Change the owner of this group.</TD>
 455 </TR>
 456 <TR BGCOLOR="white" CLASS="TableRowColor">
 457 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 458 <CODE>&nbsp;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>&nbsp;group)</CODE>
 460
 461 <BR>
 462 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Compares two Group objects respective to their names and does not
 463  factor any other attribute.    </TD>
 464 </TR>
 465 <TR BGCOLOR="white" CLASS="TableRowColor">
 466 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 467 <CODE>&nbsp;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>&nbsp;obj)</CODE>
 469
 470 <BR>
 471 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Comparable interface method.</TD>
 472 </TR>
 473 <TR BGCOLOR="white" CLASS="TableRowColor">
 474 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 475 <CODE>protected static&nbsp;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&nbsp;cellHandle,
 477        <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;groupName,
 478        <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;ownerName,
 479        int&nbsp;gid)</CODE>
 480
 481 <BR>
 482 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates the PTS entry for a new group.  </TD>
 483 </TR>
 484 <TR BGCOLOR="white" CLASS="TableRowColor">
 485 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 486 <CODE>&nbsp;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>&nbsp;ownerName)</CODE>
 488
 489 <BR>
 490 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates the PTS entry for a new group in this cell.  </TD>
 491 </TR>
 492 <TR BGCOLOR="white" CLASS="TableRowColor">
 493 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 494 <CODE>&nbsp;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>&nbsp;ownerName,
 496        int&nbsp;gid)</CODE>
 497
 498 <BR>
 499 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates the PTS entry for a new group in this cell.</TD>
 500 </TR>
 501 <TR BGCOLOR="white" CLASS="TableRowColor">
 502 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 503 <CODE>&nbsp;void</CODE></FONT></TD>
 504 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#delete()">delete</A></B>()</CODE>
 505
 506 <BR>
 507 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Deletes the PTS entry for a group in this cell. </TD>
 508 </TR>
 509 <TR BGCOLOR="white" CLASS="TableRowColor">
 510 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 511 <CODE>protected static&nbsp;void</CODE></FONT></TD>
 512 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#delete(int, java.lang.String)">delete</A></B>(int&nbsp;cellHandle,
 513        <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;groupName)</CODE>
 514
 515 <BR>
 516 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Deletes the PTS entry for a group.  </TD>
 517 </TR>
 518 <TR BGCOLOR="white" CLASS="TableRowColor">
 519 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 520 <CODE>&nbsp;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>&nbsp;otherGroup)</CODE>
 522
 523 <BR>
 524 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Tests whether two <code>Group</code> objects are equal, based on their
 525  names.</TD>
 526 </TR>
 527 <TR BGCOLOR="white" CLASS="TableRowColor">
 528 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 529 <CODE>&nbsp;void</CODE></FONT></TD>
 530 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#flushInfo()">flushInfo</A></B>()</CODE>
 531
 532 <BR>
 533 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Flushes the current information of this <code>Group</code> object to disk.
 534  </TD>
 535 </TR>
 536 <TR BGCOLOR="white" CLASS="TableRowColor">
 537 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 538 <CODE>&nbsp;<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>
 540
 541 <BR>
 542 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the Cell this group belongs to.</TD>
 543 </TR>
 544 <TR BGCOLOR="white" CLASS="TableRowColor">
 545 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 546 <CODE>&nbsp;<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>
 548
 549 <BR>
 550 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;PTS: Returns the creator of this group in the form of a <A HREF="../../../org/openafs/jafs/PTSEntry.html"><CODE>PTSEntry</CODE></A>.
 551
 552  </TD>
 553 </TR>
 554 <TR BGCOLOR="white" CLASS="TableRowColor">
 555 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 556 <CODE>protected static&nbsp;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&nbsp;cellHandle,
 558              <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;name,
 559              <A HREF="../../../org/openafs/jafs/Group.html">Group</A>&nbsp;group)</CODE>
 560
 561 <BR>
 562 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Fills in the information fields of the provided <code>Group</code>.
 563  </TD>
 564 </TR>
 565 <TR BGCOLOR="white" CLASS="TableRowColor">
 566 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 567 <CODE>protected static&nbsp;int</CODE></FONT></TD>
 568 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#getGroupMembersBegin(int, java.lang.String)">getGroupMembersBegin</A></B>(int&nbsp;cellHandle,
 569                      <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;name)</CODE>
 570
 571 <BR>
 572 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Begin the process of getting the users that belong to the group.  </TD>
 573 </TR>
 574 <TR BGCOLOR="white" CLASS="TableRowColor">
 575 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 576 <CODE>protected static&nbsp;void</CODE></FONT></TD>
 577 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#getGroupMembersDone(int)">getGroupMembersDone</A></B>(int&nbsp;iterationId)</CODE>
 578
 579 <BR>
 580 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Signals that the iteration is complete and will not be accessed anymore.</TD>
 581 </TR>
 582 <TR BGCOLOR="white" CLASS="TableRowColor">
 583 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 584 <CODE>protected static&nbsp;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&nbsp;cellHandle,
 586                     int&nbsp;iterationId,
 587                     <A HREF="../../../org/openafs/jafs/User.html">User</A>&nbsp;theUser)</CODE>
 588
 589 <BR>
 590 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Fills the next user object belonging to that group.  </TD>
 591 </TR>
 592 <TR BGCOLOR="white" CLASS="TableRowColor">
 593 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 594 <CODE>protected static&nbsp;<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&nbsp;iterationId)</CODE>
 596
 597 <BR>
 598 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the next members that belongs to the group.  </TD>
 599 </TR>
 600 <TR BGCOLOR="white" CLASS="TableRowColor">
 601 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 602 <CODE>&nbsp;<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>
 604
 605 <BR>
 606 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns an array of the <code>Group</code> objects this group owns.</TD>
 607 </TR>
 608 <TR BGCOLOR="white" CLASS="TableRowColor">
 609 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 610 <CODE>&nbsp;<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>
 612
 613 <BR>
 614 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns an array of the group names this group owns.
 615  </TD>
 616 </TR>
 617 <TR BGCOLOR="white" CLASS="TableRowColor">
 618 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 619 <CODE>protected &nbsp;<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>
 621
 622 <BR>
 623 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns a <code>String</code> representation of this <code>Group</code>.
 624  </TD>
 625 </TR>
 626 <TR BGCOLOR="white" CLASS="TableRowColor">
 627 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 628 <CODE>&nbsp;int</CODE></FONT></TD>
 629 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#getListAdd()">getListAdd</A></B>()</CODE>
 630
 631 <BR>
 632 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns who can add members (pts adduser) to this group.
 633  </TD>
 634 </TR>
 635 <TR BGCOLOR="white" CLASS="TableRowColor">
 636 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 637 <CODE>&nbsp;int</CODE></FONT></TD>
 638 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#getListDelete()">getListDelete</A></B>()</CODE>
 639
 640 <BR>
 641 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns who can delete members (pts removemember) from this group.
 642  </TD>
 643 </TR>
 644 <TR BGCOLOR="white" CLASS="TableRowColor">
 645 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 646 <CODE>&nbsp;int</CODE></FONT></TD>
 647 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#getListGroupsOwned()">getListGroupsOwned</A></B>()</CODE>
 648
 649 <BR>
 650 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns who can list the groups owned (pts listowned) by this group.
 651  </TD>
 652 </TR>
 653 <TR BGCOLOR="white" CLASS="TableRowColor">
 654 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 655 <CODE>&nbsp;int</CODE></FONT></TD>
 656 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#getListMembership()">getListMembership</A></B>()</CODE>
 657
 658 <BR>
 659 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns who can list the users (pts membership) that belong to this group.
 660  </TD>
 661 </TR>
 662 <TR BGCOLOR="white" CLASS="TableRowColor">
 663 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 664 <CODE>&nbsp;int</CODE></FONT></TD>
 665 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#getListStatus()">getListStatus</A></B>()</CODE>
 666
 667 <BR>
 668 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns who can list the status (pts examine) of this group.
 669  </TD>
 670 </TR>
 671 <TR BGCOLOR="white" CLASS="TableRowColor">
 672 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 673 <CODE>&nbsp;<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>
 675
 676 <BR>
 677 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns an array of the member names of this group.</TD>
 678 </TR>
 679 <TR BGCOLOR="white" CLASS="TableRowColor">
 680 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 681 <CODE>&nbsp;<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>
 683
 684 <BR>
 685 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns an array of the <code>User</code> object members of this group.</TD>
 686 </TR>
 687 <TR BGCOLOR="white" CLASS="TableRowColor">
 688 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 689 <CODE>&nbsp;int</CODE></FONT></TD>
 690 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#getMembershipCount()">getMembershipCount</A></B>()</CODE>
 691
 692 <BR>
 693 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the number of members of this group.</TD>
 694 </TR>
 695 <TR BGCOLOR="white" CLASS="TableRowColor">
 696 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 697 <CODE>&nbsp;<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>
 699
 700 <BR>
 701 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the name of this group.</TD>
 702 </TR>
 703 <TR BGCOLOR="white" CLASS="TableRowColor">
 704 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 705 <CODE>&nbsp;<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>
 707
 708 <BR>
 709 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;PTS: Returns the owner of this group in the form of a <A HREF="../../../org/openafs/jafs/PTSEntry.html"><CODE>PTSEntry</CODE></A>.
 710
 711  </TD>
 712 </TR>
 713 <TR BGCOLOR="white" CLASS="TableRowColor">
 714 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 715 <CODE>&nbsp;short</CODE></FONT></TD>
 716 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#getType()">getType</A></B>()</CODE>
 717
 718 <BR>
 719 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the type of <A HREF="../../../org/openafs/jafs/PTSEntry.html"><CODE>PTSEntry</CODE></A> this object represents.
 720
 721  </TD>
 722 </TR>
 723 <TR BGCOLOR="white" CLASS="TableRowColor">
 724 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 725 <CODE>&nbsp;int</CODE></FONT></TD>
 726 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#getUID()">getUID</A></B>()</CODE>
 727
 728 <BR>
 729 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the numeric AFS id of this group.</TD>
 730 </TR>
 731 <TR BGCOLOR="white" CLASS="TableRowColor">
 732 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 733 <CODE>protected static&nbsp;void</CODE></FONT></TD>
 734 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#reclaimGroupMemory()">reclaimGroupMemory</A></B>()</CODE>
 735
 736 <BR>
 737 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Reclaims all memory being saved by the group portion of the native
 738  library.
 739  </TD>
 740 </TR>
 741 <TR BGCOLOR="white" CLASS="TableRowColor">
 742 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 743 <CODE>&nbsp;void</CODE></FONT></TD>
 744 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#refresh()">refresh</A></B>()</CODE>
 745
 746 <BR>
 747 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Refreshes the properties of this Group object instance with values from
 748  the AFS group it represents.  </TD>
 749 </TR>
 750 <TR BGCOLOR="white" CLASS="TableRowColor">
 751 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 752 <CODE>protected &nbsp;void</CODE></FONT></TD>
 753 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#refresh(boolean)">refresh</A></B>(boolean&nbsp;all)</CODE>
 754
 755 <BR>
 756 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Refreshes the properties of this Group object instance with values from
 757  the AFS group it represents.  </TD>
 758 </TR>
 759 <TR BGCOLOR="white" CLASS="TableRowColor">
 760 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 761 <CODE>protected &nbsp;void</CODE></FONT></TD>
 762 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#refreshGroupsOwned()">refreshGroupsOwned</A></B>()</CODE>
 763
 764 <BR>
 765 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Refreshes the current information about the <code>Group</code> objects the
 766  group owns.  </TD>
 767 </TR>
 768 <TR BGCOLOR="white" CLASS="TableRowColor">
 769 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 770 <CODE>protected &nbsp;void</CODE></FONT></TD>
 771 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#refreshGroupsOwnedNames()">refreshGroupsOwnedNames</A></B>()</CODE>
 772
 773 <BR>
 774 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Refreshes the current information about the names of groups the group
 775  owns.  </TD>
 776 </TR>
 777 <TR BGCOLOR="white" CLASS="TableRowColor">
 778 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 779 <CODE>protected &nbsp;void</CODE></FONT></TD>
 780 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#refreshInfo()">refreshInfo</A></B>()</CODE>
 781
 782 <BR>
 783 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Refreshes the information fields of this <code>Group</code> to reflect
 784  the current state of the AFS group.  </TD>
 785 </TR>
 786 <TR BGCOLOR="white" CLASS="TableRowColor">
 787 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 788 <CODE>protected &nbsp;void</CODE></FONT></TD>
 789 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#refreshMemberNames()">refreshMemberNames</A></B>()</CODE>
 790
 791 <BR>
 792 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Refreshes the current information about the names of members belonging
 793  to this group.  </TD>
 794 </TR>
 795 <TR BGCOLOR="white" CLASS="TableRowColor">
 796 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 797 <CODE>protected &nbsp;void</CODE></FONT></TD>
 798 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#refreshMembers()">refreshMembers</A></B>()</CODE>
 799
 800 <BR>
 801 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Refreshes the current information about the <code>User</code> objects
 802  belonging to this group.  </TD>
 803 </TR>
 804 <TR BGCOLOR="white" CLASS="TableRowColor">
 805 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 806 <CODE>protected static&nbsp;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&nbsp;cellHandle,
 808              <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;groupName,
 809              <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;userName)</CODE>
 810
 811 <BR>
 812 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Removes a user from the specified group.</TD>
 813 </TR>
 814 <TR BGCOLOR="white" CLASS="TableRowColor">
 815 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 816 <CODE>&nbsp;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>&nbsp;theUser)</CODE>
 818
 819 <BR>
 820 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Remove the specified member from this group.</TD>
 821 </TR>
 822 <TR BGCOLOR="white" CLASS="TableRowColor">
 823 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 824 <CODE>protected static&nbsp;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&nbsp;cellHandle,
 826        <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;oldGroupName,
 827        <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;newGroupName)</CODE>
 828
 829 <BR>
 830 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Change the name of the specified group.</TD>
 831 </TR>
 832 <TR BGCOLOR="white" CLASS="TableRowColor">
 833 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 834 <CODE>&nbsp;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>&nbsp;newName)</CODE>
 836
 837 <BR>
 838 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Change the name of this group.</TD>
 839 </TR>
 840 <TR BGCOLOR="white" CLASS="TableRowColor">
 841 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 842 <CODE>protected static&nbsp;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&nbsp;cellHandle,
 844              <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;name,
 845              <A HREF="../../../org/openafs/jafs/Group.html">Group</A>&nbsp;theGroup)</CODE>
 846
 847 <BR>
 848 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets the information values of this AFS group to be the parameter values.</TD>
 849 </TR>
 850 <TR BGCOLOR="white" CLASS="TableRowColor">
 851 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 852 <CODE>&nbsp;void</CODE></FONT></TD>
 853 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#setListAdd(int)">setListAdd</A></B>(int&nbsp;value)</CODE>
 854
 855 <BR>
 856 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets who can add members (pts adduser) to this group.
 857  </TD>
 858 </TR>
 859 <TR BGCOLOR="white" CLASS="TableRowColor">
 860 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 861 <CODE>&nbsp;void</CODE></FONT></TD>
 862 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#setListDelete(int)">setListDelete</A></B>(int&nbsp;value)</CODE>
 863
 864 <BR>
 865 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets who can delete members (pts removemember) from this group.
 866  </TD>
 867 </TR>
 868 <TR BGCOLOR="white" CLASS="TableRowColor">
 869 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 870 <CODE>&nbsp;void</CODE></FONT></TD>
 871 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#setListGroupsOwned(int)">setListGroupsOwned</A></B>(int&nbsp;value)</CODE>
 872
 873 <BR>
 874 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets who can list the groups owned (pts listowned) by this group.
 875  </TD>
 876 </TR>
 877 <TR BGCOLOR="white" CLASS="TableRowColor">
 878 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 879 <CODE>&nbsp;void</CODE></FONT></TD>
 880 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#setListMembership(int)">setListMembership</A></B>(int&nbsp;value)</CODE>
 881
 882 <BR>
 883 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets who can list the users (pts membership) that belong to this group.
 884  </TD>
 885 </TR>
 886 <TR BGCOLOR="white" CLASS="TableRowColor">
 887 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 888 <CODE>&nbsp;void</CODE></FONT></TD>
 889 <TD><CODE><B><A HREF="../../../org/openafs/jafs/Group.html#setListStatus(int)">setListStatus</A></B>(int&nbsp;value)</CODE>
 890
 891 <BR>
 892 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets who can list the status (pts examine) of this group.
 893  </TD>
 894 </TR>
 895 <TR BGCOLOR="white" CLASS="TableRowColor">
 896 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 897 <CODE>&nbsp;<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>
 899
 900 <BR>
 901 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the name of this <CODE>Group</CODE></TD>
 902 </TR>
 903 </TABLE>
 904 &nbsp;<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>
 908 </TR>
 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>
 911 </TR>
 912 </TABLE>
 913 &nbsp;
 914 <P>
 915
 916 <!-- ============ FIELD DETAIL =========== -->
 917
 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>
 923 </TR>
 924 </TABLE>
 925
 926 <A NAME="GROUP_OWNER_ACCESS"><!-- --></A><H3>
 927 GROUP_OWNER_ACCESS</H3>
 928 <PRE>
 929 public static final int <B>GROUP_OWNER_ACCESS</B></PRE>
 930 <DL>
 931 <DD>Only the owner of the group has access
 932 <P>
 933 <DL>
 934 <DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#org.openafs.jafs.Group.GROUP_OWNER_ACCESS">Constant Field Values</A></DL>
 935 </DL>
 936 <HR>
 937
 938 <A NAME="GROUP_GROUP_ACCESS"><!-- --></A><H3>
 939 GROUP_GROUP_ACCESS</H3>
 940 <PRE>
 941 public static final int <B>GROUP_GROUP_ACCESS</B></PRE>
 942 <DL>
 943 <DD>Members of the group have access
 944 <P>
 945 <DL>
 946 <DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#org.openafs.jafs.Group.GROUP_GROUP_ACCESS">Constant Field Values</A></DL>
 947 </DL>
 948 <HR>
 949
 950 <A NAME="GROUP_ANYUSER_ACCESS"><!-- --></A><H3>
 951 GROUP_ANYUSER_ACCESS</H3>
 952 <PRE>
 953 public static final int <B>GROUP_ANYUSER_ACCESS</B></PRE>
 954 <DL>
 955 <DD>Any user has access
 956 <P>
 957 <DL>
 958 <DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#org.openafs.jafs.Group.GROUP_ANYUSER_ACCESS">Constant Field Values</A></DL>
 959 </DL>
 960 <HR>
 961
 962 <A NAME="cell"><!-- --></A><H3>
 963 cell</H3>
 964 <PRE>
 965 protected <A HREF="../../../org/openafs/jafs/Cell.html">Cell</A> <B>cell</B></PRE>
 966 <DL>
 967 <DL>
 968 </DL>
 969 </DL>
 970 <HR>
 971
 972 <A NAME="cellHandle"><!-- --></A><H3>
 973 cellHandle</H3>
 974 <PRE>
 975 protected int <B>cellHandle</B></PRE>
 976 <DL>
 977 <DL>
 978 </DL>
 979 </DL>
 980 <HR>
 981
 982 <A NAME="name"><!-- --></A><H3>
 983 name</H3>
 984 <PRE>
 985 protected <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> <B>name</B></PRE>
 986 <DL>
 987 <DL>
 988 </DL>
 989 </DL>
 990 <HR>
 991
 992 <A NAME="membershipCount"><!-- --></A><H3>
 993 membershipCount</H3>
 994 <PRE>
 995 protected int <B>membershipCount</B></PRE>
 996 <DL>
 997 <DL>
 998 </DL>
 999 </DL>
1000 <HR>
1001
1002 <A NAME="nameUID"><!-- --></A><H3>
1003 nameUID</H3>
1004 <PRE>
1005 protected int <B>nameUID</B></PRE>
1006 <DL>
1007 <DL>
1008 </DL>
1009 </DL>
1010 <HR>
1011
1012 <A NAME="ownerUID"><!-- --></A><H3>
1013 ownerUID</H3>
1014 <PRE>
1015 protected int <B>ownerUID</B></PRE>
1016 <DL>
1017 <DL>
1018 </DL>
1019 </DL>
1020 <HR>
1021
1022 <A NAME="creatorUID"><!-- --></A><H3>
1023 creatorUID</H3>
1024 <PRE>
1025 protected int <B>creatorUID</B></PRE>
1026 <DL>
1027 <DL>
1028 </DL>
1029 </DL>
1030 <HR>
1031
1032 <A NAME="owner"><!-- --></A><H3>
1033 owner</H3>
1034 <PRE>
1035 protected <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> <B>owner</B></PRE>
1036 <DL>
1037 <DL>
1038 </DL>
1039 </DL>
1040 <HR>
1041
1042 <A NAME="creator"><!-- --></A><H3>
1043 creator</H3>
1044 <PRE>
1045 protected <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> <B>creator</B></PRE>
1046 <DL>
1047 <DL>
1048 </DL>
1049 </DL>
1050 <HR>
1051
1052 <A NAME="listStatus"><!-- --></A><H3>
1053 listStatus</H3>
1054 <PRE>
1055 protected int <B>listStatus</B></PRE>
1056 <DL>
1057 <DD>who is allowed to execute PTS examine for this group.  Valid values are:
1058  <ul>
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>
1063 <P>
1064 <DL>
1065 </DL>
1066 </DL>
1067 <HR>
1068
1069 <A NAME="listGroupsOwned"><!-- --></A><H3>
1070 listGroupsOwned</H3>
1071 <PRE>
1072 protected int <B>listGroupsOwned</B></PRE>
1073 <DL>
1074 <DD>who is allowed to execute PTS examine for this group.  Valid values are:
1075  <ul>
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>
1080 <P>
1081 <DL>
1082 </DL>
1083 </DL>
1084 <HR>
1085
1086 <A NAME="listMembership"><!-- --></A><H3>
1087 listMembership</H3>
1088 <PRE>
1089 protected int <B>listMembership</B></PRE>
1090 <DL>
1091 <DD>who is allowed to execute PTS listowned for this group.  Valid values are:
1092  <ul>
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>
1097 <P>
1098 <DL>
1099 </DL>
1100 </DL>
1101 <HR>
1102
1103 <A NAME="listAdd"><!-- --></A><H3>
1104 listAdd</H3>
1105 <PRE>
1106 protected int <B>listAdd</B></PRE>
1107 <DL>
1108 <DD>who is allowed to execute PTS adduser for this group.   Valid values are:
1109  <ul>
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>
1114 <P>
1115 <DL>
1116 </DL>
1117 </DL>
1118 <HR>
1119
1120 <A NAME="listDelete"><!-- --></A><H3>
1121 listDelete</H3>
1122 <PRE>
1123 protected int <B>listDelete</B></PRE>
1124 <DL>
1125 <DD>who is allowed to execute PTS removeuser for this group.   Valid
1126  values are:
1127  <ul>
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>
1132 <P>
1133 <DL>
1134 </DL>
1135 </DL>
1136 <HR>
1137
1138 <A NAME="members"><!-- --></A><H3>
1139 members</H3>
1140 <PRE>
1141 protected <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/util/ArrayList.html">ArrayList</A> <B>members</B></PRE>
1142 <DL>
1143 <DL>
1144 </DL>
1145 </DL>
1146 <HR>
1147
1148 <A NAME="memberNames"><!-- --></A><H3>
1149 memberNames</H3>
1150 <PRE>
1151 protected <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/util/ArrayList.html">ArrayList</A> <B>memberNames</B></PRE>
1152 <DL>
1153 <DL>
1154 </DL>
1155 </DL>
1156 <HR>
1157
1158 <A NAME="groupsOwned"><!-- --></A><H3>
1159 groupsOwned</H3>
1160 <PRE>
1161 protected <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/util/ArrayList.html">ArrayList</A> <B>groupsOwned</B></PRE>
1162 <DL>
1163 <DL>
1164 </DL>
1165 </DL>
1166 <HR>
1167
1168 <A NAME="groupsOwnedNames"><!-- --></A><H3>
1169 groupsOwnedNames</H3>
1170 <PRE>
1171 protected <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/util/ArrayList.html">ArrayList</A> <B>groupsOwnedNames</B></PRE>
1172 <DL>
1173 <DL>
1174 </DL>
1175 </DL>
1176 <HR>
1177
1178 <A NAME="cachedInfo"><!-- --></A><H3>
1179 cachedInfo</H3>
1180 <PRE>
1181 protected boolean <B>cachedInfo</B></PRE>
1182 <DL>
1183 <DD>Whether or not the information fields of this group have been filled.
1184 <P>
1185 <DL>
1186 </DL>
1187 </DL>
1188
1189 <!-- ========= CONSTRUCTOR DETAIL ======== -->
1190
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>
1196 </TR>
1197 </TABLE>
1198
1199 <A NAME="Group(java.lang.String, org.openafs.jafs.Cell)"><!-- --></A><H3>
1200 Group</H3>
1201 <PRE>
1202 public <B>Group</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;name,
1203              <A HREF="../../../org/openafs/jafs/Cell.html">Cell</A>&nbsp;cell)
1204       throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1205 <DL>
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.
1214 <P>
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.
1216 <DT><B>Throws:</B>
1217 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1218 <HR>
1219
1220 <A NAME="Group(java.lang.String, org.openafs.jafs.Cell, boolean)"><!-- --></A><H3>
1221 Group</H3>
1222 <PRE>
1223 public <B>Group</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;name,
1224              <A HREF="../../../org/openafs/jafs/Cell.html">Cell</A>&nbsp;cell,
1225              boolean&nbsp;preloadAllMembers)
1226       throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1227 <DL>
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
1237  will be thrown.
1238
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
1243  concerns.
1244 <P>
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.
1249 <DT><B>Throws:</B>
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>
1251 <HR>
1252
1253 <A NAME="Group(org.openafs.jafs.Cell)"><!-- --></A><H3>
1254 Group</H3>
1255 <PRE>
1256 <B>Group</B>(<A HREF="../../../org/openafs/jafs/Cell.html">Cell</A>&nbsp;cell)
1257 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1258 <DL>
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
1261  blank object.
1262 <P>
1263 <DT><B>Parameters:</B><DD><CODE>cell</CODE> - the cell to which the group belongs.
1264 <DT><B>Throws:</B>
1265 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1266
1267 <!-- ============ METHOD DETAIL ========== -->
1268
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>
1274 </TR>
1275 </TABLE>
1276
1277 <A NAME="create(java.lang.String)"><!-- --></A><H3>
1278 create</H3>
1279 <PRE>
1280 public void <B>create</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;ownerName)
1281             throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1282 <DL>
1283 <DD>Creates the PTS entry for a new group in this cell.  Automatically assigns
1284  a group id.
1285 <P>
1286 <DD><DL>
1287 </DL>
1288 </DD>
1289 <DD><DL>
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>
1292 </DD>
1293 </DL>
1294 <HR>
1295
1296 <A NAME="create(java.lang.String, int)"><!-- --></A><H3>
1297 create</H3>
1298 <PRE>
1299 public void <B>create</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;ownerName,
1300                    int&nbsp;gid)
1301             throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1302 <DL>
1303 <DD>Creates the PTS entry for a new group in this cell.
1304 <P>
1305 <DD><DL>
1306 </DL>
1307 </DD>
1308 <DD><DL>
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
1310 <DT><B>Throws:</B>
1311 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1312 </DD>
1313 </DL>
1314 <HR>
1315
1316 <A NAME="delete()"><!-- --></A><H3>
1317 delete</H3>
1318 <PRE>
1319 public void <B>delete</B>()
1320             throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1321 <DL>
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.
1325 <P>
1326 <DD><DL>
1327 </DL>
1328 </DD>
1329 <DD><DL>
1330
1331 <DT><B>Throws:</B>
1332 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1333 </DD>
1334 </DL>
1335 <HR>
1336
1337 <A NAME="flushInfo()"><!-- --></A><H3>
1338 flushInfo</H3>
1339 <PRE>
1340 public void <B>flushInfo</B>()
1341                throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1342 <DL>
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.
1348 <P>
1349 <DD><DL>
1350 </DL>
1351 </DD>
1352 <DD><DL>
1353
1354 <DT><B>Throws:</B>
1355 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1356 </DD>
1357 </DL>
1358 <HR>
1359
1360 <A NAME="addMember(org.openafs.jafs.User)"><!-- --></A><H3>
1361 addMember</H3>
1362 <PRE>
1363 public void <B>addMember</B>(<A HREF="../../../org/openafs/jafs/User.html">User</A>&nbsp;theUser)
1364                throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1365 <DL>
1366 <DD>Add the specified member to this group.
1367 <P>
1368 <DD><DL>
1369 </DL>
1370 </DD>
1371 <DD><DL>
1372
1373 <DT><B>Throws:</B>
1374 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1375 </DD>
1376 </DL>
1377 <HR>
1378
1379 <A NAME="removeMember(org.openafs.jafs.User)"><!-- --></A><H3>
1380 removeMember</H3>
1381 <PRE>
1382 public void <B>removeMember</B>(<A HREF="../../../org/openafs/jafs/User.html">User</A>&nbsp;theUser)
1383                   throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1384 <DL>
1385 <DD>Remove the specified member from this group.
1386 <P>
1387 <DD><DL>
1388 </DL>
1389 </DD>
1390 <DD><DL>
1391
1392 <DT><B>Throws:</B>
1393 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1394 </DD>
1395 </DL>
1396 <HR>
1397
1398 <A NAME="changeOwner(org.openafs.jafs.User)"><!-- --></A><H3>
1399 changeOwner</H3>
1400 <PRE>
1401 public void <B>changeOwner</B>(<A HREF="../../../org/openafs/jafs/User.html">User</A>&nbsp;theOwner)
1402                  throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1403 <DL>
1404 <DD>Change the owner of this group.
1405 <P>
1406 <DD><DL>
1407 </DL>
1408 </DD>
1409 <DD><DL>
1410
1411 <DT><B>Throws:</B>
1412 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1413 </DD>
1414 </DL>
1415 <HR>
1416
1417 <A NAME="changeOwner(org.openafs.jafs.Group)"><!-- --></A><H3>
1418 changeOwner</H3>
1419 <PRE>
1420 public void <B>changeOwner</B>(<A HREF="../../../org/openafs/jafs/Group.html">Group</A>&nbsp;theOwner)
1421                  throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1422 <DL>
1423 <DD>Change the owner of this group.
1424 <P>
1425 <DD><DL>
1426 </DL>
1427 </DD>
1428 <DD><DL>
1429
1430 <DT><B>Throws:</B>
1431 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1432 </DD>
1433 </DL>
1434 <HR>
1435
1436 <A NAME="rename(java.lang.String)"><!-- --></A><H3>
1437 rename</H3>
1438 <PRE>
1439 public void <B>rename</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;newName)
1440             throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1441 <DL>
1442 <DD>Change the name of this group.
1443 <P>
1444 <DD><DL>
1445 </DL>
1446 </DD>
1447 <DD><DL>
1448 <DT><B>Parameters:</B><DD><CODE>newName</CODE> - the new name for this group
1449 <DT><B>Throws:</B>
1450 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1451 </DD>
1452 </DL>
1453 <HR>
1454
1455 <A NAME="refresh()"><!-- --></A><H3>
1456 refresh</H3>
1457 <PRE>
1458 public void <B>refresh</B>()
1459              throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1460 <DL>
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.
1465
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
1475  unnecessary.
1476 <P>
1477 <DD><DL>
1478 </DL>
1479 </DD>
1480 <DD><DL>
1481
1482 <DT><B>Throws:</B>
1483 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1484 </DD>
1485 </DL>
1486 <HR>
1487
1488 <A NAME="refresh(boolean)"><!-- --></A><H3>
1489 refresh</H3>
1490 <PRE>
1491 protected void <B>refresh</B>(boolean&nbsp;all)
1492                 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1493 <DL>
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.
1499
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.
1503 <P>
1504 <DD><DL>
1505 </DL>
1506 </DD>
1507 <DD><DL>
1508 <DT><B>Parameters:</B><DD><CODE>all</CODE> - if true set or renew all object properties; otherwise renew
1509               all set properties
1510 <DT><B>Throws:</B>
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>
1512 </DD>
1513 </DL>
1514 <HR>
1515
1516 <A NAME="refreshInfo()"><!-- --></A><H3>
1517 refreshInfo</H3>
1518 <PRE>
1519 protected void <B>refreshInfo</B>()
1520                     throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1521 <DL>
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.
1525 <P>
1526 <DD><DL>
1527 </DL>
1528 </DD>
1529 <DD><DL>
1530
1531 <DT><B>Throws:</B>
1532 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1533 </DD>
1534 </DL>
1535 <HR>
1536
1537 <A NAME="refreshMembers()"><!-- --></A><H3>
1538 refreshMembers</H3>
1539 <PRE>
1540 protected void <B>refreshMembers</B>()
1541                        throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1542 <DL>
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.
1546 <P>
1547 <DD><DL>
1548 </DL>
1549 </DD>
1550 <DD><DL>
1551
1552 <DT><B>Throws:</B>
1553 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1554 </DD>
1555 </DL>
1556 <HR>
1557
1558 <A NAME="refreshMemberNames()"><!-- --></A><H3>
1559 refreshMemberNames</H3>
1560 <PRE>
1561 protected void <B>refreshMemberNames</B>()
1562                            throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1563 <DL>
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
1566  or groups owned.
1567 <P>
1568 <DD><DL>
1569 </DL>
1570 </DD>
1571 <DD><DL>
1572
1573 <DT><B>Throws:</B>
1574 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1575 </DD>
1576 </DL>
1577 <HR>
1578
1579 <A NAME="refreshGroupsOwned()"><!-- --></A><H3>
1580 refreshGroupsOwned</H3>
1581 <PRE>
1582 protected void <B>refreshGroupsOwned</B>()
1583                            throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1584 <DL>
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
1587  members.
1588 <P>
1589 <DD><DL>
1590 </DL>
1591 </DD>
1592 <DD><DL>
1593
1594 <DT><B>Throws:</B>
1595 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1596 </DD>
1597 </DL>
1598 <HR>
1599
1600 <A NAME="refreshGroupsOwnedNames()"><!-- --></A><H3>
1601 refreshGroupsOwnedNames</H3>
1602 <PRE>
1603 protected void <B>refreshGroupsOwnedNames</B>()
1604                                 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1605 <DL>
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.
1608 <P>
1609 <DD><DL>
1610 </DL>
1611 </DD>
1612 <DD><DL>
1613
1614 <DT><B>Throws:</B>
1615 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1616 </DD>
1617 </DL>
1618 <HR>
1619
1620 <A NAME="getName()"><!-- --></A><H3>
1621 getName</H3>
1622 <PRE>
1623 public <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> <B>getName</B>()</PRE>
1624 <DL>
1625 <DD>Returns the name of this group.
1626 <P>
1627 <DD><DL>
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>
1629 </DD>
1630 <DD><DL>
1631
1632 <DT><B>Returns:</B><DD>the name of this group</DL>
1633 </DD>
1634 </DL>
1635 <HR>
1636
1637 <A NAME="getUID()"><!-- --></A><H3>
1638 getUID</H3>
1639 <PRE>
1640 public int <B>getUID</B>()
1641            throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1642 <DL>
1643 <DD>Returns the numeric AFS id of this group.
1644 <P>
1645 <DD><DL>
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>
1647 </DD>
1648 <DD><DL>
1649
1650 <DT><B>Returns:</B><DD>the AFS id of this group
1651 <DT><B>Throws:</B>
1652 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1653 </DD>
1654 </DL>
1655 <HR>
1656
1657 <A NAME="getCell()"><!-- --></A><H3>
1658 getCell</H3>
1659 <PRE>
1660 public <A HREF="../../../org/openafs/jafs/Cell.html">Cell</A> <B>getCell</B>()</PRE>
1661 <DL>
1662 <DD>Returns the Cell this group belongs to.
1663 <P>
1664 <DD><DL>
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>
1666 </DD>
1667 <DD><DL>
1668
1669 <DT><B>Returns:</B><DD>the Cell this group belongs to</DL>
1670 </DD>
1671 </DL>
1672 <HR>
1673
1674 <A NAME="getMembers()"><!-- --></A><H3>
1675 getMembers</H3>
1676 <PRE>
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>
1679 <DL>
1680 <DD>Returns an array of the <code>User</code> object members of this group.
1681 <P>
1682 <DD><DL>
1683 </DL>
1684 </DD>
1685 <DD><DL>
1686
1687 <DT><B>Returns:</B><DD>an array of the members of this group
1688 <DT><B>Throws:</B>
1689 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1690 </DD>
1691 </DL>
1692 <HR>
1693
1694 <A NAME="getMemberNames()"><!-- --></A><H3>
1695 getMemberNames</H3>
1696 <PRE>
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>
1699 <DL>
1700 <DD>Returns an array of the member names of this group.
1701 <P>
1702 <DD><DL>
1703 </DL>
1704 </DD>
1705 <DD><DL>
1706
1707 <DT><B>Returns:</B><DD>an array of the member names of this group
1708 <DT><B>Throws:</B>
1709 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1710 </DD>
1711 </DL>
1712 <HR>
1713
1714 <A NAME="getGroupsOwned()"><!-- --></A><H3>
1715 getGroupsOwned</H3>
1716 <PRE>
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>
1719 <DL>
1720 <DD>Returns an array of the <code>Group</code> objects this group owns.
1721 <P>
1722 <DD><DL>
1723 </DL>
1724 </DD>
1725 <DD><DL>
1726
1727 <DT><B>Returns:</B><DD>an array of the <code>Groups</code> this group owns
1728 <DT><B>Throws:</B>
1729 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1730 </DD>
1731 </DL>
1732 <HR>
1733
1734 <A NAME="getGroupsOwnedNames()"><!-- --></A><H3>
1735 getGroupsOwnedNames</H3>
1736 <PRE>
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>
1739 <DL>
1740 <DD>Returns an array of the group names this group owns.
1741  Contains <code>String</code> objects.
1742 <P>
1743 <DD><DL>
1744 </DL>
1745 </DD>
1746 <DD><DL>
1747
1748 <DT><B>Returns:</B><DD>an array of the group names this group owns
1749 <DT><B>Throws:</B>
1750 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1751 </DD>
1752 </DL>
1753 <HR>
1754
1755 <A NAME="getMembershipCount()"><!-- --></A><H3>
1756 getMembershipCount</H3>
1757 <PRE>
1758 public int <B>getMembershipCount</B>()
1759                        throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1760 <DL>
1761 <DD>Returns the number of members of this group.
1762 <P>
1763 <DD><DL>
1764 </DL>
1765 </DD>
1766 <DD><DL>
1767
1768 <DT><B>Returns:</B><DD>the membership count
1769 <DT><B>Throws:</B>
1770 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1771 </DD>
1772 </DL>
1773 <HR>
1774
1775 <A NAME="getOwner()"><!-- --></A><H3>
1776 getOwner</H3>
1777 <PRE>
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>
1780 <DL>
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>.
1782
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.
1786 <P>
1787 <DD><DL>
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>
1789 </DD>
1790 <DD><DL>
1791
1792 <DT><B>Returns:</B><DD>the owner of this group
1793 <DT><B>Throws:</B>
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>
1797 </DD>
1798 </DL>
1799 <HR>
1800
1801 <A NAME="getCreator()"><!-- --></A><H3>
1802 getCreator</H3>
1803 <PRE>
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>
1806 <DL>
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>.
1808
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.
1812 <P>
1813 <DD><DL>
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>
1815 </DD>
1816 <DD><DL>
1817
1818 <DT><B>Returns:</B><DD>the creator of this group
1819 <DT><B>Throws:</B>
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>
1823 </DD>
1824 </DL>
1825 <HR>
1826
1827 <A NAME="getType()"><!-- --></A><H3>
1828 getType</H3>
1829 <PRE>
1830 public short <B>getType</B>()</PRE>
1831 <DL>
1832 <DD>Returns the type of <A HREF="../../../org/openafs/jafs/PTSEntry.html"><CODE>PTSEntry</CODE></A> this object represents.
1833
1834  <P>This method will always return <A HREF="../../../org/openafs/jafs/PTSEntry.html#PTS_GROUP"><CODE>PTSEntry.PTS_GROUP</CODE></A>.
1835 <P>
1836 <DD><DL>
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>
1838 </DD>
1839 <DD><DL>
1840
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>
1844 </DD>
1845 </DL>
1846 <HR>
1847
1848 <A NAME="getListStatus()"><!-- --></A><H3>
1849 getListStatus</H3>
1850 <PRE>
1851 public int <B>getListStatus</B>()
1852                   throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1853 <DL>
1854 <DD>Returns who can list the status (pts examine) of this group.
1855  Valid values are:
1856  <ul>
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>
1863  </ul>
1864 <P>
1865 <DD><DL>
1866 </DL>
1867 </DD>
1868 <DD><DL>
1869
1870 <DT><B>Returns:</B><DD>the status listing permission
1871 <DT><B>Throws:</B>
1872 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1873 </DD>
1874 </DL>
1875 <HR>
1876
1877 <A NAME="getListGroupsOwned()"><!-- --></A><H3>
1878 getListGroupsOwned</H3>
1879 <PRE>
1880 public int <B>getListGroupsOwned</B>()
1881                        throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1882 <DL>
1883 <DD>Returns who can list the groups owned (pts listowned) by this group.
1884  Valid values are:
1885  <ul>
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>
1892  </ul>
1893 <P>
1894 <DD><DL>
1895 </DL>
1896 </DD>
1897 <DD><DL>
1898
1899 <DT><B>Returns:</B><DD>the groups owned listing permission
1900 <DT><B>Throws:</B>
1901 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1902 </DD>
1903 </DL>
1904 <HR>
1905
1906 <A NAME="getListMembership()"><!-- --></A><H3>
1907 getListMembership</H3>
1908 <PRE>
1909 public int <B>getListMembership</B>()
1910                       throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1911 <DL>
1912 <DD>Returns who can list the users (pts membership) that belong to this group.
1913  Valid values are:
1914  <ul>
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>
1921  </ul>
1922 <P>
1923 <DD><DL>
1924 </DL>
1925 </DD>
1926 <DD><DL>
1927
1928 <DT><B>Returns:</B><DD>the membership listing permission
1929 <DT><B>Throws:</B>
1930 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1931 </DD>
1932 </DL>
1933 <HR>
1934
1935 <A NAME="getListAdd()"><!-- --></A><H3>
1936 getListAdd</H3>
1937 <PRE>
1938 public int <B>getListAdd</B>()
1939                throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1940 <DL>
1941 <DD>Returns who can add members (pts adduser) to this group.
1942  Valid values are:
1943  <ul>
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>
1950  </ul>
1951 <P>
1952 <DD><DL>
1953 </DL>
1954 </DD>
1955 <DD><DL>
1956
1957 <DT><B>Returns:</B><DD>the member adding permission
1958 <DT><B>Throws:</B>
1959 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1960 </DD>
1961 </DL>
1962 <HR>
1963
1964 <A NAME="getListDelete()"><!-- --></A><H3>
1965 getListDelete</H3>
1966 <PRE>
1967 public int <B>getListDelete</B>()
1968                   throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1969 <DL>
1970 <DD>Returns who can delete members (pts removemember) from this group.
1971  Valid values are:
1972  <ul>
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>
1979  </ul>
1980 <P>
1981 <DD><DL>
1982 </DL>
1983 </DD>
1984 <DD><DL>
1985
1986 <DT><B>Returns:</B><DD>the member deleting permission
1987 <DT><B>Throws:</B>
1988 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - If an error occurs in the native code</DL>
1989 </DD>
1990 </DL>
1991 <HR>
1992
1993 <A NAME="setListStatus(int)"><!-- --></A><H3>
1994 setListStatus</H3>
1995 <PRE>
1996 public void <B>setListStatus</B>(int&nbsp;value)
1997                    throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
1998 <DL>
1999 <DD>Sets who can list the status (pts examine) of this group.
2000  Valid values are:
2001  <ul>
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>
2008  </ul>
2009 <P>
2010 <DD><DL>
2011 </DL>
2012 </DD>
2013 <DD><DL>
2014 <DT><B>Parameters:</B><DD><CODE>value</CODE> - the value of the new list membership permission
2015 <DT><B>Throws:</B>
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>
2018 </DD>
2019 </DL>
2020 <HR>
2021
2022 <A NAME="setListGroupsOwned(int)"><!-- --></A><H3>
2023 setListGroupsOwned</H3>
2024 <PRE>
2025 public void <B>setListGroupsOwned</B>(int&nbsp;value)
2026                         throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
2027 <DL>
2028 <DD>Sets who can list the groups owned (pts listowned) by this group.
2029  Valid values are:
2030  <ul>
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>
2037  </ul>
2038 <P>
2039 <DD><DL>
2040 </DL>
2041 </DD>
2042 <DD><DL>
2043 <DT><B>Parameters:</B><DD><CODE>value</CODE> - the value of the new list membership permission
2044 <DT><B>Throws:</B>
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>
2047 </DD>
2048 </DL>
2049 <HR>
2050
2051 <A NAME="setListMembership(int)"><!-- --></A><H3>
2052 setListMembership</H3>
2053 <PRE>
2054 public void <B>setListMembership</B>(int&nbsp;value)
2055                        throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
2056 <DL>
2057 <DD>Sets who can list the users (pts membership) that belong to this group.
2058  Valid values are:
2059  <ul>
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>
2066  </ul>
2067 <P>
2068 <DD><DL>
2069 </DL>
2070 </DD>
2071 <DD><DL>
2072 <DT><B>Parameters:</B><DD><CODE>value</CODE> - the value of the new list membership permission
2073 <DT><B>Throws:</B>
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>
2076 </DD>
2077 </DL>
2078 <HR>
2079
2080 <A NAME="setListAdd(int)"><!-- --></A><H3>
2081 setListAdd</H3>
2082 <PRE>
2083 public void <B>setListAdd</B>(int&nbsp;value)
2084                 throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
2085 <DL>
2086 <DD>Sets who can add members (pts adduser) to this group.
2087  Valid values are:
2088  <ul>
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>
2095  </ul>
2096 <P>
2097 <DD><DL>
2098 </DL>
2099 </DD>
2100 <DD><DL>
2101 <DT><B>Parameters:</B><DD><CODE>value</CODE> - the value of the new list membership permission
2102 <DT><B>Throws:</B>
2103 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - if an invalid value is provided</DL>
2104 </DD>
2105 </DL>
2106 <HR>
2107
2108 <A NAME="setListDelete(int)"><!-- --></A><H3>
2109 setListDelete</H3>
2110 <PRE>
2111 public void <B>setListDelete</B>(int&nbsp;value)
2112                    throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
2113 <DL>
2114 <DD>Sets who can delete members (pts removemember) from this group.
2115  Valid values are:
2116  <ul>
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>
2123  </ul>
2124 <P>
2125 <DD><DL>
2126 </DL>
2127 </DD>
2128 <DD><DL>
2129 <DT><B>Parameters:</B><DD><CODE>value</CODE> - the value of the new list membership permission
2130 <DT><B>Throws:</B>
2131 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></CODE> - if an invalid value is provided</DL>
2132 </DD>
2133 </DL>
2134 <HR>
2135
2136 <A NAME="getInfo()"><!-- --></A><H3>
2137 getInfo</H3>
2138 <PRE>
2139 protected <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> <B>getInfo</B>()</PRE>
2140 <DL>
2141 <DD>Returns a <code>String</code> representation of this <code>Group</code>.
2142  Contains the information fields and members.
2143 <P>
2144 <DD><DL>
2145 </DL>
2146 </DD>
2147 <DD><DL>
2148
2149 <DT><B>Returns:</B><DD>a <code>String</code> representation of the <code>Group</code></DL>
2150 </DD>
2151 </DL>
2152 <HR>
2153
2154 <A NAME="compareTo(org.openafs.jafs.Group)"><!-- --></A><H3>
2155 compareTo</H3>
2156 <PRE>
2157 public int <B>compareTo</B>(<A HREF="../../../org/openafs/jafs/Group.html">Group</A>&nbsp;group)</PRE>
2158 <DL>
2159 <DD>Compares two Group objects respective to their names and does not
2160  factor any other attribute.    Alphabetic case is significant in
2161  comparing names.
2162 <P>
2163 <DD><DL>
2164 </DL>
2165 </DD>
2166 <DD><DL>
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>
2173 </DD>
2174 </DL>
2175 <HR>
2176
2177 <A NAME="compareTo(java.lang.Object)"><!-- --></A><H3>
2178 compareTo</H3>
2179 <PRE>
2180 public int <B>compareTo</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html">Object</A>&nbsp;obj)</PRE>
2181 <DL>
2182 <DD>Comparable interface method.
2183 <P>
2184 <DD><DL>
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>
2186 </DD>
2187 <DD><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>
2189 </DD>
2190 </DL>
2191 <HR>
2192
2193 <A NAME="equals(org.openafs.jafs.Group)"><!-- --></A><H3>
2194 equals</H3>
2195 <PRE>
2196 public boolean <B>equals</B>(<A HREF="../../../org/openafs/jafs/Group.html">Group</A>&nbsp;otherGroup)</PRE>
2197 <DL>
2198 <DD>Tests whether two <code>Group</code> objects are equal, based on their
2199  names.
2200 <P>
2201 <DD><DL>
2202 </DL>
2203 </DD>
2204 <DD><DL>
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>
2207 </DD>
2208 </DL>
2209 <HR>
2210
2211 <A NAME="toString()"><!-- --></A><H3>
2212 toString</H3>
2213 <PRE>
2214 public <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> <B>toString</B>()</PRE>
2215 <DL>
2216 <DD>Returns the name of this <CODE>Group</CODE>
2217 <P>
2218 <DD><DL>
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>
2220 </DD>
2221 <DD><DL>
2222
2223 <DT><B>Returns:</B><DD>the name of this <CODE>Group</CODE></DL>
2224 </DD>
2225 </DL>
2226 <HR>
2227
2228 <A NAME="create(int, java.lang.String, java.lang.String, int)"><!-- --></A><H3>
2229 create</H3>
2230 <PRE>
2231 protected static void <B>create</B>(int&nbsp;cellHandle,
2232                              <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;groupName,
2233                              <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;ownerName,
2234                              int&nbsp;gid)
2235                       throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
2236 <DL>
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.
2239 <P>
2240 <DD><DL>
2241 </DL>
2242 </DD>
2243 <DD><DL>
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)
2246 <DT><B>Throws:</B>
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>
2248 </DD>
2249 </DL>
2250 <HR>
2251
2252 <A NAME="delete(int, java.lang.String)"><!-- --></A><H3>
2253 delete</H3>
2254 <PRE>
2255 protected static void <B>delete</B>(int&nbsp;cellHandle,
2256                              <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;groupName)
2257                       throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
2258 <DL>
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.
2262 <P>
2263 <DD><DL>
2264 </DL>
2265 </DD>
2266 <DD><DL>
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
2268 <DT><B>Throws:</B>
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>
2270 </DD>
2271 </DL>
2272 <HR>
2273
2274 <A NAME="getGroupInfo(int, java.lang.String, org.openafs.jafs.Group)"><!-- --></A><H3>
2275 getGroupInfo</H3>
2276 <PRE>
2277 protected static void <B>getGroupInfo</B>(int&nbsp;cellHandle,
2278                                    <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;name,
2279                                    <A HREF="../../../org/openafs/jafs/Group.html">Group</A>&nbsp;group)
2280                             throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
2281 <DL>
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.
2284 <P>
2285 <DD><DL>
2286 </DL>
2287 </DD>
2288 <DD><DL>
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
2290                   information
2291 <DT><B>Throws:</B>
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>
2294 </DD>
2295 </DL>
2296 <HR>
2297
2298 <A NAME="setGroupInfo(int, java.lang.String, org.openafs.jafs.Group)"><!-- --></A><H3>
2299 setGroupInfo</H3>
2300 <PRE>
2301 protected static void <B>setGroupInfo</B>(int&nbsp;cellHandle,
2302                                    <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;name,
2303                                    <A HREF="../../../org/openafs/jafs/Group.html">Group</A>&nbsp;theGroup)
2304                             throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
2305 <DL>
2306 <DD>Sets the information values of this AFS group to be the parameter values.
2307 <P>
2308 <DD><DL>
2309 </DL>
2310 </DD>
2311 <DD><DL>
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
2313 <DT><B>Throws:</B>
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>
2315 </DD>
2316 </DL>
2317 <HR>
2318
2319 <A NAME="getGroupMembersBegin(int, java.lang.String)"><!-- --></A><H3>
2320 getGroupMembersBegin</H3>
2321 <PRE>
2322 protected static int <B>getGroupMembersBegin</B>(int&nbsp;cellHandle,
2323                                           <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;name)
2324                                    throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
2325 <DL>
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>.
2329 <P>
2330 <DD><DL>
2331 </DL>
2332 </DD>
2333 <DD><DL>
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
2336 <DT><B>Throws:</B>
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>
2338 </DD>
2339 </DL>
2340 <HR>
2341
2342 <A NAME="getGroupMembersNextString(int)"><!-- --></A><H3>
2343 getGroupMembersNextString</H3>
2344 <PRE>
2345 protected static <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> <B>getGroupMembersNextString</B>(int&nbsp;iterationId)
2346                                            throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
2347 <DL>
2348 <DD>Returns the next members that belongs to the group.  Returns
2349  <code>null</code> if there are no more members.
2350 <P>
2351 <DD><DL>
2352 </DL>
2353 </DD>
2354 <DD><DL>
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
2357 <DT><B>Throws:</B>
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>
2359 </DD>
2360 </DL>
2361 <HR>
2362
2363 <A NAME="getGroupMembersNext(int, int, org.openafs.jafs.User)"><!-- --></A><H3>
2364 getGroupMembersNext</H3>
2365 <PRE>
2366 protected static int <B>getGroupMembersNext</B>(int&nbsp;cellHandle,
2367                                          int&nbsp;iterationId,
2368                                          <A HREF="../../../org/openafs/jafs/User.html">User</A>&nbsp;theUser)
2369                                   throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
2370 <DL>
2371 <DD>Fills the next user object belonging to that group.  Returns 0 if there
2372  are no more users, != 0 otherwise.
2373 <P>
2374 <DD><DL>
2375 </DL>
2376 </DD>
2377 <DD><DL>
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
2379                   next user
2380 <DT><B>Returns:</B><DD>0 if there are no more users, != 0 otherwise
2381 <DT><B>Throws:</B>
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>
2384 </DD>
2385 </DL>
2386 <HR>
2387
2388 <A NAME="getGroupMembersDone(int)"><!-- --></A><H3>
2389 getGroupMembersDone</H3>
2390 <PRE>
2391 protected static void <B>getGroupMembersDone</B>(int&nbsp;iterationId)
2392                                    throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
2393 <DL>
2394 <DD>Signals that the iteration is complete and will not be accessed anymore.
2395 <P>
2396 <DD><DL>
2397 </DL>
2398 </DD>
2399 <DD><DL>
2400 <DT><B>Parameters:</B><DD><CODE>iterationId</CODE> - the iteration ID of this iteration
2401 <DT><B>Throws:</B>
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>
2403 </DD>
2404 </DL>
2405 <HR>
2406
2407 <A NAME="addMember(int, java.lang.String, java.lang.String)"><!-- --></A><H3>
2408 addMember</H3>
2409 <PRE>
2410 protected static void <B>addMember</B>(int&nbsp;cellHandle,
2411                                 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;groupName,
2412                                 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;userName)
2413                          throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
2414 <DL>
2415 <DD>Adds a user to the specified group.
2416 <P>
2417 <DD><DL>
2418 </DL>
2419 </DD>
2420 <DD><DL>
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
2422 <DT><B>Throws:</B>
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>
2424 </DD>
2425 </DL>
2426 <HR>
2427
2428 <A NAME="removeMember(int, java.lang.String, java.lang.String)"><!-- --></A><H3>
2429 removeMember</H3>
2430 <PRE>
2431 protected static void <B>removeMember</B>(int&nbsp;cellHandle,
2432                                    <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;groupName,
2433                                    <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;userName)
2434                             throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
2435 <DL>
2436 <DD>Removes a user from the specified group.
2437 <P>
2438 <DD><DL>
2439 </DL>
2440 </DD>
2441 <DD><DL>
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
2444 <DT><B>Throws:</B>
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>
2446 </DD>
2447 </DL>
2448 <HR>
2449
2450 <A NAME="changeOwner(int, java.lang.String, java.lang.String)"><!-- --></A><H3>
2451 changeOwner</H3>
2452 <PRE>
2453 protected static void <B>changeOwner</B>(int&nbsp;cellHandle,
2454                                   <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;groupName,
2455                                   <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;ownerName)
2456                            throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
2457 <DL>
2458 <DD>Change the owner of the specified group.
2459 <P>
2460 <DD><DL>
2461 </DL>
2462 </DD>
2463 <DD><DL>
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
2466 <DT><B>Throws:</B>
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>
2468 </DD>
2469 </DL>
2470 <HR>
2471
2472 <A NAME="rename(int, java.lang.String, java.lang.String)"><!-- --></A><H3>
2473 rename</H3>
2474 <PRE>
2475 protected static void <B>rename</B>(int&nbsp;cellHandle,
2476                              <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;oldGroupName,
2477                              <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;newGroupName)
2478                       throws <A HREF="../../../org/openafs/jafs/AFSException.html">AFSException</A></PRE>
2479 <DL>
2480 <DD>Change the name of the specified group.
2481 <P>
2482 <DD><DL>
2483 </DL>
2484 </DD>
2485 <DD><DL>
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
2487 <DT><B>Throws:</B>
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>
2489 </DD>
2490 </DL>
2491 <HR>
2492
2493 <A NAME="reclaimGroupMemory()"><!-- --></A><H3>
2494 reclaimGroupMemory</H3>
2495 <PRE>
2496 protected static void <B>reclaimGroupMemory</B>()</PRE>
2497 <DL>
2498 <DD>Reclaims all memory being saved by the group portion of the native
2499  library.
2500  This method should be called when no more <code>Groups</code> are expected
2501  to be used.
2502 <P>
2503 <DD><DL>
2504 </DL>
2505 </DD>
2506 <DD><DL>
2507 </DL>
2508 </DD>
2509 </DL>
2510 <!-- ========= END OF CLASS DATA ========= -->
2511 <HR>
2512
2513 <!-- ========== START OF NAVBAR ========== -->
2514 <A NAME="navbar_bottom"><!-- --></A>
2515 <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
2516 <TR>
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>&nbsp;</TD>
2522   <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
2523   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/Group.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
2524   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
2525   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
2526   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
2527   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
2528   </TR>
2529 </TABLE>
2530 </TD>
2531 <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
2532 <B>JAFS API v2</B></EM>
2533 </TD>
2534 </TR>
2535
2536 <TR>
2537 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
2538 &nbsp;<A HREF="../../../org/openafs/jafs/FileOutputStream.html"><B>PREV CLASS</B></A>&nbsp;
2539 &nbsp;<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>  &nbsp;
2542 &nbsp;<A HREF="Group.html" TARGET="_top"><B>NO FRAMES</B></A>  &nbsp;
2543 &nbsp;
2544 <SCRIPT>
2545   <!--
2546   if(window==top) {
2547     document.writeln('<A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>');
2548   }
2549   //-->
2550 </SCRIPT>
2551 <NOSCRIPT>
2552 <A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>
2553 </NOSCRIPT>
2554 </FONT></TD>
2555 </TR>
2556 <TR>
2557 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
2558   SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
2559 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
2560 DETAIL:&nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
2561 </TR>
2562 </TABLE>
2563 <!-- =========== END OF NAVBAR =========== -->
2564
2565 <HR>
2566
2567 </BODY>
2568 </HTML>