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.