<!--
doc/src/sgml/ref/pcp_proc_info.sgml
Pgpool-II documentation
-->

<refentry id="PCP-PROC-INFO">
 <indexterm zone="pcp-proc-info">
  <primary>pcp_proc_info</primary>
 </indexterm>

 <refmeta>
  <refentrytitle>pcp_proc_info</refentrytitle>
  <manvolnum>1</manvolnum>
  <refmiscinfo>PCP Command</refmiscinfo>
 </refmeta>

 <refnamediv>
  <refname>pcp_proc_info</refname>
  <refpurpose>
   <!--
   displays the information on the given Pgpool-II child process ID</refpurpose>
   -->
   <productname>Pgpool-II</productname> の子プロセス情報を表示する</refpurpose>
 </refnamediv>

 <refsynopsisdiv>
  <cmdsynopsis>
   <command>pcp_proc_info</command>
   <arg rep="repeat"><replaceable>options</replaceable></arg>
   <arg><replaceable>processid</replaceable></arg>
  </cmdsynopsis>
 </refsynopsisdiv>

 <refsect1 id="R1-PCP-PROC-INFO-1">
  <!--
  <title>Description</title>
  -->
  <title>説明</title>
  <para>
   <command>pcp_proc_info</command>
   <!--
   displays the information on the given Pgpool-II child process ID.
   -->
   は <productname>Pgpool-II</productname> の子プロセス情報を表示します。
  </para>
 </refsect1>

 <refsect1>
  <!--
  <title>Options</title>
  -->
  <title>オプション</title>
  <para>
   <variablelist>

    <varlistentry>
     <term><option>-a</option></term>
     <term><option>--all</option></term>
     <listitem>
      <para>
       <!--
       Display all child processes and their available connection slots.
       -->
       すべての子プロセスと、それに関するコネクションスロットを表示します。
      </para>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term><option>-P <replaceable class="parameter">PID</replaceable></option></term>
     <term><option>--process-id=<replaceable class="parameter">PID</replaceable></option></term>
     <listitem>
      <para>
       <!--
       PID of Pgpool-II child process.
       -->
       Pgpool-II 子プロセスの PID を指定します。
      </para>
     </listitem>
    </varlistentry>

    <varlistentry>
     <!--
     <term><option>Other options </option></term>
     -->
     <term><option>その他</option></term>
     <listitem>
      <para>
       <!--
       See <xref linkend="pcp-common-options">.
       -->
       <xref linkend="pcp-common-options"> を参照してください。
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
   <!--
   If -a nor -P is not specified, process information of all
   connected <productname>Pgpool-II</productname> child process will
   be printed. In this case if there's no
   connected <productname>Pgpool-II</productname> child process,
   nothing but "No process information available" message will be
   printed.
   -->
   もし-aオプションも-Pオプションも指定されない場合は、すべての接続された<productname>Pgpool-II</productname>子プロセスが表示されます。
   この場合、接続された子プロセスが存在しない場合は、"No process information available"メッセージだけが表示されます。
  </para>
 </refsect1>

 <refsect1>
  <!--
  <title>Example</title>
  -->
  <title>例</title>
  <para>
   <!--
   Here is an example output:
   -->
   例を示します。
   <programlisting>
$ pcp_proc_info -p 11001
test t-ishii 2025-06-24 10:53:35 0 3 0 2025-06-24 10:55:58 2025-06-24 10:55:59 0  1 1336703 1 1336537 0 Idle 0 192.168.10.11 39216
test t-ishii 2025-06-24 10:53:35 0 3 0 2025-06-24 10:55:58 2025-06-24 10:55:59 0  1 1336704 1 1336537 1 Idle 1 192.168.10.11 39216
test t-ishii 2025-06-24 10:53:35 (4:03 before process restarting) 1 3 0 2025-06-24 10:53:42 2025-06-24 10:53:42 0 2025-06-24 10:55:37 1 1336573 0 1336544 0 Wait for connection 0 192.168.10.11 39162
test t-ishii 2025-06-24 10:53:35 (4:03 before process restarting) 1 3 0 2025-06-24 10:53:42 2025-06-24 10:53:42 0 2025-06-24 10:55:37 1 1336574 0 1336544 1 Wait for connection 0 192.168.10.11 39162
   </programlisting>
  </para>
  <para>
   <!--
   The result is in the following order:
   -->
   結果は以下の順のとおりです。
   <literallayout class="monospaced">
    <!--
    1. connected database name
    2. connected user name
    3. process start-up timestamp (If <xref linkend="guc-child-life-time"> is set not 0, the time before process restarting is displayed.)
    4. process-reuse counter for <xref linkend="guc-child-max-connections">
    5. protocol major version
    6. protocol minor version
    7. connection created timestamp
    8. last client connected timestamp
    9. client idle duration (sec) (If <xref linkend="guc-client-idle-limit"> is set not 0, the time before client disconnected is displayed.)
    10. last client disconnected timestamp
    11. connection-reuse counter
    12. PostgreSQL backend process id
    13. 1 if frontend connected 0 if not
    14. pgpool child process id
    15. PostgreSQL backend id
    16. process status
    17. 1 if backend is load balance node and frontend connected, 0 otherwise
    18. client's host name
    19. client's port number (not shown if Unix domain socket or localhost)
    20. SQL statement last executed
    -->
    1. 接続先のデータベース名
    2. 接続先のユーザ名
    3. Pgpool-IIプロセスの起動時刻 (<xref linkend="guc-child-life-time">が0でない場合、プロセスが再起動されるまでの時間を表示します)
    4. プロセスの利用カウンタ(<xref linkend="guc-child-max-connections">を参照)
    5. プロトコルのメジャーバージョン
    6. プロトコルのマイナーバージョン
    7. バックエンドへの接続時刻
    8. クライアントが最後に接続開始した時刻
    9. 接続がidleとなっている時間(秒)(<xref linkend="guc-client-idle-limit">が0でない場合、クライアントが切断されるまでの時間を表示します)
    10. クライアントが最後に接続終了した時刻
    11. 接続の再利用カウンタ値
    12. PostgreSQLバックエンドプロセスのプロセスID
    13. フロントエンドが接続中なら1、そうでなければ0
    14. pgpool子プロセスID
    15. PostgreSQLバックエンドID
    16. プロセスの状態
　　17. フロントエンドが接続中でバックエンドが負荷分散ノードならば1, そうでなければ0
    18. クライアントのホスト名
    19. クライアントのポート番号 (Unixドメインソケット、localhostでは表示されません)
    20. 最後に実行したSQL文
   </literallayout>
  </para>
  <para>
   <!--
   If <literal>a</literal> or <literal>all</literal> option is not specified and
   there is no connection to the backends, nothing will be displayed. If there are
   multiple connections, one connection's information will be displayed on each
   line multiple times. Timestamps are displayed in EPOCH format.
   -->
   <literal>-a</literal> もしくは <literal>--all</literal>オプションが指定されておらずコネクションがバックエンドに対して張られていない場合、データは表示されません。 コネクション情報が複数ある場合、複数行に 1 行 1 コネクション情報で表示されます。
  </para>
  <para>
   <!--
   The <option>verbose</option> option can help understand the output. For example:
   -->
   <option>--verbose</option> オプションは出力内容を理解するのに役に立ちます。例：
  </para>
  <programlisting>
$ pcp_proc_info -p 11001 --verbose
Database                  : test
Username                  : t-ishii
Start time                : 2025-06-24 10:53:35
Client connection count   : 0
Major                     : 3
Minor                     : 0
Backend connection time   : 2025-06-24 10:55:58
Client connection time    : 2025-06-24 10:55:59
Client idle duration      : 0
Client disconnection time : 
Pool Counter              : 1
Backend PID               : 1336703
Connected                 : 1
PID                       : 1336537
Backend ID                : 0
Status                    : Idle
Load balance node         : 0
client_host               : 192.168.10.11
client_port               : 39216
statement                 : 

Database                  : test
Username                  : t-ishii
Start time                : 2025-06-24 10:53:35
Client connection count   : 0
Major                     : 3
Minor                     : 0
Backend connection time   : 2025-06-24 10:55:58
Client connection time    : 2025-06-24 10:55:59
Client idle duration      : 0
Client disconnection time : 
Pool Counter              : 1
Backend PID               : 1336704
Connected                 : 1
PID                       : 1336537
Backend ID                : 1
Status                    : Idle
Load balance node         : 1
client_host               : 192.168.10.11
client_port               : 39216
statement                 : select 1;

Database                  : test
Username                  : t-ishii
Start time                : 2025-06-24 10:53:35 (4:33 before process restarting)
Client connection count   : 1
Major                     : 3
Minor                     : 0
Backend connection time   : 2025-06-24 10:53:42
Client connection time    : 2025-06-24 10:53:42
Client idle duration      : 0
Client disconnection time : 2025-06-24 10:55:37
Pool Counter              : 1
Backend PID               : 1336573
Connected                 : 0
PID                       : 1336544
Backend ID                : 0
Status                    : Wait for connection
Load balance node         : 0
client_host               : 192.168.10.11
client_port               : 39162
statement                 : DISCARD ALL

Database                  : test
Username                  : t-ishii
Start time                : 2025-06-24 10:53:35 (4:33 before process restarting)
Client connection count   : 1
Major                     : 3
Minor                     : 0
Backend connection time   : 2025-06-24 10:53:42
Client connection time    : 2025-06-24 10:53:42
Client idle duration      : 0
Client disconnection time : 2025-06-24 10:55:37
Pool Counter              : 1
Backend PID               : 1336574
Connected                 : 0
PID                       : 1336544
Backend ID                : 1
Status                    : Wait for connection
Load balance node         : 0
client_host               : 192.168.10.11
client_port               : 39162
statement                 : 
  </programlisting>
 </refsect1>

</refentry>
