doc/html/AdminReference/auarf220.htm

   1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
   2 <HTML><HEAD>
   3 <TITLE>Administration Reference</TITLE>
   4 <!-- Begin Header Records  ========================================== -->
   5 <!-- /tmp/idwt3672/auarf000.scr converted by idb2h R4.2 (359) ID      -->
   6 <!-- Workbench Version (AIX) on 3 Oct 2000 at 16:18:30                -->
   7 <META HTTP-EQUIV="updated" CONTENT="Tue, 03 Oct 2000 16:18:29">
   8 <META HTTP-EQUIV="review" CONTENT="Wed, 03 Oct 2001 16:18:29">
   9 <META HTTP-EQUIV="expires" CONTENT="Thu, 03 Oct 2002 16:18:29">
  10 </HEAD><BODY>
  11 <!-- (C) IBM Corporation 2000. All Rights Reserved    -->
  12 <BODY bgcolor="ffffff">
  13 <!-- End Header Records  ============================================ -->
  14 <A NAME="Top_Of_Page"></A>
  15 <H1>Administration Reference</H1>
  16 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf219.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Bot_Of_Page"><IMG SRC="../bot.gif" BORDER="0" ALT="[Bottom of Topic]"></A> <A HREF="auarf221.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
  17 <P>
  18 <H2><A NAME="HDRPTS_LISTMAX" HREF="auarf002.htm#ToC_234">pts listmax</A></H2>
  19 <A NAME="IDX5359"></A>
  20 <A NAME="IDX5360"></A>
  21 <A NAME="IDX5361"></A>
  22 <A NAME="IDX5362"></A>
  23 <A NAME="IDX5363"></A>
  24 <A NAME="IDX5364"></A>
  25 <A NAME="IDX5365"></A>
  26 <A NAME="IDX5366"></A>
  27 <P><STRONG>Purpose</STRONG>
  28 <P>Displays the <TT>max user id</TT> and <TT>max group id</TT> counters
  29 <P><STRONG>Synopsis</STRONG>
  30 <PRE><B>pts listmax</B> [<B>-cell</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-noauth</B>]  [<B>-force</B>]  [<B>-help</B>]
  31
  32 <B>pts listm</B>  [<B>-c</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-n</B>]  [<B>-f</B>]  [<B>-h</B>]
  33 </PRE>
  34 <P><STRONG>Description</STRONG>
  35 <P>The <B>pts listmax</B> command displays the values of the <TT>max user
  36 id</TT> and <TT>max group id</TT> counters, which the Protection Server
  37 uses to track the AFS user IDs (AFS UIDs) it allocates to new users or
  38 machines, and the AFS group IDs (AFS GIDs) it allocates to new groups,
  39 respectively. When an administrator next issues the <B>pts
  40 createuser</B> command and does not include the <B>-id</B> argument, the
  41 new user or machine receives an AFS UID one greater than the <TT>max user
  42 id</TT> counter, and when a user issues the <B>pts creategroup</B>
  43 command and does not include the <B>-id</B> argument, the new group
  44 receives an AFS UID one less (more negative) than the <TT>max group id</TT>
  45 counter.
  46 <P>To reset one or both counters, members of the
  47 <B>system:administrators</B> group can issue the <B>pts
  48 setmax</B> command.
  49 <P><STRONG>Options</STRONG>
  50 <DL>
  51 <P><DT><B>-cell
  52 </B><DD>Names the cell in which to run the command. For more details, see
  53 the introductory <B>pts</B> reference page.
  54 <P><DT><B>-noauth
  55 </B><DD>Assigns the unprivileged identity <B>anonymous</B> to the
  56 issuer. For more details, see the introductory <B>pts</B> reference
  57 page.
  58 <P><DT><B>-force
  59 </B><DD>Enables the command to continue executing as far as possible when errors
  60 or other problems occur, rather than halting execution at the first
  61 error.
  62 <P><DT><B>-help
  63 </B><DD>Prints the online help for this command. All other valid options
  64 are ignored.
  65 </DL>
  66 <P><STRONG>Output</STRONG>
  67 <P>The command displays the counters in the following format:
  68 <PRE>   Max user id is <VAR>user_counter</VAR> and max group id is <VAR>group_counter</VAR>.
  69
  70 </PRE>
  71 <P><STRONG>Examples</STRONG>
  72 <P>The following example displays the output of this command:
  73 <PRE>   %<B> pts listmax</B>
  74    Max user name is 1271 and max group id is -382.
  75
  76 </PRE>
  77 <P><STRONG>Privilege Required</STRONG>
  78 <P>None
  79 <P><STRONG>Related Information</STRONG>
  80 <P><A HREF="auarf210.htm#HDRPTS_INTRO">pts</A>
  81 <P><A HREF="auarf226.htm#HDRPTS_SETMAX">pts setmax</A>
  82 <P>
  83 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf219.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Top_Of_Page"><IMG SRC="../top.gif" BORDER="0" ALT="[Top of Topic]"></A> <A HREF="auarf221.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
  84 <!-- Begin Footer Records  ========================================== -->
  85 <P><HR><B>
  86 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
  87 </B>
  88 <!-- End Footer Records  ============================================ -->
  89 <A NAME="Bot_Of_Page"></A>
  90 </BODY></HTML>