buildbot(1)

NAME

Buildbot - manual page for Buildbot version: 0.7.11p3

SYNOPSIS

buildbot [global options] <command> [command options]

The  `buildbot' command-line tool can be used to start or stop a buildmaster or buildbot, and to interact with a running  buildmaster.   Some
of  its subcommands are intended for buildmaster admins, while some are
for developers who are editing the code that the buildbot  is  monitoring.

OPTIONS

These are the global buildbot options:

--version

--help

Display this help and exit.

--verbose

Administrator commands:

create-master

Create and populate a directory for a new buildmaster:

buildbot create-master [--quiet] [--force] [--config=FILE]

[--log-size=SIZE] [--log-count=COUNT] BASEDIR

upgrade-master

Upgrade an existing buildmaster directory for the current version. When this command is finished, the buildmaster directory should look much like a brand-new one created by the 'createmaster' command.

buildbot upgrade-master [--quiet] [--replace] BASEDIR

create-slave

Create and populate a directory for a new buildslave

buildbot create-slave BASEDIR MASTERHOST:PORT

SLAVENAME PASSWORD

start Start a buildmaster or buildslave

buildbot start [--quiet] BASEDIR

stop Stop a buildmaster or buildslave

buildbot stop [--quiet] BASEDIR

restart

Restart a buildmaster or buildslave

buildbot restart [--quiet] BASEDIR

reconfig

SIGHUP a buildmaster to make it re-read the config file. The sighup command is an alias for this command.

buildbot reconfig [--quiet] BASEDIR

checkconfig

test the validity of a master.cfg config file

buildbot checkconfig [CONFIG_FILE]

tryserver

buildmaster-side 'try' support function, not for users

Buildmaster debug commands

These commands are also used by buildmaster administrators but not an day-to-day basis.

sendchange

Send a change to the buildmaster. The buildmaster must have been configured already to accept changes.

buildbot sendchange --master=HOST:PORT --username=USERNAME

[--branch=BRANCH] [--category=CATEGORY] [--revision=STRING | --revision-number=NUMBER |

--revision-file=FILENAME ] [--comments=LOG_MESSAGE ]

[--when=TIMESTAMP] FILENAMES...

debugclient

Launch a small debug panel GUI

buildbot debuclient [--master=HOST:PORT] [--passwd=PASSWORD]

Developer commands:

statuslog

Emit current builder status to stdout

buildbot statuslog [--master=HOST:PORT]

statusgui

Display a small window showing current builder status

buildbot statusgui [--master=HOST:PORT]

try Run a build with your local changes. This command requires in

advance configuration of the buildmaster to accept such build requests. Please see the documentation for details about this command.

SEE ALSO

The full documentation for Buildbot is maintained as a Texinfo manual. If the info and Buildbot programs are properly installed at your site, the command

info Buildbot

should give you access to the complete manual.

AUTHOR

This manual page was written by Iustin Pop <iusty@k1024.org>, for the Debian project (and may be used by others).

Buildbot version: 0.7.11p3 November 2009 BUILDBOT(1)