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
’create-master’ 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).