← Back to branch summary

~ubuntu-branches/debian/jessie/apt/jessie

« back to all changes in this revision

Viewing changes to doc/en/apt-mark.8

  • Committer: Package Import Robot
  • Author(s): Michael Vogt, Michael Vogt, Trần Ngọc Quân, Chris Leick, Mert Dirik
  • Date: 2014-09-16 20:52:25 UTC
  • Revision ID: package-import@ubuntu.com-20140916205225-8i75g4aqjb3ycour
Tags: 1.0.9.1
http://bugs.debian.org/759264
http://bugs.debian.org/761394
[ Michael Vogt ]
* Allow override of Proxy-Auto-Detect by the users configuration
  (Closes: 759264)
* fix ci autopkgtest
* fix regression from 1.0.9 when file:/// source are used and
  those are on a different partition than the apt state directory
  and add regression test

[ Trần Ngọc Quân ]
* l10n: vi.po (636t): Update program translation

[ Chris Leick ]
* Updated German documentation translation

[ Mert Dirik ]
* Turkish program translation update (Closes: 761394)

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/apt-mark.8
1
 
'\" t
2
 
.\"     Title: apt-mark
3
 
.\"    Author: Mike O\*(AqConnor
4
 
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
5
 
.\"      Date: 09\ \&June\ \&2012
6
 
.\"    Manual: APT
7
 
.\"    Source: APT 1.0.8
8
 
.\"  Language: English
9
 
.\"
10
 
.TH "APT\-MARK" "8" "09\ \&June\ \&2012" "APT 1.0.8" "APT"
11
 
.\" -----------------------------------------------------------------
12
 
.\" * Define some portability stuff
13
 
.\" -----------------------------------------------------------------
14
 
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15
 
.\" http://bugs.debian.org/507673
16
 
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17
 
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
18
 
.ie \n(.g .ds Aq \(aq
19
 
.el       .ds Aq '
20
 
.\" -----------------------------------------------------------------
21
 
.\" * set default formatting
22
 
.\" -----------------------------------------------------------------
23
 
.\" disable hyphenation
24
 
.nh
25
 
.\" disable justification (adjust text to left margin only)
26
 
.ad l
27
 
.\" -----------------------------------------------------------------
28
 
.\" * MAIN CONTENT STARTS HERE *
29
 
.\" -----------------------------------------------------------------
30
 
.SH "NAME"
31
 
apt-mark \- mark/unmark a package as being automatically\-installed
32
 
.SH "SYNOPSIS"
33
 
.HP \w'\fBapt\-mark\fR\ 'u
34
 
\fBapt\-mark\fR [\fB\-f=\fR\fB\fIfilename\fR\fR] {auto\ |\ manual\ |\ showauto\ |\ showmanual}\ \fIpkg\fR...  | {\-v\ |\ \-\-version} | {\-h\ |\ \-\-help} 
35
 
.SH "DESCRIPTION"
36
 
.PP
37
 
\fBapt\-mark\fR
38
 
will change whether a package has been marked as being automatically installed\&.
39
 
.PP
40
 
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\&.
41
 
\fBapt\-get\fR
42
 
or
43
 
\fBaptitude\fR\&.
44
 
.PP
45
 
\fBauto\fR
46
 
.RS 4
47
 
auto
48
 
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\&.
49
 
.RE
50
 
.PP
51
 
\fBmanual\fR
52
 
.RS 4
53
 
manual
54
 
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\&.
55
 
.RE
56
 
.PP
57
 
\fBhold\fR
58
 
.RS 4
59
 
hold
60
 
is used to mark a package as held back, which will prevent the package from being automatically installed, upgraded or removed\&. The command is only a wrapper around
61
 
\fBdpkg \-\-set\-selections\fR
62
 
and the state is therefore maintained by
63
 
\fBdpkg\fR(1)
64
 
and not affected by the
65
 
\fB\-\-file\fR
66
 
option\&.
67
 
.RE
68
 
.PP
69
 
\fBunhold\fR
70
 
.RS 4
71
 
unhold
72
 
is used to cancel a previously set hold on a package to allow all actions again\&.
73
 
.RE
74
 
.PP
75
 
\fBshowauto\fR
76
 
.RS 4
77
 
showauto
78
 
is used to print a 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\&.
79
 
.RE
80
 
.PP
81
 
\fBshowmanual\fR
82
 
.RS 4
83
 
showmanual
84
 
can be used in the same way as
85
 
showauto
86
 
except that it will print a list of manually installed packages instead\&.
87
 
.RE
88
 
.PP
89
 
\fBshowhold\fR
90
 
.RS 4
91
 
showhold
92
 
is used to print a list of packages on hold in the same way as for the other show commands\&.
93
 
.RE
94
 
.SH "OPTIONS"
95
 
.PP
96
 
\fB\-f=\fR\fB\fIfilename\fR\fR, \fB\-\-file=\fR\fB\fIfilename\fR\fR
97
 
.RS 4
98
 
Read/Write package stats from the filename given with the parameter
99
 
\fIfilename\fR
100
 
instead of from the default location, which is
101
 
extended_status
102
 
in the directory defined by the Configuration Item:
103
 
Dir::State\&.
104
 
.RE
105
 
.PP
106
 
\fB\-h\fR, \fB\-\-help\fR
107
 
.RS 4
108
 
Show a short usage summary\&.
109
 
.RE
110
 
.PP
111
 
\fB\-v\fR, \fB\-\-version\fR
112
 
.RS 4
113
 
Show the program version\&.
114
 
.RE
115
 
.PP
116
 
\fB\-c\fR, \fB\-\-config\-file\fR
117
 
.RS 4
118
 
Configuration File; Specify a configuration file to use\&. The program will read the default configuration file and then this configuration file\&. If configuration settings need to be set before the default configuration files are parsed specify a file with the
119
 
\fBAPT_CONFIG\fR
120
 
environment variable\&. See
121
 
\fBapt.conf\fR(5)
122
 
for syntax information\&.
123
 
.RE
124
 
.PP
125
 
\fB\-o\fR, \fB\-\-option\fR
126
 
.RS 4
127
 
Set a Configuration Option; This will set an arbitrary configuration option\&. The syntax is
128
 
\fB\-o Foo::Bar=bar\fR\&.
129
 
\fB\-o\fR
130
 
and
131
 
\fB\-\-option\fR
132
 
can be used multiple times to set different options\&.
133
 
.RE
134
 
.SH "FILES"
135
 
.PP
136
 
/var/lib/apt/extended_states
137
 
.RS 4
138
 
Status list of auto\-installed packages\&. Configuration Item:
139
 
Dir::State::extended_states\&.
140
 
.RE
141
 
.SH "SEE ALSO"
142
 
.PP
143
 
\fBapt-get\fR(8),\fBaptitude\fR(8),\fBapt.conf\fR(5)
144
 
.SH "DIAGNOSTICS"
145
 
.PP
146
 
\fBapt\-mark\fR
147
 
returns zero on normal operation, non\-zero on error\&.
148
 
.SH "BUGS"
149
 
.PP
150
 
\m[blue]\fBAPT bug page\fR\m[]\&\s-2\u[1]\d\s+2\&. If you wish to report a bug in APT, please see
151
 
/usr/share/doc/debian/bug\-reporting\&.txt
152
 
or the
153
 
\fBreportbug\fR(1)
154
 
command\&.
155
 
.SH "AUTHORS"
156
 
.PP
157
 
\fBMike O\*(AqConnor\fR
158
 
.RS 4
159
 
.RE
160
 
.PP
161
 
\fBAPT team\fR
162
 
.RS 4
163
 
.RE
164
 
.SH "NOTES"
165
 
.IP " 1." 4
166
 
APT bug page
167
 
.RS 4
168
 
\%http://bugs.debian.org/src:apt
169
 
.RE