cmdline.py 7.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128
  1. # SPDX-License-Identifier: GPL-2.0+
  2. # Copyright (c) 2014 Google, Inc
  3. #
  4. from optparse import OptionParser
  5. def ParseArgs():
  6. """Parse command line arguments from sys.argv[]
  7. Returns:
  8. tuple containing:
  9. options: command line options
  10. args: command lin arguments
  11. """
  12. parser = OptionParser()
  13. parser.add_option('-A', '--print-prefix', action='store_true',
  14. help='Print the tool-chain prefix for a board (CROSS_COMPILE=)')
  15. parser.add_option('-b', '--branch', type='string',
  16. help='Branch name to build, or range of commits to build')
  17. parser.add_option('-B', '--bloat', dest='show_bloat',
  18. action='store_true', default=False,
  19. help='Show changes in function code size for each board')
  20. parser.add_option('--boards', type='string', action='append',
  21. help='List of board names to build separated by comma')
  22. parser.add_option('-c', '--count', dest='count', type='int',
  23. default=-1, help='Run build on the top n commits')
  24. parser.add_option('-C', '--force-reconfig', dest='force_reconfig',
  25. action='store_true', default=False,
  26. help='Reconfigure for every commit (disable incremental build)')
  27. parser.add_option('-d', '--detail', dest='show_detail',
  28. action='store_true', default=False,
  29. help='Show detailed size delta for each board in the -S summary')
  30. parser.add_option('-D', '--config-only', action='store_true', default=False,
  31. help="Don't build, just configure each commit")
  32. parser.add_option('-e', '--show_errors', action='store_true',
  33. default=False, help='Show errors and warnings')
  34. parser.add_option('-E', '--warnings-as-errors', action='store_true',
  35. default=False, help='Treat all compiler warnings as errors')
  36. parser.add_option('-f', '--force-build', dest='force_build',
  37. action='store_true', default=False,
  38. help='Force build of boards even if already built')
  39. parser.add_option('-F', '--force-build-failures', dest='force_build_failures',
  40. action='store_true', default=False,
  41. help='Force build of previously-failed build')
  42. parser.add_option('--fetch-arch', type='string',
  43. help="Fetch a toolchain for architecture FETCH_ARCH ('list' to list)."
  44. ' You can also fetch several toolchains separate by comma, or'
  45. " 'all' to download all")
  46. parser.add_option('-g', '--git', type='string',
  47. help='Git repo containing branch to build', default='.')
  48. parser.add_option('-G', '--config-file', type='string',
  49. help='Path to buildman config file', default='')
  50. parser.add_option('-H', '--full-help', action='store_true', dest='full_help',
  51. default=False, help='Display the README file')
  52. parser.add_option('-i', '--in-tree', dest='in_tree',
  53. action='store_true', default=False,
  54. help='Build in the source tree instead of a separate directory')
  55. # -I will be removed after April 2021
  56. parser.add_option('-I', '--incremental', action='store_true',
  57. default=False, help='Deprecated, does nothing. See -m')
  58. parser.add_option('-j', '--jobs', dest='jobs', type='int',
  59. default=None, help='Number of jobs to run at once (passed to make)')
  60. parser.add_option('-k', '--keep-outputs', action='store_true',
  61. default=False, help='Keep all build output files (e.g. binaries)')
  62. parser.add_option('-K', '--show-config', action='store_true',
  63. default=False, help='Show configuration changes in summary (both board config files and Kconfig)')
  64. parser.add_option('--preserve-config-y', action='store_true',
  65. default=False, help="Don't convert y to 1 in configs")
  66. parser.add_option('-l', '--list-error-boards', action='store_true',
  67. default=False, help='Show a list of boards next to each error/warning')
  68. parser.add_option('--list-tool-chains', action='store_true', default=False,
  69. help='List available tool chains (use -v to see probing detail)')
  70. parser.add_option('-m', '--mrproper', action='store_true',
  71. default=False, help="Run 'make mrproper before reconfiguring")
  72. parser.add_option('-n', '--dry-run', action='store_true', dest='dry_run',
  73. default=False, help="Do a dry run (describe actions, but do nothing)")
  74. parser.add_option('-N', '--no-subdirs', action='store_true', dest='no_subdirs',
  75. default=False, help="Don't create subdirectories when building current source for a single board")
  76. parser.add_option('-o', '--output-dir', type='string', dest='output_dir',
  77. help='Directory where all builds happen and buildman has its workspace (default is ../)')
  78. parser.add_option('-O', '--override-toolchain', type='string',
  79. help="Override host toochain to use for sandbox (e.g. 'clang-7')")
  80. parser.add_option('-Q', '--quick', action='store_true',
  81. default=False, help='Do a rough build, with limited warning resolution')
  82. parser.add_option('-p', '--full-path', action='store_true',
  83. default=False, help="Use full toolchain path in CROSS_COMPILE")
  84. parser.add_option('-P', '--per-board-out-dir', action='store_true',
  85. default=False, help="Use an O= (output) directory per board rather than per thread")
  86. parser.add_option('-s', '--summary', action='store_true',
  87. default=False, help='Show a build summary')
  88. parser.add_option('-S', '--show-sizes', action='store_true',
  89. default=False, help='Show image size variation in summary')
  90. parser.add_option('--skip-net-tests', action='store_true', default=False,
  91. help='Skip tests which need the network')
  92. parser.add_option('--step', type='int',
  93. default=1, help='Only build every n commits (0=just first and last)')
  94. parser.add_option('-t', '--test', action='store_true', dest='test',
  95. default=False, help='run tests')
  96. parser.add_option('-T', '--threads', type='int',
  97. default=None,
  98. help='Number of builder threads to use (0=single-thread)')
  99. parser.add_option('-u', '--show_unknown', action='store_true',
  100. default=False, help='Show boards with unknown build result')
  101. parser.add_option('-U', '--show-environment', action='store_true',
  102. default=False, help='Show environment changes in summary')
  103. parser.add_option('-v', '--verbose', action='store_true',
  104. default=False, help='Show build results while the build progresses')
  105. parser.add_option('-V', '--verbose-build', action='store_true',
  106. default=False, help='Run make with V=1, logging all output')
  107. parser.add_option('-w', '--work-in-output', action='store_true',
  108. default=False, help='Use the output directory as the work directory')
  109. parser.add_option('-W', '--ignore-warnings', action='store_true',
  110. default=False, help='Return success even if there are warnings')
  111. parser.add_option('-x', '--exclude', dest='exclude',
  112. type='string', action='append',
  113. help='Specify a list of boards to exclude, separated by comma')
  114. parser.add_option('-y', '--filter-dtb-warnings', action='store_true',
  115. default=False,
  116. help='Filter out device-tree-compiler warnings from output')
  117. parser.add_option('-Y', '--filter-migration-warnings', action='store_true',
  118. default=False,
  119. help='Filter out migration warnings from output')
  120. parser.usage += """ [list of target/arch/cpu/board/vendor/soc to build]
  121. Build U-Boot for all commits in a branch. Use -n to do a dry run"""
  122. return parser.parse_args()