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

NAME

6       bpkg-pkg-update - update package
7

SYNOPSIS

9       bpkg pkg-update|update [options] [vars] pkg...
10       bpkg pkg-update|update [options] [vars] --all|-a
11

DESCRIPTION

13       The  pkg-update command updates the specified packages (the first form)
14       or all the held packages (the  second  form,  see  bpkg-pkg-status(1)).
15       Underneath, this command doesn't do much more than run b update (or one
16       of its update-for-* variants; see --for|-f).  In  the  first  form  the
17       specified  packages must have been previously configured with bpkg-pkg-
18       build(1) or bpkg-pkg-configure(1).
19
20       Additional command line variables  (vars,  normally  config.*)  can  be
21       passed  to  the build system. Such variables apply to all the specified
22       packages but can also be specified to only apply to  specific  packages
23       using  the  argument  grouping mechanism (see bpkg-argument-grouping(1)
24       for details).
25

PKG-UPDATE OPTIONS

27       --all|-a
28              Update all held packages.
29
30       --for|-f operation
31              Instead of the default update build  system  operation,  perform
32              the  update-for-operation  variant  where  operation is normally
33              install or test.
34
35       --directory|-d dir
36              Assume configuration is in dir rather than in the current  work‐
37              ing directory.
38

COMMON OPTIONS

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

DEFAULT OPTIONS FILES

135       See  bpkg-default-options-files(1)  for  an  overview  of  the  default
136       options files. For the pkg-update command the search start directory is
137       the  configuration  directory. The following options files are searched
138       for in each directory and, if found, loaded in the order listed:
139
140       bpkg.options
141       bpkg-pkg-update.options
142
143       The following pkg-update command options cannot  be  specified  in  the
144       default options files:
145
146       --directory|-d
147

BUGS

149       Send bug reports to the users@build2.org mailing list.
150

152       Copyright (c) 2014-2020 the build2 authors.
153
154       Permission  is  granted to copy, distribute and/or modify this document
155       under the terms of the MIT License.
156
157
158
159bpkg 0.13.0                        July 2020                bpkg-pkg-update(1)
Impressum