X-Git-Url: https://git.saurik.com/apt.git/blobdiff_plain/c0c3f8678d401bd4e8995e1491827520a112525c..a02f24e046d58b723a9283211cb558605a024bdf:/doc/apt-key.8.xml diff --git a/doc/apt-key.8.xml b/doc/apt-key.8.xml index 62686618a..f1cc3ac02 100644 --- a/doc/apt-key.8.xml +++ b/doc/apt-key.8.xml @@ -5,6 +5,9 @@ <!ENTITY % aptent SYSTEM "apt.ent"> %aptent; +<!ENTITY % aptverbatiment SYSTEM "apt-verbatim.ent"> +%aptverbatiment; + ]> <refentry> @@ -13,6 +16,7 @@ <refmeta> <refentrytitle>apt-key</refentrytitle> <manvolnum>8</manvolnum> + <refmiscinfo class="manual">APT</refmiscinfo> </refmeta> <!-- Man page title --> @@ -25,7 +29,8 @@ <refsynopsisdiv> <cmdsynopsis> <command>apt-key</command> - <arg><replaceable>command</replaceable>/</arg> + <arg><option>--keyring <replaceable>filename</replaceable></option></arg> + <arg><replaceable>command</replaceable></arg> <arg rep="repeat"><option><replaceable>arguments</replaceable></option></arg> </cmdsynopsis> </refsynopsisdiv> @@ -63,11 +68,70 @@ </listitem> </varlistentry> + <varlistentry><term>export <replaceable>keyid</replaceable></term> + <listitem> + <para> + + Output the key <replaceable>keyid</replaceable> to standard output. + + </para> + + </listitem> + </varlistentry> + + <varlistentry><term>exportall</term> + <listitem> + <para> + + Output all trusted keys to standard output. + + </para> + + </listitem> + </varlistentry> + <varlistentry><term>list</term> <listitem> <para> List trusted keys. + + </para> + + </listitem> + </varlistentry> + + <varlistentry><term>finger</term> + <listitem> + <para> + + List fingerprints of trusted keys. + + </para> + + </listitem> + </varlistentry> + + <varlistentry><term>adv</term> + <listitem> + <para> + + Pass advanced options to gpg. With adv --recv-key you can download the + public key. + + </para> + + </listitem> + </varlistentry> + + <varlistentry><term>update</term> + <listitem> + <para> + + Update the local keyring with the keyring of Debian archive + keys and removes from the keyring the archive keys which are no + longer valid. + </para> </listitem> @@ -75,10 +139,46 @@ </variablelist> </refsect1> -<!-- <refsect1><title>See Also</title> --> -<!-- <para> --> -<!-- &apt-conf;, &apt-get;, &sources-list; --> -<!-- </refsect1> --> + <refsect1><title>Options</title> +<para>Note that options need to be defined before the commands described in the previous section.</para> + <variablelist> + <varlistentry><term>--keyring <replaceable>filename</replaceable></term> + <listitem><para>With this option it is possible to specify a specific keyring + file the command should operate on. The default is that a command is executed + on the <filename>trusted.gpg</filename> file as well as on all parts in the + <filename>trusted.gpg.d</filename> directory, through <filename>trusted.gpg</filename> + is the primary keyring which means that e.g. new keys are added to this one. + </para></listitem> + </varlistentry> + </variablelist> + </refsect1> + + <refsect1><title>Files</title> + <variablelist> + + &file-trustedgpg; + + <varlistentry><term><filename>/etc/apt/trustdb.gpg</filename></term> + <listitem><para>Local trust database of archive keys.</para></listitem> + </varlistentry> + + <varlistentry><term><filename>/usr/share/keyrings/debian-archive-keyring.gpg</filename></term> + <listitem><para>Keyring of Debian archive trusted keys.</para></listitem> + </varlistentry> + + <varlistentry><term><filename>/usr/share/keyrings/debian-archive-removed-keys.gpg</filename></term> + <listitem><para>Keyring of Debian archive removed trusted keys.</para></listitem> + </varlistentry> + + </variablelist> + +</refsect1> + +<refsect1><title>See Also</title> +<para> +&apt-get;, &apt-secure; +</para> +</refsect1> &manbugs; &manauthor;