1bpkg-rep-add(1)             General Commands Manual            bpkg-rep-add(1)
2
3
4

NAME

6       bpkg-rep-add - add repository to configuration
7

SYNOPSIS

9       bpkg rep-add|add [options] rep-loc...
10

DESCRIPTION

12       The rep-add command adds the specified package repositories to the con‐
13       figuration. The repository location rep-loc is a  URL  or  a  directory
14       path.  If  a  repository with the same canonical name already exists in
15       the configuration, then its location is replaced with the specified.
16
17       Note that this command doesn't fetch the list of available packages for
18       the  newly  added  repository. For that, use the bpkg-rep-fetch(1) com‐
19       mand, normally, after adding all the repositories you wish to use.
20
21       Currently three types of repositories are supported: archive-based pkg,
22       directory-based  dir,  and  version control-based git. See bpkg-reposi‐
23       tory-types(1) for details on their structure and URL format.
24
25       Normally the repository type can be automatically guessed by  examining
26       its  URL  (for example, the presence of the .git extension) or, in case
27       of a local repository, its content (for example, the  presence  of  the
28       .git/  subdirectory).  Without any identifying information the pkg type
29       is assumed unless explicitly specified with the --type option or in the
30       URL  scheme.  Note,  however,  that  the  dir  repository type is never
31       guessed since it is not easily distinguishable from local pkg  and  git
32       repositories.
33

REP-ADD OPTIONS

35       --type type
36              Specify  the  repository  type with valid values being pkg, dir,
37              and git.
38
39       --directory|-d dir
40              Assume configuration is in dir rather than in the current  work‐
41              ing directory.
42

COMMON OPTIONS

44       The  common  options are summarized below with a more detailed descrip‐
45       tion available in bpkg-common-options(1).
46
47       -v     Print essential underlying commands being executed.
48
49       -V     Print all underlying commands being executed.
50
51       --quiet|-q
52              Run quietly, only printing error messages.
53
54       --verbose level
55              Set the diagnostics verbosity to level between 0 and 6.
56
57       --stdout-format format
58              Representation format to use for printing to stdout.
59
60       --jobs|-j num
61              Number of jobs to perform in parallel.
62
63       --no-result
64              Don't print informational messages about the outcome of perform‐
65              ing a command or some of its parts.
66
67       --progress
68              Display progress indicators for long-lasting operations, such as
69              network transfers, building, etc.
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       --pkg-proxy url
91              HTTP proxy server to use when fetching package manifests and ar‐
92              chives from remote pkg repositories.
93
94       --git path
95              The git program to be used to fetch git repositories.
96
97       --git-option opt
98              Additional common option to be passed to the git program.
99
100       --sha256 path
101              The sha256 program to be used to calculate SHA256 sums.
102
103       --sha256-option opt
104              Additional option to be passed to the sha256 program.
105
106       --tar path
107              The tar program to be used to extract package archives.
108
109       --tar-option opt
110              Additional option to be passed to the tar program.
111
112       --openssl path
113              The openssl program to be used for crypto operations.
114
115       --openssl-option opt
116              Additional option to be passed to the openssl program.
117
118       --auth type
119              Types of repositories to authenticate.
120
121       --trust fingerprint
122              Trust repository certificate with a SHA256 fingerprint.
123
124       --trust-yes
125              Assume the answer to all authentication prompts is yes.
126
127       --trust-no
128              Assume the answer to all authentication prompts is no.
129
130       --pager path
131              The pager program to be used to show long text.
132
133       --pager-option opt
134              Additional option to be passed to the pager program.
135
136       --options-file file
137              Read additional options from file.
138
139       --default-options dir
140              The directory to load additional default options files from.
141
142       --no-default-options
143              Don't load default options files.
144
145       --keep-tmp
146              Don't remove the bpkg's temporary directory at the  end  of  the
147              command execution and print its path at the verbosity level 2 or
148              higher.
149

DEFAULT OPTIONS FILES

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

BUGS

165       Send bug reports to the users@build2.org mailing list.
166
168       Copyright (c) 2014-2022 the build2 authors.
169
170       Permission is granted to copy, distribute and/or modify  this  document
171       under the terms of the MIT License.
172
173
174
175bpkg 0.15.0                        July 2022                   bpkg-rep-add(1)
Impressum