Difference between revisions of "Yaourt"

From ArchWiki
Jump to: navigation, search
(Added AUR for related AW articles. Added Yaourt and it's home page as Required software. Expanded the summary to detail how yaourt is installed.)
(Examples: Added the manual page for convient (complete} referencing prior to installation or whenever else.)
Line 83: Line 83:
  
 
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 07:04, 23 August 2013

Summary help replacing me
How to install and use Yaourt via the AUR or an unofficial repository.
Required software
Yaourt
Related
AUR Helpers
AUR

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

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.

Manual page

$ man yaourt
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)

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.