Commit | Line | Data |
---|---|---|
75a3362b OS |
1 | <?xml version="1.0" encoding="utf-8" standalone="no"?> |
2 | <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" | |
3 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [ | |
4 | ||
5 | <!ENTITY % aptent SYSTEM "apt.ent"> | |
6 | %aptent; | |
7 | ||
0c1a7101 DK |
8 | <!ENTITY % aptverbatiment SYSTEM "apt-verbatim.ent"> |
9 | %aptverbatiment; | |
10 | ||
75a3362b OS |
11 | ]> |
12 | ||
13 | <refentry> | |
14 | ||
15 | <refentryinfo> | |
16 | &apt-author.moconnor; | |
17 | &apt-author.team; | |
18 | &apt-email; | |
19 | &apt-product; | |
20 | <!-- The last update date --> | |
b40f2c3b | 21 | <date>21 April 2011</date> |
75a3362b OS |
22 | </refentryinfo> |
23 | ||
24 | <refmeta> | |
25 | <refentrytitle>apt-mark</refentrytitle> | |
26 | <manvolnum>8</manvolnum> | |
f0599b9c | 27 | <refmiscinfo class="manual">APT</refmiscinfo> |
75a3362b OS |
28 | </refmeta> |
29 | ||
30 | <!-- Man page title --> | |
31 | <refnamediv> | |
32 | <refname>apt-mark</refname> | |
62b17f74 | 33 | <refpurpose>mark/unmark a package as being automatically-installed</refpurpose> |
75a3362b OS |
34 | </refnamediv> |
35 | ||
36 | <!-- Arguments --> | |
37 | <refsynopsisdiv> | |
38 | <cmdsynopsis> | |
b2fa014b DK |
39 | <command>apt-mark</command> |
40 | <arg><option>-hv</option></arg> | |
41 | <arg><option>-f=<replaceable>FILENAME</replaceable></option></arg> | |
42 | <group choice="plain"> | |
43 | <arg choice="plain"> | |
44 | <group choice="req"> | |
b40f2c3b DK |
45 | <arg choice="plain">auto</arg> |
46 | <arg choice="plain">manual</arg> | |
47 | <arg choice="plain">showauto</arg> | |
48 | <arg choice="plain">showmanual</arg> | |
b2fa014b DK |
49 | </group> |
50 | <arg choice="plain" rep="repeat"><replaceable>package</replaceable></arg> | |
51 | </arg> | |
b2fa014b | 52 | </group> |
75a3362b OS |
53 | </cmdsynopsis> |
54 | </refsynopsisdiv> | |
55 | ||
56 | <refsect1><title>Description</title> | |
57 | <para><command>apt-mark</command> will change whether a package has | |
58 | been marked as being automatically installed. | |
59 | </para> | |
60 | <para> | |
61 | When you request that a package is installed, and as a result | |
62 | other packages are installed to satisfy its dependencies, the | |
e3a1f08d | 63 | dependencies are marked as being automatically installed. Once |
75a3362b | 64 | these automatically installed packages are no longer depended on |
b2fa014b DK |
65 | by any manually installed packages, they will be removed by e.g. |
66 | <command>apt-get</command> or <command>aptitude</command>. | |
75a3362b OS |
67 | </para> |
68 | <variablelist> | |
b40f2c3b DK |
69 | <varlistentry><term>auto</term> |
70 | <listitem><para><literal>auto</literal> is used to mark a | |
75a3362b OS |
71 | package as being automatically installed, which will cause the |
72 | package to be removed when no more manually installed packages | |
73 | depend on this package. | |
74 | </para></listitem> | |
75 | </varlistentry> | |
76 | ||
b40f2c3b DK |
77 | <varlistentry><term>manual</term> |
78 | <listitem><para><literal>manual</literal> is used to mark a | |
75a3362b OS |
79 | package as being manually installed, which will prevent the |
80 | package from being automatically removed if no other packages | |
81 | depend on it. | |
82 | </para></listitem> | |
83 | </varlistentry> | |
b2fa014b DK |
84 | |
85 | <varlistentry><term>showauto</term> | |
86 | <listitem><para><literal>showauto</literal> is used to print a | |
5632b305 | 87 | list of automatically installed packages with each package on a new line. |
b40f2c3b DK |
88 | All automatically installed packages will be listed if no package is given. |
89 | If packages are given only those which are automatically installed will be shown. | |
b2fa014b DK |
90 | </para></listitem> |
91 | </varlistentry> | |
b40f2c3b DK |
92 | |
93 | <varlistentry><term>showmanual</term> | |
94 | <listitem><para><literal>showmanual</literal> can be used in | |
95 | the same way as <literal>showauto</literal> except that it will print | |
96 | a list of manually installed packages instead. | |
97 | </para></listitem> | |
98 | </varlistentry> | |
99 | ||
75a3362b OS |
100 | </variablelist> |
101 | </refsect1> | |
102 | ||
103 | <refsect1><title>options</title> | |
104 | ||
105 | <variablelist> | |
b2fa014b DK |
106 | <varlistentry> |
107 | <term><option>-f=<filename><replaceable>FILENAME</replaceable></filename></option></term> | |
108 | <term><option>--file=<filename><replaceable>FILENAME</replaceable></filename></option></term> | |
75a3362b OS |
109 | <listitem><para> |
110 | ||
b2fa014b | 111 | Read/Write package stats from <filename><replaceable>FILENAME</replaceable></filename> |
75a3362b OS |
112 | instead of the default location, which |
113 | is <filename>extended_status</filename> in the directory defined | |
114 | by the Configuration Item: <literal>Dir::State</literal>.</para></listitem> | |
115 | </varlistentry> | |
75a3362b | 116 | |
b40f2c3b | 117 | &apt-commonoptions; |
75a3362b OS |
118 | </variablelist> |
119 | </refsect1> | |
120 | ||
b2fa014b DK |
121 | <refsect1><title>Files</title> |
122 | <variablelist> | |
d34690e1 | 123 | &file-extended_states; |
b2fa014b DK |
124 | </variablelist> |
125 | </refsect1> | |
126 | ||
75a3362b | 127 | <refsect1><title>See Also</title> |
b2fa014b | 128 | <para>&apt-get;,&aptitude;,&apt-conf;</para> |
75a3362b OS |
129 | </refsect1> |
130 | ||
131 | <refsect1><title>Diagnostics</title> | |
132 | <para><command>apt-mark</command> returns zero on normal operation, non-zero on error.</para> | |
133 | </refsect1> | |
134 | ||
135 | &manbugs; | |
136 | ||
137 | </refentry> |