<!--
$Header: /usr/prj/pg/cvsroot/doc/doc/src/sgml/ref/pg_passwd.sgml,v 1.4 2001/08/14 08:51:39 k-kondo Exp $
Postgres documentation
-->

<refentry id="APP-PG-PASSWD">
 <docinfo>
  <date>2000-11-18</date>
 </docinfo>

 <refmeta>
  <refentrytitle id="APP-PG-PASSWD-TITLE"><application>pg_passwd</application></refentrytitle>
  <manvolnum>1</manvolnum>
  <refmiscinfo><!--Application-->アプリケーション</refmiscinfo>
 </refmeta>

 <refnamediv>
  <refname>pg_passwd</refname>
  <refpurpose><!--Manipulate a text password file-->
              テキストパスワードファイルを操作します。<indexterm><primary>pg_passwd</primary></indexterm><indexterm><primary>PostgreSQL</primary><secondary>pg_passwd</secondary></indexterm><indexterm><primary sortas="ぱすわーど">パスワード</primary></indexterm><indexterm><primary>PostgreSQL</primary><secondary sortas="ぱすわーど">パスワード</secondary></indexterm>
  </refpurpose>
 </refnamediv>

 <refsynopsisdiv>
  <cmdsynopsis>
   <command>pg_passwd</command>
   <arg choice="plain"><replaceable>filename</replaceable></arg>
  </cmdsynopsis>
 </refsynopsisdiv>

 <refsect1 id="app-pg-passwd-description">
  <title><!--Description-->説明</title>
  <para>
   <!--<application>pg_passwd</application> is a tool to manipulate a flat
   text password file for the purpose of using that file to control
   client authentication of the
   <productname>PostgreSQL</productname> server.  More information
   about setting up this authentication mechanism can be found in the
   <citetitle>Administrator's Guide</citetitle>.-->

   <application>pg_passwd</application>は、パスワードファイル（通常のテキスト）を操作するツールで、パスワードファイルを<productname>PostgreSQL</productname>サーバーでのクライアント認証を制御するために使用します。認証方法に関する詳細は<citetitle>&admin-guide;</citetitle>を参照してください。
  </para>

  <para>
   <!--The form of a text password file is one entry per line; the fields
   of each entry are separated by colons.  The first field is the user
   name, the second field is the encrypted password.  Other fields are
   ignored (to allow password files to be shared between applications
   that use similar formats).  The functionality of the
   <application>pg_passwd</application> utility is to enable a user to
   interactively add entries to such a file, to alter passwords of
   existing entries, and to take care of encrypting the passwords.-->

   テキストパスワードファイルは、各行に1つの項目（各項目のフィールドはコロンによって区別されます）を記述する形式となっています。1つ目のフィールドはユーザー名、2つ目のフィールドは暗号化されたパスワードです。その他のフィールドは無視されます（似たようなフォーマットを使用するアプリケーション間でパスワードファイルを共有するためです）。<application>pg_passwd</application>ユーティリティの機能には、ユーザーが対話的にそれらのファイルにパスワードを追加、存在するパスワードを変更、それとパスワードの暗号化を操作という目的があります。
   
  </para>

  <para>
   <!--Supply the name of the password file as argument to the <application>pg_passwd</application>
   command.  To be of use for client authentication the file needs to
   be located in the server's data directory, and the base name of
   the file needs to be specified in the
   <filename>pg_hba.conf</filename> access control file.-->

   <application>pg_passwd</application>コマンドの引数としてパスワードファイル名を指定します。クライアント認証で使用する際には、ファイルはサーバーのデータディレクトリにある必要があり、ファイルのベース名は<filename>pg_hba.conf</filename>接続管理ファイルに指定されている必要があります。
</para>

<screen>
<prompt>$</prompt> <userinput>pg_passwd /usr/local/pgsql/data/passwords</userinput>
<computeroutput>File "/usr/local/pgsql/data/passwords" does not exist.  Create? (y/n):</computeroutput> <userinput>y</userinput>
<prompt>Username:</prompt> <userinput>guest</userinput>
<prompt>Password:</prompt>
<prompt>Re-enter password:</prompt>
</screen>

<para>
   <!--where the <literal>Password:</literal> and <literal>Re-enter
   password:</literal> prompts require the same password input which
   is not displayed on the terminal.  Note that the password is limited
   to eight useful characters by restrictions of the standard crypt(3)
   library routine.-->

   <literal>Password:</literal>と<literal>Re-enter password:</literal>プロンプトでは同じパスワードを入力する必要があります。入力する文字はターミナルには表示されません。標準のcrypt(3)ライブラリルーチンで、パスワードは有効な8文字に制限されています。
  </para>

  <para>
   <!--The original password file is renamed to
   <filename>passwords.bk</filename>.-->
   オリジナルパスワードファイル名は<filename>passwords.bk</filename>に変更されます。
  </para>

  <para>
   <!--To make use of this password file, put a line like the following in
   <filename>pg_hba.conf</filename>:-->

   このパスワードファイルを使用する際には、下記のような1行を<filename>pg_hba.conf</filename>に記述してください。
</para>

<programlisting>
host  mydb     133.65.96.250   255.255.255.255 password passwords
</programlisting>

<para>
   <!--which would allow access to database mydb from host 133.65.96.250 using
   the passwords listed in the <filename>passwords</filename> file (and
   only to the users listed in that file).-->

   この1行によって、ホスト133.65.96.250からの、<filename>passwords</filename>ファイルに書かれているパスワード（また、そのファイルに書かれているユーザー）を使用したmydbというデータベースへの接続を許可します。
  </para>

  <note>
   <para>
    <!--It is also useful to have entries in a password file with an empty
    password field.  (This is different from an empty password.)
    These entries cannot be managed by
    <application>pg_passwd</application>, but it is always possible to
    edit password files manually.-->

    パスワードファイルのパスワードフィールドを空にしておくのも便利な使用方法です（これは空のパスワードとは異なります）。それらは<application>pg_passwd</application>で管理できませんが、パスワードファイルを手動で編集することはいつでも可能です。
   </para>
  </note>
 </refsect1>

 <refsect1 id="app-pg-passwd-seealso">
  <title><!--See also-->参照</title>
  <para>
   <citetitle>&admin-guide;</citetitle>
  </para>
 </refsect1>
</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:nil
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../reference.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:"/usr/lib/sgml/catalog"
sgml-local-ecat-files:nil
End:
-->
