---
name: "mini-buildd-tool"
section: "1"
platform: "linux"
package: "python-mini-buildd"
version: "1.0.36+deb10u1"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/mini-buildd-tool"
---

# mini-buildd-tool(1)

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

## NAME

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

## DESCRIPTION

usage: mini-buildd-tool \[-h\] \[--version\] \[-v\] \[-q\] \[-O {plain,html,python}\]

- \[-R\] \[-P {http,https}\]

  HOST {status,start,stop,printuploaders,meta,getkey,getdputconf,getsourceslist,logcat,list,show,migrate,remove,port,portext,retry,setuserkey,subscription} ...

Command line tool to run API calls.

### positional arguments:

- HOST

  target host, either '\[user@\]host:port', or '\[user@\]DPUT\_TARGET'

### optional arguments:

- **-h**, **--help**

  show this help message and exit

**--version**

- **-v**, **--verbose**

  lower log level. Give twice for max logs (default: 0)

- **-q**, **--quiet**

  tighten log level. Give twice for min logs (default: 0)

- **-O** {plain,html,python}, **--output** {plain,html,python}

  output type (default: plain)

- **-R**, **--reset-save-policy**

  reset save policy of used keyring (to 'ask') (default: False)

- **-P** {http,https}, **--protocol** {http,https}

  protocol to use. Note: mini-buildd 1.0.x only speaks http **--** you may use this in case you have manually set up a https proxy, though. (default: http)

### API commands:

-

  {status,start,stop,printuploaders,meta,getkey,getdputconf,getsourceslist,logcat,list,show,migrate,remove,port,portext,retry,setuserkey,subscription}

- status

  Show the status of the mini-buildd instance. \[auth level 0: anonymous\]

- start

  Start the Daemon (engine). \[auth level 3: super user login\]

- stop

  Stop the Daemon (engine). \[auth level 3: super user login\]

- printuploaders

  Print all GPG ids allowed to upload to repositories. \[auth level 3: super user login\]

- meta

  Call arbitrary meta functions for models; usually for internal use only. \[auth level 3: super user login\]

- getkey

  Get GnuPG public key. \[auth level 0: anonymous\]

- getdputconf

  Get recommended dput config snippet. Usually, this is for integration in your personal ~/.dput.cf. \[auth level 0: anonymous\]

- 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\]

- logcat

  Cat last n lines of the mini-buildd's log. \[auth level 2: staff user login\]

- list

  List packages matching a shell-like glob pattern; matches both source and binary package names. \[auth level 1: any user login\]

- show

  Show a source package. \[auth level 0: anonymous\]

- migrate

  Migrate a source package (along with all binary packages). \[auth level 2: staff user login\]

- remove

  Remove a source package (along with all binary packages). \[auth level 3: super user login\]

- 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\]

- 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\]

- retry

  Retry a previously failed package. \[auth level 2: staff user login\]

- setuserkey

  Set a user's GnuPG public key. \[auth level 1: any user login\]

- 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\]

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