Debian Codegraph @

upstream/debian-unstable/man8/pacman.8

raw
1 '\" t
2 .\" Title: pacman
3 .\" Author: [see the "Authors" section]
4 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
5 .\" Date: 11-11-1111
6 .\" Manual: Pacman Manual
7 .\" Source: Pacman 7.1.0
8 .\" Language: English
9 .\"
10 .TH "PACMAN" "8" "11\-11\-1111" "Pacman 7\&.1\&.0" "Pacman Manual"
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 pacman \- package manager utility
32 .SH "SYNOPSIS"
33 .sp
34 \fIpacman\fR <operation> [options] [targets]
35 .SH "DESCRIPTION"
36 .sp
37 Pacman is a package management utility that tracks installed packages on a Linux system\&. It features dependency support, package groups, install and uninstall scripts, and the ability to sync your local machine with a remote repository to automatically upgrade packages\&. Pacman packages are a zipped tar format\&.
38 .sp
39 Since version 3\&.0\&.0, pacman has been the front\-end to \fBlibalpm\fR(3), the \(lqArch Linux Package Management\(rq library\&. This library allows alternative front\-ends to be written (for instance, a GUI front\-end)\&.
40 .sp
41 Invoking pacman involves specifying an operation with any potential options and targets to operate on\&. A \fItarget\fR is usually a package name, file name, URL, or a search string\&. Targets can be provided as command line arguments\&. Additionally, if stdin is not from a terminal and a single hyphen (\-) is passed as an argument, targets will be read from stdin\&.
42 .SH "OPERATIONS"
43 .PP
44 \fB\-D, \-\-database\fR
45 .RS 4
46 Operate on the package database\&. This operation allows you to modify certain attributes of the installed packages in pacman\(cqs database\&. It also allows you to check the databases for internal consistency\&. See
47 Database Options
48 below\&.
49 .RE
50 .PP
51 \fB\-Q, \-\-query\fR
52 .RS 4
53 Query the package database\&. This operation allows you to view installed packages and their files, as well as meta\-information about individual packages (dependencies, conflicts, install date, build date, size)\&. This can be run against the local package database or can be used on individual package files\&. In the first case, if no package names are provided in the command line, all installed packages will be queried\&. Additionally, various filters can be applied on the package list\&. See
54 Query Options
55 below\&.
56 .RE
57 .PP
58 \fB\-R, \-\-remove\fR
59 .RS 4
60 Remove package(s) from the system\&. Groups can also be specified to be removed, in which case every package in that group will be removed\&. Files belonging to the specified package will be deleted, and the database will be updated\&. Most configuration files will be saved with a
61 \fI\&.pacsave\fR
62 extension unless the
63 \fI\-\-nosave\fR
64 option is used\&. See
65 Remove Options
66 below\&.
67 .RE
68 .PP
69 \fB\-S, \-\-sync\fR
70 .RS 4
71 Synchronize packages\&. Packages are installed directly from the remote repositories, including all dependencies required to run the packages\&. For example,
72 pacman \-S qt
73 will download and install qt and all the packages it depends on\&. If a package name exists in more than one repository, the repository can be explicitly specified to clarify the package to install:
74 pacman \-S testing/qt\&. You can also specify version requirements:
75 pacman \-S "bash>=3\&.2"\&. Quotes are needed, otherwise the shell interprets ">" as redirection to a file\&.
76 .sp
77 In addition to packages, groups can be specified as well\&. For example, if gnome is a defined package group, then
78 pacman \-S gnome
79 will provide a prompt allowing you to select which packages to install from a numbered list\&. The package selection is specified using a space\- and/or comma\-separated list of package numbers\&. Sequential packages may be selected by specifying the first and last package numbers separated by a hyphen (\-)\&. Excluding packages is achieved by prefixing a number or range of numbers with a caret (^)\&.
80 .sp
81 Packages that provide other packages are also handled\&. For example,
82 pacman \-S foo
83 will first look for a foo package\&. If foo is not found, packages that provide the same functionality as foo will be searched for\&. If any package is found, it will be installed\&. A selection prompt is provided if multiple packages providing foo are found\&.
84 .sp
85 You can also use
86 pacman \-Su
87 to upgrade all packages that are out\-of\-date\&. See
88 Sync Options
89 below\&. When upgrading, pacman performs version comparison to determine which packages need upgrading\&. This behavior operates as follows:
90 .sp
91 .if n \{\
92 .RS 4
93 .\}
94 .nf
95 Alphanumeric:
96 1\&.0a < 1\&.0b < 1\&.0beta < 1\&.0p < 1\&.0pre < 1\&.0rc < 1\&.0 < 1\&.0\&.a < 1\&.0\&.1
97 Numeric:
98 1 < 1\&.0 < 1\&.1 < 1\&.1\&.1 < 1\&.2 < 2\&.0 < 3\&.0\&.0
99 .fi
100 .if n \{\
101 .RE
102 .\}
103 .sp
104 Additionally, version strings can have an
105 \fIepoch\fR
106 value defined that will overrule any version comparison, unless the epoch values are equal\&. This is specified in an
107 epoch:version\-rel
108 format\&. For example,
109 2:1\&.0\-1
110 is always greater than
111 1:3\&.6\-1\&.
112 .RE
113 .PP
114 \fB\-T, \-\-deptest\fR
115 .RS 4
116 Check dependencies; this is useful in scripts such as makepkg to check installed packages\&. This operation will check each dependency specified and return a list of dependencies that are not currently satisfied on the system\&. This operation accepts no other options\&. Example usage:
117 pacman \-T qt "bash>=3\&.2"\&.
118 .RE
119 .PP
120 \fB\-U, \-\-upgrade\fR
121 .RS 4
122 Upgrade or add package(s) to the system and install the required dependencies from sync repositories\&. Either a URL or file path can be specified\&. This is a \(lqremove\-then\-add\(rq process\&. See
123 Upgrade Options
124 below; also see
125 Handling Config Files
126 for an explanation on how pacman takes care of configuration files\&.
127 .RE
128 .PP
129 \fB\-F, \-\-files\fR
130 .RS 4
131 Query the files database\&. This operation allows you to look for packages owning certain files or display files owned by certain packages\&. Only packages that are part of your sync databases are searched\&. See
132 File Options
133 below\&.
134 .RE
135 .PP
136 \fB\-V, \-\-version\fR
137 .RS 4
138 Display version and exit\&.
139 .RE
140 .PP
141 \fB\-h, \-\-help\fR
142 .RS 4
143 Display syntax for the given operation\&. If no operation was supplied, then the general syntax is shown\&.
144 .RE
145 .SH "OPTIONS"
146 .PP
147 \fB\-b, \-\-dbpath\fR <path>
148 .RS 4
149 Specify an alternative database location (the default is
150 /var/lib/pacman)\&. This should not be used unless you know what you are doing\&.
151 \fBNOTE\fR: If specified, this is an absolute path, and the root path is not automatically prepended\&.
152 .RE
153 .PP
154 \fB\-r, \-\-root\fR <path>
155 .RS 4
156 Specify an alternative installation root (default is
157 /)\&. This should not be used as a way to install software into
158 /usr/local
159 instead of
160 /usr\&.
161 \fBNOTE\fR: If database path or log file are not specified on either the command line or in
162 \fBpacman.conf\fR(5), their default location will be inside this root path\&.
163 \fBNOTE\fR: This option is not suitable for performing operations on a mounted guest system\&. See
164 \fI\-\-sysroot\fR
165 instead\&.
166 .RE
167 .PP
168 \fB\-v, \-\-verbose\fR
169 .RS 4
170 Output paths such as the Root, Conf File, DB Path, Cache Dirs, etc\&.
171 .RE
172 .PP
173 \fB\-\-arch\fR <arch>
174 .RS 4
175 Specify an alternate architecture\&.
176 .RE
177 .PP
178 \fB\-\-cachedir\fR <dir>
179 .RS 4
180 Specify an alternative package cache location (the default is
181 /var/cache/pacman/pkg)\&. Multiple cache directories can be specified, and they are tried in the order they are passed to pacman\&.
182 \fBNOTE\fR: This is an absolute path, and the root path is not automatically prepended\&. If DownloadUser is set in
183 \fBpacman.conf\fR(5), then the specified user must have permission to access the cache directory\&.
184 .RE
185 .PP
186 \fB\-\-color\fR <when>
187 .RS 4
188 Specify when to enable coloring\&. Valid options are
189 \fIalways\fR,
190 \fInever\fR, or
191 \fIauto\fR\&.
192 \fIalways\fR
193 forces colors on;
194 \fInever\fR
195 forces colors off; and
196 \fIauto\fR
197 only automatically enables colors when outputting onto a tty\&.
198 .RE
199 .PP
200 \fB\-\-config\fR <file>
201 .RS 4
202 Specify an alternate configuration file\&.
203 .RE
204 .PP
205 \fB\-\-debug\fR
206 .RS 4
207 Display debug messages\&. When reporting bugs, this option is recommended to be used\&.
208 .RE
209 .PP
210 \fB\-\-gpgdir\fR <dir>
211 .RS 4
212 Specify a directory of files used by GnuPG to verify package signatures (the default is
213 /etc/pacman\&.d/gnupg)\&. This directory should contain two files:
214 pubring\&.gpg
215 and
216 trustdb\&.gpg\&.
217 pubring\&.gpg
218 holds the public keys of all packagers\&.
219 trustdb\&.gpg
220 contains a so\-called trust database, which specifies that the keys are authentic and trusted\&.
221 \fBNOTE\fR: This is an absolute path, and the root path is not automatically prepended\&.
222 .RE
223 .PP
224 \fB\-\-hookdir\fR <dir>
225 .RS 4
226 Specify a alternative directory containing hook files (the default is
227 /etc/pacman\&.d/hooks)\&. Multiple hook directories can be specified with hooks in later directories taking precedence over hooks in earlier directories\&.
228 \fBNOTE\fR: This is an absolute path, and the root path is not automatically prepended\&.
229 .RE
230 .PP
231 \fB\-\-logfile\fR <file>
232 .RS 4
233 Specify an alternate log file\&. This is an absolute path, regardless of the installation root setting\&.
234 .RE
235 .PP
236 \fB\-\-noconfirm\fR
237 .RS 4
238 Bypass any and all \(lqAre you sure?\(rq messages\&. It\(cqs not a good idea to do this unless you want to run pacman from a script\&.
239 .RE
240 .PP
241 \fB\-\-confirm\fR
242 .RS 4
243 Cancels the effects of a previous
244 \fI\-\-noconfirm\fR\&.
245 .RE
246 .PP
247 \fB\-\-disable\-download\-timeout\fR
248 .RS 4
249 Disable defaults for low speed limit and timeout on downloads\&. Use this if you have issues downloading files with proxy and/or security gateway\&.
250 .RE
251 .PP
252 \fB\-\-sysroot\fR <dir>
253 .RS 4
254 Specify an alternative system root\&. This path will be prepended to all other configuration directories and any repository servers beginning with
255 file://\&. Any paths or URLs passed as targets will not be modified\&. This allows mounted guest systems to be properly operated on\&.
256 .RE
257 .PP
258 \fB\-\-disable\-sandbox\fR
259 .RS 4
260 Completely disables the sandbox applied to the process of downloading files on Linux systems\&. Equivalent to jointly specifying
261 \-\-disable\-sandbox\-filesystem
262 and
263 \-\-disable\-sandbox\-syscalls\&.
264 .RE
265 .PP
266 \fB\-\-disable\-sandbox\-filesystem\fR
267 .RS 4
268 Disable the filesystem restrictions part of the sandbox applied to the process downloading files on Linux systems\&. Useful if experiencing Landlock related failures while downloading files when running a Linux kernel that does not support this feature\&.
269 .RE
270 .PP
271 \fB\-\-disable\-sandbox\-syscalls\fR
272 .RS 4
273 Disable the syscall filtering part of the sandbox applied to the process downloading files on Linux systems\&. Useful if experiencing seccomp related failures while downloading files when running a Linux kernel that does not support this feature\&.
274 .RE
275 .SH "TRANSACTION OPTIONS (APPLY TO \FI\-S\FR, \FI\-R\FR AND \FI\-U\FR)"
276 .PP
277 \fB\-d, \-\-nodeps\fR
278 .RS 4
279 Skips dependency version checks\&. Package names are still checked\&. Normally, pacman will always check a package\(cqs dependency fields to ensure that all dependencies are installed and there are no package conflicts in the system\&. Specify this option twice to skip all dependency checks\&.
280 .RE
281 .PP
282 \fB\-\-assume\-installed\fR <package=version>
283 .RS 4
284 Add a virtual package "package" with version "version" to the transaction to satisfy dependencies\&. This allows disabling the specific dependency checks without affecting all dependency checks\&. To disable all dependency checking, see the
285 \fI\-\-nodeps\fR
286 option\&.
287 .RE
288 .PP
289 \fB\-\-dbonly\fR
290 .RS 4
291 Adds/removes the database entry only, leaving all files in place\&.
292 .RE
293 .PP
294 \fB\-\-noprogressbar\fR
295 .RS 4
296 Do not show a progress bar when downloading files\&. This can be useful for scripts that call pacman and capture the output\&.
297 .RE
298 .PP
299 \fB\-\-noscriptlet\fR
300 .RS 4
301 If an install scriptlet exists, do not execute it\&. Do not use this unless you know what you are doing\&.
302 .RE
303 .PP
304 \fB\-p, \-\-print\fR
305 .RS 4
306 Only print the targets instead of performing the actual operation (sync, remove or upgrade)\&. Use
307 \fI\-\-print\-format\fR
308 to specify how targets are displayed\&. The default format string is "%l", which displays URLs with
309 \fI\-S\fR, file names with
310 \fI\-U\fR, and pkgname\-pkgver with
311 \fI\-R\fR\&.
312 .RE
313 .PP
314 \fB\-\-print\-format\fR <format>
315 .RS 4
316 Specify a printf\-like format to control the output of the
317 \fI\-\-print\fR
318 operation\&. The possible attributes are: "%a" for arch, "%b" for builddate, "%d" for description, "%e" for pkgbase, "%f" for filename, "%g" for base64 encoded PGP signature, "%h" for sha256sum, "%m" for md5sum, "%n" for pkgname, "%p" for packager, "%v" for pkgver, "%l" for location, "%r" for repository, "%s" for size, "%C" for checkdepends, "%D" for depends, "%G" for groups, "%H" for conflicts, "%L" for licenses, "%M" for makedepends, "%O" for optional depends, "%P" for provides and "%R" for replaces\&. Implies
319 \fI\-\-print\fR\&.
320 .RE
321 .SH "UPGRADE OPTIONS (APPLY TO \FI\-S\FR AND \FI\-U\FR)"
322 .PP
323 \fB\-w, \-\-downloadonly\fR
324 .RS 4
325 Retrieve all packages from the server, but do not install/upgrade anything\&.
326 .RE
327 .PP
328 \fB\-\-asdeps\fR
329 .RS 4
330 Install packages non\-explicitly; in other words, fake their install reason to be installed as a dependency\&. This is useful for makepkg and other build\-from\-source tools that need to install dependencies before building the package\&.
331 .RE
332 .PP
333 \fB\-\-asexplicit\fR
334 .RS 4
335 Install packages explicitly; in other words, fake their install reason to be explicitly installed\&. This is useful if you want to mark a dependency as explicitly installed so it will not be removed by the
336 \fI\-\-recursive\fR
337 remove operation\&.
338 .RE
339 .PP
340 \fB\-\-ignore\fR <package>
341 .RS 4
342 Directs pacman to ignore upgrades of package even if there is one available\&. Multiple packages can be specified by separating them with a comma\&.
343 .RE
344 .PP
345 \fB\-\-ignoregroup\fR <group>
346 .RS 4
347 Directs pacman to ignore upgrades of all packages in
348 \fIgroup\fR, even if there is one available\&. Multiple groups can be specified by separating them with a comma\&.
349 .RE
350 .PP
351 \fB\-\-needed\fR
352 .RS 4
353 Do not reinstall the targets that are already up\-to\-date\&.
354 .RE
355 .PP
356 \fB\-\-overwrite\fR <glob>
357 .RS 4
358 Bypass file conflict checks and overwrite conflicting files\&. If the package that is about to be installed contains files that are already installed and match
359 \fIglob\fR, this option will cause all those files to be overwritten\&. Using
360 \fI\-\-overwrite\fR
361 will not allow overwriting a directory with a file or installing packages with conflicting files and directories\&. Multiple patterns can be specified by separating them with a comma\&. May be specified multiple times\&. Patterns can be negated, such that files matching them will not be overwritten, by prefixing them with an exclamation mark\&. Subsequent matches will override previous ones\&. A leading literal exclamation mark or backslash needs to be escaped\&.
362 .RE
363 .SH "QUERY OPTIONS (APPLY TO \FI\-Q\FR)"
364 .PP
365 \fB\-c, \-\-changelog\fR
366 .RS 4
367 View the ChangeLog of a package if it exists\&.
368 .RE
369 .PP
370 \fB\-d, \-\-deps\fR
371 .RS 4
372 Restrict or filter output to packages installed as dependencies\&. This option can be combined with
373 \fI\-t\fR
374 for listing real orphans \- packages that were installed as dependencies but are no longer required by any installed package\&.
375 .RE
376 .PP
377 \fB\-e, \-\-explicit\fR
378 .RS 4
379 Restrict or filter output to explicitly installed packages\&. This option can be combined with
380 \fI\-t\fR
381 to list explicitly installed packages that are not required by any other package\&.
382 .RE
383 .PP
384 \fB\-g, \-\-groups\fR
385 .RS 4
386 Display all packages that are members of a named group\&. If a name is not specified, list all grouped packages\&.
387 .RE
388 .PP
389 \fB\-i, \-\-info\fR
390 .RS 4
391 Display information on a given package\&. The
392 \fI\-p\fR
393 option can be used if querying a package file instead of the local database\&. Passing two
394 \fI\-\-info\fR
395 or
396 \fI\-i\fR
397 flags will also display the list of backup files and their modification states\&.
398 .RE
399 .PP
400 \fB\-k, \-\-check\fR
401 .RS 4
402 Check that all files owned by the given package(s) are present on the system\&. If packages are not specified or filter flags are not provided, check all installed packages\&. Specifying this option twice will perform more detailed file checking (including permissions, file sizes, and modification times) for packages that contain the needed mtree file\&.
403 .RE
404 .PP
405 \fB\-l, \-\-list\fR
406 .RS 4
407 List all files owned by a given package\&. Multiple packages can be specified on the command line\&.
408 .RE
409 .PP
410 \fB\-m, \-\-foreign\fR
411 .RS 4
412 Restrict or filter output to packages that were not found in the sync database(s)\&. Typically these are packages that were downloaded manually and installed with
413 \fI\-\-upgrade\fR\&.
414 .RE
415 .PP
416 \fB\-n, \-\-native\fR
417 .RS 4
418 Restrict or filter output to packages that are found in the sync database(s)\&. This is the inverse filter of
419 \fI\-\-foreign\fR\&.
420 .RE
421 .PP
422 \fB\-o, \-\-owns\fR <file>
423 .RS 4
424 Search for packages that own the specified file(s)\&. The path can be relative or absolute, and one or more files can be specified\&.
425 .RE
426 .PP
427 \fB\-p, \-\-file\fR
428 .RS 4
429 Signifies that the package supplied on the command line is a file and not an entry in the database\&. The file will be decompressed and queried\&. This is useful in combination with
430 \fI\-\-info\fR
431 and
432 \fI\-\-list\fR\&.
433 .RE
434 .PP
435 \fB\-q, \-\-quiet\fR
436 .RS 4
437 Show less information for certain query operations\&. This is useful when pacman\(cqs output is processed in a script\&. Search will only show package names and not version, group, and description information; owns will only show package names instead of "file is owned by pkg" messages; group will only show package names and omit group names; list will only show files and omit package names; check will only show pairs of package names and missing files; a bare query will only show package names rather than names and versions\&.
438 .RE
439 .PP
440 \fB\-s, \-\-search\fR <regexp>
441 .RS 4
442 Search each locally\-installed package for names or descriptions that match
443 regexp\&. When including multiple search terms, only packages with descriptions matching ALL of those terms are returned\&.
444 .RE
445 .PP
446 \fB\-t, \-\-unrequired\fR
447 .RS 4
448 Restrict or filter output to print only packages neither required nor optionally required by any currently installed package\&. Specify this option twice to include packages which are optionally, but not directly, required by another package\&.
449 .RE
450 .PP
451 \fB\-u, \-\-upgrades\fR
452 .RS 4
453 Restrict or filter output to packages that are out\-of\-date on the local system\&. Only package versions are used to find outdated packages; replacements are not checked here\&. This option works best if the sync database is refreshed using
454 \fI\-Sy\fR\&.
455 .RE
456 .SH "REMOVE OPTIONS (APPLY TO \FI\-R\FR)"
457 .PP
458 \fB\-c, \-\-cascade\fR
459 .RS 4
460 Remove all target packages, as well as all packages that depend on one or more target packages\&. This operation is recursive and must be used with care, since it can remove many potentially needed packages\&.
461 .RE
462 .PP
463 \fB\-n, \-\-nosave\fR
464 .RS 4
465 Instructs pacman to ignore file backup designations\&. Normally, when a file is removed from the system, the database is checked to see if the file should be renamed with a
466 \fI\&.pacsave\fR
467 extension\&.
468 .RE
469 .PP
470 \fB\-s, \-\-recursive\fR
471 .RS 4
472 Remove each target specified including all of their dependencies, provided that (A) they are not required by other packages; and (B) they were not explicitly installed by the user\&. This operation is recursive and analogous to a backwards
473 \fI\-\-sync\fR
474 operation, and it helps keep a clean system without orphans\&. If you want to omit condition (B), pass this option twice\&.
475 .RE
476 .PP
477 \fB\-u, \-\-unneeded\fR
478 .RS 4
479 Removes targets that are not required by any other packages\&. This is mostly useful when removing a group without using the
480 \fI\-c\fR
481 option, to avoid breaking any dependencies\&.
482 .RE
483 .SH "SYNC OPTIONS (APPLY TO \FI\-S\FR)"
484 .PP
485 \fB\-c, \-\-clean\fR
486 .RS 4
487 Remove packages that are no longer installed from the cache as well as currently unused sync databases to free up disk space\&. When pacman downloads packages, it saves them in a cache directory\&. In addition, databases are saved for every sync DB you download from and are not deleted even if they are removed from the configuration file
488 \fBpacman.conf\fR(5)\&. Use one
489 \fI\-\-clean\fR
490 switch to only remove packages that are no longer installed; use two to remove all files from the cache\&. In both cases, you will have a yes or no option to remove packages and/or unused downloaded databases\&.
491 .sp
492 If you use a network shared cache, see the
493 \fICleanMethod\fR
494 option in
495 \fBpacman.conf\fR(5)\&.
496 .RE
497 .PP
498 \fB\-g, \-\-groups\fR
499 .RS 4
500 Display all the members for each package group specified\&. If no group names are provided, all groups will be listed; pass the flag twice to view all groups and their members\&.
501 .RE
502 .PP
503 \fB\-i, \-\-info\fR
504 .RS 4
505 Display information on a given sync database package\&. Passing two
506 \fI\-\-info\fR
507 or
508 \fI\-i\fR
509 flags will also display those packages in all repositories that depend on this package\&.
510 .RE
511 .PP
512 \fB\-l, \-\-list\fR
513 .RS 4
514 List all packages in the specified repositories\&. Multiple repositories can be specified on the command line\&.
515 .RE
516 .PP
517 \fB\-q, \-\-quiet\fR
518 .RS 4
519 Show less information for certain sync operations\&. This is useful when pacman\(cqs output is processed in a script\&. Search will only show package names and not repository, version, group, and description information; list will only show package names and omit databases and versions; group will only show package names and omit group names\&.
520 .RE
521 .PP
522 \fB\-s, \-\-search\fR <regexp>
523 .RS 4
524 This will search each package in the sync databases for names or descriptions that match
525 regexp\&. When you include multiple search terms, only packages with descriptions matching ALL of those terms will be returned\&.
526 .RE
527 .PP
528 \fB\-u, \-\-sysupgrade\fR
529 .RS 4
530 Upgrades all packages that are out\-of\-date\&. Each currently\-installed package will be examined and upgraded if a newer package exists\&. A report of all packages to upgrade will be presented, and the operation will not proceed without user confirmation\&. Dependencies are automatically resolved at this level and will be installed/upgraded if necessary\&.
531 .sp
532 Pass this option twice to enable package downgrades; in this case, pacman will select sync packages whose versions do not match with the local versions\&. This can be useful when the user switches from a testing repository to a stable one\&.
533 .sp
534 Additional targets can also be specified manually, so that
535 \fI\-Su foo\fR
536 will do a system upgrade and install/upgrade the "foo" package in the same operation\&.
537 .RE
538 .PP
539 \fB\-y, \-\-refresh\fR
540 .RS 4
541 Download a fresh copy of the master package databases
542 \fI(repo\&.db)\fR
543 from the server(s) defined in
544 \fBpacman.conf\fR(5)\&. This should typically be used each time you use
545 \fI\-\-sysupgrade\fR
546 or
547 \fI\-u\fR\&. Passing two
548 \fI\-\-refresh\fR
549 or
550 \fI\-y\fR
551 flags will force a refresh of all package databases, even if they appear to be up\-to\-date\&.
552 .RE
553 .SH "DATABASE OPTIONS (APPLY TO \FI\-D\FR)"
554 .PP
555 \fB\-\-asdeps\fR <package>
556 .RS 4
557 Mark a package as non\-explicitly installed; in other words, set their install reason to be installed as a dependency\&.
558 .RE
559 .PP
560 \fB\-\-asexplicit\fR <package>
561 .RS 4
562 Mark a package as explicitly installed; in other words, set their install reason to be explicitly installed\&. This is useful if you want to keep a package installed even when it was initially installed as a dependency of another package\&.
563 .RE
564 .PP
565 \fB\-k, \-\-check\fR
566 .RS 4
567 Check the local package database is internally consistent\&. This will check all required files are present and that installed packages have the required dependencies, do not conflict and that multiple packages do not own the same file\&. Specifying this option twice will perform a check on the sync databases to ensure all specified dependencies are available\&.
568 .RE
569 .PP
570 \fB\-q, \-\-quiet\fR
571 .RS 4
572 Suppress messages on successful completion of database operations\&.
573 .RE
574 .SH "FILE OPTIONS (APPLY TO \FI\-F\FR)"
575 .PP
576 \fB\-y, \-\-refresh\fR
577 .RS 4
578 Download fresh package file databases
579 \fI(repo\&.files)\fR
580 from the server\&. Use twice to force a refresh even if databases are up to date\&.
581 .RE
582 .PP
583 \fB\-l, \-\-list\fR
584 .RS 4
585 List the files owned by the queried package\&.
586 .RE
587 .PP
588 \fB\-x, \-\-regex\fR
589 .RS 4
590 Interpret each query as a regular expression\&.
591 .RE
592 .PP
593 \fB\-q, \-\-quiet\fR
594 .RS 4
595 Show less information for certain file operations\&. This is useful when pacman\(cqs output is processed in a script, however, you may want to use
596 \fI\-\-machinereadable\fR
597 instead\&.
598 .RE
599 .PP
600 \fB\-\-machinereadable\fR
601 .RS 4
602 Print each match in a machine readable output format\&. The format is
603 \fIrepository\e0pkgname\e0pkgver\e0path\en\fR
604 with
605 \fI\e0\fR
606 being the NULL character and
607 \fI\en\fR
608 a linefeed\&.
609 .RE
610 .SH "HANDLING CONFIG FILES"
611 .sp
612 Pacman uses the same logic as \fIrpm\fR to determine action against files that are designated to be backed up\&. During an upgrade, three MD5 hashes are used for each backup file to determine the required action: one for the original file installed, one for the new file that is about to be installed, and one for the actual file existing on the file system\&. After comparing these three hashes, the following scenarios can result:
613 .PP
614 original=X, current=X, new=X
615 .RS 4
616 All three files are the same, so overwrites are not an issue\&. Install the new file\&.
617 .RE
618 .PP
619 original=X, current=X, new=Y
620 .RS 4
621 The current file is the same as the original, but the new one differs\&. Since the user did not ever modify the file, and the new one may contain improvements or bug fixes, install the new file\&.
622 .RE
623 .PP
624 original=X, current=Y, new=X
625 .RS 4
626 Both package versions contain the exact same file, but the one on the file system has been modified\&. Leave the current file in place\&.
627 .RE
628 .PP
629 original=X, current=Y, new=Y
630 .RS 4
631 The new file is identical to the current file\&. Install the new file\&.
632 .RE
633 .PP
634 original=X, current=Y, new=Z
635 .RS 4
636 All three files are different, so install the new file with a
637 \fI\&.pacnew\fR
638 extension and warn the user\&. The user must then manually merge any necessary changes into the original file\&.
639 .RE
640 .PP
641 original=NULL, current=Y, new=Z
642 .RS 4
643 The package was not previously installed, and the file already exists on the file system\&. Install the new file with a
644 \fI\&.pacnew\fR
645 extension and warn the user\&. The user must then manually merge any necessary changes into the original file\&.
646 .RE
647 .SH "EXAMPLES"
648 .PP
649 pacman \-Ss ne\&.hack
650 .RS 4
651 Search for regexp "ne\&.hack" in package database\&.
652 .RE
653 .PP
654 pacman \-S gpm
655 .RS 4
656 Download and install gpm including dependencies\&.
657 .RE
658 .PP
659 pacman \-U /home/user/ceofhack\-0\&.6\-1\-x86_64\&.pkg\&.tar\&.gz
660 .RS 4
661 Install ceofhack\-0\&.6\-1 package from a local file\&.
662 .RE
663 .PP
664 pacman \-Syu
665 .RS 4
666 Update package list and upgrade all packages afterwards\&.
667 .RE
668 .PP
669 pacman \-Syu gpm
670 .RS 4
671 Update package list, upgrade all packages, and then install gpm if it wasn\(cqt already installed\&.
672 .RE
673 .SH "CONFIGURATION"
674 .sp
675 See \fBpacman.conf\fR(5) for more details on configuring pacman using the \fIpacman\&.conf\fR file\&.
676 .SH "SEE ALSO"
677 .sp
678 \fBalpm-hooks\fR(5), \fBlibalpm\fR(3), \fBmakepkg\fR(8), \fBpacman.conf\fR(5)
679 .sp
680 See the pacman website at https://archlinux\&.org/pacman/ for current information on pacman and its related tools\&.
681 .SH "BUGS"
682 .sp
683 Bugs? You must be kidding; there are no bugs in this software\&. But if we happen to be wrong, please report them to the issue tracker at https://gitlab\&.archlinux\&.org/pacman/pacman/\-/issues with specific information such as your command\-line, the nature of the bug, and even the package database if it helps\&.
684 .SH "AUTHORS"
685 .sp
686 Current maintainers:
687 .sp
688 .RS 4
689 .ie n \{\
690 \h'-04'\(bu\h'+03'\c
691 .\}
692 .el \{\
693 .sp -1
694 .IP \(bu 2.3
695 .\}
696 Allan McRae <allan@archlinux\&.org>
697 .RE
698 .sp
699 .RS 4
700 .ie n \{\
701 \h'-04'\(bu\h'+03'\c
702 .\}
703 .el \{\
704 .sp -1
705 .IP \(bu 2.3
706 .\}
707 Andrew Gregory <andrew\&.gregory\&.8@gmail\&.com>
708 .RE
709 .sp
710 .RS 4
711 .ie n \{\
712 \h'-04'\(bu\h'+03'\c
713 .\}
714 .el \{\
715 .sp -1
716 .IP \(bu 2.3
717 .\}
718 Morgan Adamiec <morganamilo@archlinux\&.org>
719 .RE
720 .sp
721 Past major contributors:
722 .sp
723 .RS 4
724 .ie n \{\
725 \h'-04'\(bu\h'+03'\c
726 .\}
727 .el \{\
728 .sp -1
729 .IP \(bu 2.3
730 .\}
731 Judd Vinet <jvinet@zeroflux\&.org>
732 .RE
733 .sp
734 .RS 4
735 .ie n \{\
736 \h'-04'\(bu\h'+03'\c
737 .\}
738 .el \{\
739 .sp -1
740 .IP \(bu 2.3
741 .\}
742 Aurelien Foret <aurelien@archlinux\&.org>
743 .RE
744 .sp
745 .RS 4
746 .ie n \{\
747 \h'-04'\(bu\h'+03'\c
748 .\}
749 .el \{\
750 .sp -1
751 .IP \(bu 2.3
752 .\}
753 Aaron Griffin <aaron@archlinux\&.org>
754 .RE
755 .sp
756 .RS 4
757 .ie n \{\
758 \h'-04'\(bu\h'+03'\c
759 .\}
760 .el \{\
761 .sp -1
762 .IP \(bu 2.3
763 .\}
764 Dan McGee <dan@archlinux\&.org>
765 .RE
766 .sp
767 .RS 4
768 .ie n \{\
769 \h'-04'\(bu\h'+03'\c
770 .\}
771 .el \{\
772 .sp -1
773 .IP \(bu 2.3
774 .\}
775 Xavier Chantry <shiningxc@gmail\&.com>
776 .RE
777 .sp
778 .RS 4
779 .ie n \{\
780 \h'-04'\(bu\h'+03'\c
781 .\}
782 .el \{\
783 .sp -1
784 .IP \(bu 2.3
785 .\}
786 Nagy Gabor <ngaba@bibl\&.u\-szeged\&.hu>
787 .RE
788 .sp
789 .RS 4
790 .ie n \{\
791 \h'-04'\(bu\h'+03'\c
792 .\}
793 .el \{\
794 .sp -1
795 .IP \(bu 2.3
796 .\}
797 Dave Reisner <dreisner@archlinux\&.org>
798 .RE
799 .sp
800 .RS 4
801 .ie n \{\
802 \h'-04'\(bu\h'+03'\c
803 .\}
804 .el \{\
805 .sp -1
806 .IP \(bu 2.3
807 .\}
808 Eli Schwartz <eschwartz@archlinux\&.org>
809 .RE
810 .sp
811 For additional contributors, use git shortlog \-s on the pacman\&.git repository\&.