doc/apt-key.8.xml

   1 <?xml version="1.0" encoding="utf-8" standalone="no"?>
   2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
   3   "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
   4
   5 <!ENTITY % aptent SYSTEM "apt.ent">
   6 %aptent;
   7
   8 ]>
   9
  10 <refentry>
  11  &apt-docinfo;
  12
  13  <refmeta>
  14    <refentrytitle>apt-key</refentrytitle>
  15    <manvolnum>8</manvolnum>
  16    <refmiscinfo class="manual">APT</refmiscinfo>
  17  </refmeta>
  18
  19  <!-- Man page title -->
  20  <refnamediv>
  21     <refname>apt-key</refname>
  22     <refpurpose>APT key management utility</refpurpose>
  23  </refnamediv>
  24
  25  <!-- Arguments -->
  26  <refsynopsisdiv>
  27    <cmdsynopsis>
  28       <command>apt-key</command>
  29       <arg><replaceable>command</replaceable>/</arg>
  30       <arg rep="repeat"><option><replaceable>arguments</replaceable></option></arg>
  31    </cmdsynopsis>
  32  </refsynopsisdiv>
  33
  34  <refsect1><title>Description</title>
  35    <para>
  36    <command>apt-key</command> is used to manage the list of keys used
  37    by apt to authenticate packages.  Packages which have been
  38    authenticated using these keys will be considered trusted.
  39    </para>
  40 </refsect1>
  41
  42 <refsect1><title>Commands</title>
  43    <variablelist>
  44      <varlistentry><term>add <replaceable>filename</replaceable></term>
  45      <listitem>
  46      <para>
  47
  48        Add a new key to the list of trusted keys.  The key is read
  49        from <replaceable>filename</replaceable>, or standard input if
  50        <replaceable>filename</replaceable> is <literal>-</literal>.
  51      </para>
  52
  53      </listitem>
  54      </varlistentry>
  55
  56      <varlistentry><term>del <replaceable>keyid</replaceable></term>
  57      <listitem>
  58      <para>
  59
  60        Remove a key from the list of trusted keys.
  61
  62      </para>
  63
  64      </listitem>
  65      </varlistentry>
  66
  67      <varlistentry><term>export <replaceable>keyid</replaceable></term>
  68      <listitem>
  69      <para>
  70
  71         Output the key <replaceable>keyid</replaceable> to standard output.
  72
  73      </para>
  74
  75      </listitem>
  76      </varlistentry>
  77
  78      <varlistentry><term>exportall</term>
  79      <listitem>
  80      <para>
  81
  82         Output all trusted keys to standard output.
  83
  84      </para>
  85
  86      </listitem>
  87      </varlistentry>
  88
  89      <varlistentry><term>list</term>
  90      <listitem>
  91      <para>
  92
  93        List trusted keys.
  94
  95      </para>
  96
  97      </listitem>
  98      </varlistentry>
  99
 100          <varlistentry><term>finger</term>
 101      <listitem>
 102      <para>
 103
 104      List fingerprints of trusted keys.
 105
 106      </para>
 107
 108      </listitem>
 109      </varlistentry>
 110
 111          <varlistentry><term>adv</term>
 112      <listitem>
 113      <para>
 114
 115      Pass advanced options to gpg. With adv --recv-key you can download the
 116          public key.
 117
 118      </para>
 119
 120      </listitem>
 121      </varlistentry>
 122
 123      <varlistentry><term>update</term>
 124      <listitem>
 125      <para>
 126
 127        Update the local keyring with the keyring of Debian archive
 128        keys and removes from the keyring the archive keys which are no
 129        longer valid.
 130
 131      </para>
 132
 133      </listitem>
 134      </varlistentry>
 135    </variablelist>
 136 </refsect1>
 137
 138  <refsect1><title>Files</title>
 139    <variablelist>
 140      <varlistentry><term><filename>/etc/apt/trusted.gpg</filename></term>
 141      <listitem><para>Keyring of local trusted keys, new keys will be added here.</para></listitem>
 142      </varlistentry>
 143
 144      <varlistentry><term><filename>/etc/apt/trustdb.gpg</filename></term>
 145      <listitem><para>Local trust database of archive keys.</para></listitem>
 146      </varlistentry>
 147
 148      <varlistentry><term><filename>/usr/share/keyrings/debian-archive-keyring.gpg</filename></term>
 149      <listitem><para>Keyring of Debian archive trusted keys.</para></listitem>
 150      </varlistentry>
 151
 152      <varlistentry><term><filename>/usr/share/keyrings/debian-archive-removed-keys.gpg</filename></term>
 153      <listitem><para>Keyring of Debian archive removed trusted keys.</para></listitem>
 154      </varlistentry>
 155
 156
 157
 158    </variablelist>
 159
 160 </refsect1>
 161
 162 <refsect1><title>See Also</title>
 163 <para>
 164 &apt-get;, &apt-secure;
 165 </para>
 166 </refsect1>
 167
 168  &manbugs;
 169  &manauthor;
 170
 171 </refentry>
 172