X-Git-Url: https://git.saurik.com/apt.git/blobdiff_plain/b43af876ed0901eabfb7fe93276eb9272cacf22d..dd47e21814291e965be6da73331f28dc695ce489:/doc/apt-mark.8.xml diff --git a/doc/apt-mark.8.xml b/doc/apt-mark.8.xml index 35412d7c9..ddde0416f 100644 --- a/doc/apt-mark.8.xml +++ b/doc/apt-mark.8.xml @@ -1,10 +1,9 @@ - -%aptent; - + %aptent; + %aptverbatiment; + %aptvendor; ]> @@ -15,7 +14,7 @@ &apt-email; &apt-product; - 9 August 2009 + 2015-09-25T00:00:00Z @@ -27,111 +26,124 @@ apt-mark - mark/unmark a package as being automatically-installed + show, set and unset various settings for a package - - - - apt-mark - - - - - - markauto - unmarkauto - - package - - showauto - - - - + &synopsis-command-apt-mark; + Description - apt-mark will change whether a package has - been marked as being automatically installed. + apt-mark can be used as a unified front-end to set + various settings for a package, such as marking a package as being + automatically/manually installed or changing dpkg + selections such as hold, install, deinstall and purge which are respected + e.g. by apt-get dselect-upgrade or aptitude. + Automatically and Manually Installed Packages When you request that a package is installed, and as a result other packages are installed to satisfy its dependencies, the - dependencies are marked as being automatically installed. Once - these automatically installed packages are no longer depended on - by any manually installed packages, they will be removed by e.g. - apt-get or aptitude. + dependencies are marked as being automatically installed, while the + package you installed explicitly is marked as manually installed. + Once an automatically installed package is no longer depended on + by any manually installed package it is considered no longer needed + and e.g. apt-get or aptitude + will at least suggest removing them. - - markauto - markauto is used to mark a + + + auto is used to mark a package as being automatically installed, which will cause the package to be removed when no more manually installed packages depend on this package. - + - unmarkauto - unmarkauto is used to mark a + + manual is used to mark a package as being manually installed, which will prevent the package from being automatically removed if no other packages depend on it. - + - showauto + showauto is used to print a - list of manually installed packages with each package on a new line. + list of automatically installed packages with each package on a new line. + All automatically installed packages will be listed if no package is given. + If packages are given only those which are automatically installed will be shown. + + + + showmanual can be used in + the same way as showauto except that it will print + a list of manually installed packages instead. + + + + + Options + + + + + + Read/Write package stats from the filename given with the parameter + &synopsis-param-filename; instead of from the default location, which + is extended_status in the directory defined + by the Configuration Item: Dir::State. + - - - options - + + + Prevent Changes for a Package - - - - - - Read/Write package stats from FILENAME - instead of the default location, which - is extended_status in the directory defined - by the Configuration Item: Dir::State. + + hold is used to mark a + package as held back, which will prevent the package from being + automatically installed, upgraded or removed. + - - - - Show a short usage summary. - - + + + unhold is used to cancel a + previously set hold on a package to allow all actions again. + - - - - - Show the program version. - - + + + showhold is used to print a list + of packages on hold in the same way as for the other show commands. + + + Schedule Packages for Install, Remove and Purge + + Some front-ends like apt-get dselect-upgrade can be used to + apply previously scheduled changes to the install state of packages. Such changes + can be scheduled with the , + (also known as ) and commands. + Packages with a specific selection can be displayed with , + and respectively. + More information about these so called dpkg selections can be found in &dpkg;. + + - + Options + + &apt-commonoptions; Files - /var/lib/apt/extended_states - Status list of auto-installed packages. - Configuration Item: Dir::State - sets the path to the extended_states file. - - + &file-extended_states; See Also - &apt-get;,&aptitude;,&apt-conf; + &apt-get;,&aptitude;,&apt-conf; Diagnostics