Difference between revisions of "Yaourt"

From ArchWiki
Jump to: navigation, search
m (Adding pacman to related articles summary section.)
(Undo revision 272199 by AdamT (talk) do not duplicate upstream documentation)
Line 63: Line 63:
 
You can update your system including [[AUR]] packages with:
 
You can update your system including [[AUR]] packages with:
 
{{bc|$ yaourt -Syua}}
 
{{bc|$ yaourt -Syua}}
 +
 +
See {{ic|man yaourt}} for more information.
  
 
==Examples==
 
==Examples==
Line 84: Line 86:
  
 
See also: [[Pacman]] and [[Pacman Tips]].
 
See also: [[Pacman]] and [[Pacman Tips]].
 
==Manual page==
 
{{hc|$ man yaourt|<nowiki>
 
YAOURT(8)                                  Yaourt Manual                                YAOURT(8)
 
 
NAME
 
      yaourt - more than a frontend to pacman
 
 
SYNOPSIS
 
      yaourt <operation> [options] [packages]
 
 
      yaourt (search pattern|package file)
 
 
DESCRIPTION
 
      Yaourt is a pacman frontend with a lot of features.
 
 
      AUR/ABS support, colorized output, interactive search/install, save/restore Alpm database,
 
      orphans detection, manage .pac* files, ...
 
 
OPERATIONS
 
      Since the majority of those options are same as pacman’s ones (pacman(8)), this manual page
 
      will focus on the specific ones.
 
 
      -B, --backup
 
          Backup or restore alpm local database. See Backup Options.
 
 
      -C
 
          Manage .pac* files. See Clean Options.
 
 
      -G, --getpkgbuild <package>
 
          Get PKGBUILD for ABS or AUR.
 
 
      -Q, --query
 
          Query local database + Can sort packages by installation date, possibility to delete
 
          orphans. See Query Options.
 
 
      -R, --remove
 
          Remove package(s) from the system.
 
 
      -U, --upgrade
 
          Upgrade or add package(s) to the system.
 
 
      -S, --sync
 
          Synchronize packages + AUR support, building from sources. See Sync Options.
 
 
      --stats
 
          Show some statistics about your packages.
 
 
      -V, --version
 
          Display version and exit.
 
 
      -h, --help
 
          Display a short help.
 
 
OPTIONS
 
      --export <dir>
 
          Export built packages and their sources (makepkg(8)) to <dir>.
 
 
      -f, --force
 
          Force installation or updates.
 
 
      --insecure
 
          Allow curl & package-query to perform "insecure" SSL connections
 
 
      --nocolor
 
          Disable color.
 
 
      --noconfirm
 
          Don’t ask for confirmation.
 
 
      --sucre
 
          Equivalent to -Sfyyua --devel --noconfirm
 
 
      --tmp <dir>
 
          Use <dir> as temporary folder. default to /tmp
 
 
BACKUP OPTIONS
 
      yaourt -B
 
          Backup alpm local database in current dir.
 
 
      yaourt -B <dir>
 
          Backup alpm local database in <dir>/pacman-date.tar.bz2
 
 
      yaourt -B <file>
 
          Restore alpm local database from <file>.
 
 
CLEAN OPTIONS
 
      Manage .pacnew, .pacsave and .pacorig files.
 
 
      -c, --clean
 
          Clean all these files.
 
 
QUERY OPTIONS
 
      --backupfile <file>
 
          Query <file> instead of alpm/aur.
 
 
      --date
 
          List queries result sorted by installation date.
 
 
      -d, --deps
 
          Filter output to packages installed as dependencies.
 
 
      -t, --unrequired
 
          Filter output to packages not required by any currently installed package. With -d,
 
          yaourt list all real orphans and ask for deletion.
 
 
SYNC OPTIONS
 
      -a, --aur
 
          Also search in AUR database. With -u or --sysupgrade, upgrade aur packages that are out
 
          of date. With -Qm, display more info about foreign package.
 
 
      --conflicts
 
          Show packages that conflicts with one of the targets
 
 
      -b, --build
 
          Build from sources, ABS for official packages, or AUR if packages is not found. Specify
 
          this option twice to build all dependencies.
 
 
      --depends
 
          Show packages that depends on one of the targets
 
 
      --devel
 
          With -u or --sysupgrade, search an update for devel packages.
 
 
      -i, --info
 
          Display dependency and other information for a given package. This will search through
 
          all repositories and AUR database for a matching package.
 
 
      --provides
 
          Show packages that provides one of the targets.
 
 
      --replaces
 
          Show packages that replaces one of the targets.
 
 
      -u, --sysupgrade
 
          Upgrade all packages that are out of date.
 
 
HANDLING CONFIG FILES
 
      With AUTOSAVEBACKUPFILE (yaourtrc(5)), yaourt will search and save all files marked as
 
      backup. These files can be used later with yaourt -C to automerge current configuration
 
      files with new ones.
 
 
CONFIGURATION
 
      See yaourtrc(5) for more details on configuring yaourt using the yaourtrc file.
 
 
ENVIRONMENT VARIABLES
 
      PACMAN
 
          Set an alternative pacman(8) command.
 
 
      TMPDIR
 
          Set a temporary folder to use.
 
 
      YAOURT_COLORS
 
          Set a user defined colors. (see package-query(8))
 
 
SEE ALSO
 
      yaourtrc(5), makepkg(8), pacman(8)
 
 
      See the yaourt website at http://archlinux.fr/yaourt-en/ for more info.
 
 
BUGS
 
      http://bugs.archlinux.fr
 
 
AUTHORS
 
      Julien MISCHKOWITZ <wain@archlinux.fr>
 
 
      Current maintainers:
 
 
      Tuxce <tuxce.net@gmail.com>
 
 
Yaourt 1.1                                  2012-09-19                                  YAOURT(8)</nowiki>}}
 
  
 
==Troubleshooting==
 
==Troubleshooting==

Revision as of 06:08, 24 August 2013

Template:Article summary start Template:Article summary text Template:Article summary heading Template:Article summary link Template:Article summary heading Template:Article summary wiki Template:Article summary wiki Template:Article summary wiki Template:Article summary end

Yaourt (Yet AnOther User Repository Tool; French for 'Yogurt') is a community-contributed wrapper for pacman which adds seamless access to the AUR, allowing and automating package compilation and installation from your choice of the thousands of PKGBUILDs in the AUR, in addition to the many thousands of available Arch Linux binary packages. Yaourt uses the same exact syntax as pacman, which saves you from relearning an entirely new method of system maintenance but also adds new options. Yaourt expands the power and simplicity of pacman by adding even more useful features and provides pleasing, colorized output, interactive search mode, and much more.

Warning: Yaourt is an unofficial, third-party script that is not supported by the Arch Linux developers.
Note: Please report bugs at the archlinux.fr bugtracker.

Installation

First you need to install package-queryAUR as a dependency, and then the yaourtAUR package itself. Since both those packages are available from the AUR, you will have to install them with the official method for installing unsupported packages, which is exhaustively described in the Arch User Repository article. It is important that you understand what "unsupported package" really means, and you can take this as an opportunity to learn what are the operations that AUR helpers like yaourt make automatic.

Alternatively you can add the archlinuxfr repository as described on the yaourt homepage by adding this to your /etc/pacman.conf:

 [archlinuxfr]
 SigLevel = Never
 Server = http://repo.archlinux.fr/$arch

Then you can use pacman to install the yaourt package.

Proxy Settings

If you access the Internet through an HTTP proxy, you may have to set the environment variables http_proxy and https_proxy in your ~/.bashrc (setting only http_proxy will prevent you from downloading the package from AUR):

$ export http_proxy='http://proxy.hostname.com:port'
$ export https_proxy='https://proxy.hostname.com:port'

For more information, check curl's man page.

sudo does not keep environment variables like http_proxy, so if you use sudo, you must use visudo command to edit /etc/sudoers and add:

Defaults env_keep += "http_proxy"
Defaults env_keep += "https_proxy"
Defaults env_keep += "ftp_proxy"

Using yaourt

You can install packages (including AUR packages) with

$ yaourt packagename

You can update your system including AUR packages with:

$ yaourt -Syua

See man yaourt for more information.

Examples

Search and install:

$ yaourt <search pattern>

Sync database, upgrade packages, search the AUR and devel (all packages based on cvs, svn, git, bzr(...)-version) upgrades:

$ yaourt -Syua --devel 

Build package from source:

$ yaourt -Sb <package>

Check, edit, merge or remove *.pac* files:

$ yaourt -C

Get a PKGBUILD (support split package):

$ yaourt -G <package>

Build and export package, its sources to a directory:

$ yaourt -Sb --export <dir> <package>

Backup database:

$ yaourt -B

Query backup file:

$ yaourt -Q --backupfile <file>

See also: Pacman and Pacman Tips.

Troubleshooting

Yaourt asking for password twice

If you disable the sudo password timeout by adding

Defaults timestamp_timeout=0

to /etc/sudoers, then yaourt will ask for your password twice each time you try to perform an operation that requires root. To prevent this, add:

SUDONOVERIF=1

to /etc/yaourtrc or to ~/.yaourtrc

Yaourt freezing / system heavy slowdown

Mostly a problem for systems with less RAM or a smaller swap space. Yaourt uses /tmp to compile in by default. By default this is all in RAM as it's a tmpfs. Change the location in /etc/yaourtrc (uncomment "TMPDIR = " line) to somewhere else to avoid clogging up your system.