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

DESCRIPTION

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

PKG-INSTALL OPTIONS

37       --all|-a
38              Install all held packages.
39
40       --immediate|-i
41              Also install immediate dependencies.
42
43       --recursive|-r
44              Also install all dependencies, recursively.
45
46       --directory|-d dir
47              Assume configuration is in dir rather than in the current  work‐
48              ing directory.
49

COMMON OPTIONS

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

DEFAULT OPTIONS FILES

142       See  bpkg-default-options-files(1)  for  an  overview  of  the  default
143       options  files.  For the pkg-install command the search start directory
144       is  the  configuration  directory.  The  following  options  files  are
145       searched  for  in  each  directory  and,  if found, loaded in the order
146       listed:
147
148       bpkg.options
149       bpkg-pkg-install.options
150
151       The following pkg-install command options cannot be  specified  in  the
152       default options files:
153
154       --directory|-d
155

BUGS

157       Send bug reports to the users@build2.org mailing list.
158
160       Copyright (c) 2014-2019 Code Synthesis Ltd
161
162       Permission  is  granted to copy, distribute and/or modify this document
163       under the terms of the MIT License.
164
165
166
167bpkg 0.12.0                      November 2019             bpkg-pkg-install(1)
Impressum