build-usage.adoc 2.3 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849
  1. = build usage
  2. ....
  3. ./build [OPTIONS] [-- EXTRA_MAKE_ARGS]
  4. ....
  5. == build configuration options
  6. [options="header"]
  7. |===
  8. |Name |Argument name |Description
  9. |`-a` |`ARCH` |Build for architecture `ARCH`.
  10. |`-B` |`BR2_CONFIG` |Add a single Buildroot option to the current build.
  11. Example: `-B 'BR2_TARGET_ROOTFS_EXT2_SIZE="512M"'`
  12. |`-b` |`BR2_FILE` |Also use the given Buildroot configuration fragment file.
  13. Pass multiple times to use multiple fragment files.
  14. |`-C` | |Skip the Buildroot configuration. Saves a few seconds,
  15. but requires you to know what you are doing :-)
  16. |`-c` |`CONFIG_SOMETHING` |Also use the given Linux kernel configuration, example:
  17. `./build -c 'CONFIG_FORTIFY_SOURCE=y'`
  18. Can be used multiple times for multiple configs.
  19. |`-g` | |Enable gem5 build or force its rebuild.
  20. |`-h` | |Show this help message.
  21. |`-I` | |Enable initramfs for the current build.
  22. |`-i` | |Enable initrd for the current build.
  23. |`-K` |`KERNEL_CONFIG_FILE` |Use `KERNEL_CONFIG_FILE` as the exact Linux kernel
  24. configuration. Ignore the default kernel config fragments.
  25. |`-p` | |Pass extra arguments to the `rootfs_post_build_script`.
  26. |`-S` | |Don't build QEMU with SDL support.
  27. Graphics such as X11 won't work, only the terminal.
  28. |`-s` | |Add a custom suffix to the build.
  29. E.g., doing `./build -s mysuf` puts all the build output
  30. into `out/x86_64-mysuf`. This allows keep multiple builds around
  31. when you checkout between branches.
  32. |`-v` | |Do a verbose build.
  33. |===
  34. == build target options
  35. [options="header"]
  36. |===
  37. |Name |Forces rebuild of |Extra actions
  38. |`-g` |gem5 |
  39. |`-k` |Kernel modules |
  40. |`-l` |Linux kernel |Touches kernel configuration files to overcome:
  41. https://stackoverflow.com/questions/49260466/why-when-i-change-br2-linux-kernel-custom-config-file-and-run-make-linux-reconfi
  42. |`-q` |QEMU |
  43. |===