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;
11 import java.io.FileOutputStream;
12 import java.io.InputStream;
13 import java.io.OutputStream;
17 public final class Msg {
18 /* Statically load the library which contains all native functions used in here */
19 static private boolean isNativeInited = false;
20 public static void nativeInit() {
24 /* prefer the version on disk, if existing */
25 System.loadLibrary("simgrid-java");
26 } catch (UnsatisfiedLinkError e) {
27 /* If not found, unpack the one bundled into the jar file and use it */
29 loadLib("simgrid-java");
31 isNativeInited = true;
36 private static void loadLib (String name) {
37 String Os = System.getProperty("os.name");
38 String Arch = System.getProperty("os.arch");
39 // Some OS/Arch may be different between Java and Cmake,
40 // which generated the path
41 if (Os.toLowerCase().startsWith("win"))
43 else if (Os.contains("OS X"))
45 if (Arch.equalsIgnoreCase("x86"))
47 else if (Arch.equalsIgnoreCase("x86_64"))
49 String Path = "NATIVE/" + Os + "/" + Arch + "/";
52 InputStream in = Msg.class.getClassLoader().getResourceAsStream(Path+filename);
55 filename = "lib"+name+".so";
56 in = Msg.class.getClassLoader().getResourceAsStream(Path+filename);
59 filename = name+".dll";
60 in = Msg.class.getClassLoader().getResourceAsStream(Path+filename);
63 filename = "lib"+name+".dll";
64 in = Msg.class.getClassLoader().getResourceAsStream(Path+filename);
67 filename = "lib"+name+".dylib";
68 in = Msg.class.getClassLoader().getResourceAsStream(Path+filename);
71 throw new RuntimeException("Cannot find library "+name+" in path "+Path+". Sorry, but this jar does not seem to be usable on your machine.");
73 // Caching the file on disk: desactivated because it could fool the users
74 // if (new File(filename).isFile()) {
75 // // file was already unpacked -- use it directly
76 // System.load(new File(".").getAbsolutePath()+File.separator+filename);
80 // We must write the lib onto the disk before loading it -- stupid operating systems
81 File fileOut = new File(filename);
82 // if (!new File(".").canWrite()) {
83 // System.out.println("Cannot write in ."+File.separator+filename+"; unpacking the library into a temporary file instead");
84 fileOut = File.createTempFile("simgrid-", ".tmp");
85 // don't leak the file on disk, but remove it on JVM shutdown
86 Runtime.getRuntime().addShutdownHook(new Thread(new FileCleaner(fileOut.getAbsolutePath())));
88 // System.out.println("Unpacking SimGrid native library to " + fileOut.getAbsolutePath());
89 OutputStream out = new FileOutputStream(fileOut);
91 /* copy the library in position */
92 byte[] buffer = new byte[4096];
94 while ((bytes_read = in.read(buffer)) != -1) // Read until EOF
95 out.write(buffer, 0, bytes_read);
97 /* close all file descriptors, and load that shit */
100 System.load(fileOut.getAbsolutePath());
101 } catch (Exception e) {
102 System.err.println("Cannot load the bindings to the simgrid library: ");
104 System.err.println("This jar file does not seem to fit your system, sorry");
108 /* A hackish mechanism used to remove the file containing our library when the JVM shuts down */
109 private static class FileCleaner implements Runnable {
110 private String target;
111 public FileCleaner(String name) {
116 new File(target).delete();
117 } catch(Exception e) {
118 System.out.println("Unable to clean temporary file "+target+" during shutdown.");
124 /** Retrieve the simulation time
125 * @return The simulation time.
127 public final static native double getClock();
129 * Issue a debug logging message.
130 * @param s message to log.
132 public final static native void debug(String s);
134 * Issue an verbose logging message.
135 * @param s message to log.
137 public final static native void verb(String s);
139 /** Issue an information logging message
142 public final static native void info(String s);
144 * Issue an warning logging message.
145 * @param s message to log.
147 public final static native void warn(String s);
149 * Issue an error logging message.
150 * @param s message to log.
152 public final static native void error(String s);
154 * Issue an critical logging message.
155 * @param s message to log.
157 public final static native void critical(String s);
159 /*********************************************************************************
160 * Deployment and initialization related functions *
161 *********************************************************************************/
164 * The natively implemented method to initialize a MSG simulation.
166 * @param args The arguments of the command line of the simulation.
168 public final static native void init(String[]args);
171 * Run the MSG simulation.
173 * The simulation is not cleaned afterward (see
174 * {@link #clean()} if you really insist on cleaning the C side), so you can freely
175 * retrieve the informations that you want from the simulation. In particular, retrieving the status
176 * of a process or the current date is perfectly ok.
178 public final static native void run() ;
180 /** This function is useless nowadays, just stop calling it. */
182 public final static void clean(){}
185 * The native implemented method to create the environment of the simulation.
187 * @param platformFile The XML file which contains the description of the environment of the simulation
190 public final static native void createEnvironment(String platformFile);
192 public final static native As environmentGetRoutingRoot();
195 * The method to deploy the simulation.
198 * @param deploymentFile
200 public final static native void deployApplication(String deploymentFile);
202 /** Example launcher. You can use it or provide your own launcher, as you wish
204 * @throws MsgException
206 static public void main(String[]args) throws MsgException {
207 /* initialize the MSG simulation. Must be done before anything else (even logging). */
210 if (args.length < 2) {
211 Msg.info("Usage: Msg platform_file deployment_file");
215 /* Load the platform and deploy the application */
216 Msg.createEnvironment(args[0]);
217 Msg.deployApplication(args[1]);
218 /* Execute the simulation */