~ubuntu-branches/ubuntu/trusty/monodevelop/trusty-proposed

<td width="100%" align="center" bgcolor="#294563"><a href="http://www.ikvm.net/"><img border="0" class="logoImage" alt="IKVM.NET" src="../images/project.gif" title="Java on .NET"></a></td>

<td valign="top" rowspan="2" bgcolor="#294563"></td>

<td bgcolor="#294563"><img height="10" width="10" alt="" src="../skin/images/spacer.gif" class="spacer"></td>

</tr>

<tr>

<tr>

</tr>

</table>

</div>

</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../skin/images/spacer.gif" class="spacer"></td>

</tr>

<tr>

</tr>

</table>

<tr>

<tr>

<tr>

</tr>

<tr>

</tr>

<tr>

</tr>

</table>

</td>

<td bgcolor="#294563"><img width="1" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">

<ul>

<li>

<font color="#CFDCED">About</font>

<ul>

<li>

</li>

<li>

<a href="../download.html" title="">Download</a>

</li>

<li>

</li>

<li>

</li>

<li>

</li>

<li>

<a href="http://weblog.ikvm.net/story.aspx/license" title="">License</a>

</li>

100

<li>

101

<a href="../stories.html" title="">Case Studies</a>

102

</li>

103

104

</ul>

105

</li>

106

<li>

107

<font color="#CFDCED">User's Guide</font>

108

<ul>

109

110

<li>

111

<a href="../userguide/intro.html">Introduction</a>

112

</li>

113

114

<li>

115

<a href="../userguide/install.html" title="">Installation</a>

116

</li>

117

118

<li>

119

<a href="../userguide/tutorial.html" title="">Tutorial</a>

120

</li>

121

122

<li>

123

<a href="../userguide/tools.html" title="">Tools Reference</a>

124

</li>

125

126

127

128

129

</ul>

130

</li>

131

<li>

132

<font color="#CFDCED">Developer's Guide</font>

133

<ul>

134

135

<li>

136

<a href="../devguide/intro.html" title="">Introduction</a>

137

</li>

138

139

<li>

140

<a href="../devguide/concepts.html" title="">Concepts</a>

141

</li>

142

143

<li>

144

<a href="../devguide/net2java.html" title="">Using Java Libraries</a>

145

</li>

146

147

<li>

148

<a href="../devguide/java2net.html" title="">Developing in Java</a>

149

</li>

150

151

</ul>

152

</li>

153

<li>

154

<font color="#CFDCED">Contributing</font>

155

<ul>

156

157

<li>

158

<a href="http://sourceforge.net/mail/?group_id=69637">Mailing Lists</a>

159

</li>

160

161

<li>

162

<a href="http://sourceforge.net/tracker/?group_id=69637">Report Bugs</a>

163

</li>

164

165

<li>

166

<a href="http://sourceforge.net/cvs/?group_id=69637">CVS Repository</a>

167

</li>

168

169

</ul>

170

</li>

171

</ul>

172

</div>

173

174

</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>

175

</tr>

176

<tr>

177

178

</tr>

179

<tr>

180

181

</tr>

182

</table>

183

</td><td valign="top" width="100%">

184

185

186

<tr>

187

188

</tr>

189

<tr>

190

191

192

193

</font><img width="10" height="8" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">

194

195

196

</font><img width="10" height="8" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>

197

</tr>

198

<tr>

199

200

</tr>

201

202

203

<tr>

204

205

206

207

<tr>

208

209

<h1>IKVM.NET Virtual Machine (ikvm.exe)</h1>

210

</td>

211

</tr>

212

</table>

213

<p>The ikvm tool is a Java virtual machine implemented in .NET.</p>

214

215

<li>

216

<a href="#Usage">Usage</a>

217

</li>

218

<li>

219

<a href="#Options">Options</a>

220

</li>

221

<li>

222

<a href="#Notes">Notes</a>

223

</li>

224

<li>

225

<a href="#Examples">Examples</a>

226

</li>

227

</ul>

228

229

230

<h3>Usage</h3>

231

232

233

<tr>

234

235

236

<div class="pre"> ikvm [ <em>options</em> ] <em>classname</em> [ <em>args ...</em> ]</div>

237

238

<div class="pre"> ikvm [ <em>options</em> ] -jar <em>jarfile</em> [ <em>args ...</em> ]</div>

239

240

</td>

241

</tr>

242

</table>

243

<dl>

244

245

<dt>options</dt>

246

247

<dd>Command-line options for the virtual machine.</dd>

248

249

<dt>classname</dt>

250

251

<dd>Fully-qualified name of a class containing the main method to execute. Do not include a

252

path or a .class extension. Do not use this with the -jar option.</dd>

253

254

<dt>jarfile</dt>

255

256

<dd>The name of an executable .jar file to execute. Used only with the -jar option.</dd>

257

258

259

260

<dd>Command-line arguments passed to the main class.</dd>

261

262

</dl>

263

</div>

264

265

266

267

<h3>Options</h3>

268

269

270

271

<tr>

272

273

<th colspan="1" rowspan="1">Option</th>

274

<th colspan="1" rowspan="1">Description</th>

275

276

</tr>

277

278

<tr>

279

280

281

-cp <em>classpath</em>

282

<br>

283

-classpath <em>classpath</em>

284

</td>

285

286

<p>Specifies the classpath for the JVM. <em>classpath</em> is a semicolon-delimited list of pathnames to directories and zip files / jar files.</p>

287

288

<p>Note: If you specify this option more than once, only the last is used.</p>

289

290

</td>

291

292

</tr>

293

294

<tr>

295

296

297

-D<em>property-name</em>=<em>value</em>

298

</td>

299

300

Set a system property named <em>property-name</em> to <em>value</em>. Note that there is no

301

space between the -D and <em>property-name</em>.

302

</td>

303

304

</tr>

305

306

<tr>

307

308

309

-Xsave

310

</td>

311

312

Saves the generated assembly (for debugging)

313

</td>

314

315

</tr>

316

317

<tr>

318

319

320

-Xtime

321

</td>

322

323

Times the execution

324

</td>

325

326

</tr>

327

328

<tr>

329

330

331

-Xbootclasspath:<em>classpath</em>

332

</td>

333

334

335

<p>Augments the boot classpath for the JVM. <em>classpath</em> is a semicolon-delimited list of pathnames to directories and jars.

336

These classes are made available through the boot class loader in addition to those in the GNU Classpath libraries.</p>

337

338

<p>Note: If you specify this option more than once, only the last is used.</p>

339

340

</td>

341

342

</tr>

343

344

<tr>

345

346

347

-Xtrace:<em>name</em>

348

</td>

349

350

Displays all tracepoints with the given name

351

</td>

352

353

</tr>

354

355

<tr>

356

357

358

-Xmethodtrace:<em>name</em>

359

</td>

360

361

Builds method trace into the specified output method

362

</td>

363

364

</tr>

365

366

<tr>

367

368

369

-Xwait

370

</td>

371

372

Keeps process hanging around after exit

373

</td>

374

375

</tr>

376

377

</table>

378

</div>

379

380

381

<h3>Notes</h3>

382

383

<p>This command is intended to act as a "drop-in" replacement for the Sun / IBM JVM's. In many cases,

384

you can take a java command line and simply replace <em>java</em> with <em>ikvm</em>.</p>

385

<p>Please refer to the <a target="_top" href="http://java.sun.com/j2se/1.4.2/docs/tooldocs/windows/java.html">Sun documentation</a>

386

for usage details. Note that ikvm supports only the options listed here.</p>

387

<p>ikvm finds classes as follows:</p>

388

<ul>

389

390

<li>If no -cp/-classpath or -jar option specified, and no CLASSPATH environment variable is set,

391

looks in the current directory.</li>

392

393

<li>If no -cp/-classpath or -jar option specified, and CLASSPATH environment variable is set,

394

looks in directories specified in CLASSPATH (not in the current directory unless CLASSPATH contains .).</li>

395

396

<li>If -cp/-classpath option specified, ignores CLASSPATH environment variable, and looks only in

397

directories specified in -cp/-classpath option.</li>

398

399

<li>If -jar option specified, prepends jarfile to CLASSPATH (or -cp/-classpath specified classpath).

400

<p>

401

<strong>Note:</strong> This is different from the Sun JVM behavior.</p>

402

403

</li>

404

405

</ul>

406

<p>For information about creating executable jar files, see <a target="_top" href="http://www-106.ibm.com/developerworks/library/j-jar/">this IBM article</a>.</p>

407

</div>

408

409

410

411

<h3>Examples</h3>

412

413

414

<span class="codefrag"> ikvm MyProg </span>

415

</div>

416

<p>Loads a class named MyProg.class from the current directory (unless the CLASSPATH environment variable

417

is set, in which case that is searched instead) and executes its main method.

418

</p>

419

420

<span class="codefrag"> ikvm -cp c:\java\lib;c:\mystuff\mylib.jar;c:\mystuff\otherlib.zip org.me.MyProg </span>

421

</div>

422

<p>Loads a class named org.me.MyProg from a file named MyProg.class and executes its main method. Searches for it in the following locations:</p>

423

<ul>

424

425

<li>c:\java\lib\org\me\MyProg.class</li>

426

427

<li>c:\mystuff\mylib.jar (looks inside for org/me/MyProg.class)</li>

428

429

<li>c:\mystuff\otherlib.zip (looks inside for org/me/MyProg.class)</li>

430

431

</ul>

432

433

<span class="codefrag"> ikvm -jar /usr/share/myprog.jar </span>

434

</div>

435

<p>Executes Java code in the executable jar file /usr/share/myprog.jar.</p>

436

</div>

437

438

439

</div>

440

</td><td width="10"><img width="10" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>

441

</tr>

442

443

</table>

444

</td>

445

</tr>

446

</table>

447

448

449

450

<tr>

451

452

</tr>

453

<tr>

454

455

456

Send feedback about this page to <a href="mailto:webmaster@ikvm.net?subject=IKVM Website Feedback - Page userguide/ikvm.html">webmaster@ikvm.net</a>

457

<br>

458

459

460

461

document.write(" - "+"Last Published: " + document.lastModified);

462

// --></script></font></td>

463

</tr>

464

<tr>

465

466

</tr>

467

</table>

468

469

</body>

470

</html>

Older »