1APT-MARK(8) APT APT-MARK(8)
2
6 apt-mark - show, set and unset various settings for a package
7
9 apt-mark {-f=filename | {auto | manual} pkg... |
10 {showauto | showmanual} [pkg...] } | {-v | --version} |
11 {-h | --help}
12 apt-mark {hold | unhold | install | remove | purge} pkg... |
14 {showhold | showinstall | showremove | showpurge} [pkg...]
15
17 apt-mark can be used as a unified front-end to set various settings for
18 a package, such as marking a package as being automatically/manually
19 installed or changing dpkg selections such as hold, install, deinstall
20 and purge which are respected e.g. by apt-get dselect-upgrade or
21 aptitude.
22
24 When you request that a package is installed, and as a result other
25 packages are installed to satisfy its dependencies, the dependencies
26 are marked as being automatically installed, while the package you
27 installed explicitly is marked as manually installed. Once an
28 automatically installed package is no longer depended on by any
29 manually installed package it is considered no longer needed and e.g.
30 apt-get or aptitude will at least suggest removing them.
31 auto
33 auto is used to mark a package as being automatically installed,
34 which will cause the package to be removed when no more manually
35 installed packages depend on this package.
36 manual
38 manual is used to mark a package as being manually installed, which
39 will prevent the package from being automatically removed if no
40 other packages depend on it.
41 minimize-manual
43 minimize-manual is used to mark (transitive) dependencies of
44 metapackages as automatically installed. This can be used after an
45 installation for example, to minimize the number of manually
46 installed packages; or continuously on systems managed by system
47 configuration metapackages.
48 showauto
50 showauto is used to print a list of automatically installed
51 packages with each package on a new line. All automatically
52 installed packages will be listed if no package is given. If
53 packages are given only those which are automatically installed
54 will be shown.
55 showmanual
57 showmanual can be used in the same way as showauto except that it
58 will print a list of manually installed packages instead.
59 Options
61 -f=filename, --file=filename
62 Read/Write package stats from the filename given with the parameter
63 filename instead of from the default location, which is
64 extended_states in the directory defined by the Configuration Item:
65 Dir::State.
66
68 hold
69 hold is used to mark a package as held back, which will prevent the
70 package from being automatically installed, upgraded or removed.
71 unhold
73 unhold is used to cancel a previously set hold on a package to
74 allow all actions again.
75 showhold
77 showhold is used to print a list of packages on hold in the same
78 way as for the other show commands.
79
81 Some front-ends like apt-get dselect-upgrade can be used to apply
82 previously scheduled changes to the install state of packages. Such
83 changes can be scheduled with the install, remove (also known as
84 deinstall) and purge commands. Packages with a specific selection can
85 be displayed with showinstall, showremove and showpurge respectively.
86 More information about these so called dpkg selections can be found in
87 dpkg(1).
88
90 -h, --help
91 Show a short usage summary.
92 -v, --version
94 Show the program version.
95 -c, --config-file
97 Configuration File; Specify a configuration file to use. The
98 program will read the default configuration file and then this
99 configuration file. If configuration settings need to be set before
100 the default configuration files are parsed specify a file with the
101 APT_CONFIG environment variable. See apt.conf(5) for syntax
102 information.
103 -o, --option
105 Set a Configuration Option; This will set an arbitrary
106 configuration option. The syntax is -o Foo::Bar=bar. -o and
107 --option can be used multiple times to set different options.
108
110 /var/lib/apt/extended_states
111 Status list of auto-installed packages. Configuration Item:
112 Dir::State::extended_states.
113
115 apt-get(8),aptitude(8),apt.conf(5)
116
118 apt-mark returns zero on normal operation, non-zero on error.
119
121 APT bug page[1]. If you wish to report a bug in APT, please see
122 /usr/share/doc/debian/bug-reporting.txt or the reportbug(1) command.
123
125 Mike O'Connor
126 APT team
128
130 1. APT bug page
131 http://bugs.debian.org/src:apt
132APT 2.5.5 11 December 2018 APT-MARK(8)