11<!--
2- $Header: /cvsroot/pgsql/doc/src/sgml/ref/Attic/pg_passwd.sgml,v 1.6 2001/02/20 01: 16:49 tgl Exp $
2+ $Header: /cvsroot/pgsql/doc/src/sgml/ref/Attic/pg_passwd.sgml,v 1.7 2001/06/18 16:11:30 momjian Exp $
33Postgres documentation
44-->
55
@@ -16,7 +16,7 @@ Postgres documentation
1616
1717 <refnamediv>
1818 <refname>pg_passwd</refname>
19- <refpurpose>Manipulate atext password file</refpurpose>
19+ <refpurpose>Manipulate asecondary password file</refpurpose>
2020 </refnamediv>
2121
2222 <refsynopsisdiv>
@@ -29,30 +29,28 @@ Postgres documentation
2929 <refsect1 id="app-pg-passwd-description">
3030 <title>Description</title>
3131 <para>
32- <application>pg_passwd</application> is a tool to manipulate a flat
33- text password file for the purpose of using that file to control
34- client authentication of the
35- <productname>PostgreSQL</productname> server. More information
32+ <application>pg_passwd</application> is a tool for manipulating flat
33+ text password files. These files can control client authentication of
34+ the <productname>PostgreSQL</productname> server. More information
3635 about setting up this authentication mechanism can be found in the
3736 <citetitle>Administrator's Guide</citetitle>.
3837 </para>
3938
4039 <para>
41- Theform of a text password file is one entry per line; the fields
42- of each entry are separated by colons. The first field is the user
43- name, the second field is the encrypted password. Other fields are
40+ Theformat of a text password file is one entry per line; the fields
41+ of each entry are separated by colons. The first field is the user
42+ name, the second field is the encrypted password. Other fields are
4443 ignored (to allow password files to be shared between applications
45- that use similar formats). The functionality of the
46- <application>pg_passwd</application> utility is to enable a user to
47- interactively add entries to such a file, to alter passwords of
48- existing entries, and to take care of encrypting the passwords.
44+ that use similar formats). <application>pg_passwd</application>
45+ enables users to interactively add entries to such a file, to alter
46+ passwords of existing entries, and to encrypt such passwords.
4947 </para>
5048
5149 <para>
52- Supply the name of the password file as argument to the <application>pg_passwd</application>
53- command. To beof use for client authentication the file needs to
54- be located in the server's data directory, and the base name of
55- the file needs to be specified in the
50+ Supply the name of the password file as argument to the
51+ <application>pg_passwd</application> command. To beused by
52+ PostgreSQL, the file needs to be located in the server's data
53+ directory, and the base name of the file needs to be specified in the
5654 <filename>pg_hba.conf</filename> access control file.
5755
5856<screen>
@@ -90,11 +88,11 @@ host mydb 133.65.96.250 255.255.255.255 password passwords
9088
9189 <note>
9290 <para>
93- It is also useful to have entries in a password file withan empty
94- passwordfield. (This is different from an empty password.)
95- These entriescannot be managed by
96- <application>pg_passwd</application>, but it is always possible to
97- edit password files manually.
91+ It is also useful to have entries in a password file with empty
92+ passwordfields. (This is different from an empty password.) Such
93+ entriesallow you to restrict users who can access the system. These
94+ entries cannot be managed by <application>pg_passwd</application>,
95+ but you can edit password files manually.
9896 </para>
9997 </note>
10098 </refsect1>