<!--
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>
 </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>
  <para>
  <command>pcp_proc_info</command>
	displays the information on the given Pgpool-II child process ID.
  </para>
 </refsect1>

 <refsect1>
  <title>Options</title>
   <para>
    <variablelist>

     <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.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term><option>Other options </option></term>
      <listitem>
       <para>
	 See <xref linkend="pcp-common-options">.
       </para>
      </listitem>
     </varlistentry>
    </variablelist>
   </para>
 </refsect1>

 <refsect1>
  <title>Example</title>
   <para>
	Here is an example output:
    <programlisting>
$ pcp_proc_info -h localhost -p 9898 -U postgres 3815
postgres_db postgres 1150769932 1150767351 3 0 1 1467 1
postgres_db postgres 1150769932 1150767351 3 0 1 1468 1
    </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
4. connection created timestamp
5. protocol major version
6. protocol minor version
7. connection-reuse counter
8. PostgreSQL backend process id
9. 1 if frontend conncted 0 if not
</literallayout>
  </para>
  <para>
  If 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.
  </para>
  <para>
	The <option>--verbose</option> option can help understand the output. For example:
  </para>
    <programlisting>
$ pcp_proc_info --verbose -U postgres 3815
Database     : postgres_db
Username     : postgres
Start time   : 1150769932
Creation time: 1150767351
Major        : 3
Minor        : 0
Counter      : 1
PID          : 1467
Connected    : 1
Database     : postgres_db
Username     : postgres
Start time   : 1150769932
Creation time: 1150767351
Major        : 3
Minor        : 0
Counter      : 1
PID          : 1468
Connected    : 1
    </programlisting>
 </refsect1>

</refentry>
