1bpkg-pkg-install(1)         General Commands Manual        bpkg-pkg-install(1)
2
3
4

NAME

6       bpkg-pkg-install - install package
7

SYNOPSIS

9       bpkg pkg-install|install [options] [vars] pkg...
10       bpkg pkg-install|install [options] [vars] --all|-a
11       bpkg pkg-install|install [options] [vars] (--all-pattern <pattern>)...
12

DESCRIPTION

14       The  pkg-install  command  installs  the  specified packages (the first
15       form), all the held packages (the second form, see bpkg-pkg-status(1)),
16       or  all the held packages that match any of the specified wildcard pat‐
17       terns (the third form). Additionally, immediate or all dependencies  of
18       these  packages  can be also installed by specifying the --immediate|-i
19       or  --recursive|-r  options,  respectively.  Underneath,  this  command
20       doesn't  do  much more than run b install. In the first form the speci‐
21       fied packages must  have  been  previously  configured  with  bpkg-pkg-
22       build(1) or bpkg-pkg-configure(1).
23
24       Additional  command  line  variables  (vars,  normally config.*) can be
25       passed to the build system. Such variables apply to all  the  specified
26       packages  but  can also be specified to only apply to specific packages
27       using the argument grouping  mechanism  (see  bpkg-argument-grouping(1)
28       for  details). In particular, this mechanism can be used to specify the
29       installation directory, for example:
30
31       bpkg install config.install.root=/usr/local \
32                    config.install.sudo=sudo       \
33                    libfoo libbar
34
35       Alternatively, the installation directory can be  specified  once  when
36       creating the configuration (bpkg-cfg-create(1)).
37

PKG-INSTALL OPTIONS

39       --all|-a
40              Install all held packages.
41
42       --all-pattern pattern
43              Install held packages that match the specified wildcard pattern.
44              Repeat this option to match multiple patterns. Note that you may
45              need to quote the pattern to prevent expansion by your shell.
46
47       --immediate|-i
48              Also install immediate dependencies.
49
50       --recursive|-r
51              Also install all dependencies, recursively.
52
53       --directory|-d dir
54              Assume  configuration is in dir rather than in the current work‐
55              ing directory.
56

COMMON OPTIONS

58       The common options are summarized below with a more  detailed  descrip‐
59       tion available in bpkg-common-options(1).
60
61       -v     Print essential underlying commands being executed.
62
63       -V     Print all underlying commands being executed.
64
65       --quiet|-q
66              Run quietly, only printing error messages.
67
68       --verbose level
69              Set the diagnostics verbosity to level between 0 and 6.
70
71       --jobs|-j num
72              Number of jobs to perform in parallel.
73
74       --no-result
75              Don't print informational messages about the outcome of perform‐
76              ing a command or some of its parts.
77
78       --no-progress
79              Suppress progress indicators for long-lasting  operations,  such
80              as network transfers, building, etc.
81
82       --build path
83              The build program to be used to build packages.
84
85       --build-option opt
86              Additional option to be passed to the build program.
87
88       --fetch path
89              The fetch program to be used to download resources.
90
91       --fetch-option opt
92              Additional option to be passed to the fetch program.
93
94       --fetch-timeout sec
95              The fetch and fetch-like (for example, git) program timeout.
96
97       --pkg-proxy url
98              HTTP proxy server to use when fetching package manifests and ar‐
99              chives from remote pkg repositories.
100
101       --git path
102              The git program to be used to fetch git repositories.
103
104       --git-option opt
105              Additional common option to be passed to the git program.
106
107       --sha256 path
108              The sha256 program to be used to calculate SHA256 sums.
109
110       --sha256-option opt
111              Additional option to be passed to the sha256 program.
112
113       --tar path
114              The tar program to be used to extract package archives.
115
116       --tar-option opt
117              Additional option to be passed to the tar program.
118
119       --openssl path
120              The openssl program to be used for crypto operations.
121
122       --openssl-option opt
123              Additional option to be passed to the openssl program.
124
125       --auth type
126              Types of repositories to authenticate.
127
128       --trust fingerprint
129              Trust repository certificate with a SHA256 fingerprint.
130
131       --trust-yes
132              Assume the answer to all authentication prompts is yes.
133
134       --trust-no
135              Assume the answer to all authentication prompts is no.
136
137       --pager path
138              The pager program to be used to show long text.
139
140       --pager-option opt
141              Additional option to be passed to the pager program.
142
143       --options-file file
144              Read additional options from file.
145
146       --default-options dir
147              The directory to load additional default options files from.
148
149       --no-default-options
150              Don't load default options files.
151

DEFAULT OPTIONS FILES

153       See bpkg-default-options-files(1) for an overview of  the  default  op‐
154       tions  files. For the pkg-install command the search start directory is
155       the configuration directory. The following options files  are  searched
156       for in each directory and, if found, loaded in the order listed:
157
158       bpkg.options
159       bpkg-pkg-install.options
160
161       The  following  pkg-install  command options cannot be specified in the
162       default options files:
163
164       --directory|-d
165

BUGS

167       Send bug reports to the users@build2.org mailing list.
168
170       Copyright (c) 2014-2021 the build2 authors.
171
172       Permission is granted to copy, distribute and/or modify  this  document
173       under the terms of the MIT License.
174
175
176
177bpkg 0.14.0                      October 2021              bpkg-pkg-install(1)
Impressum