blob: 832a5145d28429675e851bec32d35c27d71f9f42 [file] [log] [blame]
Tom Rini83d290c2018-05-06 17:58:06 -04001# SPDX-License-Identifier: GPL-2.0+
Simon Glassd3d5c122014-09-05 19:00:10 -06002# Copyright (c) 2014 Google, Inc
3#
Simon Glassd3d5c122014-09-05 19:00:10 -06004
5from optparse import OptionParser
6
7def ParseArgs():
8 """Parse command line arguments from sys.argv[]
9
10 Returns:
11 tuple containing:
12 options: command line options
13 args: command lin arguments
14 """
15 parser = OptionParser()
16 parser.add_option('-b', '--branch', type='string',
Simon Glass843312d2015-02-05 22:06:15 -070017 help='Branch name to build, or range of commits to build')
Simon Glassd3d5c122014-09-05 19:00:10 -060018 parser.add_option('-B', '--bloat', dest='show_bloat',
19 action='store_true', default=False,
20 help='Show changes in function code size for each board')
Simon Glass06890362018-06-11 23:26:46 -060021 parser.add_option('--boards', type='string', action='append',
22 help='List of board names to build separated by comma')
Simon Glassd3d5c122014-09-05 19:00:10 -060023 parser.add_option('-c', '--count', dest='count', type='int',
24 default=-1, help='Run build on the top n commits')
25 parser.add_option('-C', '--force-reconfig', dest='force_reconfig',
26 action='store_true', default=False,
27 help='Reconfigure for every commit (disable incremental build)')
28 parser.add_option('-d', '--detail', dest='show_detail',
29 action='store_true', default=False,
30 help='Show detailed information for each board in summary')
Simon Glassb50113f2016-11-13 14:25:51 -070031 parser.add_option('-D', '--config-only', action='store_true', default=False,
32 help="Don't build, just configure each commit")
Simon Glassd3d5c122014-09-05 19:00:10 -060033 parser.add_option('-e', '--show_errors', action='store_true',
34 default=False, help='Show errors and warnings')
Daniel Schwierzeck2371d1b2018-01-26 16:31:05 +010035 parser.add_option('-E', '--warnings-as-errors', action='store_true',
36 default=False, help='Treat all compiler warnings as errors')
Simon Glassd3d5c122014-09-05 19:00:10 -060037 parser.add_option('-f', '--force-build', dest='force_build',
38 action='store_true', default=False,
39 help='Force build of boards even if already built')
40 parser.add_option('-F', '--force-build-failures', dest='force_build_failures',
41 action='store_true', default=False,
42 help='Force build of previously-failed build')
Simon Glass827e37b2014-12-01 17:34:06 -070043 parser.add_option('--fetch-arch', type='string',
44 help="Fetch a toolchain for architecture FETCH_ARCH ('list' to list)."
45 ' You can also fetch several toolchains separate by comma, or'
46 " 'all' to download all")
Simon Glassd3d5c122014-09-05 19:00:10 -060047 parser.add_option('-g', '--git', type='string',
48 help='Git repo containing branch to build', default='.')
49 parser.add_option('-G', '--config-file', type='string',
50 help='Path to buildman config file', default='')
51 parser.add_option('-H', '--full-help', action='store_true', dest='full_help',
52 default=False, help='Display the README file')
53 parser.add_option('-i', '--in-tree', dest='in_tree',
54 action='store_true', default=False,
55 help='Build in the source tree instead of a separate directory')
Stephen Warrenf79f1e02016-04-11 10:48:44 -060056 parser.add_option('-I', '--incremental', action='store_true',
57 default=False, help='Do not run make mrproper (when reconfiguring)')
Simon Glassd3d5c122014-09-05 19:00:10 -060058 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)')
Simon Glass843312d2015-02-05 22:06:15 -070062 parser.add_option('-K', '--show-config', action='store_true',
63 default=False, help='Show configuration changes in summary (both board config files and Kconfig)')
Simon Glassb464f8e2016-11-13 14:25:53 -070064 parser.add_option('--preserve-config-y', action='store_true',
65 default=False, help="Don't convert y to 1 in configs")
Simon Glassd3d5c122014-09-05 19:00:10 -060066 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,
Simon Glass40232c92018-11-06 16:02:10 -070069 help='List available tool chains (use -v to see probing detail)')
Simon Glassd3d5c122014-09-05 19:00:10 -060070 parser.add_option('-n', '--dry-run', action='store_true', dest='dry_run',
Masahiro Yamadad0ea61d2014-09-05 02:23:27 +090071 default=False, help="Do a dry run (describe actions, but do nothing)")
Simon Glass5971ab52014-12-01 17:33:55 -070072 parser.add_option('-N', '--no-subdirs', action='store_true', dest='no_subdirs',
73 default=False, help="Don't create subdirectories when building current source for a single board")
Simon Glassd3d5c122014-09-05 19:00:10 -060074 parser.add_option('-o', '--output-dir', type='string',
75 dest='output_dir', default='..',
76 help='Directory where all builds happen and buildman has its workspace (default is ../)')
Simon Glass00beb242019-01-07 16:44:20 -070077 parser.add_option('-O', '--override-toolchain', type='string',
78 help="Override host toochain to use for sandbox (e.g. 'clang-7')")
Simon Glassd3d5c122014-09-05 19:00:10 -060079 parser.add_option('-Q', '--quick', action='store_true',
80 default=False, help='Do a rough build, with limited warning resolution')
Simon Glassbb1501f2014-12-01 17:34:00 -070081 parser.add_option('-p', '--full-path', action='store_true',
82 default=False, help="Use full toolchain path in CROSS_COMPILE")
Stephen Warrenf79f1e02016-04-11 10:48:44 -060083 parser.add_option('-P', '--per-board-out-dir', action='store_true',
84 default=False, help="Use an O= (output) directory per board rather than per thread")
Simon Glassd3d5c122014-09-05 19:00:10 -060085 parser.add_option('-s', '--summary', action='store_true',
86 default=False, help='Show a build summary')
87 parser.add_option('-S', '--show-sizes', action='store_true',
88 default=False, help='Show image size variation in summary')
Simon Glasscb39a102017-11-12 21:52:14 -070089 parser.add_option('--skip-net-tests', action='store_true', default=False,
90 help='Skip tests which need the network')
Simon Glassd3d5c122014-09-05 19:00:10 -060091 parser.add_option('--step', type='int',
92 default=1, help='Only build every n commits (0=just first and last)')
93 parser.add_option('-t', '--test', action='store_true', dest='test',
94 default=False, help='run tests')
95 parser.add_option('-T', '--threads', type='int',
96 default=None, help='Number of builder threads to use')
97 parser.add_option('-u', '--show_unknown', action='store_true',
98 default=False, help='Show boards with unknown build result')
Alex Kiernan48ae4122018-05-31 04:48:34 +000099 parser.add_option('-U', '--show-environment', action='store_true',
100 default=False, help='Show environment changes in summary')
Simon Glassd3d5c122014-09-05 19:00:10 -0600101 parser.add_option('-v', '--verbose', action='store_true',
102 default=False, help='Show build results while the build progresses')
Simon Glassd2ce6582014-12-01 17:34:07 -0700103 parser.add_option('-V', '--verbose-build', action='store_true',
Simon Glassc81d0d22016-03-12 18:50:33 -0700104 default=False, help='Run make with V=1, logging all output')
Simon Glassd3d5c122014-09-05 19:00:10 -0600105 parser.add_option('-x', '--exclude', dest='exclude',
106 type='string', action='append',
107 help='Specify a list of boards to exclude, separated by comma')
108
Simon Glass06890362018-06-11 23:26:46 -0600109 parser.usage += """ [list of target/arch/cpu/board/vendor/soc to build]
Simon Glassd3d5c122014-09-05 19:00:10 -0600110
111 Build U-Boot for all commits in a branch. Use -n to do a dry run"""
112
113 return parser.parse_args()