buildslave(1) · carta

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.