<!-- agpg.sgml - man page source for agpg -->
<!DOCTYPE RefEntry PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
  <!ENTITY trailer SYSTEM "trailer.sgml">
]>

<refentry>
  <refmeta>
    <refentrytitle>agpg</refentrytitle>
    <manvolnum>1</manvolnum>
    <refmiscinfo>Quintuple Agent</refmiscinfo>
  </refmeta>
  <refnamediv>
    <refname>agpg</refname>
    <refpurpose>wrapper around <command>gpg</command> that provides
 passphrases for you</refpurpose>
  </refnamediv>
  <refsynopsisdiv>
    <cmdsynopsis>
      <command>agpg</command>
      <arg rep=repeat><replaceable>OPTION</replaceable></arg>
      <arg rep=repeat><replaceable>FILE</replaceable></arg>
    </cmdsynopsis>
  </refsynopsisdiv>
  <refsect1>
    <title>Description</title>
    <para>When <command/q-agent/ is running, <command/agpg/ can
    be used instead of <command/gpg/, and it will try to get all
    necessary passphrases from the agent instead of asking you
    directly.</para>
    <para>Since all arguments are handed off to <command/gpg/
    verbatim, the interface of <command/agpg/ is exactly the same as
    that of <command/gpg/.</para>
    <para>The following <command/gpg/ options will influence the
    behaviour of <command/agpg/ itself:</para>
    <variablelist>
      <varlistentry>
        <term><option/-u/, <option/--local-user/ <replaceable/NAME/</term>
	<listitem>
	  <para>informs <command/agpg/ that it should provide the
	  passphrase for the key indicated by
	  <replaceable/NAME/.</para>
	</listitem>
      </varlistentry>
      <varlistentry>
        <term><option/--version/</term>
	<listitem>
	  <para><command/agpg/ will output its version, too.</para>
	</listitem>
      </varlistentry>
      <varlistentry>
        <term><option/--passphrase-fd/ <replaceable/FD/</term>
	<listitem>
	  <para>prevents the querying of passphrases from the agent -
	  you will have to provide the passphrases yourself on the
	  given <replaceable/FD/. Its usage with <command/agpg/ is
	  discouraged.</para>
	</listitem>
      </varlistentry>
    </variablelist>
  </refsect1>
  <refsect1>
    <title>Environment</title>
    <variablelist>
      <varlistentry>
	<term>AGENT_SOCKET</term>
	<listitem>
	  <para><command/agpg/ will use this variable to find the socket for
communicating with the agent.</para>
	</listitem>
      </varlistentry>
    </variablelist>
  </refsect1>
  <refsect1>
    <title>See Also</title>
    <simplelist>
      <member><citerefentry>
	  <refentrytitle>q-agent<manvolnum/1/
	</citerefentry></member>
      <member><citerefentry>
	  <refentrytitle>q-client<manvolnum/1/
	</citerefentry></member>
      <member><citerefentry>
	  <refentrytitle>apgp<manvolnum/1/
	</citerefentry></member>
    </simplelist>
  </refsect1>
&trailer;
</refentry>
