Aura

From ArchWiki
Revision as of 04:36, 8 September 2012 by Fosskers (Talk | contribs)

Jump to: navigation, search

Aura is a multilingual package manager for Arch Linux written in Haskell. It connects to both the official ABS repositories and to the Arch User Repository, allowing easy control of all packages on an Arch system. It allows all pacman operations and provides new custom ones for dealing with AUR packages. This differs from some other AUR helpers.

Philosophy

Aura's philosophy as a package manager can be view in more detail here. The main points are summarized below.

  • Aura is Pacman - All pacman operators and their sub-options are allowed.
  • ABS and AUR are separate - New aura-only operators are introduced for handling AUR packages.
  • Quiet Building - Makepkg output is suppressed by default. Unsuppress by using -x alongside -A.
  • Run as Root, Build as a User - Running makepkg as root or with sudo is dangerous. Aura builds packages with normal user privilages, even when run with sudo.
  • Know your System - Editing PKGBUILDs mid-build is not default behaviour. All package research should be done prior to building.
  • Downgradibility - Aura caches built package files, so they can be managed like any ABS package would. This includes downgrading with -C.
  • No Orphans - Aura provides several options for dealing with orphaned dependencies.
  • Multilingual - Aura provides multiple output languages.

Installation

Alongside ghc, aura also requires haskell-regex-baseAUR and haskell-regex-posixAUR as build dependencies. Once those are installed, please install the auraAUR package itself.

Aura-unique Operators

See the aura man page for more detailed descriptions.

  • -A - Perform actions involving the AUR. Default action builds and installs AUR packages.
  • -C - Perform actions involving the package cache. Default action downgrades packages. This is interactive.
  • -L - Perform actions involving the pacman log. Default action opens the log for read-only viewing.
  • -O - Perform actions involving orphaned dependencies. Default action lists orphaned dependencies.

Usage

Installing Packages

Install an AUR package:

aura -A (package)

Upgrade all installed AUR packages and sync the package database:

aura -Ayu

Checkout an AUR package's PKGBUILD:

aura -Ap (package)

Install with makepkg output unsuppressed:

aura -Ax (package)

Install and remove make dependencies afterwards:

aura -Aa (package)

Working with the Package Cache

Downgrade a package (this is interactive):

aura -C (package)

Search the package cache for package files via a regex:

aura -Cs (regex)

Backup the package cache:

aura -Cb (/path/to/backup/location/)

Reduce the package cache to contain only the 5 most recent versions of each package file:

aura -Cc 5

Working with the Pacman Log

View the pacman log:

aura -L

View log info on a package:

aura -Li

Search the log via a regex:

aura -Ls (regex)

Working with Orphan Dependencies

Display orphans:

aura -O

Adopt a package (shorthand for -D --asexplicit):

aura -O (package)

Uninstall all orphans:

aura -Oj

Multilingual Support

Aura supports multiple output languages. The current available languages (and their flags) are:

  • English (default) - --english
  • Japanese - --日本語 or --japanese
Note: To use non-ASCII arguments, you will need a UTF-8 compatible terminal client, like urxvt.

Troubleshooting

GHC dependency is too big

While a ~700mB dependency is a big one, ghc is nothing but a build dependency for aura. It is not needed post-installation. Feel free to uninstall it (and any other orphans) with aura -Oj.

External Links