xref: /llvm-project/llvm/utils/UpdateTestChecks/asm.py (revision 822b9c971be6784fe3dc04f4a7926834c1c818d3)
1import re
2import sys
3
4from . import common
5
6if sys.version_info[0] > 2:
7  class string:
8    expandtabs = str.expandtabs
9else:
10  import string
11
12# RegEx: this is where the magic happens.
13
14##### Assembly parser
15
16ASM_FUNCTION_X86_RE = re.compile(
17    r'^_?(?P<func>[^:]+):[ \t]*#+[ \t]*@(?P=func)\n(?:\s*\.?Lfunc_begin[^:\n]*:\n)?[^:]*?'
18    r'(?P<body>^##?[ \t]+[^:]+:.*?)\s*'
19    r'^\s*(?:[^:\n]+?:\s*\n\s*\.size|\.cfi_endproc|\.globl|\.comm|\.(?:sub)?section|#+ -- End function)',
20    flags=(re.M | re.S))
21
22ASM_FUNCTION_ARM_RE = re.compile(
23        r'^(?P<func>[0-9a-zA-Z_]+):\n' # f: (name of function)
24        r'\s+\.fnstart\n' # .fnstart
25        r'(?P<body>.*?)\n' # (body of the function)
26        r'.Lfunc_end[0-9]+:', # .Lfunc_end0: or # -- End function
27        flags=(re.M | re.S))
28
29ASM_FUNCTION_AARCH64_RE = re.compile(
30     r'^_?(?P<func>[^:]+):[ \t]*\/\/[ \t]*@(?P=func)\n'
31     r'(?:[ \t]+.cfi_startproc\n)?'  # drop optional cfi noise
32     r'(?P<body>.*?)\n'
33     # This list is incomplete
34     r'.Lfunc_end[0-9]+:\n',
35     flags=(re.M | re.S))
36
37ASM_FUNCTION_AMDGPU_RE = re.compile(
38    r'^_?(?P<func>[^:]+):[ \t]*;+[ \t]*@(?P=func)\n[^:]*?'
39    r'(?P<body>.*?)\n' # (body of the function)
40    # This list is incomplete
41    r'.Lfunc_end[0-9]+:\n',
42    flags=(re.M | re.S))
43
44ASM_FUNCTION_MIPS_RE = re.compile(
45    r'^_?(?P<func>[^:]+):[ \t]*#+[ \t]*@(?P=func)\n[^:]*?' # f: (name of func)
46    r'(?:^[ \t]+\.(frame|f?mask|set).*?\n)+'  # Mips+LLVM standard asm prologue
47    r'(?P<body>.*?)\n'                        # (body of the function)
48    r'(?:^[ \t]+\.(set|end).*?\n)+'           # Mips+LLVM standard asm epilogue
49    r'(\$|\.L)func_end[0-9]+:\n',             # $func_end0: (mips32 - O32) or
50                                              # .Lfunc_end0: (mips64 - NewABI)
51    flags=(re.M | re.S))
52
53ASM_FUNCTION_PPC_RE = re.compile(
54    r'^_?(?P<func>[^:]+):[ \t]*#+[ \t]*@(?P=func)\n'
55    r'.*?'
56    r'\.Lfunc_begin[0-9]+:\n'
57    r'(?:[ \t]+.cfi_startproc\n)?'
58    r'(?:\.Lfunc_[gl]ep[0-9]+:\n(?:[ \t]+.*?\n)*)*'
59    r'(?P<body>.*?)\n'
60    # This list is incomplete
61    r'(?:^[ \t]*(?:\.long[ \t]+[^\n]+|\.quad[ \t]+[^\n]+)\n)*'
62    r'.Lfunc_end[0-9]+:\n',
63    flags=(re.M | re.S))
64
65ASM_FUNCTION_RISCV_RE = re.compile(
66    r'^_?(?P<func>[^:]+):[ \t]*#+[ \t]*@(?P=func)\n[^:]*?'
67    r'(?P<body>^##?[ \t]+[^:]+:.*?)\s*'
68    r'.Lfunc_end[0-9]+:\n',
69    flags=(re.M | re.S))
70
71ASM_FUNCTION_SPARC_RE = re.compile(
72    r'^_?(?P<func>[^:]+):[ \t]*!+[ \t]*@(?P=func)\n'
73    r'(?P<body>.*?)\s*'
74    r'.Lfunc_end[0-9]+:\n',
75    flags=(re.M | re.S))
76
77ASM_FUNCTION_SYSTEMZ_RE = re.compile(
78    r'^_?(?P<func>[^:]+):[ \t]*#+[ \t]*@(?P=func)\n'
79    r'[ \t]+.cfi_startproc\n'
80    r'(?P<body>.*?)\n'
81    r'.Lfunc_end[0-9]+:\n',
82    flags=(re.M | re.S))
83
84
85SCRUB_LOOP_COMMENT_RE = re.compile(
86    r'# =>This Inner Loop Header:.*|# in Loop:.*', flags=re.M)
87
88SCRUB_X86_SHUFFLES_RE = (
89    re.compile(
90        r'^(\s*\w+) [^#\n]+#+ ((?:[xyz]mm\d+|mem)( \{%k\d+\}( \{z\})?)? = .*)$',
91        flags=re.M))
92SCRUB_X86_SPILL_RELOAD_RE = (
93    re.compile(
94        r'-?\d+\(%([er])[sb]p\)(.*(?:Spill|Reload))$',
95        flags=re.M))
96SCRUB_X86_SP_RE = re.compile(r'\d+\(%(esp|rsp)\)')
97SCRUB_X86_RIP_RE = re.compile(r'[.\w]+\(%rip\)')
98SCRUB_X86_LCP_RE = re.compile(r'\.LCPI[0-9]+_[0-9]+')
99SCRUB_X86_RET_RE = re.compile(r'ret[l|q]')
100
101def scrub_asm_x86(asm, args):
102  # Scrub runs of whitespace out of the assembly, but leave the leading
103  # whitespace in place.
104  asm = common.SCRUB_WHITESPACE_RE.sub(r' ', asm)
105  # Expand the tabs used for indentation.
106  asm = string.expandtabs(asm, 2)
107  # Detect shuffle asm comments and hide the operands in favor of the comments.
108  asm = SCRUB_X86_SHUFFLES_RE.sub(r'\1 {{.*#+}} \2', asm)
109  # Detect stack spills and reloads and hide their exact offset and whether
110  # they used the stack pointer or frame pointer.
111  asm = SCRUB_X86_SPILL_RELOAD_RE.sub(r'{{[-0-9]+}}(%\1{{[sb]}}p)\2', asm)
112  # Generically match the stack offset of a memory operand.
113  asm = SCRUB_X86_SP_RE.sub(r'{{[0-9]+}}(%\1)', asm)
114  if getattr(args, 'x86_scrub_rip', False):
115    # Generically match a RIP-relative memory operand.
116    asm = SCRUB_X86_RIP_RE.sub(r'{{.*}}(%rip)', asm)
117  # Generically match a LCP symbol.
118  asm = SCRUB_X86_LCP_RE.sub(r'{{\.LCPI.*}}', asm)
119  if getattr(args, 'extra_scrub', False):
120    # Avoid generating different checks for 32- and 64-bit because of 'retl' vs 'retq'.
121    asm = SCRUB_X86_RET_RE.sub(r'ret{{[l|q]}}', asm)
122  # Strip kill operands inserted into the asm.
123  asm = common.SCRUB_KILL_COMMENT_RE.sub('', asm)
124  # Strip trailing whitespace.
125  asm = common.SCRUB_TRAILING_WHITESPACE_RE.sub(r'', asm)
126  return asm
127
128def scrub_asm_amdgpu(asm, args):
129  # Scrub runs of whitespace out of the assembly, but leave the leading
130  # whitespace in place.
131  asm = common.SCRUB_WHITESPACE_RE.sub(r' ', asm)
132  # Expand the tabs used for indentation.
133  asm = string.expandtabs(asm, 2)
134  # Strip trailing whitespace.
135  asm = common.SCRUB_TRAILING_WHITESPACE_RE.sub(r'', asm)
136  return asm
137
138def scrub_asm_arm_eabi(asm, args):
139  # Scrub runs of whitespace out of the assembly, but leave the leading
140  # whitespace in place.
141  asm = common.SCRUB_WHITESPACE_RE.sub(r' ', asm)
142  # Expand the tabs used for indentation.
143  asm = string.expandtabs(asm, 2)
144  # Strip kill operands inserted into the asm.
145  asm = common.SCRUB_KILL_COMMENT_RE.sub('', asm)
146  # Strip trailing whitespace.
147  asm = common.SCRUB_TRAILING_WHITESPACE_RE.sub(r'', asm)
148  return asm
149
150def scrub_asm_powerpc64(asm, args):
151  # Scrub runs of whitespace out of the assembly, but leave the leading
152  # whitespace in place.
153  asm = common.SCRUB_WHITESPACE_RE.sub(r' ', asm)
154  # Expand the tabs used for indentation.
155  asm = string.expandtabs(asm, 2)
156  # Stripe unimportant comments
157  asm = SCRUB_LOOP_COMMENT_RE.sub(r'', asm)
158  # Strip trailing whitespace.
159  asm = common.SCRUB_TRAILING_WHITESPACE_RE.sub(r'', asm)
160  return asm
161
162def scrub_asm_mips(asm, args):
163  # Scrub runs of whitespace out of the assembly, but leave the leading
164  # whitespace in place.
165  asm = common.SCRUB_WHITESPACE_RE.sub(r' ', asm)
166  # Expand the tabs used for indentation.
167  asm = string.expandtabs(asm, 2)
168  # Strip trailing whitespace.
169  asm = common.SCRUB_TRAILING_WHITESPACE_RE.sub(r'', asm)
170  return asm
171
172def scrub_asm_riscv(asm, args):
173  # Scrub runs of whitespace out of the assembly, but leave the leading
174  # whitespace in place.
175  asm = common.SCRUB_WHITESPACE_RE.sub(r' ', asm)
176  # Expand the tabs used for indentation.
177  asm = string.expandtabs(asm, 2)
178  # Strip trailing whitespace.
179  asm = common.SCRUB_TRAILING_WHITESPACE_RE.sub(r'', asm)
180  return asm
181
182def scrub_asm_sparc(asm, args):
183  # Scrub runs of whitespace out of the assembly, but leave the leading
184  # whitespace in place.
185  asm = common.SCRUB_WHITESPACE_RE.sub(r' ', asm)
186  # Expand the tabs used for indentation.
187  asm = string.expandtabs(asm, 2)
188  # Strip trailing whitespace.
189  asm = common.SCRUB_TRAILING_WHITESPACE_RE.sub(r'', asm)
190  return asm
191
192def scrub_asm_systemz(asm, args):
193  # Scrub runs of whitespace out of the assembly, but leave the leading
194  # whitespace in place.
195  asm = common.SCRUB_WHITESPACE_RE.sub(r' ', asm)
196  # Expand the tabs used for indentation.
197  asm = string.expandtabs(asm, 2)
198  # Strip trailing whitespace.
199  asm = common.SCRUB_TRAILING_WHITESPACE_RE.sub(r'', asm)
200  return asm
201
202
203def build_function_body_dictionary_for_triple(args, raw_tool_output, triple, prefixes, func_dict):
204  target_handlers = {
205      'x86_64': (scrub_asm_x86, ASM_FUNCTION_X86_RE),
206      'i686': (scrub_asm_x86, ASM_FUNCTION_X86_RE),
207      'x86': (scrub_asm_x86, ASM_FUNCTION_X86_RE),
208      'i386': (scrub_asm_x86, ASM_FUNCTION_X86_RE),
209      'arm64-eabi': (scrub_asm_arm_eabi, ASM_FUNCTION_AARCH64_RE),
210      'aarch64': (scrub_asm_arm_eabi, ASM_FUNCTION_AARCH64_RE),
211      'r600': (scrub_asm_amdgpu, ASM_FUNCTION_AMDGPU_RE),
212      'amdgcn': (scrub_asm_amdgpu, ASM_FUNCTION_AMDGPU_RE),
213      'arm-eabi': (scrub_asm_arm_eabi, ASM_FUNCTION_ARM_RE),
214      'thumb-eabi': (scrub_asm_arm_eabi, ASM_FUNCTION_ARM_RE),
215      'thumbv6': (scrub_asm_arm_eabi, ASM_FUNCTION_ARM_RE),
216      'thumbv6-eabi': (scrub_asm_arm_eabi, ASM_FUNCTION_ARM_RE),
217      'thumbv6t2': (scrub_asm_arm_eabi, ASM_FUNCTION_ARM_RE),
218      'thumbv6t2-eabi': (scrub_asm_arm_eabi, ASM_FUNCTION_ARM_RE),
219      'thumbv6m': (scrub_asm_arm_eabi, ASM_FUNCTION_ARM_RE),
220      'thumbv6m-eabi': (scrub_asm_arm_eabi, ASM_FUNCTION_ARM_RE),
221      'thumbv7': (scrub_asm_arm_eabi, ASM_FUNCTION_ARM_RE),
222      'thumbv7-eabi': (scrub_asm_arm_eabi, ASM_FUNCTION_ARM_RE),
223      'thumbv7m': (scrub_asm_arm_eabi, ASM_FUNCTION_ARM_RE),
224      'thumbv7m-eabi': (scrub_asm_arm_eabi, ASM_FUNCTION_ARM_RE),
225      'thumbv8-eabi': (scrub_asm_arm_eabi, ASM_FUNCTION_ARM_RE),
226      'thumbv8m.base': (scrub_asm_arm_eabi, ASM_FUNCTION_ARM_RE),
227      'thumbv8m.main': (scrub_asm_arm_eabi, ASM_FUNCTION_ARM_RE),
228      'armv6': (scrub_asm_arm_eabi, ASM_FUNCTION_ARM_RE),
229      'armv7': (scrub_asm_arm_eabi, ASM_FUNCTION_ARM_RE),
230      'armv7-eabi': (scrub_asm_arm_eabi, ASM_FUNCTION_ARM_RE),
231      'armeb-eabi': (scrub_asm_arm_eabi, ASM_FUNCTION_ARM_RE),
232      'armv7eb-eabi': (scrub_asm_arm_eabi, ASM_FUNCTION_ARM_RE),
233      'armv7eb': (scrub_asm_arm_eabi, ASM_FUNCTION_ARM_RE),
234      'armv8a': (scrub_asm_arm_eabi, ASM_FUNCTION_ARM_RE),
235      'mips': (scrub_asm_mips, ASM_FUNCTION_MIPS_RE),
236      'powerpc64': (scrub_asm_powerpc64, ASM_FUNCTION_PPC_RE),
237      'powerpc64le': (scrub_asm_powerpc64, ASM_FUNCTION_PPC_RE),
238      'riscv32': (scrub_asm_riscv, ASM_FUNCTION_RISCV_RE),
239      'riscv64': (scrub_asm_riscv, ASM_FUNCTION_RISCV_RE),
240      'sparc': (scrub_asm_sparc, ASM_FUNCTION_SPARC_RE),
241      'sparcv9': (scrub_asm_sparc, ASM_FUNCTION_SPARC_RE),
242      's390x': (scrub_asm_systemz, ASM_FUNCTION_SYSTEMZ_RE),
243  }
244  handlers = None
245  for prefix, s in target_handlers.items():
246    if triple.startswith(prefix):
247      handlers = s
248      break
249  else:
250    raise KeyError('Triple %r is not supported' % (triple))
251
252  scrubber, function_re = handlers
253  common.build_function_body_dictionary(
254          function_re, scrubber, [args], raw_tool_output, prefixes,
255          func_dict, args.verbose)
256
257##### Generator of assembly CHECK lines
258
259def add_asm_checks(output_lines, comment_marker, prefix_list, func_dict, func_name):
260  # Label format is based on ASM string.
261  check_label_format = '{} %s-LABEL: %s:'.format(comment_marker)
262  common.add_checks(output_lines, comment_marker, prefix_list, func_dict, func_name, check_label_format, True, False)
263