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       --jobs|-j num
58              Number of jobs to perform in parallel.
59
60       --no-result
61              Don't print informational messages about the outcome of perform‐
62              ing a command.
63
64       --no-progress
65              Suppress  progress  indicators for long-lasting operations, such
66              as network transfers, building, etc.
67
68       --build path
69              The build program to be used to build packages.
70
71       --build-option opt
72              Additional option to be passed to the build program.
73
74       --fetch path
75              The fetch program to be used to download resources.
76
77       --fetch-option opt
78              Additional option to be passed to the fetch program.
79
80       --fetch-timeout sec
81              The fetch and fetch-like (for example, git) program timeout.
82
83       --pkg-proxy url
84              HTTP proxy server to use when fetching package manifests and ar‐
85              chives from remote pkg repositories.
86
87       --git path
88              The git program to be used to fetch git repositories.
89
90       --git-option opt
91              Additional common option to be passed to the git program.
92
93       --sha256 path
94              The sha256 program to be used to calculate SHA256 sums.
95
96       --sha256-option opt
97              Additional option to be passed to the sha256 program.
98
99       --tar path
100              The tar program to be used to extract package archives.
101
102       --tar-option opt
103              Additional option to be passed to the tar program.
104
105       --openssl path
106              The openssl program to be used for crypto operations.
107
108       --openssl-option opt
109              Additional option to be passed to the openssl program.
110
111       --auth type
112              Types of repositories to authenticate.
113
114       --trust fingerprint
115              Trust repository certificate with a SHA256 fingerprint.
116
117       --trust-yes
118              Assume the answer to all authentication prompts is yes.
119
120       --trust-no
121              Assume the answer to all authentication prompts is no.
122
123       --pager path
124              The pager program to be used to show long text.
125
126       --pager-option opt
127              Additional option to be passed to the pager program.
128
129       --options-file file
130              Read additional options from file.
131
132       --default-options dir
133              The directory to load additional default options files from.
134
135       --no-default-options
136              Don't load default options files.
137

DEFAULT OPTIONS FILES

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

BUGS

153       Send bug reports to the users@build2.org mailing list.
154

COPYRIGHT

156       Copyright (c) 2014-2020 the build2 authors.
157
158       Permission  is  granted to copy, distribute and/or modify this document
159       under the terms of the MIT License.
160
161
162
163bpkg 0.13.0                        July 2020                   bpkg-rep-add(1)