Penguin
Recent Changes
Annotated edit history of aptitude(1) version 4, including all changes. View license author blame.
Rev Author # Line
1 perry 1 APTITUDE
2 !!!APTITUDE
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 COMMAND-LINE ACTIONS
7 OPTIONS
8 INTERACTIVE USAGE
9 SEE ALSO
10 AUTHOR
11 ----
12 !!NAME
13
14
15 aptitude - high-level interface to the package manager.
16 !!SYNOPSIS
17
18
19 __aptitude [[ -S__ ''fname'' __] [[ -u | -i
20 ]__
21
22
23 __aptitude [[__ ''options'' __] [[ update | upgrade |
24 forget-new | clean | autoclean ]__
25
26
27 __aptitude [[__ ''options'' __] [[ remove | hold |
28 purge | markauto | unmarkauto | dist-upgrade ]
29 packages...__
30
31
32 __aptitude [[__ ''options'' __] search
33 patterns...__
34
35
36 __aptitude [[__ ''options'' __] download
37 packages...__
38 !!DESCRIPTION
39
40
41 __aptitude__ is a text-based interface to the Debian
42 GNU/Linux package system.
43
44
45 It allows the user to view the list of packages and to
46 perform package management tasks such as installing,
47 upgrading, and removing packages. Actions may be performed
48 from an
49 !!COMMAND-LINE ACTIONS
50
51
52 The first argument which does not begin with a hyphen
53 (
54
55
56 The following actions are available:
57
58
59 __install__
60
61
62 Install one or more packages. The packages should be listed
63 after the
64 /usr/share/doc/aptitude/README__)
65
66
67 Appending
68
69
70 As a special case,
71
72
73 NOTE: The
74
75
76 __remove, purge, hold__
77
78
79 These commands are the same as
80
81
82 (for instance,
83
84
85 __markauto, unmarkauto__
86
87
88 Mark packages as automatically installed or manually
89 installed, respectively. You may specify packages using the
90 same syntax as before, including specifying actions to be
91 performed. For instance,
92
93
94 __update__
95
96
97 Update the list of available packages from the master
98 servers. (this is equivalent to
99
100
101 __upgrade__
102
103
104 Upgrades installed packages to their most recent version.
105 Installed packages will not be removed unless they are
106 unused; packages which are not currently installed will not
107 be installed.
108
109
110 If a package cannot be upgraded without violating these
111 constraints, it will be kept back.
112
113
114 __forget-new__
115
116
117 Forgets which packages are
118
119
120 __search__
121
122
123 Searches for packages matching one or more expressions. The
124 expressions should be listed after the
125 /usr/share/doc/aptitude/README__.
126
127
128 __clean__
129
130
131 Removes all downloaded and cached packages.
132
133
134 __autoclean__
135
136
137 Removes any cached packages which are no longer
138 downloadable.
139
140
141 __download__
142
143
144 Downloads the .deb file for the most recent version of the
145 given package to the current directory.
146
147
148 The following hyphened arguments function as actions for the
149 interactive mode of the program; however, they are only used
150 internally. Generally, you shouldn't need to set these
151 yourself.
152
153
154 __-S__ ''fname''
155
156
157 Loads the extended state information from
158 ''fname''.
159
160
161 __-u__
162
163
164 Begins updating the package lists when the program starts.
165 You cannot use this option and __-i__ at the same
166 time.
167
168
169 __-i__
170
171
172 Displays a download screen when the program starts
173 (equivalent to starting the program and then pressing 'g')
174 You cannot use this option and __-u__ at the same
175 time.
176 !!OPTIONS
177
178
179 The following options may be specified to modify the
180 behavior of the above commands. Note that not every command
181 will pay attention to every option (indeed; many options are
182 nonsensical for one or more commands)
183
184
185 Many of these options have an associated configuration file
186 directive; placing this directive in /etc/apt/apt.conf or
187 ~/.aptitude/config will cause aptitude to always act as if
188 the option had been provided.
189
190
191 __-h, --help__
192
193
194 Display a brief help message.
195
196
197 __--version__
198
199
200 Display the version of aptitude and some information about
201 its compilation environment.
202
203
204 __-s, --simulate__
205
206
207 Print the actions that would be performed, but don't
208 actually perform them. This does not require root
209 privileges.
210
211
212 Configuration Item:
3 perry 213 Aptitude::!CmdLine::Simulate.
1 perry 214
215
216 __-d, --download-only__
217
218
219 Do not install or remove any packages; only download
220 them.
221
222
223 Configuration Item:
3 perry 224 Aptitude::!CmdLine::Download-Only
1 perry 225
226
227 __-P, --prompt__
228
229
230 Always display a prompt, even if no additional actions are
231 to be undertaken.
232
233
234 Configuration Item:
3 perry 235 Aptitude::!CmdLine::Always-Prompt
1 perry 236
237
238 __-y, --assume-yes__
239
240
241 Assume
242
243
244 Configuration Item:
3 perry 245 Aptitude::!CmdLine::Assume-Yes
1 perry 246
247
248 __-F__ ''format''__, --display-format__
249 ''format''
250
251
252 Specify the format which should be used to display output
253 from the __search__ command. For instance, '%p %V %v'
254 will display a package's name, followed by its currently
255 installed version and its available version. (see the
256 section
257 __
258
259
260 Configuration Item:
3 perry 261 Aptitude::!CmdLine::Package-Display-Format
1 perry 262
263
264 __-w__ ''width''__, --width__
265 ''width''
266
267
268 Specify the display width which should be used for output
269 from the __search__ command. (by default, the terminal
270 width is used)
271
272
273 Configuration Item:
3 perry 274 Aptitude::!CmdLine::Package-Display-Width
1 perry 275
276
277 __-f__
278
279
280 Aggressively try to fix dependencies of broken
281 packages.
282
283
284 Configuration Item:
3 perry 285 Aptitude::!CmdLine::Fix-Broken
1 perry 286
287
288 __--with-recommends, --with-suggests__
289
290
291 Treat recommends or suggests, respectively, as dependencies
292 when installing new packages. (this overrides settings in
293 /etc/apt/apt.conf and ~/.aptitude/config)
294
295
296 Configuration Item:
297 Aptitude::Recommends-Important
298
299
300 __--without-recommends, --without-suggests__
301
302
303 Do not treat recommends or suggests, respectively, as
304 dependencies when installing packages.
305
306
307 Configuration Item:
308 Aptitude::Suggests-Important
309 !!INTERACTIVE USAGE
310
311
312 In interactive mode, aptitude makes the following keys and
313 commands available:
314
315
316 __q__
317
318
319 Quit the current context, saving changes.
320
321
322 __x__
323
324
325 Quit the current context, discarding changes.
326
327
328 __?__
329
330
331 Display an online help screen.
332
333
334 __Up, j__
335
336
337 Move the selection one item up.
338
339
340 __Down, k__
341
342
343 Move the selection one item down.
344
345
346 __^__
347
348
349 Move the selection to the parent of the current
350 item.
351
352
353 __Enter__
354
355
356 Expand or collapse a group of packages.
357
358
359 __[[__
360
361
362 Expand an entire tree of packages.
363
364
365 __]__
366
367
368 Collapse an entire tree of packages.
369
370
371 __Enter, i__
372
373
374 Display information about a package.
375
376
377 __+__
378
379
380 Cancel a package's removal, or request that it be installed
381 or upgraded.
382
383
384 __-__
385
386
387 Cancel the installation of a package, or request that it be
388 removed.
389
390
391 __=__
392
393
394 Place a package on hold (or remove the
395
396
397 _____
398
399
400 Request that a package and all its conffiles be removed
401 (
402
403
404 __u__
405
406
407 Update the lists of available packages.
408
409
410 __g__
411
412
413 Perform all pending installations, removals, and
414 upgrades.
415
416
417 __Control-u__
418
419
420 Undo the last action or set of actions.
421
422
423 __/__
424
425
426 Perform a search
427
428
429 __n__
430
431
432 Repeat the last search
433
434
435 __v__
436
437
438 Show the available versions of a package
439 !!SEE ALSO
440
441
4 perry 442 apt-get(1), apt(8),
1 perry 443 __/usr/share/doc/aptitude/README__.
444 !!AUTHOR
445
446
447 This manual page was written by Daniel Burrows
448 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.