make-tips.txt 2.2 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394
  1. // -*- mode:doc; -*-
  2. // vim: set syntax=asciidoc:
  3. [[make-tips]]
  4. 'make' tips
  5. -----------
  6. This is a collection of tips that help you make the most of OpenADK.
  7. .Configuration searches:
  8. The +make menuconfig+ command offer a search tool.
  9. The search tool is called by pressing +/+;
  10. The result of the search shows the help message of the matching items.
  11. .Display all commands executed by make:
  12. --------------------
  13. $ make v
  14. --------------------
  15. or
  16. --------------------
  17. $ make VERBOSE=1 <target>
  18. --------------------
  19. .Display all available targets:
  20. --------------------
  21. $ make help
  22. --------------------
  23. .Cleaning:
  24. There are different cleaning targets available. If a full clean is
  25. necessary, you normally will get a message from OpenADK.
  26. To delete all build products (including build directories, target, host
  27. and pkg trees, the firmware and the toolchain for all targets):
  28. --------------------
  29. $ make cleandir
  30. --------------------
  31. If you even want to clean any downloaded source and your
  32. configuration +.config+:
  33. --------------------
  34. $ make distclean
  35. --------------------
  36. If you only want to clean the kernel build, because you added or
  37. removed some patch, just do:
  38. --------------------
  39. $ make cleankernel
  40. --------------------
  41. This is automatically triggered if you change the kernel version in
  42. your configuration.
  43. If you just want to clean all packages and wants to rebuild the firmware,
  44. (the toolchain is not deleted) just use:
  45. --------------------
  46. $ make clean
  47. --------------------
  48. .Resetting OpenADK for a new target:
  49. You can either delete the configuration and start from scratch:
  50. --------------------
  51. $ rm .config*
  52. $ make menuconfig
  53. --------------------
  54. Or you can save your existing configuration and switch to a new
  55. one with:
  56. --------------------
  57. $ make switch
  58. --------------------
  59. Afterwards you can switch back to your old configuration, you just
  60. need to remember, which architecture and system you had configured:
  61. --------------------
  62. $ make switch ARCH=<arch> SYSTEM=<system>
  63. --------------------
  64. OpenADK is designed to have multiple architectures and embedded system
  65. combinations configured and build without a need to rebuild everything
  66. from scratch. There is no limit, you just need to have enough disk space.