summaryrefslogtreecommitdiff
path: root/doc/vendors.list.5.sgml
diff options
context:
space:
mode:
authorArch Librarian <arch@canonical.com>2004-09-20 17:05:19 +0000
committerArch Librarian <arch@canonical.com>2004-09-20 17:05:19 +0000
commit24f6490f4ba3572069619d88e053db5cb07e846c (patch)
tree2c4774b6233e12f552dc9bde4e62e1f7fa6f9b6f /doc/vendors.list.5.sgml
parent16633d164ed17530dca1d016db26176e99a02557 (diff)
* Replace SGML manpages with XML man pages from richard...
Author: mdz Date: 2004-02-07 21:48:14 GMT * Replace SGML manpages with XML man pages from richard.bos@xs4all.nl (Closes: #230687)
Diffstat (limited to 'doc/vendors.list.5.sgml')
-rw-r--r--doc/vendors.list.5.sgml104
1 files changed, 0 insertions, 104 deletions
diff --git a/doc/vendors.list.5.sgml b/doc/vendors.list.5.sgml
deleted file mode 100644
index 5b3d6a8af..000000000
--- a/doc/vendors.list.5.sgml
+++ /dev/null
@@ -1,104 +0,0 @@
-<!-- -*- mode: sgml; mode: fold -*- -->
-<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
-
-<!ENTITY % aptent SYSTEM "apt.ent">
-%aptent;
-
-]>
-
-<refentry>
- &apt-docinfo;
-
- <refmeta>
- <refentrytitle>vendors.list</>
- <manvolnum>5</>
- </refmeta>
-
- <!-- Man page title -->
- <refnamediv>
- <refname>vendors.list</>
- <refpurpose>Security key configuration for APT</>
- </refnamediv>
-
- <RefSect1><Title>Description</>
- <para>
- The package vendor list contains a list of all vendors
- from whom you wish to authenticate downloaded packages.
- For each vendor listed, it must contain the corresponding
- PGP key fingerprint, so that APT can perform signature
- verification of the release file and subsequent checking
- of the checksums of each downloaded package.
- To have authentication enabled, you must add the
- vendor identification string (see below) enclosed in
- square braces to the sources.list line for all sites that mirror
- the repository provided by that vendor.
- <para>
- The format of this file is similar to the one used by
- apt.conf. It consists of an arbitrary number of blocks of
- vendors, where each block starts with a string telling the
- <replaceable/key_type/ and the <replaceable/vendor_id/.
- <para>
- Some vendors may have multiple blocks that define different
- security policies for their distributions. Debian for instance
- uses a different signing methodology for stable and unstable releases.
- <para>
- <replaceable/key_type/ is the type of the check required.
- Currently, there is only one type available which is
- <literal/simple-key/.
- <para>
- <replaceable/vendor_id/ is the vendor identification string. It is an
- arbitrary string you must supply to uniquely identifify a
- vendor that's listed in this file.
-
- Example:
-<informalexample><programlisting>
-simple-key "joe"
-{
- Fingerprint "0987AB4378FSD872343298787ACC";
- Name "Joe Shmoe &lt;joe@shmoe.com&gt;";
-}
-</programlisting></informalexample>
-
- </RefSect1>
-
- <RefSect1><Title>The simple-key type</>
- <para>
- This type of verification is used when the vendor has a single
- secured key that must be used to sign the Release file. The
- following items should be present
-
- <VariableList>
- <VarListEntry><Term>Fingerprint</Term>
- <ListItem><Para>
- The PGP fingerprint for the key. The fingerprint should be
- expressed in the standard notion with or without spaces.
- The <option/--fingerprint/ option for
- <CiteRefEntry><RefEntryTitle><command/gpg/</RefEntryTitle><ManVolNum/1/</CiteRefEntry>
- will show the fingerprint for the selected keys(s).
- </VarListEntry>
-
- <VarListEntry><Term>Name</Term>
- <ListItem><Para>
- A string containing a description of the owner of
- the key or vendor. You may put the vendor name and it's
- email. The string must be quoted with ".
- </VarListEntry>
-
- </VariableList>
- </RefSect1>
-
- <RefSect1><Title>Files</>
- <para>
- <filename>/etc/apt/vendors.list</>
- </RefSect1>
-
- <RefSect1><Title>See Also</>
- <para>
- &sources-list;
- </RefSect1>
-
- &manbugs;
- &manauthor;
-
-</refentry>
-