source: release-kits/lirk3/bin/ant-installer/web/manual1.7.0/manual/OptionalTasks/ilasm.html@ 14982

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

initial import of LiRK3
File size: 11.3 KB
Line 
1<!--
2 Licensed to the Apache Software Foundation (ASF) under one or more
3 contributor license agreements. See the NOTICE file distributed with
4 this work for additional information regarding copyright ownership.
5 The ASF licenses this file to You under the Apache License, Version 2.0
6 (the "License"); you may not use this file except in compliance with
7 the License. You may obtain a copy of the License at
8
9 http://www.apache.org/licenses/LICENSE-2.0
10
11 Unless required by applicable law or agreed to in writing, software
12 distributed under the License is distributed on an "AS IS" BASIS,
13 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 See the License for the specific language governing permissions and
15 limitations under the License.
16-->
17
18<html>
19<head>
20 <meta http-equiv="Content-Language" content="en-us">
21 <title>Ilasm
22 Task</title>
23</head>
24
25<body bgcolor="#ffffff" text="#000000" link="#525D76"
26 alink="#525D76" vlink="#525D76">
27
28<table border="0" width="100%" cellspacing="4">
29
30 <!-- PAGE HEADER -->
31 <tr>
32 <td>
33 <table border="0" width="100%"><tr>
34 <td valign="bottom">
35 <font size="+3" face="arial,helvetica,sanserif"><strong>Ilasm
36 Task</strong></font>
37 <br><font face="arial,helvetica,sanserif">Assembles .NET Intermediate Language files.</font>
38 </td>
39 <td>
40 <!-- PROJECT LOGO -->
41 <a href="http://ant.apache.org/">
42 <img src="../../images/ant_logo_large.gif" align="right" alt="Apache Ant" border="0">
43 </a>
44 </td>
45 </tr></table>
46 </td>
47 </tr>
48
49 <!-- START RIGHT SIDE MAIN BODY -->
50 <tr>
51 <td valign="top" align="left">
52
53 <!-- Applying task/long-description -->
54 <!-- Start Description -->
55 <table border="0" cellspacing="0" cellpadding="2" width="100%">
56 <tr><td>&nbsp;</td></tr>
57
58 <tr><td bgcolor="#525D76">
59 <font color="#ffffff" face="arial,helvetica.sanserif">
60 <a name="description">
61 <strong>Description</strong></a></font>
62 </td></tr>
63
64 <tr><td><blockquote>
65 Assembles .NET Intermediate Language files. ilasm.exe must be on the execute path, unless another executable or the full path to that executable is specified in the <tt>executable</tt> parameter <p> <p> All parameters are optional: <code>&lt;il/&gt;</code> should suffice to produce a debug build of all *.il files. The option set is roughly compatible with the CSharp class; even though the command line options are only vaguely equivalent. [The low level commands take things like /OUT=file, csc wants /out:file ... /verbose is used some places; /quiet here in ildasm... etc.] It would be nice if someone made all the command line tools consistent (and not as brittle as the java cmdline tools) <p> <p> The task is a directory based task, so attributes like <b>includes="*.il" </b> and <b>excludes="broken.il"</b> can be used to control the files pulled in. You can also use nested &lt;src&gt filesets to refer to source. <p>
66 </blockquote></td></tr>
67
68 </table>
69 <!-- End Description -->
70
71 <!-- Start Attributes -->
72 <table border="0" cellspacing="0" cellpadding="2" width="100%">
73 <tr><td>&nbsp;</td></tr>
74 <tr><td bgcolor="#525D76">
75 <font color="#ffffff" face="arial,helvetica.sanserif">
76 <a name="attributes">
77 <strong>Parameters</strong></a></font>
78 </td></tr>
79 <tr><td><blockquote>
80 <table>
81 <tr>
82 <td bgcolor="#cccccc" valign="top" align="left">
83 <font color="#000000" size="-1" face="arial,helvetica,sanserif"><b>Attribute</b></font>
84 </td>
85 <td bgcolor="#cccccc" valign="top" align="left">
86 <font color="#000000" size="-1" face="arial,helvetica,sanserif"><b>Description</b></font>
87 </td>
88 <td bgcolor="#cccccc" valign="top" align="left">
89 <font color="#000000" size="-1" face="arial,helvetica,sanserif"><b>Type</b></font>
90 </td>
91 <td bgcolor="#cccccc" valign="top" align="left">
92 <font color="#000000" size="-1" face="arial,helvetica,sanserif"><b>Requirement</b></font>
93 </td>
94 </tr>
95 <!-- Attribute Group -->
96
97 <!-- Attribute Group -->
98 <!-- Attribute -->
99 <tr>
100 <td bgcolor="#eeeeee" valign="top" align="left">
101 <font color="#000000" size="-1" face="arial,helvetica,sanserif">debug</font>
102 </td>
103 <td bgcolor="#eeeeee" valign="top" align="left">
104 <font color="#000000" size="-1" face="arial,helvetica,sanserif">set the debug flag on or off.</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 <td bgcolor="#eeeeee" valign="top" align="left" rowspan="10">
110 <font color="#000000" size="-1" face="arial,helvetica,sanserif">Optional</font>
111 </td>
112 </tr>
113 <!-- Attribute -->
114 <tr>
115 <td bgcolor="#eeeeee" valign="top" align="left">
116 <font color="#000000" size="-1" face="arial,helvetica,sanserif">destfile</font>
117 </td>
118 <td bgcolor="#eeeeee" valign="top" align="left">
119 <font color="#000000" size="-1" face="arial,helvetica,sanserif">Set the name of exe/library to create.</font>
120 </td>
121 <td bgcolor="#eeeeee" valign="top" align="left">
122 <font color="#000000" size="-1" face="arial,helvetica,sanserif">File</font>
123 </td>
124 </tr>
125 <!-- Attribute -->
126 <tr>
127 <td bgcolor="#eeeeee" valign="top" align="left">
128 <font color="#000000" size="-1" face="arial,helvetica,sanserif">extraoptions</font>
129 </td>
130 <td bgcolor="#eeeeee" valign="top" align="left">
131 <font color="#000000" size="-1" face="arial,helvetica,sanserif">Any extra options which are not explicitly supported by this task.</font>
132 </td>
133 <td bgcolor="#eeeeee" valign="top" align="left">
134 <font color="#000000" size="-1" face="arial,helvetica,sanserif">String</font>
135 </td>
136 </tr>
137 <!-- Attribute -->
138 <tr>
139 <td bgcolor="#eeeeee" valign="top" align="left">
140 <font color="#000000" size="-1" face="arial,helvetica,sanserif">failonerror</font>
141 </td>
142 <td bgcolor="#eeeeee" valign="top" align="left">
143 <font color="#000000" size="-1" face="arial,helvetica,sanserif">If true, fails if ilasm tool fails.</font>
144 </td>
145 <td bgcolor="#eeeeee" valign="top" align="left">
146 <font color="#000000" size="-1" face="arial,helvetica,sanserif">boolean</font>
147 </td>
148 </tr>
149 <!-- Attribute -->
150 <tr>
151 <td bgcolor="#eeeeee" valign="top" align="left">
152 <font color="#000000" size="-1" face="arial,helvetica,sanserif">keyfile</font>
153 </td>
154 <td bgcolor="#eeeeee" valign="top" align="left">
155 <font color="#000000" size="-1" face="arial,helvetica,sanserif">the name of a file containing a private key.</font>
156 </td>
157 <td bgcolor="#eeeeee" valign="top" align="left">
158 <font color="#000000" size="-1" face="arial,helvetica,sanserif">File</font>
159 </td>
160 </tr>
161 <!-- Attribute -->
162 <tr>
163 <td bgcolor="#eeeeee" valign="top" align="left">
164 <font color="#000000" size="-1" face="arial,helvetica,sanserif">listing</font>
165 </td>
166 <td bgcolor="#eeeeee" valign="top" align="left">
167 <font color="#000000" size="-1" face="arial,helvetica,sanserif">If true, produce a listing (off by default).</font>
168 </td>
169 <td bgcolor="#eeeeee" valign="top" align="left">
170 <font color="#000000" size="-1" face="arial,helvetica,sanserif">boolean</font>
171 </td>
172 </tr>
173 <!-- Attribute -->
174 <tr>
175 <td bgcolor="#eeeeee" valign="top" align="left">
176 <font color="#000000" size="-1" face="arial,helvetica,sanserif">outputfile</font>
177 </td>
178 <td bgcolor="#eeeeee" valign="top" align="left">
179 <font color="#000000" size="-1" face="arial,helvetica,sanserif">Set the output file; identical to setDestFile</font>
180 </td>
181 <td bgcolor="#eeeeee" valign="top" align="left">
182 <font color="#000000" size="-1" face="arial,helvetica,sanserif">File</font>
183 </td>
184 </tr>
185 <!-- Attribute -->
186 <tr>
187 <td bgcolor="#eeeeee" valign="top" align="left">
188 <font color="#000000" size="-1" face="arial,helvetica,sanserif">resourcefile</font>
189 </td>
190 <td bgcolor="#eeeeee" valign="top" align="left">
191 <font color="#000000" size="-1" face="arial,helvetica,sanserif">name of resource file to include.</font>
192 </td>
193 <td bgcolor="#eeeeee" valign="top" align="left">
194 <font color="#000000" size="-1" face="arial,helvetica,sanserif">File</font>
195 </td>
196 </tr>
197 <!-- Attribute -->
198 <tr>
199 <td bgcolor="#eeeeee" valign="top" align="left">
200 <font color="#000000" size="-1" face="arial,helvetica,sanserif">srcdir</font>
201 </td>
202 <td bgcolor="#eeeeee" valign="top" align="left">
203 <font color="#000000" size="-1" face="arial,helvetica,sanserif">Set the source directory of the files to be compiled.</font>
204 </td>
205 <td bgcolor="#eeeeee" valign="top" align="left">
206 <font color="#000000" size="-1" face="arial,helvetica,sanserif">File</font>
207 </td>
208 </tr>
209 <!-- Attribute -->
210 <tr>
211 <td bgcolor="#eeeeee" valign="top" align="left">
212 <font color="#000000" size="-1" face="arial,helvetica,sanserif">verbose</font>
213 </td>
214 <td bgcolor="#eeeeee" valign="top" align="left">
215 <font color="#000000" size="-1" face="arial,helvetica,sanserif">If true, enable verbose ILASM output.</font>
216 </td>
217 <td bgcolor="#eeeeee" valign="top" align="left">
218 <font color="#000000" size="-1" face="arial,helvetica,sanserif">boolean</font>
219 </td>
220 </tr>
221
222
223 </table>
224 </blockquote></td></tr>
225
226 </table>
227 <!-- End Attributes -->
228
229 <!-- Start Elements -->
230 <table border="0" cellspacing="0" cellpadding="2" width="100%">
231 <tr><td>&nbsp;</td></tr>
232
233 <tr><td bgcolor="#525D76">
234 <font color="#ffffff" face="arial,helvetica.sanserif">
235 <a name="elements">
236 <strong>Parameters as nested elements</strong></a></font>
237 </td></tr>
238
239 <tr><td><blockquote>
240 <!-- Start Element -->
241 <table border="0" cellspacing="0" cellpadding="2" width="100%">
242 <tr><td>&nbsp;</td></tr>
243 <tr><td bgcolor="#828DA6">
244 <font color="#ffffff" face="arial,helvetica.sanserif" size="-1">
245 <strong>reference</strong> (org.apache.tools.ant.types.FileSet)</font>
246 </td></tr>
247 <tr><td><blockquote>
248 add a new reference fileset to the compilation
249 </blockquote></td></tr>
250 </table>
251 <!-- End Element -->
252 <!-- Start Element -->
253 <table border="0" cellspacing="0" cellpadding="2" width="100%">
254 <tr><td>&nbsp;</td></tr>
255 <tr><td bgcolor="#828DA6">
256 <font color="#ffffff" face="arial,helvetica.sanserif" size="-1">
257 <strong>src</strong> (org.apache.tools.ant.types.FileSet)</font>
258 </td></tr>
259 <tr><td><blockquote>
260 add a new source directory to the compile
261 </blockquote></td></tr>
262 </table>
263 <!-- End Element -->
264
265 </blockquote></td></tr>
266
267 </table>
268 <!-- End Elements -->
269
270
271 </td>
272 </tr>
273 <!-- END RIGHT SIDE MAIN BODY -->
274
275</table>
276
277</body>
278</html>
Note: See TracBrowser for help on using the repository browser.