doc/html/AdminReference/auarf219.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="auarf218.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="auarf220.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_LISTENTRIES" HREF="auarf002.htm#ToC_233">pts listentries</A></H2>
  19 <A NAME="IDX5353"></A>
  20 <A NAME="IDX5354"></A>
  21 <A NAME="IDX5355"></A>
  22 <A NAME="IDX5356"></A>
  23 <A NAME="IDX5357"></A>
  24 <A NAME="IDX5358"></A>
  25 <P><STRONG>Purpose</STRONG>
  26 <P>Displays all user or group entries in the Protection Database
  27 <P><STRONG>Synopsis</STRONG>
  28 <PRE><B>pts listentries</B> [<B>-users</B>]  [<B>-groups</B>]  [<B>-cell</B> &lt;<VAR>cell&nbsp;name</VAR>>]
  29                 [<B>-noauth</B>]  [<B>-force</B>]  [<B>-help</B>]
  30
  31 <B>pts liste</B> [<B>-u</B>]  [<B>-g</B>]  [<B>-c</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-n</B>]  [<B>-f</B>]  [<B>-h</B>]
  32 </PRE>
  33 <P><STRONG>Description</STRONG>
  34 <P>The <B>pts listentries</B> command displays the name and AFS ID of all
  35 Protection Database entries of the indicated type. It also displays the
  36 AFS ID of each entry's owner and creator.
  37 <P>To display all user and machine entries, either include the
  38 <B>-users</B> flag or omit both it and the <B>-groups</B> flag.
  39 To display all group entries, include the <B>-groups</B> flag. To
  40 display all entries, provide both flags.
  41 <P><STRONG>Options</STRONG>
  42 <DL>
  43 <P><DT><B>-users
  44 </B><DD>Displays user and machine entries.
  45 <P><DT><B>-groups
  46 </B><DD>Displays group entries.
  47 <P><DT><B>-cell
  48 </B><DD>Names the cell in which to run the command. For more details, see
  49 the introductory <B>pts</B> reference page.
  50 <P><DT><B>-noauth
  51 </B><DD>Assigns the unprivileged identity <B>anonymous</B> to the
  52 issuer. For more details, see the introductory <B>pts</B> reference
  53 page.
  54 <P><DT><B>-force
  55 </B><DD>Enables the command to continue executing as far as possible when errors
  56 or other problems occur, rather than halting execution at the first
  57 error.
  58 <P><DT><B>-help
  59 </B><DD>Prints the online help for this command. All other valid options
  60 are ignored.
  61 </DL>
  62 <P><STRONG>Output</STRONG>
  63 <P>The output includes a line for each entry, with information in four columns
  64 that have the following headers:
  65 <DL>
  66 <P><DT><B><TT>Name</TT>
  67 </B><DD>The entry's name
  68 <P><DT><B><TT>ID</TT>
  69 </B><DD>The entry's AFS ID (AFS UID for a user or machine, negative AFS GID
  70 for a group)
  71 <P><DT><B><TT>Owner</TT>
  72 </B><DD>The AFS ID of the user or group that owns the entry
  73 <P><DT><B><TT>Creator</TT>
  74 </B><DD>The AFS ID of the user who created the entry (the
  75 <B>system:administrators</B> group is listed as the creator of the
  76 entry for <B>anonymous</B> and the system groups, but it is not otherwise
  77 possible for a group to create groups)
  78 </DL>
  79 <P>In general, the entries appear in the order in which they were
  80 created.
  81 <P><STRONG>Examples</STRONG>
  82 <P>The following example displays both user and group entries.
  83 <PRE>   % <B>pts listentries -users -groups</B>
  84    Name                          ID  Owner Creator
  85    system:administrators       -204   -204    -204
  86    system:anyuser              -101   -204    -204
  87    system:authuser             -102   -204    -204
  88    anonymous                  32766   -204    -204
  89    admin                          1   -204   32766
  90    pat                          100   -204       1
  91    smith                        101   -204       1
  92    pat:friends                 -206    100     100
  93    staff                       -207   -204       1
  94
  95 </PRE>
  96 <P><STRONG>Privilege Required</STRONG>
  97 <P>The issuer must belong to the <B>system:administrators</B>
  98 group.
  99 <P><STRONG>Related Information</STRONG>
 100 <P><A HREF="auarf210.htm#HDRPTS_INTRO">pts</A>
 101 <P><A HREF="auarf214.htm#HDRPTS_CREATEGROUP">pts creategroup</A>
 102 <P><A HREF="auarf215.htm#HDRPTS_CREATEUSER">pts createuser</A>
 103 <P><A HREF="auarf217.htm#HDRPTS_EXAMINE">pts examine</A>
 104 <P>
 105 <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="auarf218.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="auarf220.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>
 106 <!-- Begin Footer Records  ========================================== -->
 107 <P><HR><B>
 108 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 109 </B>
 110 <!-- End Footer Records  ============================================ -->
 111 <A NAME="Bot_Of_Page"></A>
 112 </BODY></HTML>