DragonFly On-Line Manual Pages

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.

Buildbot                          August 2010                    BUILDSLAVE(1)