diff options
Diffstat (limited to 'doc/apt-get.8.sgml')
| -rw-r--r-- | doc/apt-get.8.sgml | 512 |
1 files changed, 0 insertions, 512 deletions
diff --git a/doc/apt-get.8.sgml b/doc/apt-get.8.sgml deleted file mode 100644 index 0d6be65d7..000000000 --- a/doc/apt-get.8.sgml +++ /dev/null @@ -1,512 +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>apt-get</> - <manvolnum>8</> - </refmeta> - - <!-- Man page title --> - <refnamediv> - <refname>apt-get</> - <refpurpose>APT package handling utility -- command-line interface</> - </refnamediv> - - <!-- Arguments --> - <refsynopsisdiv> - <cmdsynopsis> - <command>apt-get</> - <arg><option>-hvs</></arg> - <arg><option>-o=<replaceable/config string/</></arg> - <arg><option>-c=<replaceable/file/</></arg> - <group choice=req> - <arg>update</> - <arg>upgrade</> - <arg>dselect-upgrade</> - <arg>install <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg> - <arg>remove <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg> - <arg>source <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg> - <arg>build-dep <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg> - <arg>check</> - <arg>clean</> - <arg>autoclean</> - </group> - </cmdsynopsis> - </refsynopsisdiv> - - <RefSect1><Title>Description</> - <para> - <command/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(8), - aptitude, synaptic, gnome-apt and wajig. - <para> - Unless the <option/-h/, or <option/--help/ option is given, one of the - commands below must be present. - - <VariableList> - <VarListEntry><Term>update</Term> - <ListItem><Para> - <literal/update/ is used to resynchronize the package index files from - their sources. The indexes of available packages are fetched from the - location(s) specified in <filename>/etc/apt/sources.list</>. - For example, when using a Debian archive, this command retrieves and - scans the <filename>Packages.gz</> files, so that information about new - and updated packages is available. An <literal/update/ should always be - performed before an <literal/upgrade/ or <literal/dist-upgrade/. Please - be aware that the overall progress meter will be incorrect as the size - of the package files cannot be known in advance. - </VarListEntry> - - <VarListEntry><Term>upgrade</Term> - <ListItem><Para> - <literal/upgrade/ is used to install the newest versions of all packages - currently installed on the system from the sources enumerated in - <filename>/etc/apt/sources.list</>. Packages currently installed with - new versions available are retrieved and upgraded; under no circumstances - are currently installed packages removed, or packages not already installed - retrieved and installed. New versions of currently installed packages that - cannot be upgraded without changing the install status of another package - will be left at their current version. An <literal/update/ must be - performed first so that <command/apt-get/ knows that new versions of packages are - available. - </VarListEntry> - - <VarListEntry><Term>dselect-upgrade</Term> - <ListItem><Para> - <literal/dselect-upgrade/ - is used in conjunction with the traditional Debian packaging - front-end, &dselect;. <literal/dselect-upgrade/ - follows the changes made by &dselect; to the <literal/Status/ - field of available packages, and performs the actions necessary to realize - that state (for instance, the removal of old and the installation of new - packages). - </VarListEntry> - - <VarListEntry><Term>dist-upgrade</Term> - <ListItem><Para> - <literal/dist-upgrade/, in addition to performing the function of - <literal/upgrade/, also intelligently handles changing dependencies - with new versions of packages; <command/apt-get/ has a "smart" conflict - resolution system, and it will attempt to upgrade the most important - packages at the expense of less important ones if necessary. - The <filename>/etc/apt/sources.list</> file contains a list of locations - from which to retrieve desired package files. - See also &apt-preferences; for a mechanism for - overriding the general settings for individual packages. - </VarListEntry> - - <VarListEntry><Term>install</Term> - <ListItem><Para> - <literal/install/ is followed by one or more packages desired for - installation. Each package is a package name, not a fully qualified - filename (for instance, in a Debian GNU/Linux system, libc6 would be the - argument provided, not <literal/libc6_1.9.6-2.deb/). All packages required - by the package(s) specified for installation will also be retrieved and - installed. The <filename>/etc/apt/sources.list</> file is used to locate - the desired packages. If a hyphen is appended to the package name (with - no intervening space), the identified package will be removed if it is - installed. Similarly a plus sign can be used to designate a package to - install. These latter features may be used to override decisions made by - apt-get's conflict resolution system. - <para> - A specific version of a package can be selected for installation by - following the package name with an equals and the version of the package - to select. This will cause that version to be located and selected for - install. Alternatively a specific distribution can be selected by - following the package name with a slash and the version of the - distribution or the Archive name (stable, testing, unstable). - <para> - Both of the version selection mechanisms can downgrade packages and must - be used with care. - <para> - Finally, the &apt-preferences; mechanism allows you to - create an alternative installation policy for - individual packages. - <para> - If no package matches the given expression and the expression contains one - of '.', '?' or '*' then it is assumed to be a POSIX regular expression, - and it is applied - to all package names in the database. Any matches are then installed (or - removed). Note that matching is done by substring so 'lo.*' matches 'how-lo' - and 'lowest'. If this is undesired, anchor the regular expression - with a '^' or '$' character, or create a more specific regular expression. - </VarListEntry> - - <VarListEntry><Term>remove</Term> - <ListItem><Para> - <literal/remove/ is identical to <literal/install/ except that packages are - removed instead of installed. If a plus sign is appended to the package - name (with no intervening space), the identified package will be - installed instead of removed. - </VarListEntry> - - <VarListEntry><Term>source</Term> - <ListItem><Para> - <literal/source/ causes <command/apt-get/ to fetch source packages. APT - will examine the available packages to decide which source package to - fetch. It will then find and download into the current directory the - newest available version of that source package. Source packages are - tracked separately from binary packages via <literal/deb-src/ type lines - in the &sources-list; file. This probably will mean that you will not - get the same source as the package you have installed or as you could - install. If the --compile options is specified then the package will be - compiled to a binary .deb using dpkg-buildpackage, if --download-only is - specified then the source package will not be unpacked. - <para> - A specific source version can be retrieved by postfixing the source name - with an equals and then the version to fetch, similar to the mechanism - used for the package files. This enables exact matching of the source - package name and version, implicitly enabling the - <literal/APT::Get::Only-Source/ option. - - <para> - Note that source packages are not tracked like binary packages, they - exist only in the current directory and are similar to downloading source - tar balls. - </VarListEntry> - - <VarListEntry><Term>build-dep</Term> - <ListItem><Para> - <literal/build-dep/ causes apt-get to install/remove packages in an - attempt to satisfy the build dependencies for a source package. - </VarListEntry> - - <VarListEntry><Term>check</Term> - <ListItem><Para> - <literal/check/ is a diagnostic tool; it updates the package cache and checks - for broken dependencies. - </VarListEntry> - - <VarListEntry><Term>clean</Term> - <ListItem><Para> - <literal/clean/ clears out the local repository of retrieved package - files. It removes everything but the lock file from - <filename>&cachedir;/archives/</> and - <filename>&cachedir;/archives/partial/</>. When APT is used as a - &dselect; method, <literal/clean/ is run automatically. - Those who do not use dselect will likely want to run <literal/apt-get clean/ - from time to time to free up disk space. - </VarListEntry> - - <VarListEntry><Term>autoclean</Term> - <ListItem><Para> - Like <literal/clean/, <literal/autoclean/ clears out the local - repository of retrieved package files. The difference is that it only - removes package files that can no longer be downloaded, and are largely - useless. This allows a cache to be maintained over a long period without - it growing out of control. The configuration option - <literal/APT::Clean-Installed/ will prevent installed packages from being - erased if it is set to off. - </VarListEntry> - </VariableList> - </RefSect1> - - <RefSect1><Title>Options</> - &apt-cmdblurb; - - <VariableList> - <VarListEntry><term><option/-d/</><term><option/--download-only/</> - <ListItem><Para> - Download only; package files are only retrieved, not unpacked or installed. - Configuration Item: <literal/APT::Get::Download-Only/. - </VarListEntry> - - <VarListEntry><term><option/-f/</><term><option/--fix-broken/</> - <ListItem><Para> - Fix; attempt to correct a system with broken dependencies in - place. This option, when used with install/remove, can omit any packages - to permit APT to deduce a likely solution. Any Package that are specified - must completely correct the problem. The option is sometimes necessary when - 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 <command/dpkg --remove/ to eliminate some of - the offending packages). Use of this option together with <option/-m/ may produce an - error in some situations. - Configuration Item: <literal/APT::Get::Fix-Broken/. - </VarListEntry> - - <VarListEntry><term><option/-m/</><term><option/--ignore-missing/</> - <term><option/--fix-missing/</> - <ListItem><Para> - Ignore missing packages; If packages cannot be retrieved or fail the - integrity check after retrieval (corrupted package files), hold back - those packages and handle the result. Use of this option together with - <option/-f/ may produce an error in some situations. If a package is - selected for installation (particularly if it is mentioned on the - command line) and it could not be downloaded then it will be silently - held back. - Configuration Item: <literal/APT::Get::Fix-Missing/. - </VarListEntry> - - <VarListEntry><term><option/--no-download/</> - <ListItem><Para> - Disables downloading of packages. This is best used with - <option/--ignore-missing/ to force APT to use only the .debs it has - already downloaded. - Configuration Item: <literal/APT::Get::Download/. - </VarListEntry> - - <VarListEntry><term><option/-q/</><term><option/--quiet/</> - <ListItem><Para> - Quiet; produces output suitable for logging, omitting progress indicators. - More q's will produce more quiet up to a maximum of 2. You can also use - <option/-q=#/ to set the quiet level, overriding the configuration file. - Note that quiet level 2 implies <option/-y/, you should never use -qq - without a no-action modifier such as -d, --print-uris or -s as APT may - decided to do something you did not expect. - Configuration Item: <literal/quiet/. - </VarListEntry> - - <VarListEntry><term><option/-s/</> - <term><option/--simulate/</> - <term><option/--just-print/</> - <term><option/--dry-run/</> - <term><option/--recon/</> - <term><option/--no-act/</> - <ListItem><Para> - No action; perform a simulation of events that would occur but do not - actually change the system. - Configuration Item: <literal/APT::Get::Simulate/. - <para> - Simulate prints out - a series of lines each one representing a dpkg operation, Configure (Conf), - Remove (Remv), Unpack (Inst). Square brackets indicate broken packages with - and empty set of square brackets meaning breaks that are of no consequence - (rare). - </VarListEntry> - - <VarListEntry><term><option/-y/</><term><option/--yes/</> - <term><option/--assume-yes/</> - <ListItem><Para> - Automatic yes to prompts; assume "yes" as answer to all prompts and run - non-interactively. If an undesirable situation, such as changing a held - package or removing an essential package occurs then <literal/apt-get/ - will abort. - Configuration Item: <literal/APT::Get::Assume-Yes/. - </VarListEntry> - - <VarListEntry><term><option/-u/</><term><option/--show-upgraded/</> - <ListItem><Para> - Show upgraded packages; Print out a list of all packages that are to be - upgraded. - Configuration Item: <literal/APT::Get::Show-Upgraded/. - </VarListEntry> - - <VarListEntry><term><option/-V/</><term><option/--verbose-versions/</> - <ListItem><Para> - Show full versions for upgraded and installed packages. - Configuration Item: <literal/APT::Get::Show-Versions/. - </VarListEntry> - - <VarListEntry><term><option/-b/</><term><option/--compile/</> - <term><option/--build/</> - <ListItem><Para> - Compile source packages after downloading them. - Configuration Item: <literal/APT::Get::Compile/. - </VarListEntry> - - <VarListEntry><term><option/--ignore-hold/</> - <ListItem><Para> - Ignore package Holds; This causes <command/apt-get/ to ignore a hold - placed on a package. This may be useful in conjunction with - <literal/dist-upgrade/ to override a large number of undesired holds. - Configuration Item: <literal/APT::Ignore-Hold/. - </VarListEntry> - - <VarListEntry><term><option/--no-upgrade/</> - <ListItem><Para> - - Do not upgrade packages; When used in conjunction with - <literal/install/, <literal/no-upgrade/ will prevent packages - listed on the command linefrom being upgraded if they are already - installed. - - Configuration Item: <literal/APT::Get::Upgrade/. - </VarListEntry> - - <VarListEntry><term><option/--force-yes/</> - <ListItem><Para> - 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 - <literal/force-yes/ can potentially destroy your system! - Configuration Item: <literal/APT::Get::force-yes/. - </VarListEntry> - - <VarListEntry><term><option/--print-uris/</> - <ListItem><Para> - Instead of fetching the files to install their URIs are printed. Each - URI will have the path, the destination file name, the size and the expected - md5 hash. Note that the file name to write to will not always match - the file name on the remote site! This also works with the - <literal/source/ and <literal/update/ commands. When used with the - <literal/update/ command the MD5 and size are not included, and it is - up to the user to decompress any compressed files. - Configuration Item: <literal/APT::Get::Print-URIs/. - </VarListEntry> - - <VarListEntry><term><option/--purge/</> - <ListItem><Para> - Use purge instead of remove for anything that would be removed. - An asterisk ("*") will be displayed next to packages which are - scheduled to be purged. - Configuration Item: <literal/APT::Get::Purge/. - </VarListEntry> - - <VarListEntry><term><option/--reinstall/</> - <ListItem><Para> - Re-Install packages that are already installed and at the newest version. - Configuration Item: <literal/APT::Get::ReInstall/. - </VarListEntry> - - <VarListEntry><term><option/--list-cleanup/</> - <ListItem><Para> - This option defaults to on, use <literal/--no-list-cleanup/ to turn it - off. When on <command/apt-get/ will automatically manage the contents of - <filename>&statedir;/lists</> to ensure that obsolete files are erased. - The only reason to turn it off is if you frequently change your source - list. - Configuration Item: <literal/APT::Get::List-Cleanup/. - </VarListEntry> - - <VarListEntry><term><option/-t/</> - <term><option/--target-release/</> - <term><option/--default-release/</> - <ListItem><Para> - This option controls the default input to the policy engine, it creates - a default pin at priority 990 using the specified release string. The - preferences file may further override this setting. In short, this option - lets you have simple control over which distribution packages will be - retrieved from. Some common examples might be - <option>-t '2.1*'</> or <option>-t unstable</>. - Configuration Item: <literal/APT::Default-Release/; - see also the &apt-preferences; manual page. - </VarListEntry> - - <VarListEntry><term><option/--trivial-only/</> - <ListItem><Para> - Only perform operations that are 'trivial'. Logically this can be considered - related to <option/--assume-yes/, where <option/--assume-yes/ will answer - yes to any prompt, <option/--trivial-only/ will answer no. - Configuration Item: <literal/APT::Get::Trivial-Only/. - </VarListEntry> - - <VarListEntry><term><option/--no-remove/</> - <ListItem><Para> - If any packages are to be removed apt-get immediately aborts without - prompting. - Configuration Item: <literal/APT::Get::Remove/ - </VarListEntry> - - <VarListEntry><term><option/--only-source/</> - <ListItem><Para> - Only has meaning for the <literal/source/ command. Indicates that the - given source names are not to be mapped through the binary - table. This means that if this option is specified, the - <literal/source/ command will only accept source package names as - arguments, rather than accepting binary package names and looking - up the corresponding source package. - Configuration Item: <literal/APT::Get::Only-Source/ - </VarListEntry> - - <VarListEntry><term><option/--diff-only/</><term><option/--tar-only/</> - <ListItem><Para> - Download only the diff or tar file of a source archive. - Configuration Item: <literal/APT::Get::Diff-Only/ and - <literal/APT::Get::Tar-Only/ - </VarListEntry> - - <VarListEntry><term><option/--arch-only/</> - <ListItem><Para> - Only process architecture-dependent build-dependencies. - Configuration Item: <literal/APT::Get::Arch-Only/ - </VarListEntry> - - &apt-commonoptions; - - </VariableList> - </RefSect1> - - <RefSect1><Title>Files</> - <variablelist> - <VarListEntry><term><filename>/etc/apt/sources.list</></term> - <ListItem><Para> - Locations to fetch packages from. - Configuration Item: <literal/Dir::Etc::SourceList/. - </VarListEntry> - - <VarListEntry><term><filename>/etc/apt/apt.conf</></term> - <ListItem><Para> - APT configuration file. - Configuration Item: <literal/Dir::Etc::Main/. - </VarListEntry> - - <VarListEntry><term><filename>/etc/apt/apt.conf.d/</></term> - <ListItem><Para> - APT configuration file fragments - Configuration Item: <literal/Dir::Etc::Parts/. - </VarListEntry> - - <VarListEntry><term><filename>/etc/apt/preferences</></term> - <ListItem><Para> - Version preferences file. - This is where you would specify "pinning", - i.e. a preference to get certain packages - from a separate source - or from a different version of a distribution. - Configuration Item: <literal/Dir::Etc::Preferences/. - </VarListEntry> - - <VarListEntry><term><filename>&cachedir;/archives/</></term> - <ListItem><Para> - Storage area for retrieved package files. - Configuration Item: <literal/Dir::Cache::Archives/. - </VarListEntry> - - <VarListEntry><term><filename>&cachedir;/archives/partial/</></term> - <ListItem><Para> - Storage area for package files in transit. - Configuration Item: <literal/Dir::Cache::Archives/ (implicit partial). - </VarListEntry> - - <VarListEntry><term><filename>&statedir;/lists/</></term> - <ListItem><Para> - Storage area for state information for each package resource specified in - &sources-list; - Configuration Item: <literal/Dir::State::Lists/. - </VarListEntry> - - <VarListEntry><term><filename>&statedir;/lists/partial/</></term> - <ListItem><Para> - Storage area for state information in transit. - Configuration Item: <literal/Dir::State::Lists/ (implicit partial). - </VarListEntry> - </variablelist> - </RefSect1> - - <RefSect1><Title>See Also</> - <para> - &apt-cache;, &apt-cdrom;, &dpkg;, &dselect;, &sources-list;, - &apt-conf;, &apt-config;, - The APT User's guide in &docdir;, &apt-preferences;, the APT Howto. - </RefSect1> - - <RefSect1><Title>Diagnostics</> - <para> - <command/apt-get/ returns zero on normal operation, decimal 100 on error. - </RefSect1> - - &manbugs; - &manauthor; - -</refentry> |