buildbot - a tool for managing buildbot master instances

       The  `buildbot'  command-line  tool  can  be  used  to start or stop a buildmaster and to interact with a
       running buildmaster instance.  Some of its subcommands are intended for buildmaster  admins,  while  some
       are for developers who are editing the code that the buildbot is monitoring.

       master.cfg
              Buildbot master configuration file

       buildbot - a tool for managing buildbot master instances

Commandscreate-master
              Create and populate a directory for a new buildmaster

       upgrade-master
              Upgrade an existing buildmaster directory for the current version

       start  Start a buildmaster

       stop   Stop a buildmaster

       restart
              Restart a buildmaster

       sighup|reconfig
              Send SIGHUP signal to buildmaster to make it re-read the config file

       sendchange
              Send a change to the buildmaster

       try    Run  a  build  with  your  local  changes.  This  command requires in-advance configuration of the
              buildmaster to accept such build requests. Please see the documentation  for  details  about  this
              command.

       tryserver
              buildmaster-side ´try´ support function, not for users

       checkconfig
              Validate buildbot master config file.

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

       --version
              Print Buildbot and Twisted versions.  All subsequent commands are ignored.

       --verbose
              Verbose output.

   create-mastercommandoptions-q|--quiet
              Do not emit the commands being run

       -f|--force
              Re-use an existing directory (will not overwrite master.cfg file)

       -r|--relocatable
              Create a relocatable buildbot.tac

       -n|--no-logrotate
              Do not permit buildmaster rotate logs by itself.

       -c|--config
              Set name of the buildbot master config file to CONFIG.  Default file name is master.cfg.

       -s|--log-size
              Set size at which twisted lof file is rotated to SIZE bytes.  Default value is 1000000 bytes.

       -l|--log-count
              Limit the number of kept old twisted log files to COUNT.  All files are kept by default.

       --db   Set  the  database  connection  for  storing scheduler/status state to DATABASE.  Default value is
              sqlite:///state.sqlite.

       PATH   Directory where buildbot master files will be stored.

   upgrade-mastercommandoptions-q|--quiet
              Do not emit the commands being run.

       -r|--replace
              Replace any modified files without confirmation.

       --db   Set the database connection for storing scheduler/status state  to  DATABASE.   Default  value  is
              sqlite:///state.sqlite.

       PATH   Directory where buildbot master files are stored.

   sendchangecommandoptions--master
              Set the location of buildmaster's PBChangeSource to attach to in form HOST:PORT.

       -u|--username
              Set committer's username to USERNAME.

       -R|--repository
              Set repository URL to REPOSITORY.

       -P|--project
              Set project specifier to PROJECT.

       -b|--branch
              Set branch name to BRANCH.

       -c|--category
              Set category of repository to CATEGORY.

       -r|--revision
              Set revision being built to REVISION.

       --revision-file
              Use REVISIONFILE file to read revision spec data from.

       -p|--property
              Set property for the change to PROPERTY.  It should be in format NAME:VALUE.

       -m|--comments
              Set log message to MESSAGE.

       -F|--logfile
              Set logfile to LOGFILE.

       -w|--when
              Set timestamp used as the change time to TIMESTAMP.

       FILES  Lis of files have been changed.

   trycommandoptions--wait Wait until the builds have finished.

       -n|--dry-run
              Gather info, but don't actually submit.

       --get-builder-names
              Get  the  names  of  available  builders.   Doesn't  submit  anything.   Only  supported  for 'pb'
              connections.

       -c|--connect
              Connection type.  Can be either ´ssh´ or ´pb´.

       --tryhost
              Set the hostname (used by ssh) for the buildmaster to HOSTNAME.

       --trydir
              Specify trydir (on the tryhost) where tryjobs are deposited.

       -m|--master
              Set the location of the buildmaster's try scheduler in form HOST:PORT-u|--username
              Set the username performing the trial build to USERNAME.

       --passwd
              Set password for PB authentication to PASSWORD.

       --diff Use DIFF file to use as a patch instead of scanning a local tree.  Use ´-´ for stdin.

       --patchlevel
              Specify the patchlevel to apply with.  Defaults to 0.  See patch for details.

       --baserev
              Use BASEREV revision instead of scanning a local tree.

       --vc   Specify version control system in use.  Possible values: cvs, svn, tla, baz, darcs, p4.

       --branch
              Specify the branch in use, for VC systems that can't figure it out themselves.

       -b|--builder
              Run the trial build on the specified Builder. Can be used multiple times.

       --properties
              Specify  the  set  of  properties  made   available   in   the   build   environment   in   format
              prop1=value1,prop2=value2...

       --try-topfile
              Specify  name of a file at the top of the tree.  This option is used to find the top.  Only needed
              for SVN and CVS.

       --try-topdir
              Specify the path to the top of the working copy.  Only needed for SVN and CVS.

   tryservercommandoptions--jobdir
              The jobdir (maildir) for submitting jobs

buildbot-worker(1), patch(1)

Buildbot                                           August 2010                                       BUILDBOT(1)

GeneralInvocationbuildbot [ globaloptions ] command [ commandoptions ]

       buildbotcommand-h|--helpCommandOptionsbuildbot  create-master  [  -q|--quiet  ]  [  -f|--force  ]  [ -r|--relocatable ] [ -n|--no-logrotate ] [
       -s|--log-sizeSIZE ] [ -l|--log-countCOUNT ] [ -c|--configCONFIG ] [ --dbDATABASE ] [ PATH ]

       buildbot upgrade-master [ -q|--quiet ] [ -r|--replace ] [ --dbDATABASE ] [ PATH ]

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

       buildbot sendchange [ -m|--masterMASTER ] [ -u|--usernameUSERNAME ] [ -R|--repositoryREPOSITORY  ]  [
       -P|--projectPROJECT  ]  [  -b|--branchBRANCH ] [ -C|--categoryCATEGORY ] [ -r|--revisionREVISION ] [
       --revision-fileREVISIONFILE ] [ -p|--propertyPROPERTY  ]  [  -c|--commentsMESSAGE  ]  [  -F|--logfileLOGFILE ] [ -w|--whenTIMESTAMP ] FILES...

       buildbot  try  [  --wait ] [ -n|--dry-run ] [ --get-builder-names ] [ -c|--connect {ssh|pb} ] [ --tryhostHOSTNAME ] [ --trydirPATH ] [ -m|--masterMASTER ] [ -u|--usernameUSERNAME ] [ --passwdPASSWORD  ]  [
       --diffDIFF  ]  [  --patchlevelPATCHLEVEL ] [ --baserevBASEREV ] [ --vc {cvs|svn|tla|baz|darcs|p4} ] [
       --branchBRANCH ] [ -b|--builderBUILDER ] [ --propertiesPROPERTIES ] [ --try-topfileFILE  ]  [  --try-topdirPATH ]

       buildbot tryserver [ --jobdirPATH ]

       buildbot checkconfig [ CONFIGFILE ]

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

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