X-Git-Url: https://git.saurik.com/apt.git/blobdiff_plain/6f4574e8dbbabc6b9bb67b31edc765602b63a088..52090faab4401ad6a2acb4d2c0c2cb53aa6b8f7f:/doc/apt-key.8.xml diff --git a/doc/apt-key.8.xml b/doc/apt-key.8.xml index f1cc3ac02..5dbbaaf26 100644 --- a/doc/apt-key.8.xml +++ b/doc/apt-key.8.xml @@ -1,6 +1,6 @@ - %aptent; @@ -8,11 +8,20 @@ %aptverbatiment; + +%aptvendor; ]> - &apt-docinfo; - + + &apt-author.jgunthorpe; + &apt-author.team; + &apt-email; + &apt-product; + + 2012-06-09T00:00:00Z + + apt-key 8 @@ -25,15 +34,7 @@ APT key management utility - - - - apt-key - - command - - - + &synopsis-command-apt-key; Description @@ -45,19 +46,19 @@ Commands - add filename + - - Add a new key to the list of trusted keys. The key is read - from filename, or standard input if - filename is -. + Add a new key to the list of trusted keys. + The key is read from the filename given with the parameter + &synopsis-param-filename; or if the filename is - + from standard input. - del keyid + @@ -68,18 +69,18 @@ - export keyid + - Output the key keyid to standard output. + Output the key &synopsis-param-keyid; to standard output. - exportall + @@ -90,7 +91,7 @@ - list + @@ -101,7 +102,7 @@ - finger + @@ -112,7 +113,7 @@ - adv + @@ -124,13 +125,32 @@ - update + + + + + Update the local keyring with the archive keyring and remove from + the local keyring the archive keys which are no longer valid. + The archive keyring is shipped in the archive-keyring package of your + distribution, e.g. the &keyring-package; package in &keyring-distro;. + + + + + + + - Update the local keyring with the keyring of Debian archive - keys and removes from the keyring the archive keys which are no - longer valid. + Perform an update working similarly to the update command above, + but get the archive keyring from a URI instead and validate it against a master key. + + This requires an installed &wget; and an APT build configured to have + a server to fetch from and a master keyring to validate. + + APT in Debian does not support this command, relying on + update instead, but Ubuntu's APT does. @@ -142,11 +162,11 @@ Options Note that options need to be defined before the commands described in the previous section. - --keyring filename - With this option it is possible to specify a specific keyring + + With this option it is possible to specify a particular keyring file the command should operate on. The default is that a command is executed on the trusted.gpg file as well as on all parts in the - trusted.gpg.d directory, through trusted.gpg + trusted.gpg.d directory, though trusted.gpg is the primary keyring which means that e.g. new keys are added to this one. @@ -162,12 +182,12 @@ Local trust database of archive keys. - /usr/share/keyrings/debian-archive-keyring.gpg - Keyring of Debian archive trusted keys. + &keyring-filename; + Keyring of &keyring-distro; archive trusted keys. - /usr/share/keyrings/debian-archive-removed-keys.gpg - Keyring of Debian archive removed trusted keys. + &keyring-removed-filename; + Keyring of &keyring-distro; archive removed trusted keys.