aboutsummaryrefslogtreecommitdiff
path: root/load/load.cli
blob: bda186ad1ff1da8d71aa11dcfb7e07d352e564ab (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
// file      : load/load.cli
// license   : MIT; see accompanying LICENSE file

include <vector>;
include <string>;
include <cstdint>; // uint16_t

include <libbrep/types.hxx>;

include <load/options-types.hxx>;

"\section=1"
"\name=brep-load"
"\summary=load repositories into brep package database"

{
  "<options> <loadtab>",

  "\h|SYNOPSIS|

   \c{\b{brep-load --help}\n
      \b{brep-load --version}\n
      \b{brep-load} [<options>] <loadtab>}

   \h|DESCRIPTION|

   \cb{brep-load} reads the list of repositories from the specified <loadtab>
   configuration file, fetches their manifest files, and loads the repository
   and package information into the \cb{package} database, suitable for
   consumption by the \cb{brep} web module.

   Note that \cb{brep-load} expects the \cb{package} database schema to have
   already been created using \l{brep-migrate(1)}.

   Also note that \cb{brep-load} requires \l{bpkg(1)} to fetch repository
   information. See \cb{--bpkg} for more information on the package manager
   program."
}

class options
{
  "\h|OPTIONS|"

  bool --ignore-unknown
  {
    "Ignore unknown manifest entries."
  }

  bool --force
  {
    "Reload package information regardless of the repository manifest file
     timestamps."
  };

  bool --shallow
  {
    "Don't load package information from prerequisite or complement
     repositories, don't fail if unable to resolve a package dependency, and
     don't detect package dependency cycles."
  };

  bool --ignore-unresolv-tests
  {
    "Ignore tests, examples, and benchmarks package manifest entries which
     cannot be resolved from the main package's complement repositories,
     recursively. Note that in contrast to --shallow option, such entries will
     be removed from the main package manifests outright."
  }

  brep::ignore_unresolved_conditional_dependencies --ignore-unresolv-cond
  {
    "<pkg>",
    "Ignore conditional package dependencies which cannot be resolved. The
     valid <pkg> values are \cb{all} and \cb{tests}. If \cb{all} is specified,
     then unresolved conditional dependencies are ignored in all packages. If
     \cb{tests} is specified, then unresolved conditional dependencies are
     only ignored in external tests, examples, and benchmarks packages."
  }

  std::string --tenant
  {
    "<id>",
    "Tenant the package and repository information should be loaded in. If not
     specified, then the single-tenant mode is assumed."
  };

  bool --existing-tenant
  {
    "Load the repository and package information into the already created empty
     tenant rather than into the newly created one. Requires the \cb{--tenant}
     option to be specified."
  };

  bool --private
  {
    "Display the tenant packages in the web interface only in the tenant view
     mode."
  };

  std::string --interactive
  {
    "<bkp>",
    "Build the tenant packages interactively, stopping builds at the specified
     breakpoint. Implies \cb{--private}."
  };

  std::string --service-id
  {
    "<id>",
    "Third party service information to associate with the being created
     tenant. Requires the \cb{--tenant} and \cb{--service-type} options to be
     specified."
  };

  std::string --service-type
  {
    "<type>",
    "Type of the service to associate with the being created tenant. Requires
     the \cb{--service-id} option to be specified."
  };

  std::string --service-data
  {
    "<data>",
    "Service data to associate with the being created tenant. Requires the
     \cb{--service-id} option to be specified."
  };

  brep::path --overrides-file
  {
    "<file>",
    "Read package manifest overrides from the specified manifest fragment
     file and apply them to packages being loaded."
  }

  std::string --db-user|-u
  {
    "<user>",
    "Database user name. If not specified, then operating system (login)
     name is used."
  }

  std::string --db-password
  {
    "<pass>",
    "Database password. If not specified, then login without password is
     expected to work."
  }

  std::string --db-name|-n = "brep_package"
  {
    "<name>",
    "Database name. If not specified, then \cb{brep_package} is used by
     default."
  }

  std::string --db-host|-h
  {
    "<host>",
    "Database host name, address, or socket. If not specified, then connect
     to \cb{localhost} using the operating system-default mechanism
     (Unix-domain socket, etc)."
  }

  std::uint16_t --db-port|-p = 0
  {
    "<port>",
    "Database port number. If not specified, the default port is used."
  }

  brep::path --bpkg = "bpkg"
  {
    "<path>",
    "The package manager program to be used to fetch repository information.
     This should be the path to the \cb{bpkg} executable. You can also specify
     additional options that should be passed to the package manager program
     with \cb{--bpkg-option}. If the package manager program is not explicitly
     specified, then \cb{brep-load} will use \cb{bpkg} by default."
  }

  brep::strings --bpkg-option
  {
    "<opt>",
    "Additional option to be passed to the package manager program. See
     \cb{--bpkg} for more information on the package manager program. Repeat
     this option to specify multiple package manager options."
  }

  brep::path openssl = "openssl"
  {
    "<path>",
    "The openssl program to be used for crypto operations. You can also
     specify additional options that should be passed to the openssl program
     with \cb{openssl-option}. If the openssl program is not explicitly
     specified, then \cb{brep-load} will use \cb{openssl} by default."
  }

  brep::strings openssl-option
  {
    "<opt>",
    "Additional option to be passed to the openssl program (see \cb{openssl}
     for details). Repeat this option to specify multiple openssl options."
  }

  std::string --pager // String to allow empty value.
  {
    "<path>",
    "The pager program to be used to show long text. Commonly used pager
     programs are \cb{less} and \cb{more}. You can also specify additional
     options that should be passed to the pager program with
     \cb{--pager-option}. If an empty string is specified as the pager
     program, then no pager will be used. If the pager program is not
     explicitly specified, then \cb{brep-load} will try to use \cb{less}. If
     it is not available, then no pager will be used."
  }

  std::vector<std::string> --pager-option
  {
    "<opt>",
    "Additional option to be passed to the pager program. See \cb{--pager}
     for more information on the pager program. Repeat this option to
     specify multiple pager options."
  }

  bool --help {"Print usage information and exit."}
  bool --version {"Print version and exit."}
};

"\h|EXIT STATUS|

\dl|

\li|\cb{0}

Success.|

\li|\cb{1}

Fatal error.|

\li|\cb{2}

An instance of \cb{brep-load} or some other \cb{brep} utility is already
running. Try again.|

\li|\cb{3}

Recoverable database error. Try again.||
"