blob: 19420a2df690549036621d80029807161044e36d [file] [log] [blame]
lh9ed821d2023-04-07 01:36:19 -07001#!/usr/bin/env python3
2
3# bitbake-diffsigs / bitbake-dumpsig
4# BitBake task signature data dump and comparison utility
5#
6# Copyright (C) 2012-2013, 2017 Intel Corporation
7#
8# SPDX-License-Identifier: GPL-2.0-only
9#
10
11import os
12import sys
13import warnings
14import argparse
15import logging
16import pickle
17
18sys.path.insert(0, os.path.join(os.path.dirname(os.path.dirname(sys.argv[0])), 'lib'))
19
20import bb.tinfoil
21import bb.siggen
22import bb.msg
23
24myname = os.path.basename(sys.argv[0])
25logger = bb.msg.logger_create(myname)
26
27is_dump = myname == 'bitbake-dumpsig'
28
29def find_siginfo(tinfoil, pn, taskname, sigs=None):
30 result = None
31 tinfoil.set_event_mask(['bb.event.FindSigInfoResult',
32 'logging.LogRecord',
33 'bb.command.CommandCompleted',
34 'bb.command.CommandFailed'])
35 ret = tinfoil.run_command('findSigInfo', pn, taskname, sigs)
36 if ret:
37 while True:
38 event = tinfoil.wait_event(1)
39 if event:
40 if isinstance(event, bb.command.CommandCompleted):
41 break
42 elif isinstance(event, bb.command.CommandFailed):
43 logger.error(str(event))
44 sys.exit(2)
45 elif isinstance(event, bb.event.FindSigInfoResult):
46 result = event.result
47 elif isinstance(event, logging.LogRecord):
48 logger.handle(event)
49 else:
50 logger.error('No result returned from findSigInfo command')
51 sys.exit(2)
52 return result
53
54def find_siginfo_task(bbhandler, pn, taskname, sig1=None, sig2=None):
55 """ Find the most recent signature files for the specified PN/task """
56
57 if not taskname.startswith('do_'):
58 taskname = 'do_%s' % taskname
59
60 if sig1 and sig2:
61 sigfiles = find_siginfo(bbhandler, pn, taskname, [sig1, sig2])
62 if len(sigfiles) == 0:
63 logger.error('No sigdata files found matching %s %s matching either %s or %s' % (pn, taskname, sig1, sig2))
64 sys.exit(1)
65 elif not sig1 in sigfiles:
66 logger.error('No sigdata files found matching %s %s with signature %s' % (pn, taskname, sig1))
67 sys.exit(1)
68 elif not sig2 in sigfiles:
69 logger.error('No sigdata files found matching %s %s with signature %s' % (pn, taskname, sig2))
70 sys.exit(1)
71 latestfiles = [sigfiles[sig1], sigfiles[sig2]]
72 else:
73 filedates = find_siginfo(bbhandler, pn, taskname)
74 latestfiles = sorted(filedates.keys(), key=lambda f: filedates[f])[-2:]
75 if not latestfiles:
76 logger.error('No sigdata files found matching %s %s' % (pn, taskname))
77 sys.exit(1)
78
79 return latestfiles
80
81
82# Define recursion callback
83def recursecb(key, hash1, hash2):
84 hashes = [hash1, hash2]
85 hashfiles = find_siginfo(tinfoil, key, None, hashes)
86
87 recout = []
88 if len(hashfiles) == 0:
89 recout.append("Unable to find matching sigdata for %s with hashes %s or %s" % (key, hash1, hash2))
90 elif not hash1 in hashfiles:
91 recout.append("Unable to find matching sigdata for %s with hash %s" % (key, hash1))
92 elif not hash2 in hashfiles:
93 recout.append("Unable to find matching sigdata for %s with hash %s" % (key, hash2))
94 else:
95 out2 = bb.siggen.compare_sigfiles(hashfiles[hash1], hashfiles[hash2], recursecb, color=color)
96 for change in out2:
97 for line in change.splitlines():
98 recout.append(' ' + line)
99
100 return recout
101
102
103parser = argparse.ArgumentParser(
104 description=("Dumps" if is_dump else "Compares") + " siginfo/sigdata files written out by BitBake")
105
106parser.add_argument('-D', '--debug',
107 help='Enable debug output',
108 action='store_true')
109
110if is_dump:
111 parser.add_argument("-t", "--task",
112 help="find the signature data file for the last run of the specified task",
113 action="store", dest="taskargs", nargs=2, metavar=('recipename', 'taskname'))
114
115 parser.add_argument("sigdatafile1",
116 help="Signature file to dump. Not used when using -t/--task.",
117 action="store", nargs='?', metavar="sigdatafile")
118else:
119 parser.add_argument('-c', '--color',
120 help='Colorize the output (where %(metavar)s is %(choices)s)',
121 choices=['auto', 'always', 'never'], default='auto', metavar='color')
122
123 parser.add_argument('-d', '--dump',
124 help='Dump the last signature data instead of comparing (equivalent to using bitbake-dumpsig)',
125 action='store_true')
126
127 parser.add_argument("-t", "--task",
128 help="find the signature data files for the last two runs of the specified task and compare them",
129 action="store", dest="taskargs", nargs=2, metavar=('recipename', 'taskname'))
130
131 parser.add_argument("-s", "--signature",
132 help="With -t/--task, specify the signatures to look for instead of taking the last two",
133 action="store", dest="sigargs", nargs=2, metavar=('fromsig', 'tosig'))
134
135 parser.add_argument("sigdatafile1",
136 help="First signature file to compare (or signature file to dump, if second not specified). Not used when using -t/--task.",
137 action="store", nargs='?')
138
139 parser.add_argument("sigdatafile2",
140 help="Second signature file to compare",
141 action="store", nargs='?')
142
143options = parser.parse_args()
144if is_dump:
145 options.color = 'never'
146 options.dump = True
147 options.sigdatafile2 = None
148 options.sigargs = None
149
150if options.debug:
151 logger.setLevel(logging.DEBUG)
152
153color = (options.color == 'always' or (options.color == 'auto' and sys.stdout.isatty()))
154
155if options.taskargs:
156 with bb.tinfoil.Tinfoil() as tinfoil:
157 tinfoil.prepare(config_only=True)
158 if not options.dump and options.sigargs:
159 files = find_siginfo_task(tinfoil, options.taskargs[0], options.taskargs[1], options.sigargs[0], options.sigargs[1])
160 else:
161 files = find_siginfo_task(tinfoil, options.taskargs[0], options.taskargs[1])
162
163 if options.dump:
164 logger.debug("Signature file: %s" % files[-1])
165 output = bb.siggen.dump_sigfile(files[-1])
166 else:
167 if len(files) < 2:
168 logger.error('Only one matching sigdata file found for the specified task (%s %s)' % (options.taskargs[0], options.taskargs[1]))
169 sys.exit(1)
170
171 # Recurse into signature comparison
172 logger.debug("Signature file (previous): %s" % files[-2])
173 logger.debug("Signature file (latest): %s" % files[-1])
174 output = bb.siggen.compare_sigfiles(files[-2], files[-1], recursecb, color=color)
175else:
176 if options.sigargs:
177 logger.error('-s/--signature can only be used together with -t/--task')
178 sys.exit(1)
179 try:
180 if not options.dump and options.sigdatafile1 and options.sigdatafile2:
181 with bb.tinfoil.Tinfoil() as tinfoil:
182 tinfoil.prepare(config_only=True)
183 output = bb.siggen.compare_sigfiles(options.sigdatafile1, options.sigdatafile2, recursecb, color=color)
184 elif options.sigdatafile1:
185 output = bb.siggen.dump_sigfile(options.sigdatafile1)
186 else:
187 logger.error('Must specify signature file(s) or -t/--task')
188 parser.print_help()
189 sys.exit(1)
190 except IOError as e:
191 logger.error(str(e))
192 sys.exit(1)
193 except (pickle.UnpicklingError, EOFError):
194 logger.error('Invalid signature data - ensure you are specifying sigdata/siginfo files')
195 sys.exit(1)
196
197if output:
198 print('\n'.join(output))