diff options
| -rw-r--r-- | bitbake/doc/user-manual/user-manual-intro.xml | 141 |
1 files changed, 71 insertions, 70 deletions
diff --git a/bitbake/doc/user-manual/user-manual-intro.xml b/bitbake/doc/user-manual/user-manual-intro.xml index c7f01ad726..cd05fc5d07 100644 --- a/bitbake/doc/user-manual/user-manual-intro.xml +++ b/bitbake/doc/user-manual/user-manual-intro.xml | |||
| @@ -434,76 +434,77 @@ | |||
| 434 | Following is the usage and syntax for BitBake: | 434 | Following is the usage and syntax for BitBake: |
| 435 | <literallayout class='monospaced'> | 435 | <literallayout class='monospaced'> |
| 436 | $ bitbake -h | 436 | $ bitbake -h |
| 437 | Usage: bitbake [options] [recipename/target ...] | 437 | Usage: bitbake [options] [recipename/target ...] |
| 438 | 438 | ||
| 439 | Executes the specified task (default is 'build') for a given set of target recipes (.bb files). | 439 | Executes the specified task (default is 'build') for a given set of target recipes (.bb files). |
| 440 | It is assumed there is a conf/bblayers.conf available in cwd or in BBPATH which | 440 | It is assumed there is a conf/bblayers.conf available in cwd or in BBPATH which |
| 441 | will provide the layer, BBFILES and other configuration information. | 441 | will provide the layer, BBFILES and other configuration information. |
| 442 | 442 | ||
| 443 | Options: | 443 | Options: |
| 444 | --version show program's version number and exit | 444 | --version show program's version number and exit |
| 445 | -h, --help show this help message and exit | 445 | -h, --help show this help message and exit |
| 446 | -b BUILDFILE, --buildfile=BUILDFILE | 446 | -b BUILDFILE, --buildfile=BUILDFILE |
| 447 | Execute tasks from a specific .bb recipe directly. | 447 | Execute tasks from a specific .bb recipe directly. |
| 448 | WARNING: Does not handle any dependencies from other | 448 | WARNING: Does not handle any dependencies from other |
| 449 | recipes. | 449 | recipes. |
| 450 | -k, --continue Continue as much as possible after an error. While the | 450 | -k, --continue Continue as much as possible after an error. While the |
| 451 | target that failed and anything depending on it cannot | 451 | target that failed and anything depending on it cannot |
| 452 | be built, as much as possible will be built before | 452 | be built, as much as possible will be built before |
| 453 | stopping. | 453 | stopping. |
| 454 | -a, --tryaltconfigs Continue with builds by trying to use alternative | 454 | -a, --tryaltconfigs Continue with builds by trying to use alternative |
| 455 | providers where possible. | 455 | providers where possible. |
| 456 | -f, --force Force the specified targets/task to run (invalidating | 456 | -f, --force Force the specified targets/task to run (invalidating |
| 457 | any existing stamp file). | 457 | any existing stamp file). |
| 458 | -c CMD, --cmd=CMD Specify the task to execute. The exact options | 458 | -c CMD, --cmd=CMD Specify the task to execute. The exact options |
| 459 | available depend on the metadata. Some examples might | 459 | available depend on the metadata. Some examples might |
| 460 | be 'compile' or 'populate_sysroot' or 'listtasks' may | 460 | be 'compile' or 'populate_sysroot' or 'listtasks' may |
| 461 | give a list of the tasks available. | 461 | give a list of the tasks available. |
| 462 | -C INVALIDATE_STAMP, --clear-stamp=INVALIDATE_STAMP | 462 | -C INVALIDATE_STAMP, --clear-stamp=INVALIDATE_STAMP |
| 463 | Invalidate the stamp for the specified task such as | 463 | Invalidate the stamp for the specified task such as |
| 464 | 'compile' and then run the default task for the | 464 | 'compile' and then run the default task for the |
| 465 | specified target(s). | 465 | specified target(s). |
| 466 | -r PREFILE, --read=PREFILE | 466 | -r PREFILE, --read=PREFILE |
| 467 | Read the specified file before bitbake.conf. | 467 | Read the specified file before bitbake.conf. |
| 468 | -R POSTFILE, --postread=POSTFILE | 468 | -R POSTFILE, --postread=POSTFILE |
| 469 | Read the specified file after bitbake.conf. | 469 | Read the specified file after bitbake.conf. |
| 470 | -v, --verbose Output more log message data to the terminal. | 470 | -v, --verbose Output more log message data to the terminal. |
| 471 | -D, --debug Increase the debug level. You can specify this more | 471 | -D, --debug Increase the debug level. You can specify this more |
| 472 | than once. | 472 | than once. |
| 473 | -n, --dry-run Don't execute, just go through the motions. | 473 | -n, --dry-run Don't execute, just go through the motions. |
| 474 | -S, --dump-signatures | 474 | -S DUMP_SIGNATURES, --dump-signatures=DUMP_SIGNATURES |
| 475 | Don't execute, just dump out the signature | 475 | Dump out the signature construction information, with |
| 476 | construction information. | 476 | no task execution. Parameters are passed to the |
| 477 | -p, --parse-only Quit after parsing the BB recipes. | 477 | signature handling code, use 'none' if no specific |
| 478 | -s, --show-versions Show current and preferred versions of all recipes. | 478 | handler is required. |
| 479 | -e, --environment Show the global or per-package environment complete | 479 | -p, --parse-only Quit after parsing the BB recipes. |
| 480 | with information about where variables were | 480 | -s, --show-versions Show current and preferred versions of all recipes. |
| 481 | set/changed. | 481 | -e, --environment Show the global or per-package environment complete |
| 482 | -g, --graphviz Save dependency tree information for the specified | 482 | with information about where variables were |
| 483 | targets in the dot syntax. | 483 | set/changed. |
| 484 | -I EXTRA_ASSUME_PROVIDED, --ignore-deps=EXTRA_ASSUME_PROVIDED | 484 | -g, --graphviz Save dependency tree information for the specified |
| 485 | Assume these dependencies don't exist and are already | 485 | targets in the dot syntax. |
| 486 | provided (equivalent to ASSUME_PROVIDED). Useful to | 486 | -I EXTRA_ASSUME_PROVIDED, --ignore-deps=EXTRA_ASSUME_PROVIDED |
| 487 | make dependency graphs more appealing | 487 | Assume these dependencies don't exist and are already |
| 488 | -l DEBUG_DOMAINS, --log-domains=DEBUG_DOMAINS | 488 | provided (equivalent to ASSUME_PROVIDED). Useful to |
| 489 | Show debug logging for the specified logging domains | 489 | make dependency graphs more appealing |
| 490 | -P, --profile Profile the command and save reports. | 490 | -l DEBUG_DOMAINS, --log-domains=DEBUG_DOMAINS |
| 491 | -u UI, --ui=UI The user interface to use (e.g. knotty, hob, depexp). | 491 | Show debug logging for the specified logging domains |
| 492 | -t SERVERTYPE, --servertype=SERVERTYPE | 492 | -P, --profile Profile the command and save reports. |
| 493 | Choose which server to use, process or xmlrpc. | 493 | -u UI, --ui=UI The user interface to use (e.g. knotty, hob, depexp). |
| 494 | --revisions-changed Set the exit code depending on whether upstream | 494 | -t SERVERTYPE, --servertype=SERVERTYPE |
| 495 | floating revisions have changed or not. | 495 | Choose which server to use, process or xmlrpc. |
| 496 | --server-only Run bitbake without a UI, only starting a server | 496 | --revisions-changed Set the exit code depending on whether upstream |
| 497 | (cooker) process. | 497 | floating revisions have changed or not. |
| 498 | -B BIND, --bind=BIND The name/address for the bitbake server to bind to. | 498 | --server-only Run bitbake without a UI, only starting a server |
| 499 | --no-setscene Do not run any setscene tasks. sstate will be ignored | 499 | (cooker) process. |
| 500 | and everything needed, built. | 500 | -B BIND, --bind=BIND The name/address for the bitbake server to bind to. |
| 501 | --remote-server=REMOTE_SERVER | 501 | --no-setscene Do not run any setscene tasks. sstate will be ignored |
| 502 | Connect to the specified server. | 502 | and everything needed, built. |
| 503 | -m, --kill-server Terminate the remote server. | 503 | --remote-server=REMOTE_SERVER |
| 504 | --observe-only Connect to a server as an observing-only client. | 504 | Connect to the specified server. |
| 505 | --status-only Check the status of the remote bitbake server. | 505 | -m, --kill-server Terminate the remote server. |
| 506 | 506 | --observe-only Connect to a server as an observing-only client. | |
| 507 | --status-only Check the status of the remote bitbake server. | ||
| 507 | </literallayout> | 508 | </literallayout> |
| 508 | </para> | 509 | </para> |
| 509 | </section> | 510 | </section> |
