X-Git-Url: https://git.saurik.com/apt.git/blobdiff_plain/c861c34804edcbe0644118dcf48c74fd552aea5a..c38847ebbbab115b01dd1421dee55d5a50d404f1:/doc/apt-get.8.xml diff --git a/doc/apt-get.8.xml b/doc/apt-get.8.xml index 5fef807e2..76a53aec2 100644 --- a/doc/apt-get.8.xml +++ b/doc/apt-get.8.xml @@ -1,13 +1,9 @@ -%aptent; - - -%aptverbatiment; - + %aptent; + %aptverbatiment; + %aptvendor; ]> @@ -18,7 +14,7 @@ &apt-email; &apt-product; - 2012-05-21T00:00:00Z + 2012-06-09T00:00:00Z @@ -38,7 +34,7 @@ Description apt-get is the command-line tool for handling packages, and may be considered the user's "back-end" to other tools using the APT - library. Several "front-end" interfaces exist, such as &dselect;, + library. Several "front-end" interfaces exist, such as &aptitude;, &synaptic; and &wajig;. Unless the , or option is given, one of the @@ -215,10 +211,7 @@ clean clears out the local repository of retrieved package files. It removes everything but the lock file from &cachedir;/archives/ and - &cachedir;/archives/partial/. When APT is used as a - &dselect; method, clean is run automatically. - Those who do not use dselect will likely want to run apt-get clean - from time to time to free up disk space. + &cachedir;/archives/partial/. @@ -237,19 +230,30 @@ - changelog downloads a package changelog and displays - it through sensible-pager. The server name and base - directory is defined in the APT::Changelogs::Server - variable (e.g. packages.debian.org/changelogs for - Debian or changelogs.ubuntu.com/changelogs for - Ubuntu). - By default it displays the changelog for the version that is - installed. However, you can specify the same options as for - the command. - + changelog tries to download the + changelog of a package and displays it through + sensible-pager. By default it + displays the changelog for the version that is installed. + However, you can specify the same options as for the + command. + + Displays by default a deb822 formatted listing of + information about all data files (aka index targets) apt-get + update would download. Supports a + option to modify the output format as + well as accepts lines of the default output to filter the records + by. The command is mainly used as an interface for external tools + working with APT to get information as well as filenames for + downloaded files so they can use them as well instead of + downloading them again on their own. Detailed documentation is + omitted here and can instead be found in the source tree in + doc/acquire-additional-files.txt. + + + @@ -282,7 +286,7 @@ running APT for the first time; APT itself does not allow broken package dependencies to exist on a system. It is possible that a system's dependency structure can be so corrupt as to require manual intervention - (which usually means using &dselect; or dpkg --remove to eliminate some of + (which usually means using dpkg --remove to eliminate some of the offending packages). Use of this option together with may produce an error in some situations. Configuration Item: APT::Get::Fix-Broken. @@ -323,17 +327,15 @@ - No action; perform a simulation of events that would occur but do not - actually change the system. - Configuration Item: APT::Get::Simulate. - - Simulated runs performed as a user will automatically deactivate locking - (Debug::NoLocking), and if the option - APT::Get::Show-User-Simulation-Note is set - (as it is by default) a notice will also be displayed indicating that - this is only a simulation. Runs performed as root do not trigger either - NoLocking or the notice - superusers should know what they are doing - without further warnings from apt-get. + No action; perform a simulation of events that would occur + based on the current system state but do not actually change the + system. Locking will be disabled () + so the system state could change while apt-get is + running. Simulations can also be executed by non-root users which might + not have read access to all apt configuration distorting the simulation. + A notice expressing this warning is also shown by default for non-root + users (). + Configuration Item: APT::Get::Simulate. Simulated runs print out a series of lines, each representing a dpkg operation: configure (Conf), remove (Remv) @@ -372,7 +374,18 @@ by apt-get source --compile and how cross-builddependencies are satisfied. By default is it not set which means that the host architecture is the same as the build architecture (which is defined by APT::Architecture). - Configuration Item: APT::Get::Host-Architecture + Configuration Item: APT::Get::Host-Architecture. + + + + + + This option controls the activated build profiles for which + a source package is built by apt-get source --compile and + how build dependencies are satisfied. By default no build profile is active. + More than one build profile can be activated at a time by concatenating them + with a comma. + Configuration Item: APT::Build-Profiles. @@ -389,6 +402,18 @@ Configuration Item: APT::Ignore-Hold. + + Allow installing new packages when used in + conjunction with upgrade. This is useful if + the update of a installed package requires new dependencies to be + installed. Instead of holding the package back upgrade + will upgrade the package and install the new dependencies. Note that + upgrade with this option will never remove packages, + only allow adding new ones. + Configuration Item: APT::Get::Upgrade-Allow-New. + + + Do not upgrade packages; when used in conjunction with install, no-upgrade will prevent packages on the command line @@ -404,12 +429,36 @@ Configuration Item: APT::Get::Only-Upgrade. + + This is a dangerous option that will cause apt to continue + without prompting if it is doing downgrades. It + should not be used except in very special situations. Using + it can potentially destroy your system! + Configuration Item: APT::Get::allow-downgrades. Introduced in APT 1.1. + + + + Force yes; this is a dangerous option that will cause apt to continue + without prompting if it is removing essentials. It + should not be used except in very special situations. Using + it can potentially destroy your system! + Configuration Item: APT::Get::allow-remove-essential. Introduced in APT 1.1. + + + + Force yes; this is a dangerous option that will cause apt to continue + without prompting if it is changing held packages. It + should not be used except in very special situations. Using + it can potentially destroy your system! + Configuration Item: APT::Get::allow-change-held-packages. Introduced in APT 1.1. + + Force yes; this is a dangerous option that will cause apt to continue without prompting if it is doing something potentially harmful. It should not be used except in very special situations. Using force-yes can potentially destroy your system! - Configuration Item: APT::Get::force-yes. + Configuration Item: APT::Get::force-yes. This is deprecated and replaced by , , in 1.1. @@ -504,11 +553,31 @@ - Ignore if packages can't be authenticated and don't prompt about it. - This is useful for tools like pbuilder. - Configuration Item: APT::Get::AllowUnauthenticated. + Ignore if packages can't be authenticated and don't prompt + about it. This can be useful while working with local repositories, + but is a huge security risk if data authenticity isn't ensured in + another way by the user itself. The usage of the + option for &sources-list; entries should + usually be preferred over this global override. Configuration Item: + APT::Get::AllowUnauthenticated. - + + + Forbid the update command to acquire unverifiable + data from configured sources. Apt will fail at the update command + for repositories without valid cryptographically signatures. + + Configuration Item: Acquire::AllowInsecureRepositories. + + + + Show user friendly progress information in the + terminal window when packages are installed, upgraded or + removed. For a machine parsable version of this data see + README.progress-reporting in the apt doc directory. + Configuration Item: Dpkg::Progress and Dpkg::Progress-Fancy. + + &apt-commonoptions; @@ -526,7 +595,7 @@ See Also - &apt-cache;, &apt-cdrom;, &dpkg;, &dselect;, &sources-list;, + &apt-cache;, &apt-cdrom;, &dpkg;, &sources-list;, &apt-conf;, &apt-config;, &apt-secure;, The APT User's guide in &guidesdir;, &apt-preferences;, the APT Howto.