source: release-kits/lirk3/resources/gs3-release-maker/ant/docs/manual/OptionalTasks/ildasm.html@ 14982

Last change on this file since 14982 was 14982, checked in by oranfry, 16 years ago

initial import of LiRK3
File size: 15.4 KB
Line 
1
2<html>
3<head>
4 <meta http-equiv="Content-Language" content="en-us">
5 <title>Ildasm
6 Task</title>
7<link rel="stylesheet" type="text/css" href="../stylesheets/antmanual.css">
8</head>
9
10<body bgcolor="#ffffff" text="#000000" link="#525D76"
11 alink="#525D76" vlink="#525D76">
12
13<table border="0" width="100%" cellspacing="4">
14
15 <!-- PAGE HEADER -->
16 <tr>
17 <td>
18 <table border="0" width="100%"><tr>
19 <td valign="bottom">
20 <font size="+3" face="arial,helvetica,sanserif"><strong>Ildasm
21 Task</strong></font>
22 <br><font face="arial,helvetica,sanserif">Task to take a .NET or Mono -generated managed executable and turn it into ILASM assembly code.</font>
23 </td>
24 <td>
25 <!-- PROJECT LOGO -->
26 <a href="http://ant.apache.org/">
27 <img src="../../images/ant_logo_large.gif" align="right" alt="Apache Ant" border="0"/>
28 </a>
29 </td>
30 </tr></table>
31 </td>
32 </tr>
33
34 <!-- START RIGHT SIDE MAIN BODY -->
35 <tr>
36 <td valign="top" align="left">
37
38 <!-- Applying task/long-description -->
39 <!-- Start Description -->
40 <table border="0" cellspacing="0" cellpadding="2" width="100%">
41 <tr><td>&nbsp;</td></tr>
42
43 <tr><td bgcolor="#525D76">
44 <font color="#ffffff" face="arial,helvetica.sanserif">
45 <a name="description">
46 <strong>Description</strong></a></font>
47 </td></tr>
48
49 <tr><td><blockquote>
50 Task to take a .NET or Mono -generated managed executable and turn it into ILASM assembly code. Useful when converting imported typelibs into assembler before patching and recompiling, as one has to do when doing advanced typelib work. <p> As well as generating the named output file, the ildasm program will also generate resource files <code>Icons.resources</code> <code>Message.resources</code> and a .res file whose filename stub is derived from the source in ways to obscure to determine. There is no way to control whether or not these files are created, or where they are created (they are created in the current directory; their names come from inside the executable and may be those used by the original developer). This task creates the resources in the directory specified by <code>resourceDir</code> if set, else in the same directory as the <code>destFile</code>. <p> This task requires the .NET SDK installed and ildasm on the path. To disassemble using alternate CLR systems, set the executable attribute to the name/path of the alternate implementation -one that must support all the classic ildasm commands. <p> Dependency logic: the task executes the command if the output file is missing or older than the source file. It does not take into account changes in the options of the task, or timestamp differences in resource files. When the underlying ildasm executable fails for some reason, it leaves the .il file in place with some error message. To prevent this from confusing the dependency logic, the file specified by the <code>dest</code> attribute is <i>always</i> deleted after an unsuccessful build.
51 </blockquote></td></tr>
52
53 </table>
54 <!-- End Description -->
55
56 <!-- Start Attributes -->
57 <table border="0" cellspacing="0" cellpadding="2" width="100%">
58 <tr><td>&nbsp;</td></tr>
59 <tr><td bgcolor="#525D76">
60 <font color="#ffffff" face="arial,helvetica.sanserif">
61 <a name="attributes">
62 <strong>Parameters</strong></a></font>
63 </td></tr>
64 <tr><td><blockquote>
65 <table>
66 <tr>
67 <td bgcolor="#cccccc" valign="top" align="left">
68 <font color="#000000" size="-1" face="arial,helvetica,sanserif"><b>Attribute</b></font>
69 </td>
70 <td bgcolor="#cccccc" valign="top" align="left">
71 <font color="#000000" size="-1" face="arial,helvetica,sanserif"><b>Description</b></font>
72 </td>
73 <td bgcolor="#cccccc" valign="top" align="left">
74 <font color="#000000" size="-1" face="arial,helvetica,sanserif"><b>Type</b></font>
75 </td>
76 <td bgcolor="#cccccc" valign="top" align="left">
77 <font color="#000000" size="-1" face="arial,helvetica,sanserif"><b>Requirement</b></font>
78 </td>
79 </tr>
80 <!-- Attribute Group -->
81
82 <!-- Attribute Group -->
83 <!-- Attribute -->
84 <tr>
85 <td bgcolor="#eeeeee" valign="top" align="left">
86 <font color="#000000" size="-1" face="arial,helvetica,sanserif">assembler</font>
87 </td>
88 <td bgcolor="#eeeeee" valign="top" align="left">
89 <font color="#000000" size="-1" face="arial,helvetica,sanserif">enable (default) or disable assembly language in the output</font>
90 </td>
91 <td bgcolor="#eeeeee" valign="top" align="left">
92 <font color="#000000" size="-1" face="arial,helvetica,sanserif">boolean</font>
93 </td>
94 <td bgcolor="#eeeeee" valign="top" align="left" rowspan="17">
95 <font color="#000000" size="-1" face="arial,helvetica,sanserif">Optional</font>
96 </td>
97 </tr>
98 <!-- Attribute -->
99 <tr>
100 <td bgcolor="#eeeeee" valign="top" align="left">
101 <font color="#000000" size="-1" face="arial,helvetica,sanserif">bytes</font>
102 </td>
103 <td bgcolor="#eeeeee" valign="top" align="left">
104 <font color="#000000" size="-1" face="arial,helvetica,sanserif">enable or disable (default) the original bytes as comments</font>
105 </td>
106 <td bgcolor="#eeeeee" valign="top" align="left">
107 <font color="#000000" size="-1" face="arial,helvetica,sanserif">boolean</font>
108 </td>
109 </tr>
110 <!-- Attribute -->
111 <tr>
112 <td bgcolor="#eeeeee" valign="top" align="left">
113 <font color="#000000" size="-1" face="arial,helvetica,sanserif">destfile</font>
114 </td>
115 <td bgcolor="#eeeeee" valign="top" align="left">
116 <font color="#000000" size="-1" face="arial,helvetica,sanserif">the output file (required)</font>
117 </td>
118 <td bgcolor="#eeeeee" valign="top" align="left">
119 <font color="#000000" size="-1" face="arial,helvetica,sanserif">File</font>
120 </td>
121 </tr>
122 <!-- Attribute -->
123 <tr>
124 <td bgcolor="#eeeeee" valign="top" align="left">
125 <font color="#000000" size="-1" face="arial,helvetica,sanserif">encoding</font>
126 </td>
127 <td bgcolor="#eeeeee" valign="top" align="left">
128 <font color="#000000" size="-1" face="arial,helvetica,sanserif">Select the output encoding: ascii, utf8 or unicode</font>
129 </td>
130 <td bgcolor="#eeeeee" valign="top" align="left">
131 <font color="#000000" size="-1" face="arial,helvetica,sanserif">"ascii", "utf8", "unicode"</font>
132 </td>
133 </tr>
134 <!-- Attribute -->
135 <tr>
136 <td bgcolor="#eeeeee" valign="top" align="left">
137 <font color="#000000" size="-1" face="arial,helvetica,sanserif">executable</font>
138 </td>
139 <td bgcolor="#eeeeee" valign="top" align="left">
140 <font color="#000000" size="-1" face="arial,helvetica,sanserif">override the name of the executable (normally ildasm) or set its full path. Do not set a relative path, as the ugly hacks needed to create resource files in the dest directory force us to change to this directory before running the application. i.e use &lt;property location&gt to create an absolute path from a relative one before setting this value.</font>
141 </td>
142 <td bgcolor="#eeeeee" valign="top" align="left">
143 <font color="#000000" size="-1" face="arial,helvetica,sanserif">String</font>
144 </td>
145 </tr>
146 <!-- Attribute -->
147 <tr>
148 <td bgcolor="#eeeeee" valign="top" align="left">
149 <font color="#000000" size="-1" face="arial,helvetica,sanserif">header</font>
150 </td>
151 <td bgcolor="#eeeeee" valign="top" align="left">
152 <font color="#000000" size="-1" face="arial,helvetica,sanserif">include header information; default false.</font>
153 </td>
154 <td bgcolor="#eeeeee" valign="top" align="left">
155 <font color="#000000" size="-1" face="arial,helvetica,sanserif">boolean</font>
156 </td>
157 </tr>
158 <!-- Attribute -->
159 <tr>
160 <td bgcolor="#eeeeee" valign="top" align="left">
161 <font color="#000000" size="-1" face="arial,helvetica,sanserif">item</font>
162 </td>
163 <td bgcolor="#eeeeee" valign="top" align="left">
164 <font color="#000000" size="-1" face="arial,helvetica,sanserif">name a single item to decode; a class or a method e.g item="Myclass::method" or item="namespace1::namespace2::Myclass:method(void(int32))</font>
165 </td>
166 <td bgcolor="#eeeeee" valign="top" align="left">
167 <font color="#000000" size="-1" face="arial,helvetica,sanserif">String</font>
168 </td>
169 </tr>
170 <!-- Attribute -->
171 <tr>
172 <td bgcolor="#eeeeee" valign="top" align="left">
173 <font color="#000000" size="-1" face="arial,helvetica,sanserif">linenumbers</font>
174 </td>
175 <td bgcolor="#eeeeee" valign="top" align="left">
176 <font color="#000000" size="-1" face="arial,helvetica,sanserif">include line number information; default=false</font>
177 </td>
178 <td bgcolor="#eeeeee" valign="top" align="left">
179 <font color="#000000" size="-1" face="arial,helvetica,sanserif">boolean</font>
180 </td>
181 </tr>
182 <!-- Attribute -->
183 <tr>
184 <td bgcolor="#eeeeee" valign="top" align="left">
185 <font color="#000000" size="-1" face="arial,helvetica,sanserif">metadata</font>
186 </td>
187 <td bgcolor="#eeeeee" valign="top" align="left">
188 <font color="#000000" size="-1" face="arial,helvetica,sanserif">include metadata information</font>
189 </td>
190 <td bgcolor="#eeeeee" valign="top" align="left">
191 <font color="#000000" size="-1" face="arial,helvetica,sanserif">boolean</font>
192 </td>
193 </tr>
194 <!-- Attribute -->
195 <tr>
196 <td bgcolor="#eeeeee" valign="top" align="left">
197 <font color="#000000" size="-1" face="arial,helvetica,sanserif">progressbar</font>
198 </td>
199 <td bgcolor="#eeeeee" valign="top" align="left">
200 <font color="#000000" size="-1" face="arial,helvetica,sanserif">show a graphical progress bar in a window during the process; off by default</font>
201 </td>
202 <td bgcolor="#eeeeee" valign="top" align="left">
203 <font color="#000000" size="-1" face="arial,helvetica,sanserif">boolean</font>
204 </td>
205 </tr>
206 <!-- Attribute -->
207 <tr>
208 <td bgcolor="#eeeeee" valign="top" align="left">
209 <font color="#000000" size="-1" face="arial,helvetica,sanserif">quoteallnames</font>
210 </td>
211 <td bgcolor="#eeeeee" valign="top" align="left">
212 <font color="#000000" size="-1" face="arial,helvetica,sanserif">quote all names.</font>
213 </td>
214 <td bgcolor="#eeeeee" valign="top" align="left">
215 <font color="#000000" size="-1" face="arial,helvetica,sanserif">boolean</font>
216 </td>
217 </tr>
218 <!-- Attribute -->
219 <tr>
220 <td bgcolor="#eeeeee" valign="top" align="left">
221 <font color="#000000" size="-1" face="arial,helvetica,sanserif">rawexceptionhandling</font>
222 </td>
223 <td bgcolor="#eeeeee" valign="top" align="left">
224 <font color="#000000" size="-1" face="arial,helvetica,sanserif">enable raw exception handling (default = false)</font>
225 </td>
226 <td bgcolor="#eeeeee" valign="top" align="left">
227 <font color="#000000" size="-1" face="arial,helvetica,sanserif">boolean</font>
228 </td>
229 </tr>
230 <!-- Attribute -->
231 <tr>
232 <td bgcolor="#eeeeee" valign="top" align="left">
233 <font color="#000000" size="-1" face="arial,helvetica,sanserif">resourcedir</font>
234 </td>
235 <td bgcolor="#eeeeee" valign="top" align="left">
236 <font color="#000000" size="-1" face="arial,helvetica,sanserif">Set the name of the directory for resources to be created. We cannot control their names, but we can say where they get created. If not set, the directory of the dest file is used</font>
237 </td>
238 <td bgcolor="#eeeeee" valign="top" align="left">
239 <font color="#000000" size="-1" face="arial,helvetica,sanserif">File</font>
240 </td>
241 </tr>
242 <!-- Attribute -->
243 <tr>
244 <td bgcolor="#eeeeee" valign="top" align="left">
245 <font color="#000000" size="-1" face="arial,helvetica,sanserif">showsource</font>
246 </td>
247 <td bgcolor="#eeeeee" valign="top" align="left">
248 <font color="#000000" size="-1" face="arial,helvetica,sanserif">include the source as comments (default=false)</font>
249 </td>
250 <td bgcolor="#eeeeee" valign="top" align="left">
251 <font color="#000000" size="-1" face="arial,helvetica,sanserif">boolean</font>
252 </td>
253 </tr>
254 <!-- Attribute -->
255 <tr>
256 <td bgcolor="#eeeeee" valign="top" align="left">
257 <font color="#000000" size="-1" face="arial,helvetica,sanserif">sourcefile</font>
258 </td>
259 <td bgcolor="#eeeeee" valign="top" align="left">
260 <font color="#000000" size="-1" face="arial,helvetica,sanserif">the file to disassemble -required</font>
261 </td>
262 <td bgcolor="#eeeeee" valign="top" align="left">
263 <font color="#000000" size="-1" face="arial,helvetica,sanserif">File</font>
264 </td>
265 </tr>
266 <!-- Attribute -->
267 <tr>
268 <td bgcolor="#eeeeee" valign="top" align="left">
269 <font color="#000000" size="-1" face="arial,helvetica,sanserif">srcfile</font>
270 </td>
271 <td bgcolor="#eeeeee" valign="top" align="left">
272 <font color="#000000" size="-1" face="arial,helvetica,sanserif">alternate name for sourceFile</font>
273 </td>
274 <td bgcolor="#eeeeee" valign="top" align="left">
275 <font color="#000000" size="-1" face="arial,helvetica,sanserif">File</font>
276 </td>
277 </tr>
278 <!-- Attribute -->
279 <tr>
280 <td bgcolor="#eeeeee" valign="top" align="left">
281 <font color="#000000" size="-1" face="arial,helvetica,sanserif">visibility</font>
282 </td>
283 <td bgcolor="#eeeeee" valign="top" align="left">
284 <font color="#000000" size="-1" face="arial,helvetica,sanserif">visibility options: one or more of the following, with + signs to concatenate them: <pre> pub : Public pri : Private fam : Family asm : Assembly faa : Family and Assembly foa : Family or Assembly psc : Private Scope </pre> e.g. visibility="pub+pri". Family means <code>protected</code> in C#;</font>
285 </td>
286 <td bgcolor="#eeeeee" valign="top" align="left">
287 <font color="#000000" size="-1" face="arial,helvetica,sanserif">String</font>
288 </td>
289 </tr>
290
291
292 </table>
293 </blockquote></td></tr>
294
295 </table>
296 <!-- End Attributes -->
297
298 <!-- Start Elements -->
299 <table border="0" cellspacing="0" cellpadding="2" width="100%">
300 <tr><td>&nbsp;</td></tr>
301
302 <tr><td bgcolor="#525D76">
303 <font color="#ffffff" face="arial,helvetica.sanserif">
304 <a name="elements">
305 <strong>Parameters as nested elements</strong></a></font>
306 </td></tr>
307
308 <tr><td><blockquote>
309
310 </blockquote></td></tr>
311
312 </table>
313 <!-- End Elements -->
314
315
316 </td>
317 </tr>
318 <!-- END RIGHT SIDE MAIN BODY -->
319
320 <!-- FOOTER SEPARATOR -->
321 <tr>
322 <td>
323 <hr noshade="" size="1"/>
324 </td>
325 </tr>
326
327 <!-- PAGE FOOTER -->
328 <tr>
329 <td>
330 <div align="center"><font color="#525D76" size="-1"><em>
331 Copyright &copy; 2000-2004, The Apache Software Foundation. All Rights Reserved.
332 </em></font></div>
333 </td>
334 </tr>
335
336</table>
337
338</body>
339</html>
Note: See TracBrowser for help on using the repository browser.