blob: 08a52fb67224c801adee781ac3d366258ffcd789 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
|
apk-add(8)
# NAME
apk add - add or update constraints to _world_ and commit changes
# SYNOPSIS
*apk add* [<_options_>...] _constraints_...
# DESCRIPTION
*apk add* adds or updates given constraints to _world_ (see *apk-world*(5))
and commit changes to disk. This usually involves installing new packages,
but may also cause other changes to the installed packages.
To upgrade individual packages without modifying _world_ use *apk-fix*(8).
By default *apk* tries to select a set of packages so that all constraints
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.
# OPTIONS
*apk add* supports the commit options described in *apk*(8), as well as the
following options:
*--initdb*
Initialize a new package database.
*-l, --latest*
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.
*--no-chown*
Deperecated alias for --usermode.
*-u, --upgrade*
Upgrade _packages_ and their 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.
*--usermode*
Create usermode database with --initdb. In usermode, apk will operate
in such a way that root access is not required. Currently this implies:
- checking that we are running as non-root
- not changing file owner or group
- not setting system xattrs
This implies that the installation might not be fully functional.
However, this is useful mode for testing purposes or to create
chroot where some specific applications can run as non-root.
*-t, --virtual* _NAME_
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_. An optional version specifier for the virtual
package can be given via syntax _NAME_=_VERSION_. The version defaults
to synthesized version based on time.
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.
|
