1
0
Fork 0
update-mirrors/README.org

25 lines
1.6 KiB
Org Mode
Raw Normal View History

2022-06-19 06:30:44 +02:00
#+title: update-mirrors
This is a simple utility for [[https://archlinux.org/][archlinux]] that keeps the mirror list up-to-date.
Whenever the =pacman-mirrorlist= updates it's always a pain to have to pick out which servers exactly you want. And the archlinux project provides a nice [[https://archlinux.org/mirrorlist/][Pacman Mirrorlist Generator]]. This utility uses that generator to automatically update the mirror list every time =pacman-mirrorlist= is updated.
* Installation
I've provided a =PKGBUILD= through which it can be installed:
: makepkg -sic
It will install the executable, configuration file, and pacman hook into the proper locations so that after it will always be called automatically.
* Configuration
There are a few configuration options. The configuration file is just a regular shell script sourced by the =update-mirrors= script.
- =url= :: A string. The base URL for archlinux's mirrorlist generator. You probably don't have to change this.
- =countries= :: An array of strings. Which countries you want to include mirrors from. You will probably want to change this.
- =protocols= :: An array of strings. Which protocols to include. Available protocols are =http= and =https=.
- =ip_versions= :: An array of numbers. Which IP versions to include in the mirrorlist. Available versions are =4= and =6=.
- =use_mirror_status= :: The string “on” or empty. Turning this on will make the generator filter the list of mirrors by the mirror score from the [[https://archlinux.org/mirrors/status/][Mirror Status]] page.
- =dest= :: A string, a file path. Where to write the result to. You probably don't have to change this.