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

NAME

6       bpkg-rep-create - create repository
7

SYNOPSIS

9       bpkg rep-create [options] [dir]
10

DESCRIPTION

12       The  rep-create command regenerates the packages.manifest file based on
13       the files present in the repository directory. If the repositories.man‐
14       ifest  file contains a certificate, then the signature.manifest file is
15       regenerated as well. In this case the --key  option  must  be  used  to
16       specify  the  certificate's  private key. If dir is not specified, then
17       the current working directory is used as the repository root.
18

REP-CREATE OPTIONS

20       --ignore-unknown
21              Ignore unknown manifest entries.
22
23       --min-bpkg-version ver
24              Apply backward compatibility workarounds to the generated  pack‐
25              ages.manifest  file  so that it can be consumed by bpkg versions
26              greater or equal to the specified version. If unspecified,  then
27              the  min-bpkg-version  value from the repositories.manifest file
28              is used, if present. If the manifest value is not specified  ei‐
29              ther, then no backward compatibility workarounds are applied.
30
31       --key name
32              Private  key  to  use to sign the repository. In most cases name
33              will be a path to the key file but it can also be a key id  when
34              a custom openssl cryptographic engine is used.
35

COMMON OPTIONS

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

DEFAULT OPTIONS FILES

132       See  bpkg-default-options-files(1)  for  an overview of the default op‐
133       tions files. For the rep-create command the search start  directory  is
134       the  repository directory. The following options files are searched for
135       in each directory and, if found, loaded in the order listed:
136
137       bpkg.options
138       bpkg-rep-create.options
139
140       The following rep-create command options cannot be specified in the re‐
141       mote default options files:
142
143       --key
144

BUGS

146       Send bug reports to the users@build2.org mailing list.
147

149       Copyright (c) 2014-2021 the build2 authors.
150
151       Permission  is  granted to copy, distribute and/or modify this document
152       under the terms of the MIT License.
153
154
155
156bpkg 0.14.0                      October 2021               bpkg-rep-create(1)
Impressum