--- /dev/null
+<?xml version="1.0" encoding="UTF-8"?>
+<refentry id="pts_listentries1">
+ <refmeta>
+ <refentrytitle>pts listentries</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </refmeta>
+ <refnamediv>
+ <refname>pts listentries</refname>
+ <refpurpose>Displays all users or groups in the Protection Database</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Synopsis</title>
+ <para><emphasis role="bold">pts listentries</emphasis> [<emphasis role="bold">-users</emphasis>] [<emphasis role="bold">-groups</emphasis>] [<emphasis role="bold">-cell</emphasis> <<emphasis>cell name</emphasis>>]
+ [<emphasis role="bold">-noauth</emphasis>] [<emphasis role="bold">-force</emphasis>] [<emphasis role="bold">-help</emphasis>]</para>
+
+ <para><emphasis role="bold">pts liste</emphasis> [<emphasis role="bold">-u</emphasis>] [<emphasis role="bold">-g</emphasis>] [<emphasis role="bold">-c</emphasis> <<emphasis>cell name</emphasis>>] [<emphasis role="bold">-n</emphasis>] [<emphasis role="bold">-f</emphasis>] [<emphasis role="bold">-h</emphasis>]</para>
+
+ </refsect1>
+ <refsect1>
+ <title>Description</title>
+ <para>The <emphasis role="bold">pts listentries</emphasis> command displays the name and AFS ID of all
+ Protection Database entries of the indicated type. It also displays the
+ AFS ID of each entry's owner and creator.</para>
+
+ <para>To display all user and machine entries, either include the <emphasis role="bold">-users</emphasis> flag
+ or omit both it and the <emphasis role="bold">-groups</emphasis> flag. To display all group entries,
+ include the <emphasis role="bold">-groups</emphasis> flag. To display all entries, provide both flags.</para>
+
+ </refsect1>
+ <refsect1>
+ <title>Options</title>
+ <variablelist>
+ <varlistentry>
+ <term><emphasis role="bold">-users</emphasis></term>
+ <listitem>
+ <para>Displays user and machine entries.</para>
+
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><emphasis role="bold">-groups</emphasis></term>
+ <listitem>
+ <para>Displays group entries.</para>
+
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><emphasis role="bold">-cell</emphasis> <<emphasis>cell name</emphasis>></term>
+ <listitem>
+ <para>Names the cell in which to run the command. For more details, see
+ <link linkend="pts1">pts(1)</link>.</para>
+
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><emphasis role="bold">-noauth</emphasis></term>
+ <listitem>
+ <para>Assigns the unprivileged identity anonymous to the issuer. For more
+ details, see <link linkend="pts1">pts(1)</link>.</para>
+
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><emphasis role="bold">-force</emphasis></term>
+ <listitem>
+ <para>Enables the command to continue executing as far as possible when errors
+ or other problems occur, rather than halting execution at the first error.</para>
+
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><emphasis role="bold">-help</emphasis></term>
+ <listitem>
+ <para>Prints the online help for this command. All other valid options are
+ ignored.</para>
+
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refsect1>
+ <refsect1>
+ <title>Output</title>
+ <para>The output includes a line for each entry, with information in four
+ columns that have the following headers:</para>
+
+ <variablelist>
+ <varlistentry>
+ <term>Name</term>
+ <listitem>
+ <para>The entry's name.</para>
+
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>ID</term>
+ <listitem>
+ <para>The entry's AFS ID (AFS UID for a user or machine, negative AFS GID for a
+ group).</para>
+
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Owner</term>
+ <listitem>
+ <para>The AFS ID of the user or group that owns the entry.</para>
+
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Creator</term>
+ <listitem>
+ <para>The AFS ID of the user who created the entry (the system:administrators
+ group is listed as the creator of the entry for <computeroutput>anonymous</computeroutput> and the
+ system groups, but it is not otherwise possible for a group to create
+ groups).</para>
+
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <para>In general, the entries appear in the order in which they were created.</para>
+
+ </refsect1>
+ <refsect1>
+ <title>Examples</title>
+ <para>The following example displays both user and group entries.</para>
+
+<programlisting>
+ % pts listentries -users -groups
+ Name ID Owner Creator
+ system:administrators -204 -204 -204
+ system:anyuser -101 -204 -204
+ system:authuser -102 -204 -204
+ anonymous 32766 -204 -204
+ admin 1 -204 32766
+ pat 100 -204 1
+ smith 101 -204 1
+ pat:friends -206 100 100
+ staff -207 -204 1
+
+</programlisting>
+ </refsect1>
+ <refsect1>
+ <title>Privilege Required</title>
+ <para>The issuer must belong to the system:administrators group.</para>
+
+ </refsect1>
+ <refsect1>
+ <title>See Also</title>
+ <para><link linkend="pts1">pts(1)</link>,
+ <link linkend="pts_creategroup1">pts_creategroup(1)</link>,
+ <link linkend="pts_createuser1">pts_createuser(1)</link>,
+ <link linkend="pts_examine1">pts_examine(1)</link></para>
+
+ </refsect1>
+ <refsect1>
+ <title>Copyright</title>
+ <para>IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.</para>
+
+ <para>This documentation is covered by the IBM Public License Version 1.0. It was
+ converted from HTML to POD by software written by Chas Williams and Russ
+ Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.</para>
+
+ </refsect1>
+ </refentry>