| 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\&. |