pacaur - an AUR helper that minimizes user interaction
Pacaur is an Arch User Repository (AUR) helper aiming at speed and simplicity and is designed to minimize user prompt interaction. It uses an uncluttered interface and makes use of the full secured RPC interface to solve the dependency tree. It will also automatically prompt for sudo access when needed. It is built upon the well designed cower and expac C backends.
Invoking pacaur consists of supplying an operation, any applicable options, and
usually one or more targets. A I
=head1 USERBASE TARGET
Pacaur is targeted at B who want some degree of automation for repetitive tasks. As such, the user is expected to be familiar with the AUR manual build process with makepkg and its configuration options, as well as being knowledgeable about sudo and gpg configuration.
Two sets of command line options are provided: commands which call the pacman binary and extend it with AUR functions B<(-S, -Ss, -Si, -Sw, -Su, -Qu, -Sc, -Scc)>, and commands which are AUR specific B<(-s, -i, -d, -m, -y, -k, -u)>. As such, pacaur can be used by users who prefer to have a single tool to manage the official and AUR repositories, or by users who prefer to keep their AUR frontend separated from pacman.
=head2 Pacman extension operations
=item B<-S, -Ss, -Si, -Sw, -Su, -Qu, -Sc, -Scc>
Pacaur wraps all B
=head2 AUR specific operations
=item B<-s, --search>
Search for packages with the I<target(s)> as the search term(s). Queries with multiple targets will return the result of the intersection of all query results. Extended regex patterns as defined by POSIX are allowed.
=item B<-i, --info>
Show info for I<target(s)>.
=item B<-d, --download>
Clone the I<target(s)> build files. Pass this option twice to fetch uninstalled dependencies (done recursively).
=item B<-m, --makepkg>
Clone build files and build I<target(s)>. Missing dependencies will be installed as required to ensure the build to succeed, before being automatically uninstalled.
=item B<-y, --sync>
Clone build files, build and install I<target(s)>. Missing dependencies will be automatically installed as required.
=item B<-k, --check>
Check foreign packages for updates in the AUR. Without any arguments, all manually installed packages will be checked. If I<target(s)> are supplied, only those packages will be checked.
=item B<-u, --update>
Update foreign packages in the AUR. Without any arguments, all manually installed packages will be updated. If I<target(s)> are supplied, only those packages will be updated.
=head2 General operations
=item B<-v, --version>
Display version and quit.
=item B<-h, --help>
Display the help message and quit.
=head2 Pacman extension options
=item B<-a, --aur>
When used with pacman extended operations, only search, download, build, install or update I<target(s)> from the AUR.
=item B<-r, --repo>
When used with pacman extended operations, only search, download, build, install or update I<target(s)> from the repositories.
=head2 General options
=item B<-e, --edit>
Edit build files when downloading or building I<target(s)>. Overrides the
=item B<-q, --quiet>
Show less information for search and query operations. Search will only show package names and not version, group, and description information.
When used with update and check operations, also consider AUR development
packages. Supported are I
When used with build, install and update operations, also consider already installed foreign dependencies when solving the dependency tree.
=item B<--ignore> I<target(s)>
Ignore a I
Do not reinstall I<target(s)> that are already up-to-date. The build of
development packages that are found up-to-date after the source checkout will
be skipped. Supported are I
Perform commands without confirmation from the user.
Perform commands without editing any installation files. Overrides the I<--edit> option.
Always rebuild packages regardless of any existing file in I<$PKGDEST> directory, and regardless of up-to-date status of development packages.
Silence output. This will send the output of each packaging functions to text
files in the clone directory named I
=item B<--ignore-ood>, B<--no-ignore-ood>
When searching the AUR, ignore all results marked as out of date or do not ignore
results marked as out of date, respectively. The default is to not ignore results
marked as out of date. This can be changed with the I
When searching the AUR, sort the results in ascending or descending order,
respectively, by I
When searching the AUR, search by I
Point at a domain other than the default I.
=head1 CONFIG FILE
Pacaur honors a system-wide config file which will be looked for first at
and falling back to
User-defined configuration files overriding the general settings will be looked for first at
and falling back to
In addition, pacaur fully honors cower's config file. See B
=head1 CONFIG OPTIONS
The available options are:
Define the editor. Default is B<$EDITOR>, with a fallback on I
Display PKGBUILD and install script viewing prompt. Possible values are I
Extend pacman commands to the AUR. Default is B
Enable silent output. The makepkg output will be collected in the clone directory
or the I<$LOGDEST> directory should any error occur. Default is B
When searching the AUR, sort the results by I
When searching the AUR, sort the results in I or I
Prevent sudo timeout. This option overrides the system-wide I
Determines where the packages build files (PKGBUILD, .SRCINFO and install script files) will be cloned. The I<-Sc> and I<-Scc> clean operations allow to remove the untracked cloned files and the non locally installed cloned files, and all cloned files, respectively.
If this environment variable is not defined, the clone directory will be set to
with a fall back to
In addition, makepkg environment variables are fully honored. See B
Determines where the built packages will be stored. If using the existing
I</var/cache/pacman/pkg> pacman cache directory, ensure your user has proper
write permissions. Additionally, if added to the I
Determines where the source of packages will be stored. This will speed up the update of development packages. The I<-Sc> and I<-Scc> clean operations allow to remove the non development packages source files and all source files, respectively.
Determines where the build logs will be stored. By default, the I<--silent> option will write build logs in the clone directory if the build fails, but will remove them if the build succeeds.
Determines where the packages will be built. By default, build will happen in the defined clone directory, but build speed can be improved by using I located in volatile memory. This is however not recommended if big packages need to be built on a low-memory machine.
To be used with minimal password prompting, I
Miscellaneous options enabled in I
To allow build files comparison, the I
By default, any operation will be applied on the binary repositories, then the
AUR if necessary. This behavior is optional and can be disabled with the
Packages requiring user input while building are not supported and might fail to install properly. There is currently no official directive about these interactive PKGBUILDs, but some of the official pacman developers expressed the opinion that PKGBUILDs should always provide default compilation options.
If a lot of "Could not connect to the AUR" and "Timeout was reached" messages
are displayed while searching or requesting info for packages despite the
internet connection working correctly, ensure your local I
The alternative installation root I<-r /path> short option of pacman is not supported. Use the I<--root /path> long option instead, or chroot to the new path and use pacaur from there instead.
=head1 SEE ALSO
Remy Marquis Elt>[email protected]<gt
If you feel great pity for the present maintainer that has to constantly cope with users that don't want to read man pages and refuse to take responsibility for their own system, you can send me funny cat pictures. Alternatively, you can send a donation via PayPal to the above email address.
I would also suggest to donate to a charitable organization of your choice should you believe that your money could make a bigger difference there. Thank you!
All credits go to all direct or indirect contributors. Many thanks to all of you!
B<[ca] - Català> - Alex "alexhenrie" Henrie
B<[da] - Dansk> - Filip "filipkemuel" Kemuel
B<[de] - Deutsch> - Marco "BigBoot" Kirchner, "HerrNieschnell", "pszalanski", Stefan "rumpelsepp" Tatschner, Tilman "Tblue" Blumenbach
B<[es] - Español> - Germán "gosella" Osella Massa, Ismael "ChuckDaniels87" González
B<[fr] - Français> - "spider-mario", "Neitsab", Antoine "Nevax07" Gravelot
B<[hu] - Magyar> - "avelkei"
B<[it] - Italiano> - Demenico "NoMore201" Lezzi
B<[ja] - 日本語> - Colin "fosskers" Woodbury, TSUYUSATO "MakeNowJust" Kitsune
B<[nl] - Nederlands> - "Yoshi2889"
B<[pl] - Polski> - Tomasz "Ludvick" Niedzielski
B<[pt] - Português> - Thiago "thiagowfx" Barroso Perrotta, Rafael "rccavalcanti" Cavalcanti
B<[ru] - Русский> - "kyak"
B<[sk] - Slovenčina> - Pavol "pakapusta" Kapusta, Juraj "DoctorJellyface" Fiala
B<[sr] - Српски / srpski> - Slobodan "Faenriis" Terzić
B<[tr] - Türkçe> - Volkan "wakeup" Gezer