wanna-build-mail(1) wanna-build mail interface

SYNOPSIS

wanna-build-mail package
wanna-build-catgdbm package
wanna-build-catmldbm package

VERSION

This man page documents the packaged version of wanna-build. This version is maintained by the buildd-tools project developers on Alioth (https://alioth.debian.org/projects/buildd-tools/).

There is also a version maintained by Ryan Murray which is adapted to build daemon needs, with similar functionality. This version should be equally capable of working in a buildd setup, but has a number of enhancements aimed at making it suitable for use by end-users.

DESCRIPTION

wanna-build-mail is used to drive wanna-build though an email interface. Set up wanna-build-mail as the mail filter for the wanna-build user on your system, then when you send this user mail, wanna-build-mail will run to process the mail and query the database with the commands you specify in the mail.

The mail processor sends a reply mail with all the program output to the address the request came from (From: header). Alternatively, it obeys a Reply-To: header if present.

OVERVIEW

The email subject does not matter. The body must be signed with PGP, with a key registered in /var/lib/wanna-build/mail-keyring.pgp. Only these keys are authorised to use the mail interface. Additionally, the file mail-users in the same directory is used to map PGP-key names to user names.

In the body (the PGP-signed part), you can write commands like:

wanna-build hello_1.0-1
uploaded tst1_1.0 tst2_0.99a
info hello
list needs-build failed

COMMANDS

The commands below are available. All be be abbreviated to their first letter and must start in column 0. An argument package_version is the package name and its version number, as usual with wanna-build.
wanna-build package_version
uploaded-build package_version
failed-build package_version
The failed-build command also needs a failing message. You put this message in the lines after the command, each line with some whitespace at the start. This whitespace is stripped for the message actually passed to failed-build. The first line without whitespace is treated as the next command.
infopackage1 [ package2 [ packagen]]
Get package information. No version number is required.
list state1 [ state2 [ staten]]
List packages in given states. Valid states are installed, needs-build, building, uploaded, failed, not-for-us, and additionally all (for any state).
vlist state1 [ state2 [ staten]]
vlist is the same as list, but includes a -v option, so that previous states and old failing messages are printed, too.

FILES

/var/lib/wanna-build
Database files.
/var/lib/wanna-build/mail-keyring.pgp
PGP keys of users authorised to use the mail interface.
/var/lib/wanna-build/mail-users
Mapping between PGP keys and system usernames.

AUTHORS

Roman Hodek <[email protected]>, Ryan Murray <[email protected]>, and Roger Leigh <[email protected]>.