apacman − AUR wrapper forked from packer
apacman <operation> [options] [packages]
apacman is a bash wrapper forked from packer for pacman and the ArchLinux User Repository (AUR). It adds package saving functionality and some extra pass-through options for makepkg and pacman.
−Ss
Search for a package.
−S
Install a package.
−Syu
Sync with repositories.
−Si
Show information for a package.
−G
Download and extract ABS and AUR package tarballs, but don’t install anything.
−L
List installed packages by size (replacement for pacsysclean command).
−P, −−pkgfile
Patched AUR passthrough for pkgfile command.
−W
View AUR comments.
−V
Show apacman version.
−v, −−verbose
Show enabled options.
−h, −−help
Show apacman usage.
−−auronly
Only perform commands for the AUR.
−−buildonly
Build packages but do not install them then post−install remove unneeded build makedepends.
Note: list of package filenames stored in $tmpdir/bundle.lst
−−config filename, −−config=filename
Use alternate configuration file.
−−cachevcs
installs cached VCS (git, svn, hg) packages newer than AUR PKGBUILDs.
−−devel
Update development packages. (cvs, git...)
−−edit
Always ask to edit PKGBUILD (overrides ’noedit’ option).
−−gendb
Generate AUR local package database.
−−ignore package, −−ignore=pkg1,pkg2,pkg3
Ignore packages. Separate package names with a comma.
−−ignorearch
ignores architectures specified in PKGBUILD.
−−keepkeys
Do not remove imported PGP keys.
−−legacy
Use AUR3 repo rather than default AUR4 (deprecated).
−−needed
Does not install up-to-date packages.
−−noaur
Do not perform commands for the AUR.
−−noconfirm
Perform commands without confirmation from the user.
−−nodatabase
Do not store AUR database.
−−noedit
Perform commands without asking if the user wants to edit any installation files.
−−nofail
Immediately quit if any package does not build successfully.
−−noprogress
Do not replace terminal title with transaction status.
−−nosource
Do not source PKGBUILDs, for security reasons (WIP).
−−notify
Notification via notify−send with transaction status.
−−preview
Always offer to edit the pkgbuild before sourcing it.
−−progress
Terminal title transaction status.
−−purgebuild
Post−install remove unneeded build makedepends.
−−purgekeys
Remove trusted PGP keys.
−−quickcheck
Check for updates and exit.
−−quiet
Turn off package descriptions.
−−savedir directory, −−savedir=directory
Use alternate cache directory.
−−skipcache
skips check for pre-built package in cache directory.
−−skipinteg
Skip the integrity check by ignoring AUR package MD5 sums.
−−skiptest
Avoid install of check unit test packages.
−−warn
Treat errors as non-fatal warnings (only enable if you are know what you are doing.)
Use apacman without any operations or options to use the interactive mode. apacman will show a numbered list of search results. To install a package, enter the corresponding number.
• Sync and update all packages: apacman −Syu
• Update only AUR packages: apacman −Syu −−auronly
• Update, and reinstall packages that were installed from a revision control source: apacman −Syu −−devel
For a package called name:
• Search: apacman −Ss name
• Install: apacman −S name
• Install without confirmations: apacman −S −−noconfirm name
• Get information about a package: apacman −Si name
• Search and install in interactive mode: apacman name
apacman defaults to saving succesfully built packages to /var/cache/apacman/pkg.
apacman uses the AUR package cache directory if applicable (unless −−skipcache parameter)
By default VCS package versions are compared via PKGBUILD in AUR (unless −−cachevcs parameter)
apacman output will be colorized unless the environmental variable COLOR is set to ‘NO’.
To manually edit files, apacman uses the EDITOR variable. If EDITOR is not set then the default editor is vi.
Packages are built in the TMPDIR path. If the TMPDIR variable is not set then the default path is /tmp
Default configuration file:
• /etc/apacman.conf
These settings are used from /etc/pacman.conf:
• IgnorePkg
There are several possible exit status codes, useful for scripting or debugging listed below.
Note: apacman<=3.0 only uses 0 for success, 1 for fail.
0 |
Success |
|||
1 |
Miscellaneous errors |
|||
2 |
Invalid parameters |
|||
3 |
Fatal errors, not warnings |
|||
4 |
No package matches found |
|||
5 |
Package does not exist |
|||
6 |
No internet connection |
|||
7 |
No free space in tmpfs |
|||
8 |
One or more package(s) failed to build, keep going |
|||
9 |
One package failed to build, do not continue |
|||
10 |
Permission problem −− fakeroot |
|||
11 |
Permission problem −− root user |
|||
12 |
Permission problem −− sudo |
|||
13 |
Permission problem −− su |
apacman.conf(5)
pacman(8)
pkgfile(1)
packer(8)
OS Hazard <oshazard+apacman@gmail.com>
Matthew Bruenig <matthewbruenig@gmail.com>