1 /* JNI interface to C code for MSG. */
3 /* Copyright (c) 2006-2014. The SimGrid Team.
4 * All rights reserved. */
6 /* This program is free software; you can redistribute it and/or modify it
7 * under the terms of the license (GNU LGPL) which comes with this package. */
9 package org.simgrid.msg;
10 import org.simgrid.NativeLib;
13 public final class Msg {
15 /** Retrieves the simulation time */
16 public final static native double getClock();
17 /** Issue a debug logging message. */
18 public final static native void debug(String msg);
19 /** Issue a verbose logging message. */
20 public final static native void verb(String msg);
21 /** Issue an information logging message */
22 public final static native void info(String msg);
23 /** Issue a warning logging message. */
24 public final static native void warn(String msg);
25 /** Issue an error logging message. */
26 public final static native void error(String msg);
27 /** Issue a critical logging message. */
28 public final static native void critical(String s);
30 /*********************************************************************************
31 * Deployment and initialization related functions *
32 *********************************************************************************/
34 /** Initialize a MSG simulation.
36 * @param args The arguments of the command line of the simulation.
38 public final static native void init(String[]args);
40 /** Tell the kernel that you want to use the energy plugin */
41 public final static native void energyInit();
43 /** Run the MSG simulation.
45 * The simulation is not cleaned afterward (see
46 * {@link #clean()} if you really insist on cleaning the C side), so you can freely
47 * retrieve the information that you want from the simulation. In particular, retrieving the status
48 * of a process or the current date is perfectly ok.
50 public final static native void run() ;
52 /** This function is useless nowadays, just stop calling it. */
54 public final static void clean(){}
56 /** Create the simulation environment by parsing a platform file. */
57 public final static native void createEnvironment(String platformFile);
59 public final static native As environmentGetRoutingRoot();
61 /** Starts your processes by parsing a deployment file. */
62 public final static native void deployApplication(String deploymentFile);
64 /** Example launcher. You can use it or provide your own launcher, as you wish
66 * @throws MsgException
68 static public void main(String[]args) throws MsgException {
69 /* initialize the MSG simulation. Must be done before anything else (even logging). */
72 if (args.length < 2) {
73 Msg.info("Usage: Msg platform_file deployment_file");
77 /* Load the platform and deploy the application */
78 Msg.createEnvironment(args[0]);
79 Msg.deployApplication(args[1]);
80 /* Execute the simulation */
84 /* Class initializer, to initialize various JNI stuff */
86 org.simgrid.NativeLib.nativeInit();