Man pages sections > man1 > buildslave

buildslave - a tool for managing buildbot slave instances

BUILDSLAVE(1) User Commands BUILDSLAVE(1)

NAME

buildslave - a tool for managing buildbot slave instances

SYNOPSIS

buildslave [ global options ] command [ command options ]
buildslave create-slave [ -q|--quiet ] [ -f|--force ] [ -r|--relocatable ] [ -n|--no-logrotate ] [ -k|--keepalive TIME ] [ --usepty {0|1} ] [ --umask UMASK ] [ -s|--log-size SIZE ] [ -l|--log-count COUNT ] [ --verbose ] PATH MASTER USERNAME PASSWORD
buildslave [ --verbose ] { start|stop|restart } [ PATH ]
buildslave [ --verbose ] { --help|--version }
buildslave command -h|--help

DESCRIPTION

The `buildslave' command-line tool can be used to start or stop a buildslave or create a new buildslave instance.

OPTIONS

Commands

create-slave
Create and populate a directory for a new buildslave
start
Start a buildslave
stop
Stop a buildslave
restart
Restart a buildslave

Global options

-h|--help
Print the list of available commands and global options. All subsequent commands are ignored.
--version
Print twistd and buildslave version. All subsequent commands are ignored.
--verbose
Verbose output.

create-slave command options

-f|--force
Re-use an existing directory.
-h|--help
Show help for current command and exit. All subsequent commands are ignored.
-k|--keepalive
Send keepalive requests to buildmaster every TIME seconds. Default value is 600 seconds.
-l|--log-count
Limit the number of kept old twisted log files to COUNT. All files are kept by default.
-q|--quiet
Do not emit the commands being run.
-r|--relocatable
Create a relocatable buildbot.tac.
-n|--no-logrotate
Do not permit buildslave rotate logs by itself.
-s|--log-size
Set size at which twisted lof file is rotated to SIZE bytes. Default value is 1000000 bytes.
--umask
Set umask for files created by buildslave. Default value is 077 which means only owner can access the files. See umask(2) for more details.
--usepty
Set wether child processes should be run in a pty (0 means do not run in a pty). Default value is 0.
PATH
Path to buildslave base directory.
MASTER
Set the host and port of buildbot master to attach to in form HOST:PORT. This should be provided by buildmaster administrator.
USERNAME
Buildslave name to connect with. This should be provided by buildmaster administrator.
PASSWORD
Buildslave password to connect with. This should be provided by buildmaster administrator.

SEE ALSO

buildbot(1), umask(2),
The complete documentation is available in texinfo format. To use it, run info buildbot.
 
August 2010 Buildbot