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.