8,138
edits
Difference between revisions of "Pacman-mirrors/en"
Updating to match new version of source page
(Updating to match new version of source page) |
(Updating to match new version of source page) Tags: Mobile web edit Mobile edit |
||
| Line 20: | Line 20: | ||
The app is run by an ordinary user with superuser rights from the console and when no arguments are given it will display pacman-mirrors version followed by status of the mirrors currently listed in your mirrorlist. | The app is run by an ordinary user with superuser rights from the console and when no arguments are given it will display pacman-mirrors version followed by status of the mirrors currently listed in your mirrorlist. | ||
{{UserCmd|command=sudo pacman-mirrors}} | |||
Exactly how the app generates the mirrorlist is controlled by supplying arguments on the commandline. | Exactly how the app generates the mirrorlist is controlled by supplying arguments on the commandline. | ||
| Line 27: | Line 27: | ||
{{Tip|Every run of pacman-mirrors requires you to syncronize your database and update your system.}} | {{Tip|Every run of pacman-mirrors requires you to syncronize your database and update your system.}} | ||
{{UserCmd|command=sudo pacman -Syu}} | |||
If you fail to do so, the issue/s which had you make change might not be solved. Furthermore you might run into [[System_Maintenance|''partial-updated'']] scenario which can cause havoc in your system. For more detailed information on how pacman works you can read up on the [https://wiki.archlinux.org/index.php/System_maintenance Archlinux Wiki] | If you fail to do so, the issue/s which had you make change might not be solved. Furthermore you might run into [[System_Maintenance|''partial-updated'']] scenario which can cause havoc in your system. For more detailed information on how pacman works you can read up on the [https://wiki.archlinux.org/index.php/System_maintenance Archlinux Wiki] | ||
| Line 41: | Line 41: | ||
====Man page==== | ====Man page==== | ||
{{UserCmd|command=man pacman-mirrors}} | |||
====Help on usage==== | ====Help on usage==== | ||
{{UserCmd|command=pacman-mirrors --help}} | |||
====Version==== | ====Version==== | ||
{{UserCmd|command=pacman-mirrors --version}} | |||
====Mirror status==== | ====Mirror status==== | ||
{{UserCmd|command=pacman-mirrors --status}} | |||
====List available countries==== | ====List available countries==== | ||
In default mirror pool | In default mirror pool | ||
{{UserCmd|command=pacman-mirrors --country-list}} | |||
In custom mirror pool | In custom mirror pool | ||
{{UserCmd|command=pacman-mirrors --country-config}} | |||
====What branch am I on==== | ====What branch am I on==== | ||
{{UserCmd|command=pacman-mirrors --get-branch}} | |||
===Commands using defaults=== | ===Commands using defaults=== | ||
====Update mirrorlist with the fastest mirrors==== | ====Update mirrorlist with the fastest mirrors==== | ||
{{UserCmd|command=sudo pacman-mirrors --fasttrack && sudo pacman -Syu}} | |||
====Limit to 5 mirrors==== | ====Limit to 5 mirrors==== | ||
An optional number can be supplied to limit the number of mirrors in the mirrorlist | An optional number can be supplied to limit the number of mirrors in the mirrorlist | ||
{{UserCmd|command=sudo pacman-mirrors --fasttrack 5 && sudo pacman -Syu}} | |||
====Mirrors for your country only==== | ====Mirrors for your country only==== | ||
Not all countries have mirrors, if geoip returns a country not in the pool all mirrors will be used. | Not all countries have mirrors, if geoip returns a country not in the pool all mirrors will be used. | ||
{{UserCmd|command=sudo pacman-mirrors --geoip && sudo pacman -Syu}} | |||
===Commands customizing the mirror pool=== | ===Commands customizing the mirror pool=== | ||
| Line 82: | Line 82: | ||
====Customize mirror pool by continent==== | ====Customize mirror pool by continent==== | ||
Create a custom mirror pool using mirrors from the continent determined by querying a geolocation service | Create a custom mirror pool using mirrors from the continent determined by querying a geolocation service | ||
{{UserCmd|command=sudo pacman-mirrors --continent && sudo pacman -Syu}} | |||
====Customize mirror pool by countries==== | ====Customize mirror pool by countries==== | ||
Create a custom mirror pool using mirrors from Germany, France and Austria | Create a custom mirror pool using mirrors from Germany, France and Austria | ||
{{UserCmd|command=sudo pacman-mirrors --country Germany,France,Austria && sudo pacman -Syu}} | |||
====Customize mirror pool by interactive selection==== | ====Customize mirror pool by interactive selection==== | ||
Create a custom mirror pool using the '''--default''' mirror pool '''--interactive''' will list all available mirrors and procotols in a gui windows allowing to sort the columns and interactively select according to your preferences. | Create a custom mirror pool using the '''--default''' mirror pool '''--interactive''' will list all available mirrors and procotols in a gui windows allowing to sort the columns and interactively select according to your preferences. | ||
{{UserCmd|command=sudo pacman-mirrors --interactive --default && sudo pacman -Syu}} | |||
====Use specific protocols (prioritized)==== | ====Use specific protocols (prioritized)==== | ||
Rank the current mirror pool using only https and http protocol | Rank the current mirror pool using only https and http protocol | ||
{{UserCmd|command=sudo pacman-mirrors --api --protocol https,http && sudo pacman -Syu}} | |||
====Switch branch to unstable and use German mirrors==== | ====Switch branch to unstable and use German mirrors==== | ||
Change the system branch to unstable and create a custom mirror pool using mirrors from Germany | Change the system branch to unstable and create a custom mirror pool using mirrors from Germany | ||
{{UserCmd|command=sudo pacman-mirrors --country Germany --api --set-branch unstable && sudo pacman -Syu}} | |||
==== Switch branch and use German mirrors with https==== | ==== Switch branch and use German mirrors with https==== | ||
Change the system branch to unstable, set configuration to use https only and create a custom mirror pool using mirrors from Germany | Change the system branch to unstable, set configuration to use https only and create a custom mirror pool using mirrors from Germany | ||
{{UserCmd|command=sudo pacman-mirrors --country Germany --api --set-branch unstable --protocol https && sudo pacman -Syu}} | |||
===Reset=== | ===Reset=== | ||
You will come to a point where you want to reset to defaults | You will come to a point where you want to reset to defaults | ||
sudo pacman-mirrors --country all --api --protocols all --set-branch stable && sudo pacman -Syu | {{UserCmd|command=sudo pacman-mirrors --country all --api --protocols all --set-branch stable && sudo pacman -Syu}} | ||
==Overview== | ==Overview== | ||
| Line 1,950: | Line 1,950: | ||
Instead of pacman-mirrors probing all mirrors in all countries it is possible to supply a list of countries from which to use the mirrors. This creates a custom mirror pool. The countries is an example - check the country list if in doubt. | Instead of pacman-mirrors probing all mirrors in all countries it is possible to supply a list of countries from which to use the mirrors. This creates a custom mirror pool. The countries is an example - check the country list if in doubt. | ||
{{UserCmd|command=sudo pacman-mirrors --country Germany,France,Austria && sudo pacman -Syu}} | |||
If a supplied country does not offer a mirrorserver the app quits with an error explaining why. | If a supplied country does not offer a mirrorserver the app quits with an error explaining why. | ||
{{UserCmd|command=sudo pacman-mirrors --country Antarctica && sudo pacman -Syu}} | |||
.: Info Downloading mirrors from repo.manjaro.org | .: Info Downloading mirrors from repo.manjaro.org | ||
.: Warning Option '-c/--country' : unknown country: 'Antarctica' | .: Warning Option '-c/--country' : unknown country: 'Antarctica' | ||
| Line 1,983: | Line 1,983: | ||
'''First option''' is using ''--interactive''. It uses your current mirror pool(whether default or custom) | '''First option''' is using ''--interactive''. It uses your current mirror pool(whether default or custom) | ||
{{UserCmd|command=sudo pacman-mirrors --interactive && sudo pacman -Syu}} | |||
'''Second option''' is using ''--interactive --default''. This force the use of the official mirror pool | '''Second option''' is using ''--interactive --default''. This force the use of the official mirror pool | ||
{{UserCmd|command=sudo pacman-mirrors --interactive --default && sudo pacman -Syu}} | |||
'''Third option''' is supplying a list of countries with ''--country''. The countries is an example - check the country list if in doubt. | '''Third option''' is supplying a list of countries with ''--country''. The countries is an example - check the country list if in doubt. | ||
{{UserCmd|command=sudo pacman-mirrors --country Germany,France,Austria && sudo pacman -Syu}} | |||
'''Fourth option''' is ''--continent''. The countries used is determined by the continent they are assigned to and can optionally be combined with '''--interactive'''. | '''Fourth option''' is ''--continent''. The countries used is determined by the continent they are assigned to and can optionally be combined with '''--interactive'''. | ||
{{UserCmd|command=sudo pacman-mirrors --continent [--interactive]}} | |||
Using ''--interactive'' option, pacman-mirrors will process the available mirrors and present you with a list in which you will select your desired mirrors. In any case the pool is saved and used to generate a mirrorlist. | Using ''--interactive'' option, pacman-mirrors will process the available mirrors and present you with a list in which you will select your desired mirrors. In any case the pool is saved and used to generate a mirrorlist. | ||
| Line 2,004: | Line 2,004: | ||
'''First option''' to reset is to default mirror pool | '''First option''' to reset is to default mirror pool | ||
{{UserCmd|command=sudo pacman-mirrors --country all && sudo pacman -Syu}} | |||
'''Second option''' to is to use ''--default'' with ''--interactive'' and creating a new custom mirror pool | '''Second option''' to is to use ''--default'' with ''--interactive'' and creating a new custom mirror pool | ||
{{UserCmd|command=sudo pacman-mirrors --interactive --default && sudo pacman -Syu}} | |||
* You will be presented with a list with all and every mirror and you can pick your selection. | * You will be presented with a list with all and every mirror and you can pick your selection. | ||
'''Third option''' is to supply a list of countries and use those for a custom mirror pool. | '''Third option''' is to supply a list of countries and use those for a custom mirror pool. | ||
The countries is an example - check the country list if in doubt. | The countries is an example - check the country list if in doubt. | ||
{{UserCmd|command=sudo pacman-mirrors --country Germany,France,Austria && sudo pacman -Syu}} | |||
* If you supply the same preferred countries on every reset you will get your mirror pool updated with added or removed mirrors. | * If you supply the same preferred countries on every reset you will get your mirror pool updated with added or removed mirrors. | ||
| Line 2,019: | Line 2,019: | ||
=== Apply pacman-mirrors defaults === | === Apply pacman-mirrors defaults === | ||
{{UserCmd|command=sudo pacman-mirrors --country all --api --protocol all -set-branch stable && sudo pacman -Syu}} | |||
The system will throw messages about newer packages on the system. These messages can safely be ignored and they dissappear when the installed package(s) equals the system branch. | The system will throw messages about newer packages on the system. These messages can safely be ignored and they dissappear when the installed package(s) equals the system branch. | ||