Scroll to navigation

MINI-BUILDD-TOOL(1) User Commands MINI-BUILDD-TOOL(1)

NAME

mini-buildd-tool - User/client tool box for mini-buildd instances.

DESCRIPTION

usage: mini-buildd-tool [-h] [--version] [-v] [-q] [-J] [--auto-confirm]

[--auto-save-passwords]
ENDPOINT <cmd> [options] ...

Command line tool to run API calls.

positional arguments:

HTTP target endpoint: Twisted-style Network Client Endpoint.
See: https://twistedmatrix.com/documents/current/core/howto/endpoints.html#clients
----------------- 'tcp:host=localhost:port=8066': Connect to localhost, unencrypted. 'tls:host=localhost:port=8066': Connect to localhost, encrypted. 'http://localhost:8066' : Extra URL-style syntax (prefer twisted-style in saved configs, though). 'localhost:8066' : Compatibility host:port syntax (don't use -- might eventually go away).
May also be '[user@]DPUT_TARGET' for convenience

optional arguments:

show this help message and exit
show program's version number and exit
increase log level. Give twice for max logs (default: 0)
decrease log level. Give twice for min logs (default: 0)
use parsable json output (default: False)
force-bypass extra confirmation (for confirmable commands) (default: False)
don't ask before saving passwords (via python-keyring) (default: False)

API commands (run 'mini-buildd-tool '' <cmd> --help' for full command help):

<cmd> [options]
Show the status of the mini-buildd instance.
identity : string: instance identity version : string: mini-buildd version http : string: HTTP URL ftp : string: FTP URL running : bool: Whether instance is accepting incoming load : float: machine load (0 =< load <= 1+) chroots : dict: {codename: [arch, ..]}: Active chroots repositories: dict: {identity: [codename, ..]}: Active repositories remotes : list: Active or auto-reactivate remotes packaging : list: Active (source) packages being processed building : list: Active (binary) package builds
.
Start the Daemon (engine).
identity : string: instance identity version : string: mini-buildd version http : string: HTTP URL ftp : string: FTP URL running : bool: Whether instance is accepting incoming load : float: machine load (0 =< load <= 1+) chroots : dict: {codename: [arch, ..]}: Active chroots repositories: dict: {identity: [codename, ..]}: Active repositories remotes : list: Active or auto-reactivate remotes packaging : list: Active (source) packages being processed building : list: Active (binary) package builds
.
Stop the Daemon (engine).
identity : string: instance identity version : string: mini-buildd version http : string: HTTP URL ftp : string: FTP URL running : bool: Whether instance is accepting incoming load : float: machine load (0 =< load <= 1+) chroots : dict: {codename: [arch, ..]}: Active chroots repositories: dict: {identity: [codename, ..]}: Active repositories remotes : list: Active or auto-reactivate remotes packaging : list: Active (source) packages being processed building : list: Active (binary) package builds
.
Get all GPG keys allowed to upload to repositories.
JSON Result (dict): {repository: {'allow_unauthenticated_uploads': True|False, 'uploaders': {long_key_id: {key info...}), ..}}}
.
Call arbitrary meta functions for models; usually for internal use only. Authorization: super user login .
Auto setup / bootstrap.
.
Build keyring packages for all active repositories.
.
Build internal test packages.
distributions ending on 'experimental'.
.
Get GnuPG public key.
__plain__: string: ASCII-armored key.
.
Get recommended dput config snippet.
Usually, this is for integration in your personal ~/.dput.cf.
__plain__: string: dput config snippet.
.
Get sources.list (apt lines).
Usually, this output is put to a file like '/etc/sources.list.d/mini-buildd-xyz.list'.
__plain__: string: apt lines
.
Cat last n lines of the mini-buildd's log.
__plain__: string: last n loglines
.
List packages matching a shell-like glob pattern; matches both source and binary package names.
JSON Result (dict): {repository: [{package_info}...]}
.
Show a source package.
JSON Result (dict): {repository: [(codename, {package_info}),...]}
.
Find a source package.
JSON Result (dict): {repository: [{package_info},...]}
.
Migrate a source package (along with all binary packages).
__plain__: string: textual migration log.
.
Remove a source package (along with all binary packages).
__plain__: string: textual removal log.
.
Port an internal package.
will be adapted) rebuild of the given locally-installed package.
requested: list: Info string about each port that has been triggered
.
Port an external package.
will be adapted) rebuild of any given source package.
requested: list: Info string about each port that has been triggered.
.
Retry a previously failed package.
requested: string: Info string about each retry that has been triggered.
.
Set a user's GnuPG public key.
.
Manage subscriptions to package notifications.
where both PACKAGE or DISTRIBUTION may be empty to denote all resp. items.
list: list: (action=list only) Human readable list of subscriptions. add: list: (action=add only) Human readable list of added subscriptions. remove: list: (action=lremoved only) Human readable list of removed subscriptions.
.

Note: Uses 'python-keyring' to persist passwords (see '~/.local/share/python_keyring/')

May 2020 mini-buildd-tool 1.1.28