1 .TH BUILDBOT "1" "August 2010" "Buildbot version: 0.8.1" "User Commands"
3 buildbot \- a tool for managing buildbot master instances
30 .BR \-r | \-\-relocatable
33 .BR \-s | \-\-log-size
37 .BR \-l | \-\-log-count
73 .BR start | stop | restart | sighup | reconfig
86 .BR \-u | \-\-username
90 .BR \-R | \-\-repository
102 .BR \-c | \-\-category
106 .BR \-r | \-\-revision
110 .BR \-\-revision-file
114 .BR \-p | \-\-property
118 .BR \-m | \-\-comments
122 .BR \-F | \-\-logfile
149 .BR \-u | \-\-username
164 .BR \-u | \-\-username
178 .BR \-n | \-\-dry-run
181 .BR \-\-get-builder-names
184 .BR \-c | \-\-connect
200 .BR \-u | \-\-username
221 {cvs|svn|tla|baz|darcs|p4}
228 .BR \-b | \-\-builder
262 .BR start | stop | restart | sighup | reconfig
273 .BR \-\-help | \-\-version
277 The `buildbot' command-line tool can be used to start or stop a
278 buildmaster and to interact with a running buildmaster instance.
279 Some of its subcommands are intended for buildmaster admins, while
280 some are for developers who are editing the code that the buildbot is
287 Create and populate a directory for a new buildmaster
290 Upgrade an existing buildmaster directory for the current version
299 Restart a buildmaster
301 .BR sighup | reconfig
302 Send SIGHUP signal to buildmaster to make it re-read the config file
305 Send a change to the buildmaster
308 Launch a small debug panel gui
311 Emit current builder status to stdout
314 Display a small window showing current builder status
317 Run a build with your local changes. This command requires in-advance
318 configuration of the buildmaster to accept such build requests. Please
319 see the documentation for details about this command.
322 buildmaster-side \'try\' support function, not for users
325 Validate buildbot master config file.
330 Print the list of available commands and global options.
331 All subsequent commands are ignored.
334 Print twistd and buildslave version.
335 All subsequent commands are ignored.
340 .SS create-master command options
343 Do not emit the commands being run
346 Re-use an existing directory (will not overwrite master.cfg file)
348 .BR \-r | \-\-relocatable
349 Create a relocatable buildbot.tac
352 Set name of the buildbot master config file to
354 Default file name is master.cfg.
356 .BR \-s | \-\-log-size
357 Set size at which twisted lof file is rotated to
360 Default value is 1000000 bytes.
362 .BR \-l | \-\-log-count
363 Limit the number of kept old twisted log files to
365 All files are kept by default.
368 Set the database connection for storing scheduler/status state to
371 .BR "sqlite:///state.sqlite" .
374 Directory where buildbot master files will be stored.
376 .SS upgrade-master command options
379 Do not emit the commands being run.
381 .BR \-r | \-\-replace
382 Replace any modified files without confirmation.
385 Set the database connection for storing scheduler/status state to
388 .BR "sqlite:///state.sqlite" .
391 Directory where buildbot master files are stored.
393 .SS sendchange command options
396 Set the location of buildmaster's PBListener to attach to in form
399 .BR \-u | \-\-username
400 Set commiter's username to
403 .BR \-R | \-\-repository
404 Set repository URL to
407 .BR \-P | \-\-project
408 Set project specifier to
415 .BR \-c | \-\-category
416 Set category of repository to
419 .BR \-r | \-\-revision
420 Set revision being built to
423 .BR \-\-revision-file
426 file to read revision spec data from.
428 .BR \-p | \-\-property
429 Set property for the change to
431 It should be in format
434 .BR \-m | \-\-comments
438 .BR \-F | \-\-logfile
443 Set timestamp used as the change time to
447 Lis of files have been changed.
449 .SS debugclient command options
452 Set the location of buildmaster's PBListener to attach to in form
456 Debug password to use.
458 .SS statuslog command options
461 Set the location of buildmaster's PBListener to attach to in form
464 .BR \-u | \-\-username
465 Set username for PB authentication to
471 Set password for PB authentication to
476 .SS statusgui command options
479 Set the location of buildmaster's PBListener to attach to in form
482 .BR \-u | \-\-username
483 Set username for PB authentication to
489 Set password for PB authentication to
494 .SS try command options
497 Wait until the builds have finished.
499 .BR \-n | \-\-dry-run
500 Gather info, but don't actually submit.
502 .BR \-\-get-builder-names
503 Get the names of available builders.
504 Doesn't submit anything.
505 Only supported for 'pb' connections.
507 .BR \-c | \-\-connect
509 Can be either \'ssh\' or \'pb\'.
512 Set the hostname (used by ssh) for the buildmaster to
516 Specify trydir (on the tryhost) where tryjobs are deposited.
519 Set the location of the buildmaster's PBListener in form
522 .BR \-u | \-\-username
523 Set the username performing the trial build to
527 Set password for PB authentication to
533 file to use as a patch instead of scanning a local tree.
537 Specify the patchlevel to apply with.
546 revision instead of scanning a local tree.
549 Specify version control system in use.
550 Possible values: cvs, svn, tla, baz, darcs, p4.
553 Specify the branch in use, for VC systems that can't figure it out themselves.
555 .BR \-b | \-\-builder
556 Run the trial build on the specified Builder. Can be used multiple times.
559 Specify the set of properties made available in the build environment in format
560 .IR prop1 = value1 , prop2 = value2 ...
563 Specify name of a file at the top of the tree.
564 This option is used to find the top.
565 Only needed for SVN and CVS.
568 Specify the path to the top of the working copy.
569 Only needed for SVN and CVS.
571 .SS tryserver command options
574 The jobdir (maildir) for submitting jobs
578 Buildbot master configuration file
580 \fBAndriy Senkovych\fR <\&andriysenkovych@gmail.com\&>
585 The complete documentation is available in texinfo format. To use it, run
586 .BR "info buildbot" .