NAME

       buildbot-worker - a tool for managing buildbot worker instances

SYNOPSIS

       buildbot-worker [ global options ] command [ command options ]

       buildbot-worker  create-worker  [  -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 ] [ --delete-leftover-dirs ] [ --verbose ]
       PATH MASTER USERNAME PASSWORD

       buildbot-worker [ --verbose ] { start|stop|restart } [ PATH ]

       buildbot-worker [ --verbose ] { --help|--version }

       buildbot-worker command -h|--help

DESCRIPTION

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

OPTIONS

   Commands
       create-worker
              Create and populate a directory for a new worker

       start  Start a worker

       stop   Stop a worker

       restart
              Restart a worker

   Global options
       -h|--help
              Print  the  list of available commands and global options.  All subsequent commands
              are ignored.

       --version
              Print twistd and buildbot-worker version.  All subsequent commands are ignored.

       --verbose
              Verbose output.

   create-worker 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 worker 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 worker.  Default value is 077 which means only owner
              can access the files.  See umask(2) for more details.

       --usepty
              Set whether child processes should be run in a pty (0 means do not run in  a  pty).
              Default value is 0.

       --delete-leftover-dirs
              Set to remove unexpected directories in worker base directory.

       PATH   Path to worker 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
              Worker name to connect with.  This should be provided by buildmaster administrator.

       PASSWORD
              Worker  password  to  connect  with.   This  should  be  provided  by   buildmaster
              administrator.

SEE ALSO

       buildbot(1), umask(2),