Due to an influx of spam, we had to disable account registrations. If you don't have an account yet, please write an email to support@manjaro.org, with your desired username. Sorry for the inconvenience.
<p>Generate mirrorlist for Manjaro Linux. Default is to rank all mirrors by reponse time. If no arguments are given pacman-mirrors lists available options. Pacman-mirrors requires access to files which are read-only so it must be run with su or sudo. To create a up-to-date mirrorlist using all default use,</p>
<p>After all operations <strong>ALWAYS</strong> syncronize your pacman database with</p>
<pre><code>sudo pacman -Syy</code></pre>
<h1id="options">OPTIONS</h1>
<h1id="operation">OPERATION</h1>
<p>Some options are mutual exclusive and will throw an arguments error:</p>
<ul>
<li><strong>--branch</strong>, <strong>--get-branch</strong> and <strong>--set-branch</strong></li>
<li><strong>--country</strong> and <strong>--geoip</strong></li>
</ul>
<p>Others can be used together but they have precedence. If the fasttrack arg is used with interactive, country or geoip the fasttrack arg will have precendence and the others are ignored. Some arguments requires other argument to have effect for example,this command will ignore --default argument</p>
<pre><code>WRONG
pacman-mirrors -b unstable --default</code></pre>
<p>as it should have been in conjunction with --interactive, like</p>
<p>The arguments can appear in any order except for arguments which takes additional options in which case the options must follow immediately after the argument, for example</p>
<p>Pacman-mirrors downloads the lastest available status from <ahref="http://repo.manjaro.org"class="uri">http://repo.manjaro.org</a>. These data is always used during mirrorlist generation to ensure that you connected to a mirror which is up-to-date for your selected branch. Should you decide to temporarily switch branches you will still connect to an up-to-date mirror.</p>
<p>The arguments can appear in any order except for arguments which takes additional options in which case the options must follow immediately after the argument with or without space, for example</p>
<pre><code>pacman-mirrors -aB unstable
pacman-mirrors -aBunstable
pacman-mirrors -f 5
pacman-mirrors -f5</code></pre>
<p>Pacman-mirrors always attempt to download the lastest available data from <ahref="http://repo.manjaro.org"class="uri">http://repo.manjaro.org</a>. These data is always used during mirrorlist generation to ensure that you connect to a mirror which is up-to-date for your selected branch. Should you decide to temporarily switch branches you will still connect to an up-to-date mirror.</p>
<h1id="arguments-and-options">ARGUMENTS AND OPTIONS</h1>
<h2id="important-to-remember">IMPORTANT TO REMEMBER</h2>
<p>It cannot be stressed enough that for every mirrorlist generation you commence, you <strong>MUST</strong> run <em>pacman -Syy</em>.</p>
<p>For every mirrorlist generation, you <strong>MUST</strong> run <em>pacman -Syy</em>.</p>
<h2id="methods">METHODS</h2>
<dl>
<dt>-f, --fasttrack <em>NUMBER</em></dt>
<dd>Generates an up-to-date mirrorlist for the users current selected branch, mirrors are randomly selected from <ahref="http://repo.manjaro.org/status.json"class="uri">http://repo.manjaro.org/status.json</a>, the randomly selected mirrors are ranked by their current access time. The higher number the higher possibility of a fast mirror. If the number 0 is used - it is understood that all mirrors mirrors should be used.
<dd>Generates an up-to-date mirrorlist for the users current selected branch, mirrors are randomly selected from the users current mirrorfile, either a custom mirror file or the default status file, the randomly selected mirrors are ranked by their current access time. The higher number the higher possibility of a fast mirror. If the number 0 is used - it is understood that all mirrors mirrors should be used.
</dd>
<dt>-i, --interactive [--default]</dt>
<dd>This is a function designed to leave full control for mirrors and protocols. This function <strong>DOES NOT</strong> take into consideration up-to-date mirrors. The addition argument <strong>--default</strong> forces pacman-mirrors to load the default mirror file and ignore any preset custom-mirrors file, thus allowing for reselecting mirrors for a new custom mirror file.
<dd>This is a function designed to leave full control for mirrors and protocols to the user. This function <strong>DOES NOT</strong> take into consideration up-to-date mirrors. The addition argument <strong>--default</strong> forces pacman-mirrors to load the default mirror file and ignore any preset custom-mirrors file, thus allowing for reselecting mirrors for a new custom mirror file.
<h2id="important-to-remember-1">IMPORTANT TO REMEMBER</h2>
<p>It cannot be stressed enough that for every mirrorlist generation you commence, you <strong>MUST</strong> run <em>pacman -Syy</em>.</p>
<p>For every mirrorlist generation, you <strong>MUST</strong> run <em>pacman -Syy</em>.</p>
<h2id="configuration-flow-of-pacman-mirrors">Configuration flow of pacman-mirrors</h2>
<p>At launch an internal default configuration is setup, file configuration is applied and the commandline is parsed and applied.</p>
<h2id="api-arguments">API arguments</h2>
<p>These arguments modifies key elements of pacman-mirrors configuration according to the packagers needs.</p>
<p>The actions performed by the API are in strict order and performed <em>before any</em> other actions. This also means that ordinary arguments supplied in conjunction with app might be ignored. Eg. <strong>-U</strong> argument terminates pacman-mirrors when branch and mirrorlist has been written.</p>
<p>The actions performed by the API are in strict order and performed <em>before any</em> other actions. This also means that ordinary arguments supplied in conjunction with api might be ignored. Eg. <strong>-U</strong> argument terminates pacman-mirrors when branch and mirrorlist has been written.</p>
<olstyle="list-style-type: decimal">
<li>If <em>-G</em></li>
</ol>
...
...
@@ -174,10 +180,16 @@ BRANCH: Value from config</code></pre>
<h1id="examples">EXAMPLES</h1>
<p>Most optional arguments are self explaining others require explanation. The API functions is mainly designed to help packagers and iso-builders. However it can be of use for everyone because it takes the hazzle out of editing your pacman-mirrors configuration.</p>
<h2id="important-to-remember-2">IMPORTANT TO REMEMBER</h2>
<p>It cannot be stressed enough that for every mirrorlist generation you commence, you <strong>MUST</strong> run <em>pacman -Syy</em>.</p>
<p>For every mirrorlist generation, you <strong>MUST</strong> run <em>pacman -Syy</em>.</p>
