diff options
| author | Drew DeVault <sir@cmpwn.com> | 2020-01-06 22:18:41 -0500 |
|---|---|---|
| committer | Timo Teräs <timo.teras@iki.fi> | 2020-01-26 09:01:26 +0200 |
| commit | 8da102ccfff82066a71c055e35e1318112b16d02 (patch) | |
| tree | 1eefbe518cdcb58864159b2dfece3e39494c998c | |
| parent | c9e33ca851ec1cfec645b84a3f3f410c80335c1a (diff) | |
| download | apk-tools-8da102ccfff82066a71c055e35e1318112b16d02.tar.bz2 apk-tools-8da102ccfff82066a71c055e35e1318112b16d02.tar.xz | |
add apk-repositories(5)
| -rw-r--r-- | doc/Makefile | 1 | ||||
| -rw-r--r-- | doc/apk-repositories.5.scd | 40 |
2 files changed, 41 insertions, 0 deletions
diff --git a/doc/Makefile b/doc/Makefile index 57b4e5f..310a4c3 100644 --- a/doc/Makefile +++ b/doc/Makefile @@ -5,6 +5,7 @@ $(obj)/%.8: $(src)/%.8.scd $(SCDOC) < $< > $@ docs: $(obj)/apk.8 \ + $(obj)/apk-repositories.5 \ $(obj)/apk-world.5 targets += docs diff --git a/doc/apk-repositories.5.scd b/doc/apk-repositories.5.scd new file mode 100644 index 0000000..8ae3d40 --- /dev/null +++ b/doc/apk-repositories.5.scd @@ -0,0 +1,40 @@ +apk-repositories(5) + +# NAME + +*/etc/apk/repositories* - list of package repositories + +# DESCRIPTION + +/etc/apk/repositories is the list of package repositories *apk*(8) uses to +retrieve package files for installation. Each line of this file specifies the +location of a package repository, and optionally a tag. + +The location may be an _http://_, _https://_, or _ftp://_ URL, or the path to a +directory on the local filesystem. A tagged repository is prefixed with the +*@tag* specifier, followed by a space and the repository location. For more +information about repository tags, see *apk-world*(5). + +# REPOSITORY LAYOUT + +Each repository must store an index at *$repository/$arch/APKINDEX.tar.gz*. See +*apk-index*(8) for information about generating this file. The packages +themselves are stored at *$repository/$arch/$pkgname-$pkgver-r$pkgrel.apk*. + +*apk*(8) verifies that each of these files has a valid cryptographic signature +unless explicitly told not to via the *--allow-untrusted* flag. See +*abuild-keygen*(1) for information about generating keys, *apk-keys*(5) to add +keys to the list of trusted keys, *abuild-sign*(1) for information about using +these keys to sign files, and *apk-verify*(8) for information about verifying +those signatures. + +# UPDATING INDICIES + +*apk*(8) fetches and stores the index for each package repository at +/var/lib/cache. To fetch fresh indicies for all configured repositories, use +*apk-update*(8). + +# AUTHORS + +Natanael Copa <ncopa@alpinelinux.org>++ +Timo Teräs <_timo.teras@iki.fi_> |