xref: /openbmc/u-boot/tools/buildman/cmdline.py (revision 038be18f)
1#
2# Copyright (c) 2014 Google, Inc
3#
4# SPDX-License-Identifier:      GPL-2.0+
5#
6
7from optparse import OptionParser
8
9def ParseArgs():
10    """Parse command line arguments from sys.argv[]
11
12    Returns:
13        tuple containing:
14            options: command line options
15            args: command lin arguments
16    """
17    parser = OptionParser()
18    parser.add_option('-b', '--branch', type='string',
19          help='Branch name to build, or range of commits to build')
20    parser.add_option('-B', '--bloat', dest='show_bloat',
21          action='store_true', default=False,
22          help='Show changes in function code size for each board')
23    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')
31    parser.add_option('-e', '--show_errors', action='store_true',
32          default=False, help='Show errors and warnings')
33    parser.add_option('-f', '--force-build', dest='force_build',
34          action='store_true', default=False,
35          help='Force build of boards even if already built')
36    parser.add_option('-F', '--force-build-failures', dest='force_build_failures',
37          action='store_true', default=False,
38          help='Force build of previously-failed build')
39    parser.add_option('--fetch-arch', type='string',
40          help="Fetch a toolchain for architecture FETCH_ARCH ('list' to list)."
41              ' You can also fetch several toolchains separate by comma, or'
42              " 'all' to download all")
43    parser.add_option('-g', '--git', type='string',
44          help='Git repo containing branch to build', default='.')
45    parser.add_option('-G', '--config-file', type='string',
46          help='Path to buildman config file', default='')
47    parser.add_option('-H', '--full-help', action='store_true', dest='full_help',
48          default=False, help='Display the README file')
49    parser.add_option('-i', '--in-tree', dest='in_tree',
50          action='store_true', default=False,
51          help='Build in the source tree instead of a separate directory')
52    parser.add_option('-j', '--jobs', dest='jobs', type='int',
53          default=None, help='Number of jobs to run at once (passed to make)')
54    parser.add_option('-k', '--keep-outputs', action='store_true',
55          default=False, help='Keep all build output files (e.g. binaries)')
56    parser.add_option('-K', '--show-config', action='store_true',
57          default=False, help='Show configuration changes in summary (both board config files and Kconfig)')
58    parser.add_option('-l', '--list-error-boards', action='store_true',
59          default=False, help='Show a list of boards next to each error/warning')
60    parser.add_option('--list-tool-chains', action='store_true', default=False,
61          help='List available tool chains')
62    parser.add_option('-n', '--dry-run', action='store_true', dest='dry_run',
63          default=False, help="Do a dry run (describe actions, but do nothing)")
64    parser.add_option('-N', '--no-subdirs', action='store_true', dest='no_subdirs',
65          default=False, help="Don't create subdirectories when building current source for a single board")
66    parser.add_option('-o', '--output-dir', type='string',
67          dest='output_dir', default='..',
68          help='Directory where all builds happen and buildman has its workspace (default is ../)')
69    parser.add_option('-Q', '--quick', action='store_true',
70          default=False, help='Do a rough build, with limited warning resolution')
71    parser.add_option('-p', '--full-path', action='store_true',
72          default=False, help="Use full toolchain path in CROSS_COMPILE")
73    parser.add_option('-s', '--summary', action='store_true',
74          default=False, help='Show a build summary')
75    parser.add_option('-S', '--show-sizes', action='store_true',
76          default=False, help='Show image size variation in summary')
77    parser.add_option('--step', type='int',
78          default=1, help='Only build every n commits (0=just first and last)')
79    parser.add_option('-t', '--test', action='store_true', dest='test',
80                      default=False, help='run tests')
81    parser.add_option('-T', '--threads', type='int',
82          default=None, help='Number of builder threads to use')
83    parser.add_option('-u', '--show_unknown', action='store_true',
84          default=False, help='Show boards with unknown build result')
85    parser.add_option('-v', '--verbose', action='store_true',
86          default=False, help='Show build results while the build progresses')
87    parser.add_option('-V', '--verbose-build', action='store_true',
88          default=False, help='Run make with V=1, showing all output')
89    parser.add_option('-x', '--exclude', dest='exclude',
90          type='string', action='append',
91          help='Specify a list of boards to exclude, separated by comma')
92
93    parser.usage += """
94
95    Build U-Boot for all commits in a branch. Use -n to do a dry run"""
96
97    return parser.parse_args()
98