stow/oh-my-zsh/.oh-my-zsh/plugins/archlinux/README.md

   1 # Arch Linux plugin
   2
   3 This plugin adds some aliases and functions to work with Arch Linux.
   4
   5 To use it, add `archlinux` to the plugins array in your zshrc file:
   6
   7 ```zsh
   8 plugins=(... archlinux)
   9 ```
  10
  11 ## Features
  12
  13 ### Pacman
  14
  15 | Alias        | Command                                | Description                                                      |
  16 |--------------|----------------------------------------|------------------------------------------------------------------|
  17 | pacin        | `sudo pacman -S`                       | Install packages from the repositories                           |
  18 | pacins       | `sudo pacman -U`                       | Install a package from a local file                              |
  19 | pacinsd      | `sudo pacman -S --asdeps`              | Install packages as dependencies of another package              |
  20 | paclean      | `sudo pacman -Sc`                      | Clean out old and unused caches and packages                     |
  21 | pacloc       | `pacman -Qi`                           | Display information about a package in the local database        |
  22 | paclocs      | `pacman -Qs`                           | Search for packages in the local database                        |
  23 | paclr        | `sudo pacman -Scc`                     | Remove all files from the cache                                  |
  24 | paclsorphans | `sudo pacman -Qdt`                     | List all orphaned packages                                       |
  25 | pacmir       | `sudo pacman -Syy`                     | Force refresh of all package lists after updating mirrorlist     |
  26 | pacre        | `sudo pacman -R`                       | Remove packages, keeping its settings and dependencies           |
  27 | pacrem       | `sudo pacman -Rns`                     | Remove packages, including its settings and dependencies         |
  28 | pacrep       | `pacman -Si`                           | Display information about a package in the repositories          |
  29 | pacreps      | `pacman -Ss`                           | Search for packages in the repositories                          |
  30 | pacrmorphans | `sudo pacman -Rs $(pacman -Qtdq)`      | Delete all orphaned packages                                     |
  31 | pacupd       | `sudo pacman -Sy`                      | Update and refresh local package, ABS and AUR databases          |
  32 | pacupg       | `sudo pacman -Syu`                     | Sync with repositories before upgrading packages                 |
  33 | pacfileupg   | `sudo pacman -Fy`                      | Download fresh package databases from the server                 |
  34 | pacfiles     | `pacman -F`                            | Search package file names for matching strings                   |
  35 | pacls        | `pacman -Ql`                           | List files in a package                                          |
  36 | pacown       | `pacman -Qo`                           | Show which package owns a file                                   |
  37 | upgrade[¹](#f1) | `sudo pacman -Syu`                  | Sync with repositories before upgrading packages                 |
  38
  39 | Function       | Description                                               |
  40 |----------------|-----------------------------------------------------------|
  41 | pacdisowned    | List all disowned files in your system                    |
  42 | paclist        | List all explicitly installed packages with a description |
  43 | pacmanallkeys  | Get all keys for developers and trusted users             |
  44 | pacmansignkeys | Locally trust all keys passed as parameters               |
  45 | pacweb         | Open the website of an ArchLinux package                  |
  46
  47 Note: paclist used to print packages with a description which are (1) explicitly installed
  48 and (2) available for upgrade. Due to flawed scripting, it also printed all packages if no
  49 upgrades were available. Use `pacman -Que` instead.
  50
  51 ### AUR helpers
  52
  53 #### Aura
  54
  55 | Alias   | Command                                         | Description                                                             |
  56 |---------|-------------------------------------------------|-------------------------------------------------------------------------|
  57 | auclean | `sudo aura -Sc`                                 | Clean out old and unused caches and packages                            |
  58 | auclr   | `sudo aura -Scc`                                | Remove all files from the cache                                         |
  59 | auin    | `sudo aura -S`                                  | Install packages from the repositories                                  |
  60 | aurin   | `sudo aura -A`                                  | Install packages from the repositories                                  |
  61 | auins   | `sudo aura -U`                                  | Install a package from a local file                                     |
  62 | auinsd  | `sudo aura -S --asdeps`                         | Install packages as dependencies of another package (repositories only) |
  63 | aurinsd | `sudo aura -A --asdeps`                         | Install packages as dependencies of another package (AUR only)          |
  64 | auloc   | `aura -Qi`                                      | Display information about a package in the local database               |
  65 | aulocs  | `aura -Qs`                                      | Search for packages in the local database                               |
  66 | auls    | `aura -Qql`                                     | List all files owned by a given package                                 |
  67 | aulst   | `aura -Qe`                                      | List installed packages including from AUR (tagged as "local")          |
  68 | aumir   | `sudo aura -Syy`                                | Force refresh of all package lists after updating mirrorlist            |
  69 | aurph   | `sudo aura -Oj`                                 | Remove orphans using aura                                               |
  70 | auown   | `aura -Qqo`                                     | Search for packages that own the specified file(s)                      |
  71 | aure    | `sudo aura -R`                                  | Remove packages, keeping its settings and dependencies                  |
  72 | aurem   | `sudo aura -Rns`                                | Remove packages, including its settings and unneeded dependencies       |
  73 | aurep   | `aura -Si`                                      | Display information about a package in the repositories                 |
  74 | aurrep  | `aura -Ai`                                      | Display information about a package from AUR                            |
  75 | aureps  | `aura -As --both`                               | Search for packages in the repositories and AUR                         |
  76 | auras   | `aura -As --both`                               | Same as above                                                           |
  77 | auupd   | `sudo aura -Sy`                                 | Update and refresh local package, ABS and AUR databases                 |
  78 | auupg   | `sudo sh -c "aura -Syu              && aura -Au"` | Sync with repositories before upgrading all packages (from AUR too)   |
  79 | ausu    | `sudo sh -c "aura -Syu --no-confirm && aura -Au --no-confirm"` | Same as `auupg`, but without confirmation                |
  80 | upgrade[¹](#f1) | `sudo aura -Syu`                        | Sync with repositories before upgrading packages                        |
  81
  82 | Function        | Description                                                         |
  83 |-----------------|---------------------------------------------------------------------|
  84 | auownloc _file_ | Display information about a package that owns the specified file(s) |
  85 | auownls  _file_ | List all files owned by a package that owns the specified file(s)   |
  86
  87 #### Pacaur
  88
  89 | Alias   | Command                           | Description                                                         |
  90 |---------|-----------------------------------|---------------------------------------------------------------------|
  91 | pacclean| `pacaur -Sc`                      | Clean out old and unused caches and packages                        |
  92 | pacclr  | `pacaur -Scc`                     | Remove all files from the cache                                     |
  93 | pain    | `pacaur -S`                       | Install packages from the repositories                              |
  94 | pains   | `pacaur -U`                       | Install a package from a local file                                 |
  95 | painsd  | `pacaur -S --asdeps`              | Install packages as dependencies of another package                 |
  96 | paloc   | `pacaur -Qi`                      | Display information about a package in the local database           |
  97 | palocs  | `pacaur -Qs`                      | Search for packages in the local database                           |
  98 | palst   | `pacaur -Qe`                      | List installed packages including from AUR (tagged as "local")      |
  99 | pamir   | `pacaur -Syy`                     | Force refresh of all package lists after updating mirrorlist        |
 100 | paorph  | `pacaur -Qtd`                     | Remove orphans using pacaur                                         |
 101 | pare    | `pacaur -R`                       | Remove packages, keeping its settings and dependencies              |
 102 | parem   | `pacaur -Rns`                     | Remove packages, including its settings and unneeded dependencies   |
 103 | parep   | `pacaur -Si`                      | Display information about a package in the repositories             |
 104 | pareps  | `pacaur -Ss`                      | Search for packages in the repositories                             |
 105 | paupd   | `pacaur -Sy`                      | Update and refresh local package, ABS and AUR databases             |
 106 | paupg   | `pacaur -Syua`                    | Sync with repositories before upgrading all packages (from AUR too) |
 107 | pasu    | `pacaur -Syua --no-confirm`       | Same as `paupg`, but without confirmation                           |
 108 | upgrade[¹](#f1) | `pacaur -Syu`             | Sync with repositories before upgrading packages                    |
 109
 110 #### Trizen
 111
 112 | Alias   | Command                           | Description                                                         |
 113 |---------|-----------------------------------|---------------------------------------------------------------------|
 114 | trconf  | `trizen -C`                       | Fix all configuration files with vimdiff                            |
 115 | trclean | `trizen -Sc`                      | Clean out old and unused caches and packages                        |
 116 | trclr   | `trizen -Scc`                     | Remove all files from the cache                                     |
 117 | trin    | `trizen -S`                       | Install packages from the repositories                              |
 118 | trins   | `trizen -U`                       | Install a package from a local file                                 |
 119 | trinsd  | `trizen -S --asdeps`              | Install packages as dependencies of another package                 |
 120 | trloc   | `trizen -Qi`                      | Display information about a package in the local database           |
 121 | trlocs  | `trizen -Qs`                      | Search for packages in the local database                           |
 122 | trlst   | `trizen -Qe`                      | List installed packages including from AUR (tagged as "local")      |
 123 | trmir   | `trizen -Syy`                     | Force refresh of all package lists after updating mirrorlist        |
 124 | trorph  | `trizen -Qtd`                     | Remove orphans using yaourt                                         |
 125 | trre    | `trizen -R`                       | Remove packages, keeping its settings and dependencies              |
 126 | trrem   | `trizen -Rns`                     | Remove packages, including its settings and unneeded dependencies   |
 127 | trrep   | `trizen -Si`                      | Display information about a package in the repositories             |
 128 | trreps  | `trizen -Ss`                      | Search for packages in the repositories                             |
 129 | trupd   | `trizen -Sy`                      | Update and refresh local package, ABS and AUR databases             |
 130 | trupg   | `trizen -Syua`                    | Sync with repositories before upgrading all packages (from AUR too) |
 131 | trsu    | `trizen -Syua --no-confirm`       | Same as `trupg`, but without confirmation                           |
 132 | upgrade[¹](#f1) | `trizen -Syu`             | Sync with repositories before upgrading packages                    |
 133
 134 #### Yay
 135
 136 | Alias   | Command                        | Description                                                       |
 137 |---------|--------------------------------|-------------------------------------------------------------------|
 138 | yaconf  | `yay -Pg`                      | Print current configuration                                       |
 139 | yaclean | `yay -Sc`                      | Clean out old and unused caches and packages                      |
 140 | yaclr   | `yay -Scc`                     | Remove all files from the cache                                   |
 141 | yain    | `yay -S`                       | Install packages from the repositories                            |
 142 | yains   | `yay -U`                       | Install a package from a local file                               |
 143 | yainsd  | `yay -S --asdeps`              | Install packages as dependencies of another package               |
 144 | yaloc   | `yay -Qi`                      | Display information about a package in the local database         |
 145 | yalocs  | `yay -Qs`                      | Search for packages in the local database                         |
 146 | yalst   | `yay -Qe`                      | List installed packages including from AUR (tagged as "local")    |
 147 | yamir   | `yay -Syy`                     | Force refresh of all package lists after updating mirrorlist      |
 148 | yaorph  | `yay -Qtd`                     | Remove orphans using yay                                          |
 149 | yare    | `yay -R`                       | Remove packages, keeping its settings and dependencies            |
 150 | yarem   | `yay -Rns`                     | Remove packages, including its settings and unneeded dependencies |
 151 | yarep   | `yay -Si`                      | Display information about a package in the repositories           |
 152 | yareps  | `yay -Ss`                      | Search for packages in the repositories                           |
 153 | yaupd   | `yay -Sy`                      | Update and refresh local package, ABS and AUR databases           |
 154 | yaupg   | `yay -Syu`                     | Sync with repositories before upgrading packages                  |
 155 | yasu    | `yay -Syu --no-confirm`        | Same as `yaupg`, but without confirmation                         |
 156 | upgrade[¹](#f1) | `yay -Syu`             | Sync with repositories before upgrading packages                  |
 157
 158 ---
 159
 160 <span id="f1">¹</span>
 161 The `upgrade` alias is set for all package managers. Its value will depend on
 162 whether the package manager is installed, checked in the following order:
 163
 164 1. `yay`
 165 2. `trizen`
 166 3. `pacaur`
 167 4. `aura`
 168 5. `pacman`
 169
 170 ## Contributors
 171
 172 - Benjamin Boudreau - dreurmail@gmail.com
 173 - Celso Miranda - contacto@celsomiranda.net
 174 - ratijas (ivan tkachenko) - me@ratijas.tk
 175 - Juraj Fiala - doctorjellyface@riseup.net
 176 - KhasMek - Boushh@gmail.com
 177 - Majora320 (Moses Miller) - Majora320@gmail.com
 178 - Martin Putniorz - mputniorz@gmail.com
 179 - MatthR3D - matthr3d@gmail.com
 180 - ornicar - thibault.duplessis@gmail.com
 181 - Ybalrid (Arthur Brainville) - ybalrid@ybalrid.info
 182 - Jeff M. Hubbard - jeffmhubbard@gmail.com
 183 - K. Harishankar(harishnkr) - hari2menon1234@gmail.com