.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.46.4.
.TH MINI-BUILDD-TOOL "1" "January 2017" "mini-buildd-tool 1.0.29~bpo8+1" "User Commands"
.SH NAME
mini-buildd-tool \- mini-buildd-tool \- User/client tool box for mini-buildd instances.
.SH DESCRIPTION
usage: mini\-buildd\-tool [\-h] [\-\-version] [\-v] [\-q] [\-O {plain,html,python}]
.TP
[\-R] [\-P {http,https}]
HOST
{status,start,stop,printuploaders,meta,getkey,getdputconf,getsourceslist,logcat,list,show,migrate,remove,port,portext,retry,setuserkey,subscription}
\&...
.PP
Command line tool to run API calls.
.SS "positional arguments:"
.TP
HOST
target host, either '[user@]host:port', or
\&'[user@]DPUT_TARGET'
.SS "optional arguments:"
.TP
\fB\-h\fR, \fB\-\-help\fR
show this help message and exit
.HP
\fB\-\-version\fR
.TP
\fB\-v\fR, \fB\-\-verbose\fR
lower log level. Give twice for max logs (default: 0)
.TP
\fB\-q\fR, \fB\-\-quiet\fR
tighten log level. Give twice for min logs (default:
0)
.TP
\fB\-O\fR {plain,html,python}, \fB\-\-output\fR {plain,html,python}
output type (default: plain)
.TP
\fB\-R\fR, \fB\-\-reset\-save\-policy\fR
reset save policy of used keyring (to 'ask') (default:
False)
.TP
\fB\-P\fR {http,https}, \fB\-\-protocol\fR {http,https}
protocol to use. Note: mini\-buildd 1.0.x only speaks
http \fB\-\-\fR you may use this in case you have manually set
up a https proxy, though. (default: http)
.SS "API commands:"
.IP
{status,start,stop,printuploaders,meta,getkey,getdputconf,getsourceslist,logcat,list,show,migrate,remove,port,portext,retry,setuserkey,subscription}
.TP
status
Show the status of the mini\-buildd instance. [auth
level 0: anonymous]
.TP
start
Start the Daemon (engine). [auth level 3: super user
login]
.TP
stop
Stop the Daemon (engine). [auth level 3: super user
login]
.TP
printuploaders
Print all GPG ids allowed to upload to repositories.
[auth level 3: super user login]
.TP
meta
Call arbitrary meta functions for models; usually for
internal use only. [auth level 3: super user login]
.TP
getkey
Get GnuPG public key. [auth level 0: anonymous]
.TP
getdputconf
Get recommended dput config snippet. Usually, this is
for integration in your personal ~/.dput.cf. [auth
level 0: anonymous]
.TP
getsourceslist
Get sources.list (apt lines). Usually, this output is
put to a file like '/etc/sources.list.d/mini\-builddxyz.list'. [auth level 0: anonymous]
.TP
logcat
Cat last n lines of the mini\-buildd's log. [auth level
2: staff user login]
.TP
list
List packages matching a shell\-like glob pattern;
matches both source and binary package names. [auth
level 1: any user login]
.TP
show
Show a source package. [auth level 0: anonymous]
.TP
migrate
Migrate a source package (along with all binary
packages). [auth level 2: staff user login]
.TP
remove
Remove a source package (along with all binary
packages). [auth level 3: super user login]
.TP
port
Port an internal package. An internal 'port' is a nochanges (i.e., only the changelog will be adapted)
rebuild of the given locally\-installed package. [auth
level 2: staff user login]
.TP
portext
Port an external package. An external 'port' is a nochanges (i.e., only the changelog will be adapted)
rebuild of any given source package. [auth level 2:
staff user login]
.TP
retry
Retry a previously failed package. [auth level 2:
staff user login]
.TP
setuserkey
Set a user's GnuPG public key. [auth level 1: any user
login]
.TP
subscription
Manage subscriptions to package notifications. A
package subscription is a tuple
\&'PACKAGE:DISTRIBUTION', where both PACKAGE or
DISTRIBUTION may be empty to denote all resp. items.
[auth level 1: any user login]
.PP
Note: Uses 'python\-keyring' to persist passwords (see
\&'~/.local/share/python_keyring/')