.\" Automatically generated by Pandoc 3.1.3
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "nala-fetch" "8" "10 May 2024" "0.15.2" "'Nala User Manual'"
.hy
.SH NAME
.PP
nala-fetch - Fetch fast mirrors to improve download speed
.SH SYNOPSIS
.PP
\f[B]nala fetch\f[R] [\f[I]--options\f[R]]
.SH DESCRIPTION
.PP
\f[B]nala\f[R] will fetch fast mirrors to improve download speed.
.PP
\f[B]nala\f[R] parses the following files to find mirrors:
.RS
.PP
For Debian <https://mirror-master.debian.org/status/Mirrors.masterlist>
.PP
For Ubuntu <https://launchpad.net/ubuntu/+archivemirrors-rss>
.PP
For Devuan <https://pkgmaster.devuan.org/mirror_list.txt>
.RE
.PP
The resulting file of mirrors will be located at
\f[I]/etc/apt/sources.list.d/nala-sources.list\f[R]
.PP
When selecting mirrors in the interactive display, you can pass a comma
or space separated list.
.PP
Examples:
.RS
.PP
Specific List:
.RS
.PP
\f[I]1,2,3,4\f[R] Selects mirrors 1, 2, 3 and 4
.PP
Comma and spaces may be mixed in the input.
\f[B]nala\f[R] will parse it all the same.
.PP
\f[I]1,3 , 4 5\f[R] will select mirrors 1, 3, 4 and 5
.RE
.PP
Range: \f[I]1..5\f[R] will select mirrors 1 through 5
.PP
Even Range: \f[I]0..1..5\f[R] selects 2 and 4
.PP
Odd Range: \f[I]1..1..5\f[R] selects 1, 3 and 5
.RE
.SH OPTIONS
.TP
\f[B]--debian\f[R]
Instead of auto detecting the distro and release, you can use this
switch to specify a Debian release.
.RS
.PP
\f[B]nala fetch\f[R] \f[I]--debian sid\f[R]
.RE
.TP
\f[B]--ubuntu\f[R]
Much like \f[I]--debian\f[R] but for Ubuntu
.RS
.PP
\f[B]nala fetch\f[R] \f[I]--ubuntu jammy\f[R]
.RE
.TP
\f[B]--devuan\f[R]
Much like \f[I]--debian\f[R] but for Devuan
.RS
.PP
\f[B]nala fetch\f[R] \f[I]--devuan unstable\f[R]
.RE
.TP
\f[B]--https-only\f[R]
\f[B]fetch\f[R] will only provide https mirrors.
.TP
\f[B]--auto\f[R]
Run \f[B]fetch\f[R] uninteractively.
Will still prompt for overwriting the sources file if it exists.
.TP
\f[B]--fetches\f[R]
This controls the number of mirrors to fetch.
.RS
.PP
With \f[I]--auto\f[R] this will default to 3 mirrors, and write as many
mirrors as you specify to the file.
.PP
In the interactive version of \f[B]fetch\f[R], this will default to 16
mirrors.
Instead of controlling the amount of mirrors that will be written, it
controls the amount of mirrors you are shown to select from.
.RE
.TP
\f[B]--sources\f[R]
Add the source repos for the mirror, if it exists.
.RS
.PP
By default \f[B]nala\f[R] will not include the source repos.
.RE
.TP
\f[B]--non-free\f[R]
Add contrib and non-free components of the Debian mirrors.
.RS
.PP
This switch does nothing on Ubuntu systems.
.RE
.TP
\f[B]--debug\f[R]
Print helpful information for solving issues.
If you\[aq]re submitting a bug report try running the command again with
\f[I]--debug\f[R] and providing the output to the devs, it may be
helpful.
.TP
\f[B]-c\f[R], \f[B]--country\f[R]
Specify your country to limit the mirror search using the 2 letter ISO
country code.
.RS
.PP
This option can be specified multiple times to increase the pool.
.PP
Example:
.RS
.PP
\f[B]nala fetch\f[R] \f[I]-c US -c CA\f[R]
.RE
.RE
.TP
\f[B]-v\f[R], \f[B]--verbose\f[R]
Disable scrolling text and print extra information
.TP
\f[B]-h\f[R], \f[B]--help\f[R]
Shows this man page.
.SH COPYRIGHT
.PP
Copyright (C) 2021, 2022 Blake Lee