options:¶

-h, --help

show this help message and exit

--version

show program's version number and exit

-l {CRITICAL,ERROR,WARNING,INFO,DEBUG}, --log-level {CRITICAL,ERROR,WARNING,INFO,DEBUG}

set log level (DEBUG will enable exception tracebacks and python warnings) (default: INFO)

-v, --verbose

DEPRECATED (use --log-level): increase log level. Give twice for max logs (default: 0)

-q, --quiet

DEPRECATED (use --log-level): decrease log level. Give twice for min logs (default: 0)

-J, --json

use parsable json output (default: False)

--auto-confirm

force-bypass extra confirmation (for confirmable calls) (default: False)

--auto-save-passwords

don't ask before saving passwords (via python3-keyring) (default: False)

--script-mode

force not to be interactive (default: False)

API calls (run 'mini-buildd-api <call> --help' for full single call help):¶

<call> [options]

status

Get status of this instance

JSON result description:

{

"version": mini-buildd's version "identity": Instance identity "url": Instance URL (HTTP) "incoming_url": Incoming URL (currently FTP) "load": Instance's (0 =< load <= 1). If negative, the instance is stopped "chroots": List of active chroots "remotes": Active or auto-reactivatable remotes ["repositories": Simplified structural representation of all repositories]

}

Authorization: NONE

.

pub_key

Get public key

Get ASCII-armored GnuPG public key of this instance.

Used to sign the apt repositories (apt key) and for authorization across instances.

Authorization: NONE

.

dput_conf

Get recommended dput config snippet

Usually, this is for integration in your personal ``~/.dput.cf``.

Authorization: NONE

.

sources_list

Get sources.list (apt lines)

Usually, this output is put to a file like ``/etc/apt/sources.list.d/mini-buildd-xyz.list``.

Authorization: NONE

.

ls

List source package

Authorization: NONE

.

show

Show source package

Authorization: NONE

.

debdiff

Compare two internal source packages

Authorization: NONE

.

migrate

Migrate source package

Migrates a source package along with all its binary packages. If

run for a rollback distribution, this will perform a rollback restore.

Authorization: STAFF

.

remove

Remove source package

Removes a source package along with all its binary packages.

Authorization: ADMIN

.

port

Port internal source package

An internal 'port' is a no-changes (i.e., only the changelog will be adapted)

rebuild of the given locally-installed package.

When ``from_distribution`` equals ``to_distribution``, a rebuild will be done.

Authorization: STAFF

.

port_ext

Port external source package

An external 'port' is a no-changes (i.e., only the changelog will be adapted)

rebuild of any given source package.

Authorization: STAFF

.

retry

Retry a previously failed source package

JSON result description:

Changes file name that has been re-uploaded

Authorization: STAFF

.

cancel

Cancel an ongoing package build

Authorization: STAFF

.

set_user_key

Set a user's GnuPG public key

Authorization: LOGIN

.

subscribe

Subscribe to (email) notifications

Authorization: LOGIN

.

unsubscribe

Unsubscribe from (email) notifications

Authorization: LOGIN

.

remake_chroots

Remake chroots

Run actions 'remove', 'prepare', 'check' and 'activate'.

Note that Daemon will be stopped before running, cancelling ongoing events (``BUILDING``, ``PACKAGING``).

Authorization: ADMIN

.

start

Start Daemon (accept incoming)

Does nothing if already started; will fail if Daemon instance is not activated.

Authorization: ADMIN

.

stop

Stop Daemon (stop accepting incoming)

Does nothing if already stopped. Any possibly running builds will be cancelled.

This state is *not persisted*. Please *deactivate* the Daemon instance via :mbdpage:`setup` to persist over *mini-buildd service* restarts.

Authorization: ADMIN

.

wake

Wake a remote instance

Authorization: STAFF

.

handshake

Check if signed message matches a remote, reply our signed message on success

This is for internal use only.

Authorization: NONE

.

cronjob

Run a cron job now (out of schedule)

Authorization: ADMIN

.

uploaders

Get upload permissions for repositories

Authorization: ADMIN

.

snapshot_ls

Get list of repository snapshots for a distribution

Authorization: NONE

.

snapshot_create

Create a repository snapshot

Authorization: ADMIN

.

snapshot_delete

Delete a repository snapshot

Authorization: ADMIN

.

debmirror

Make local partial repository mirror via :debpkg:`debmirror`

This may be useful if you plan on publishing a stripped-down (f.e., only certain repos,

only ``stable``, omit rollbacks) variant of your repo somewhere remote.

.. error:: debmirror: ``apt update`` fails on ``experimental`` suites (contents not mirrored) (:debbug:`819925`)

This happens only on systems where APT is configured to download contents, most likely just because

``apt-file`` is installed. So, the easiest workaround is::

apt purge apt-file

Closest to an actual fix is to install debmirror variant '+abfixes' from

``Hellfield Archive``, where the "bug" has been fixed (June 2023: at least available for bullseye and bookworm).

Authorization: ADMIN

.

keyring_packages

Build keyring packages

.. note:: **keyring-packages**: No compat for urold (``apt-key add``)

Since ``2.x``, keyring packages will use ``/etc/apt/trusted.gpg.d/<foo>.gpg``, not deprecated ``apt-key add <foo>``.

In Debian, this is supported since ``wheezy (2013)``.

For distributions ``<= squeeze`` (apt versions ``~<= 0.8.x``), you would manually have to run ``apt-key add /etc/apt/trusted.gpg.d/<foo>.gpg`` after installation of the keyring package.

Authorization: ADMIN

.

test_packages

Build test packages

Authorization: ADMIN

.

setup

Create, update or inspect your setup

Note that Daemon will be stopped before running, cancelling ongoing events (``BUILDING``, ``PACKAGING``).

Authorization: ADMIN

.

Note: Uses ``python3-keyring`` to persist passwords (see ``man 1 keyring``)