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
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<title>DynASM Features</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<meta name="Author" content="Mike Pall">
<meta name="Copyright" content="Copyright (C) 2005-2011, Mike Pall">
<meta name="Language" content="en">
<link rel="stylesheet" type="text/css" href="bluequad.css" media="screen">
<link rel="stylesheet" type="text/css" href="bluequad-print.css" media="print">
</head>
<body>
<div id="site">
<a href="http://luajit.org/"><span>Lua<span id="logo">JIT</span></span></a>
</div>
<div id="head">
<h1>DynASM Features</h1>
</div>
<div id="nav">
<ul><li>
<a href="index.html">Index</a>
</li><li>
<a href="luajit.html">LuaJIT</a>
<ul><li>
<a href="luajit_features.html">Features</a>
</li><li>
<a href="luajit_install.html">Installation</a>
</li><li>
<a href="luajit_run.html">Running</a>
</li><li>
<a href="luajit_api.html">API Extensions</a>
</li><li>
<a href="luajit_intro.html">Introduction</a>
</li><li>
<a href="luajit_performance.html">Performance</a>
</li><li>
<a href="luajit_debug.html">Debugging</a>
</li><li>
<a href="luajit_changes.html">Changes</a>
</li></ul>
</li><li>
<a href="coco.html">Coco</a>
<ul><li>
<a href="coco_portability.html">Portability</a>
</li><li>
<a href="coco_api.html">API Extensions</a>
</li><li>
<a href="coco_changes.html">Changes</a>
</li></ul>
</li><li>
<a href="dynasm.html">DynASM</a>
<ul><li>
<a class="current" href="dynasm_features.html">Features</a>
</li><li>
<a href="dynasm_examples.html">Examples</a>
</li></ul>
</li><li>
<a href="http://luajit.org/download.html">Download <span class="ext">»</span></a>
</li></ul>
</div>
<div id="main">
<h2>DynASM Toolchain Features</h2>
<ul>
<li>DynASM is a pre-processing assembler.</li>
<li>DynASM converts mixed C/Assembler source to plain C code.</li>
<li>The primary knowledge about instruction names, operand modes,
registers, opcodes and how to encode them is <em>only</em>
needed in the pre-processor.</li>
<li>The generated C code is extremely small and fast.</li>
<li>A tiny embeddable C library helps with the process of dynamically
assembling, relocating and linking machine code.</li>
<li>There are no outside dependencies on other tools (such as
stand-alone assemblers or linkers).</li>
<li>Internal consistency checks catch runtime errors
(e.g. undefined labels).</li>
<li>The toolchain is split into a portable subset and
CPU-specific modules.</li>
<li>DynASM itself (the pre-processor) is written in Lua.</li>
<li>There is no machine-dependency for the pre-processor itself.
It should work everywhere you can get Lua 5.1 up and running
(i.e. Linux, *BSD, Solaris, Windows, ... you name it).</li>
</ul>
<h2>DynASM Assembler Features</h2>
<ul>
<li>C code and assembler code can be freely mixed.
<em>Readable</em>, too.</li>
<li>All the usual syntax for instructions and operand modes
you come to expect from a standard assembler.</li>
<li>Access to C variables and CPP defines in assembler statements.</li>
<li>Access to C structures and unions via type mapping.</li>
<li>Convenient shortcuts for accessing C structures.</li>
<li>Local and global labels.</li>
<li>Numbered labels (e.g. for mapping bytecode instruction numbers).</li>
<li>Multiple code sections (e.g. for tailcode).</li>
<li>Defines/substitutions (inline and from command line).</li>
<li>Conditionals (translation time) with proper nesting.</li>
<li>Macros with parameters.</li>
<li>Macros can mix assembler statements and C code.</li>
<li>Captures (output diversion for code reordering).</li>
<li>Simple and extensible template system for instruction definitions.</li>
</ul>
<h2>Restrictions</h2>
<p>
Currently only a subset of x86 (i386+) instructions is supported.
Unsupported instructions are either not usable in user-mode or
are slow on modern CPUs (i.e. not suited for a code generator).
SSE, SSE2, SSE3 and SSSE3 are fully supported. MMX is not supported.
</p>
<p>
The whole toolchain has been designed to support multiple CPU
architectures. As LuaJIT gets support for more architectures,
DynASM will be extended with new CPU-specific modules.
</p>
<p>
The assembler itself will be extended with more features on an
as-needed basis. E.g. I'm thinking about vararg macros.
</p>
<p>
Note that runtime conditionals are not really needed, since you can
just use plain C code for that (and LuaJIT does this <em>a lot</em>).
It's not going to be more (time-) efficient if conditionals are done
by the embedded C library (maybe a bit more space-efficient).
</p>
<br class="flush">
</div>
<div id="foot">
<hr class="hide">
Copyright © 2005-2011 Mike Pall
<span class="noprint">
·
<a href="contact.html">Contact</a>
</span>
</div>
</body>
</html>
|
