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)