1 <!doctype refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
3 <!-- Fill in your name for FIRSTNAME and SURNAME. -->
4 <!ENTITY dhfirstname "<firstname>Sam</firstname>">
5 <!ENTITY dhsurname "<surname>Hartman</surname>">
6 <!-- Please adjust the date whenever revising the manpage. -->
7 <!ENTITY dhdate "<date>November 23, 2000</date>">
8 <!-- SECTION should be 1-8, maybe w/ subsection other parameters are
9 allowed: see man(7), man(1). -->
10 <!ENTITY dhsection "<manvolnum>8</manvolnum>">
11 <!ENTITY dhemail "<email>hartmans@mit.edu</email>">
12 <!ENTITY dhusername "Sam Hartman">
13 <!ENTITY dhucpackage "<refentrytitle>OPENAFS-PTUTIL</refentrytitle>">
14 <!ENTITY dhpackage "openafs-ptutil">
16 <!ENTITY debian "<productname>Debian GNU/Linux</productname>">
17 <!ENTITY gnu "<acronym>GNU</acronym>">
31 <holder>&dhusername;</holder>
37 <refentrytitle>pt_util</refentrytitle>
41 <refname>pt_util</refname>
43 <refpurpose>Utility to load/dump AFS protection database</refpurpose>
47 <command>pt_util</command>
48 <arg><option>-w</option></arg>
49 <arg><option>-u</option></arg>
50 <arg><option>-g</option></arg>
51 <arg><option>-m</option></arg>
52 <arg><option>-n</option></arg>
53 <arg><option>-s</option></arg>
54 <arg><option>-x</option></arg>
55 <arg><option>-d <replaceable>datafile</replaceable></option></arg>
56 <arg><option>-p <replaceable>prdb</replaceable></option></arg>
61 <title>DESCRIPTION</title>
63 <para>This manual page documents <command>pt_util</command>, a
64 utility for dumping, loading and creating AFS protection
65 databases. The protection database is normally made available
66 by the <command>ptserver</command> daemon running on the AFS
67 database servers. However, <command>pt_util</command>
68 provides a mechanism for manipulating the database when
69 <command>ptserver</command> is unavailable. This is useful to
70 create an initial database, to effect large batch changes or
71 when the database has a damaged
72 <literal>system:administrators</literal> group.</para>
74 <para>By default, <command>pt_util</command> opens the
75 database and prints the version. Options allow extraction of
76 information from the database or writing new entries into the
82 <title>OPTIONS</title>
86 <term><option>-h</option>
89 <para>Show summary of options.</para>
93 <term><option>-w</option></term>
95 <para>Update PRDB with contents of data file or standard input if the <option>-d</option> is not used</para>
99 <term><option>-u</option></term>
101 <para>List users in the database.</para>
105 <term><option>-g</option></term>
107 <para>List groups in the database.</para>
111 <term><option>-m</option></term>
113 <para>List group members.</para>
117 <term><option>-n</option></term>
119 <para>Follow name hash chains instead of ID hashes.</para>
123 <term><option>-s</option></term>
125 <para>List only <literal>system:</literal> groups. Used by MIT's Moira.</para>
129 <term><option>-d <replaceable>datafile</replaceable></option></term>
131 <para>Read from or write printable representation of the
132 database from <replaceable>datafile</replaceable>.</para>
136 <term><option>-p <replaceable>prdb</replaceable></option></term>
138 <para>Manipulate the protection database
139 <replaceable>prdb</replaceable>. The running protection
141 <filename>/var/lib/openafs/db/prdb.DB0</filename></para>
147 <title>SEE ALSO</title>
149 <para>ptserver(8)</para>
154 <title>AUTHOR</title>
156 <para>This manual page was written by &dhusername; &dhemail; for
157 the &debian; system (but may be used by others).</para>
159 <!-- <para>Permission is granted to copy, distribute and/or modify
160 this document under the terms of the <acronym>GNU</acronym> Free
161 Documentation License, Version 1.1 or any later version
162 published by the Free Software Foundation; with no Invariant
163 Sections, no Front-Cover Texts and no Back-Cover Texts. A copy
164 of the license can be found under
165 <filename>/usr/share/common-licenses/FDL</filename>.</para> -->
170 <!-- Keep this comment at the end of the file
175 sgml-minimize-attributes:nil
176 sgml-always-quote-attributes:t
179 sgml-parent-document:nil
180 sgml-default-dtd-file:nil
181 sgml-exposed-tags:nil
182 sgml-local-catalogs:nil
183 sgml-local-ecat-files:nil