src/java/simgrid/msg/Msg.java

   1 /*
   2  * JNI interface to C code for MSG.
   3  *
   4  * Copyright 2006,2007,2010 The SimGrid Team.
   5  * All right reserved.
   6  *
   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.
  10  */
  11
  12 package simgrid.msg;
  13
  14 public final class Msg {
  15         /* Statically load the library which contains all native functions used in here */
  16         static {
  17                 try {
  18                         System.loadLibrary("simgrid");
  19                 } catch(UnsatisfiedLinkError e) {
  20                         System.err.println("Cannot load simgrid library: ");
  21                         e.printStackTrace();
  22                         System.err.println(
  23                                         "Please check your LD_LIBRARY_PATH, or copy the library to the current directory");
  24                         System.exit(1);
  25                 }
  26         }
  27
  28         /* FIXME: kill these C crufts */
  29         /** Returns the last error code of the simulation */
  30         public final static native int getErrCode();
  31
  32         /** Everything is right. Keep on going the way ! */
  33         public static final int SUCCESS = 0;
  34
  35         /** Something must be not perfectly clean (but I may be paranoid freak...) */
  36         public static final int WARNING = 1;
  37
  38         /** There has been a problem during you task transfer.
  39          *  Either the network is  down or the remote host has been shutdown */
  40         public static final int TRANSFERT_FAILURE = 2;
  41
  42         /** System shutdown.
  43          *  The host on which you are running has just been rebooted.
  44          *  Free your data structures and return now ! */
  45         public static final int HOST_FAILURE = 3;
  46
  47         /** Canceled task. This task has been canceled by somebody ! */
  48         public static final int TASK_CANCELLLED = 4;
  49
  50         /** You've done something wrong. You'd better look at it... */
  51         public static final int FATAL_ERROR = 5;
  52
  53
  54         /** Retrieve the simulation time */
  55         public final static native double getClock();
  56
  57         /** Issue an information logging message */
  58         public final static native void info(String s);
  59
  60         /*********************************************************************************
  61          * Deployment and initialization related functions                               *
  62          *********************************************************************************/
  63
  64         /**
  65          * The natively implemented method to initialize a MSG simulation.
  66          *
  67          * @param args            The arguments of the command line of the simulation.
  68          *
  69          * @see                    Msg.init()
  70          */
  71         public final static native void init(String[]args);
  72
  73         /**
  74          * Run the MSG simulation, and cleanup everything afterward.
  75          *
  76          * If you want to chain simulations in the same process, you
  77          * should call again createEnvironment and deployApplication afterward.
  78          *
  79          * @see                    MSG_run, MSG_clean
  80          */
  81         public final static native void run() throws NativeException;
  82
  83         /**
  84          * The native implemented method to create the environment of the simulation.
  85          *
  86          * @param platformFile    The XML file which contains the description of the environment of the simulation
  87          *
  88          */
  89         public final static native void createEnvironment(String platformFile) throws NativeException;
  90
  91         /**
  92          * The method to deploy the simulation.
  93          *
  94          * @param platformFile    The XML file which contains the description of the application to deploy.
  95          */
  96         public final static native void deployApplication(String deploymentFile) throws NativeException;
  97
  98         /** Example launcher. You can use it or provide your own launcher, as you wish */
  99         static public void main(String[]args) throws MsgException {
 100                 /* initialize the MSG simulation. Must be done before anything else (even logging). */
 101                 Msg.init(args);
 102
 103                 if (args.length < 2) {
 104                         Msg.info("Usage: Msg platform_file deployment_file");
 105                         System.exit(1);
 106                 }
 107
 108                 /* Load the platform and deploy the application */
 109                 Msg.createEnvironment(args[0]);
 110                 Msg.deployApplication(args[1]);
 111
 112                 /* Execute the simulation */
 113                 Msg.run();
 114         }
 115 }