1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
|
#!/usr/bin/python
import sys
import xml.etree.ElementTree as xml
SKIPZERO = True
COLORS = True
"""
A script used to filter intel intrinsics XML and print out instructions
related with them
In case of problems with ansi colors on Windows, switch COLORS to False
Also, it uses \b character hack to "truncate" strings
(while printing \b moves cursor one character back, so it appears as truncated)
Usage: ./intel-helper.py TECH?
Examples:
./intel-helper.py AVX2 # filters avx2 instructions
./intel-helper.py # prints all intrinsics
Setting SKIPZERO means this script won't print intrinsics with no assembly
instructions related with them.
This may happen because the XML may not be 100% completed, but also most of
casts just change type and do not touch the bits
Link to the XML:
https://software.intel.com/sites/landingpage/IntrinsicsGuide/files/data-3.5.0.xml
(beware, for a text file, its huge)
"""
CBLUE = ''
CGREEN = ''
CEND = ''
CBEIGE = ''
if COLORS:
CBLUE = '\033[94m'
CGREEN = '\033[92m'
CEND = '\x1b[0m'
CBEIGE = '\33[36m'
tech = ''
filename = ''
if len(sys.argv) >= 2:
filename = sys.argv[1]
else:
print("Not enough arguments")
exit(1)
def doc_helper(args, tree):
tech = ''
if len(args) != 0:
tech = args[0]
for child in tree.getroot():
if len(tech) != 0 and child.attrib["tech"] != tech:
continue
name = child.attrib["name"]
instructions = ''
for instruction in child.findall("instruction"):
iname = instruction.attrib["name"].lower()
iform = instruction.get("form")
if iform is None:
instructions += f"`{iname}`, "
else:
instructions += f"`{iname} {iform}`, "
print(f"/// * **Intrinsic:** [`{name}`]")
print(f"/// * **Assembly:** {instructions[:-2]}", end='\n\n')
def pretty_print_intrinsics_and_instructions(args, tree):
tech = ''
if len(args) != 0:
tech = args[0]
for child in tree.getroot():
if len(tech) != 0 and child.attrib["tech"] != tech:
continue
instructions = child.findall("instruction")
instr_no = len(instructions)
intrinsic_name = child.attrib["name"]
intrinsic_name += '('
for arg in child.findall("parameter"):
typ = arg.attrib["type"]
name = arg.attrib.get("varname", "\b")
intrinsic_name += f"{CBEIGE}{typ}{CBLUE} {name}, "
intrinsic_name = intrinsic_name[:-2] + ')'
if instr_no == 0 and SKIPZERO:
continue
elif instr_no == 1:
print(f"{CBLUE}{intrinsic_name}{CEND}", end=': ')
else:
print(f"{CBLUE}{intrinsic_name}{CEND}")
for instr in instructions:
attribs = instr.attrib
name = attribs["name"].lower()
form = attribs.get("form", "\b")
print(f"{CGREEN}{name}{CEND} {form}")
doc_helper(sys.argv[2:], xml.parse(filename))
#pretty_print_intrinsics_and_instructions(sys.argv[2:], xml.parse(filename))
|
