* merged with the current debian version
[ntk/apt.git] / 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>list</term>
67 <listitem>
68 <para>
69
70 List trusted keys.
71
72 </para>
73
74 </listitem>
75 </varlistentry>
76
77 <varlistentry><term>update</term>
78 <listitem>
79 <para>
80
81 Update the local keyring with the keyring of Debian archive
82 keys and removes from the keyring the archive keys which are no
83 longer valid.
84
85 </para>
86
87 </listitem>
88 </varlistentry>
89 </variablelist>
90 </refsect1>
91
92 <refsect1><title>Files</title>
93 <variablelist>
94 <varlistentry><term><filename>/etc/apt/trusted.gpg</filename></term>
95 <listitem><para>Keyring of local trusted keys, new keys will be added here.</para></listitem>
96 </varlistentry>
97
98 <varlistentry><term><filename>/etc/apt/trustdb.gpg</filename></term>
99 <listitem><para>Local trust database of archive keys.</para></listitem>
100 </varlistentry>
101
102 <varlistentry><term><filename>/usr/share/keyrings/debian-archive-keyring.gpg</filename></term>
103 <listitem><para>Keyring of Debian archive trusted keys.</para></listitem>
104 </varlistentry>
105
106 <varlistentry><term><filename>/usr/share/keyrings/debian-archive-removed-keys.gpg</filename></term>
107 <listitem><para>Keyring of Debian archive removed trusted keys.</para></listitem>
108 </varlistentry>
109
110
111
112 </variablelist>
113
114 </refsect1>
115
116 <refsect1><title>See Also</title>
117 <para>
118 &apt-get;, &apt-secure;
119 </para>
120 </refsect1>
121
122 &manbugs;
123 &manauthor;
124
125 </refentry>
126