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