tools/buildman/builderthread.py

3 # SPDX-License-Identifier:      GPL-2.0+
15 RETURN_CODE_RETRY = -1
38         board: Board object to build
39         commits: List of commit options to build.
50     result thread, and this helps to serialise the build output.
64         We collect the next result job and pass it on to the build.
73     """This thread builds U-Boot for a particular board.
75     An input queue provides each new job. We run 'make' to build U-Boot
80         thread_num: Our thread number (0-n-1), used to decide on a
100             stage: Stage of the build. Valid stages are:
101                         mrproper - can be called to clean source
102                         config - called to configure for a board
103                         build - the main make invocation - it does the build
115         """Build a particular commit.
117         If the build is already done, and we are not forcing a build, we skip
118         the build and just return the previously-saved results.
121             commit_upto: Commit number to build (0...n-1)
122             brd: Board object to build
125             config_only: Only configure the source, do not build it
126             force_build: Force a build even if one was previously done
132                 - CommandResult object containing the results of the build
133                 - boolean indicating whether 'make config' is still needed
135         # Create a default result - it will be overwritte by the call to
136         # self.Make() below, in the event that we do a build.
145                 out_rel_dir = 'build'
154             # Get the return code from that build and use it
158             # Check the signal that the build needs to be retried
166                     # The build passed, so no need to build it again
170             # We are going to have to build it. First, get a toolchain
205                         # Symlinks can confuse U-Boot's Makefile since
216                     args.append('-s')
218                     args.extend(['-j', str(self.builder.num_jobs)])
237                     result = self.Make(commit, brd, 'build', cwd, *args,
265         # If we think this might have been aborted with Ctrl-C, record the
284                 fd.write(result.stdout.decode('UTF-8').encode('ASCII', 'replace'))
291                 fd.write(result.stderr.decode('UTF-8').encode('ASCII', 'replace'))
296             # Write the build result and toolchain information.
315             for fname in ['u-boot', 'spl/u-boot-spl']:
316                 cmd = ['%snm' % self.toolchain.cross, '--size-sort', fname]
326                 cmd = ['%sobjdump' % self.toolchain.cross, '-h', fname]
361             self.CopyFiles(result.out_dir, build_dir, dirname, ['u-boot.cfg',
362                 'spl/u-boot-spl.cfg', 'tpl/u-boot-tpl.cfg', '.config',
365         # Now write the actual build output
367             self.CopyFiles(result.out_dir, build_dir, '', ['u-boot*', '*.bin',
369                 'spl/u-boot-spl*'])
372         """Copy files from the build directory to the output.
377             dirname: Source directory, '' for normal U-Boot, 'spl' for SPL
379                to the build directory
388                         target = '%s-%s%s' % (base, dirname, ext)
397             job: Job to build
415                     # If our incremental build failed, try building again
425                 # an warning, reconfig next time to force it to build the same
427                 # incremental build may not build the same file, and we will
429                 # We could avoid this by using -Werror everywhere...
431                 # the build stopped and didn't generate output, so will retry
435                 # Of course this is substantially slower if there are build
436                 # errors/warnings (e.g. 2-3x slower even if only 10% of builds
440                     # If this build failed, try the next one with a
457                 # We have the build results, so output the result
461             # Just build the currently checked-out build