<!--
$Header: /usr/prj/pg/cvsroot/doc/doc/src/sgml/ref/createlang.sgml,v 1.6 2001/09/14 09:43:32 t-ishii Exp $
Postgres documentation
-->

<refentry id="APP-CREATELANG">
 <docinfo>
  <date>2000-11-11</date>
 </docinfo>

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

 <refnamediv>
  <refname id="createlang">createlang</refname>
  <refpurpose>
   <!-- Add a new programming language to a 
  <productname>Postgres</productname> database
   -->

   <productname>Postgres</productname>データベースへに新しいプログラミング言語を追加します。<indexterm><primary>createlang</primary></indexterm><indexterm><primary>PostgreSQL</primary><secondary>createlang</secondary></indexterm><indexterm><primary sortas="でーたべーす">データベース</primary><secondary sortas="げんごのついか">言語の追加</secondary></indexterm>

  </refpurpose>
   

 </refnamediv>

 <refsynopsisdiv>
  <cmdsynopsis>
   <command>createlang</command>
   <arg rep="repeat"><replaceable>connection-options</replaceable></arg>
   <arg><replaceable>langname</replaceable></arg>
   <arg choice="plain"><replaceable>dbname</replaceable></arg>
   <sbr>
   <command>createlang</command>
   <arg rep="repeat"><replaceable>connection-options</replaceable></arg>
   <group choice="plain"><arg>--list</arg><arg>-l</arg></group>
   <arg choice="plain"><replaceable>dbname</replaceable></arg>
  </cmdsynopsis>

  <refsect2 id="R2-APP-CREATELANG-1">
   <title>
    <!-- Inputs -->入力
   </title>
   <para>
    <!-- 
    <application>createlang</application> accepts the following 
     command line arguments: -->

    <application>createlang</application>は下記のコマンドライン引数を受け付けます。
</para>

    <variablelist>
     <varlistentry>
      <term><replaceable class="parameter">langname</replaceable></term>
      <listitem>
       <para>
        <!-- 
	Specifies the name of the backend programming language to
        be defined.
	<application>createlang</application> will prompt for
	<replaceable class="parameter">langname</replaceable>
	if it is not specified on the command line. -->

        定義されるバックエンドプログラミング言語の名前を指定します。もしコマンドラインで指定されない場合、<application>createlang</application>は<replaceable class="parameter">langname</replaceable>の入力を促します。

       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term>-d <replaceable class="parameter">dbname</replaceable></term>
      <term>--dbname <replaceable class="parameter">dbname</replaceable></term>
      <listitem>
       <para>
	<!-- Specifies which database the language should be added.
        -->

        言語を追加するデータベースを指定します。

       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term>-l</term>
      <term>--list</term>
      <listitem>
       <para>
        <!-- 
        Shows a list of already installed languages in the target 
        database (which must be specified). -->

        目的のデータベース（指定されなければなりません）にすでにインストールされている言語のリストを表示します。

       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term>-L <replaceable class="parameter">DIRECTORY</replaceable></term>
      <term>--pglib <replaceable class="parameter">DIRECTORY</replaceable></term>
      <listitem>
       <para>
        言語インタープリタ用のオブジェクトを探索するディレクトリを指定します。

       </para>
      </listitem>
     </varlistentry>

    </variablelist>

   <para>
    <!-- <application>createlang</application> also accepts 
    the following command line arguments for connection parameters: -->

    <application>createlang</application>は以下のコマンドライン引数も接続パラメータとして受け付けます。
</para>

    <variablelist>
     <varlistentry>
      <term>-h <replaceable class="parameter">host</replaceable></term>
      <term>--host <replaceable class="parameter">host</replaceable></term>
      <listitem>
       <para>
	<!-- Specifies the hostname of the machine on which the 
	<application>postmaster</application>
	is running.  If host begins with a slash, it is used 
	as the directory for the unix domain socket. -->

        <application>postmaster</application>が動作しているマシンのホスト名を指定します。もしホストがスラッシュで始まる場合、それはUnixドメインソケットのディレクトリとして使われます。

       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term>-p <replaceable class="parameter">port</replaceable></term>
      <term>--port <replaceable class="parameter">port</replaceable></term>
      <listitem>
       <para>
        <!-- 
	Specifies the Internet TCP/IP port or local Unix domain 
        socket file extension on which the 
        <application>postmaster</application>
	is listening for connections. -->

        <application>postmaster</application>が接続を監視しているインターネットTCP/IPポートもしくはローカルUnixドメインソケットファイルを指定します。

       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term>-U <replaceable class="parameter">username</replaceable></term>
      <term>--username <replaceable class="parameter">username</replaceable></term>
      <listitem>
       <para>
        <!-- Username to connect as. -->
        接続するユーザー名です。

       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term>-W</term>
      <term>--password</term>
      <listitem>
       <para>
        <!-- Force password prompt. -->
        パスワードプロンプトを強制します。
       </para>
      </listitem>
     </varlistentry>

    </variablelist>
  </refsect2>

  <refsect2 id="R2-APP-CREATELANG-2">
   <title>
    <!-- Outputs -->出力
   </title>
   <para>
    <!--  
    Most error messages are self-explanatory. If not, run
    <application>createlang</application> with the 
    <option>__echo</option> option and see under the respective 
    <acronym>SQL</acronym> command for details. Check also under 
    <xref linkend="APP-PSQL"> for more possibilities. -->

    ほとんどのエラーメッセージは自明です。そうでなければ<application>createlang</application>を<option>--echo</option>オプションで実行し、詳細はそれぞれの<acronym>SQL</acronym>コマンドで見てください。その他の可能性に関しては<xref linkend="APP-PSQL">を参照してください。

   </para>
  </refsect2>
 </refsynopsisdiv>
 
 <refsect1 id="R1-APP-CREATELANG-1">
  <title>
   <!-- Description -->説明
  </title>

  <para>
   <!-- 
   <application>createlang</application> is a utility for adding a new 
   programming language to a <productname>Postgres</productname> database.
   <application>createlang</application> currently accepts several
   languages, <literal>plpgsql, pltcl, pltclu,</literal> and <literal>
   plperl</literal>. -->

   <application>createlang</application>は、<productname>Postgres</productname>データベースに新しいプログラミング言語を追加するためのものです。<application>createlang</application>は現時点ではいくつかの言語、<literal>plpgsql, pltcl, pltclu,</literal>そして<literal>plperl</literal>を受け付けます。

  </para>
  <para>
   <!-- 
   Although backend programming languages can be added directly using
   several <acronym>SQL</acronym> commands, it is recommended to use
   <application>createlang</application> because it performs a number
   of checks and is much easier to use. See
   <xref linkend="sql-createlanguage" endterm="sql-createlanguage-title">
   for more. -->

   バックエンドプログラミング言語は<acronym>SQL</acronym>コマンドを使って直接追加することができますが、<application>createlang</application>はいくつかのチェックを行いますし、使いかたも簡単ですので、こちらを使うことをお勧めします。さらに詳しくは<xref linkend="sql-createlanguage" endterm="sql-createlanguage-title">を参照してください。

  </para>
 </refsect1>

 <refsect1 id="R1-APP-CREATELANG-2">
  <title>
   <!-- Notes -->
   注釈
  </title>
  <para>
   <!-- Use <xref linkend="app-droplang"> to remove a language. -->
   言語を削除するためには<xref linkend="app-droplang">を使います。
  </para>
 </refsect1>
 
 <refsect1 id="R1-APP-CREATELANG-3">
  <title><!-- Usage -->使用方法</title>

  <informalexample>
   <para>
    <!-- To install <literal>pltcl</literal> into the database
    <literal>template1</literal>: -->

    <literal>pltcl</literal>をデータベース<literal>template1</literal>にインストールするには以下のようにします。
</para>

<screen>
<prompt>$ </prompt><userinput>createlang pltcl template1</userinput>
</screen>
  </informalexample>
 </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:
-->
