apk-add.8.scd 1.98 KB
Newer Older
Drew DeVault's avatar
Drew DeVault committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
apk-add(8)

# NAME

apk add - add packages to _world_ and commit changes

# SYNOPSIS

*apk add* [<_options_>...] _packages_...

# DESCRIPTION

*apk add* adds the requested packages to _world_ and installs (or upgrades)
them if not already present, ensuring all dependencies are met.

16 17 18 19 20 21
To upgrade individual packages without modifying _world_ use *apk-fix*(8).

By default *apk* tries to select a set of packages so that all dependencies
are satisfied. This means that some packages can be held back in an older
version if there is direct or implicit dependencies to the older version.

Drew DeVault's avatar
Drew DeVault committed
22 23
# OPTIONS

24 25
*apk add* supports the commit options described in *apk*(8), as well as the
following options:
Drew DeVault's avatar
Drew DeVault committed
26 27 28 29 30

*--initdb*
	Initialize a new package database.

*-l, --latest*
31 32 33 34
	Always choose the latest package by version. However, the versions
	considered are based on the package pinning. Primarily this overrides
	the default heuristic and will cause an error to displayed if all
	dependencies cannot be satisfied.
Drew DeVault's avatar
Drew DeVault committed
35 36

*-u, --upgrade*
37 38 39 40
	Upgrade _packages_ and it's dependencies. Normally *apk add* will
	avoid changing installed package unless it is required by the newly
	added _packages_ or their dependencies. This changes the default
	preference to upgrading the package to the latest installable version.
Drew DeVault's avatar
Drew DeVault committed
41 42

*-t, --virtual* _NAME_
43 44 45
	Create virtual package _NAME_ with given dependencies. This new package
	will get the _packages_ as dependencies instead of _world_. Finally the
	_NAME_ is added to _world_.
Drew DeVault's avatar
Drew DeVault committed
46

47 48 49
	One can use this to ensure that selected set of packages are installed,
	and later the temporary modification be undone with *apk-del*(8) _NAME_
	without removing packages that were installed earlier.
Drew DeVault's avatar
Drew DeVault committed
50

51 52 53 54 55 56
*--no-chown*
	Do not change file owner or group. By default apk will manage the file
	ownership when running as root. However, this option is turned on when
	running as non-root user, as changing file ownership is not permitted
	by the system then.

Drew DeVault's avatar
Drew DeVault committed
57 58 59
# AUTHORS

Natanael Copa <ncopa@alpinelinux.org>++
60
Timo Teräs <timo.teras@iki.fi>