2 * JNI interface to C code for MSG.
4 * Copyright 2006-2012 The SimGrid Team.
7 * This program is free software; you can redistribute
8 * it and/or modify it under the terms of the license
9 * (GNU LGPL) which comes with this package.
12 package org.simgrid.msg;
14 import java.io.FileOutputStream;
15 import java.io.InputStream;
16 import java.io.OutputStream;
20 public final class Msg {
21 /* Statically load the library which contains all native functions used in here */
22 static private boolean isNativeInited = false;
23 public static void nativeInit() {
27 /* prefer the version on disk, if existing */
28 System.loadLibrary("SG_java");
29 } catch (UnsatisfiedLinkError e) {
30 /* If not found, unpack the one bundled into the jar file and use it */
34 isNativeInited = true;
39 private static void loadLib (String name) {
40 String Os = System.getProperty("os.name");
41 //Windows may report its name in java differently from cmake, which generated the path
42 if(Os.toLowerCase().indexOf("win") >= 0) Os = "Windows";
43 String Path = "NATIVE/"+Os+"/"+System.getProperty("os.arch")+"/";
46 InputStream in = Msg.class.getClassLoader().getResourceAsStream(Path+filename);
49 filename = "lib"+name+".so";
50 in = Msg.class.getClassLoader().getResourceAsStream(Path+filename);
53 filename = name+".dll";
54 in = Msg.class.getClassLoader().getResourceAsStream(Path+filename);
57 filename = "lib"+name+".dll";
58 in = Msg.class.getClassLoader().getResourceAsStream(Path+filename);
61 filename = "lib"+name+".dylib";
62 in = Msg.class.getClassLoader().getResourceAsStream(Path+filename);
65 throw new RuntimeException("Cannot find library "+name+" in path "+Path+". Sorry, but this jar does not seem to be usable on your machine.");
67 // Caching the file on disk: desactivated because it could fool the users
68 // if (new File(filename).isFile()) {
69 // // file was already unpacked -- use it directly
70 // System.load(new File(".").getAbsolutePath()+File.separator+filename);
74 // We must write the lib onto the disk before loading it -- stupid operating systems
75 File fileOut = new File(filename);
76 // if (!new File(".").canWrite()) {
77 // System.out.println("Cannot write in ."+File.separator+filename+"; unpacking the library into a temporary file instead");
78 fileOut = File.createTempFile("simgrid-", ".tmp");
79 // don't leak the file on disk, but remove it on JVM shutdown
80 Runtime.getRuntime().addShutdownHook(new Thread(new FileCleaner(fileOut.getAbsolutePath())));
82 // System.out.println("Unpacking SimGrid native library to " + fileOut.getAbsolutePath());
83 OutputStream out = new FileOutputStream(fileOut);
85 /* copy the library in position */
86 byte[] buffer = new byte[4096];
88 while ((bytes_read = in.read(buffer)) != -1) // Read until EOF
89 out.write(buffer, 0, bytes_read);
91 /* close all file descriptors, and load that shit */
94 System.load(fileOut.getAbsolutePath());
95 } catch (Exception e) {
96 System.err.println("Cannot load the bindings to the simgrid library: ");
98 System.err.println("This jar file does not seem to fit your system, sorry");
102 /* A hackish mechanism used to remove the file containing our library when the JVM shuts down */
103 private static class FileCleaner implements Runnable {
104 private String target;
105 public FileCleaner(String name) {
110 new File(target).delete();
111 } catch(Exception e) {
112 System.out.println("Unable to clean temporary file "+target+" during shutdown.");
118 /** Retrieve the simulation time
119 * @return The simulation time.
121 public final static native double getClock();
123 * Issue a debug logging message.
124 * @param s message to log.
126 public final static native void debug(String s);
128 * Issue an verbose logging message.
129 * @param s message to log.
131 public final static native void verb(String s);
133 /** Issue an information logging message
136 public final static native void info(String s);
138 * Issue an warning logging message.
139 * @param s message to log.
141 public final static native void warn(String s);
143 * Issue an error logging message.
144 * @param s message to log.
146 public final static native void error(String s);
148 * Issue an critical logging message.
149 * @param s message to log.
151 public final static native void critical(String s);
153 /*********************************************************************************
154 * Deployment and initialization related functions *
155 *********************************************************************************/
158 * The natively implemented method to initialize a MSG simulation.
160 * @param args The arguments of the command line of the simulation.
162 public final static native void init(String[]args);
165 * Run the MSG simulation.
167 * The simulation is not cleaned afterward (see
168 * {@link #clean()} if you really insist on cleaning the C side), so you can freely
169 * retrieve the informations that you want from the simulation. In particular, retrieving the status
170 * of a process or the current date is perfectly ok.
172 public final static native void run() ;
174 /** This function is useless nowadays, just stop calling it. */
176 public final static void clean(){}
179 * The native implemented method to create the environment of the simulation.
181 * @param platformFile The XML file which contains the description of the environment of the simulation
184 public final static native void createEnvironment(String platformFile);
187 * The method to deploy the simulation.
190 * @param deploymentFile
192 public final static native void deployApplication(String deploymentFile);
194 /** Example launcher. You can use it or provide your own launcher, as you wish
196 * @throws MsgException
198 static public void main(String[]args) throws MsgException {
199 /* initialize the MSG simulation. Must be done before anything else (even logging). */
202 if (args.length < 2) {
203 Msg.info("Usage: Msg platform_file deployment_file");
207 /* Load the platform and deploy the application */
208 Msg.createEnvironment(args[0]);
209 Msg.deployApplication(args[1]);
210 /* Execute the simulation */