X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/bdfe4f8674f98efbf2d67ad854ef83a1d5f855ed..d2990e6ae897aeb38681ef24acfa01935acf8354:/src/bindings/java/org/simgrid/trace/Trace.java diff --git a/src/bindings/java/org/simgrid/trace/Trace.java b/src/bindings/java/org/simgrid/trace/Trace.java index 4723c9860f..9877a95d57 100644 --- a/src/bindings/java/org/simgrid/trace/Trace.java +++ b/src/bindings/java/org/simgrid/trace/Trace.java @@ -1,25 +1,23 @@ -/* - * JNI interface to C code for the TRACES part of SimGrid. - * - * Copyright (c) 2012-2013. The SimGrid Team. - * All right reserved. - * - * This program is free software; you can redistribute - * it and/or modify it under the terms of the license - * (GNU LGPL) which comes with this package. - */ +/* JNI interface to C code for the TRACES part of SimGrid. */ + +/* Copyright (c) 2012-2014. The SimGrid Team. + * All rights reserved. */ + +/* This program is free software; you can redistribute it and/or modify it + * under the terms of the license (GNU LGPL) which comes with this package. */ + package org.simgrid.trace; -import org.simgrid.msg.Msg; +import org.simgrid.NativeLib; public final class Trace { /* Statically load the library which contains all native functions used in here */ static { - Msg.nativeInit(); + NativeLib.nativeInit(); } // TODO complete the binding of the tracing API - + /** * Declare a new user variable associated to hosts with a color. @@ -27,9 +25,9 @@ public final class Trace { * @param variable * @param color */ - public final static native void hostVariableDeclareWithColor (String variable, String color); - - + public final static native void hostVariableDeclareWithColor (String variable, String color); + + /** * Add a value to a variable of a host. * @@ -37,7 +35,7 @@ public final class Trace { * @param variable * @param value */ - public final static native void hostVariableAdd (String host, String variable, double value); + public final static native void hostVariableAdd (String host, String variable, double value); /** * Subtract a value from a variable of a host. @@ -46,17 +44,17 @@ public final class Trace { * @param variable * @param value */ - public final static native void hostVariableSub (String host, String variable, double value); + public final static native void hostVariableSub (String host, String variable, double value); /** - * Set the value of a variable of a host at a given timestamp. - * + * Set the value of a variable of a host at a given timestamp. + * * @param time * @param host * @param variable * @param value */ - public final static native void hostVariableSetWithTime (double time, String host, String variable, double value); + public final static native void hostVariableSetWithTime (double time, String host, String variable, double value); /** * Add a value to a variable of a host at a given timestamp. @@ -66,178 +64,178 @@ public final class Trace { * @param variable * @param value */ - public final static native void hostVariableAddWithTime (double time, String host, String variable, double value); - - /** - * Subtract a value from a variable of a host at a given timestamp. - * - * @param time - * @param host - * @param variable - * @param value - */ - public final static native void hostVariableSubWithTime (double time, String host, String variable, double value); - - /** - * Get declared user host variables. - * - */ - public final static native String[] getHostVariablesName (); - - /** - * Declare a new user variable associated to links. - * - * @param variable - */ - public final static native void linkVariableDeclare (String variable); - - /** - * Declare a new user variable associated to links with a color. - * @param variable - * @param color - */ - public final static native void linkVariableDeclareWithColor (String variable, String color); - - /** - * Set the value of a variable of a link. - * - * @param link - * @param variable - * @param value - */ - public final static native void linkVariableSet (String link, String variable, double value); - - /** - * Add a value to a variable of a link. - * - * @param link - * @param variable - * @param value - */ - public final static native void linkVariableAdd (String link, String variable, double value); - - /** - * Subtract a value from a variable of a link. - * - * @param link - * @param variable - * @param value - */ - public final static native void linkVariableSub (String link, String variable, double value); - - /** - * Set the value of a variable of a link at a given timestamp. - * - * @param time - * @param link - * @param variable - * @param value - */ - public final static native void linkVariableSetWithTime (double time, String link, String variable, double value); - - /** - * Add a value to a variable of a link at a given timestamp. - * + public final static native void hostVariableAddWithTime (double time, String host, String variable, double value); + + /** + * Subtract a value from a variable of a host at a given timestamp. + * + * @param time + * @param host + * @param variable + * @param value + */ + public final static native void hostVariableSubWithTime (double time, String host, String variable, double value); + + /** + * Get declared user host variables. + * + */ + public final static native String[] getHostVariablesName (); + + /** + * Declare a new user variable associated to links. + * + * @param variable + */ + public final static native void linkVariableDeclare (String variable); + + /** + * Declare a new user variable associated to links with a color. + * @param variable + * @param color + */ + public final static native void linkVariableDeclareWithColor (String variable, String color); + + /** + * Set the value of a variable of a link. + * + * @param link + * @param variable + * @param value + */ + public final static native void linkVariableSet (String link, String variable, double value); + + /** + * Add a value to a variable of a link. + * + * @param link + * @param variable + * @param value + */ + public final static native void linkVariableAdd (String link, String variable, double value); + + /** + * Subtract a value from a variable of a link. + * + * @param link + * @param variable + * @param value + */ + public final static native void linkVariableSub (String link, String variable, double value); + + /** + * Set the value of a variable of a link at a given timestamp. + * + * @param time + * @param link + * @param variable + * @param value + */ + public final static native void linkVariableSetWithTime (double time, String link, String variable, double value); + + /** + * Add a value to a variable of a link at a given timestamp. + * + * @param time + * @param link + * @param variable + * @param value + */ + public final static native void linkVariableAddWithTime (double time, String link, String variable, double value); + + + /** + * Subtract a value from a variable of a link at a given timestamp. + * * @param time - * @param link - * @param variable - * @param value - */ - public final static native void linkVariableAddWithTime (double time, String link, String variable, double value); - - - /** - * Subtract a value from a variable of a link at a given timestamp. - * - * @param time - * @param link - * @param variable - * @param value - */ - public final static native void linkVariableSubWithTime (double time, String link, String variable, double value); - - /** - * Set the value of the variable present in the links connecting source and destination. - * - * @param src - * @param dst - * @param variable - * @param value - */ - public final static native void linkSrcDstVariableSet (String src, String dst, String variable, double value); - - /** - * Add a value to the variable present in the links connecting source and destination. - * - * @param src - * @param dst - * @param variable - * @param value - */ - public final static native void linkSrcDstVariableAdd (String src, String dst, String variable, double value); - - /** - * Subtract a value from the variable present in the links connecting source and destination. - * - * @param src - * @param dst - * @param variable - * @param value - */ - public final static native void linkSrcDstVariableSub (String src, String dst, String variable, double value); - - /** - * Set the value of the variable present in the links connecting source and destination at a given timestamp. - * - * @param time - * @param src - * @param dst - * @param variable - * @param value - */ - public final static native void linkSrcDstVariableSetWithTime (double time, String src, String dst, String variable, double value); - - /** - * Add a value to the variable present in the links connecting source and destination at a given timestamp. - * - * @param time - * @param src - * @param dst - * @param variable - * @param value - */ - public final static native void linkSrcdstVariableAddWithTime (double time, String src, String dst, String variable, double value); - - /** - * Subtract a value from the variable present in the links connecting source and destination at a given timestamp. - * - * @param time - * @param src - * @param dst - * @param variable - * @param value - */ - public final static native void linkSrcDstVariableSubWithTime (double time, String src, String dst, String variable, double value); - - /** - * Get declared user link variables. - */ + * @param link + * @param variable + * @param value + */ + public final static native void linkVariableSubWithTime (double time, String link, String variable, double value); + + /** + * Set the value of the variable present in the links connecting source and destination. + * + * @param src + * @param dst + * @param variable + * @param value + */ + public final static native void linkSrcDstVariableSet (String src, String dst, String variable, double value); + + /** + * Add a value to the variable present in the links connecting source and destination. + * + * @param src + * @param dst + * @param variable + * @param value + */ + public final static native void linkSrcDstVariableAdd (String src, String dst, String variable, double value); + + /** + * Subtract a value from the variable present in the links connecting source and destination. + * + * @param src + * @param dst + * @param variable + * @param value + */ + public final static native void linkSrcDstVariableSub (String src, String dst, String variable, double value); + + /** + * Set the value of the variable present in the links connecting source and destination at a given timestamp. + * + * @param time + * @param src + * @param dst + * @param variable + * @param value + */ + public final static native void linkSrcDstVariableSetWithTime (double time, String src, String dst, String variable, double value); + + /** + * Add a value to the variable present in the links connecting source and destination at a given timestamp. + * + * @param time + * @param src + * @param dst + * @param variable + * @param value + */ + public final static native void linkSrcdstVariableAddWithTime (double time, String src, String dst, String variable, double value); + + /** + * Subtract a value from the variable present in the links connecting source and destination at a given timestamp. + * + * @param time + * @param src + * @param dst + * @param variable + * @param value + */ + public final static native void linkSrcDstVariableSubWithTime (double time, String src, String dst, String variable, double value); + + /** + * Get declared user link variables. + */ public final static native String[] getLinkVariablesName (); - - /* **** ******** WARNINGS ************** ***** */ - /* Only the following routines have been */ - /* JNI implemented - Adrien May, 22nd */ - /* **** ******************************** ***** */ - - /** - * Declare a user state that will be associated to hosts. - * A user host state can be used to trace application states. - * - * @param name The name of the new state to be declared. - */ + + /* **** ******** WARNINGS ************** ***** */ + /* Only the following routines have been */ + /* JNI implemented - Adrien May, 22nd */ + /* **** ******************************** ***** */ + + /** + * Declare a user state that will be associated to hosts. + * A user host state can be used to trace application states. + * + * @param name The name of the new state to be declared. + */ public final static native void hostStateDeclare(String name); - + /** * Declare a new value for a user state associated to hosts. * The color needs to be a string with three numbers separated by spaces in the range [0,1]. @@ -257,32 +255,32 @@ public final class Trace { * @param state The name of the state previously declared. * @param value The new value of the state. */ - public final static native void hostSetState (String host, String state, String value); - - /** - * Push a new value for a state of a given host. - * - * @param host The name of the host to be considered. - * @param state The name of the state previously declared. - * @param value The value to be pushed. - */ - public final static native void hostPushState (String host, String state, String value); - - /** - * Pop the last value of a state of a given host. - * - * @param host The name of the host to be considered. - * @param state The name of the state to be popped. - */ - public final static native void hostPopState (String host, String state); + public final static native void hostSetState (String host, String state, String value); + + /** + * Push a new value for a state of a given host. + * + * @param host The name of the host to be considered. + * @param state The name of the state previously declared. + * @param value The value to be pushed. + */ + public final static native void hostPushState (String host, String state, String value); + + /** + * Pop the last value of a state of a given host. + * + * @param host The name of the host to be considered. + * @param state The name of the state to be popped. + */ + public final static native void hostPopState (String host, String state); /** * Declare a new user variable associated to hosts. * * @param variable */ - public final static native void hostVariableDeclare (String variable); - + public final static native void hostVariableDeclare (String variable); + /** * Set the value of a variable of a host. @@ -291,22 +289,22 @@ public final class Trace { * @param variable * @param value */ - public final static native void hostVariableSet (String host, String variable, double value); + public final static native void hostVariableSet (String host, String variable, double value); /** * Declare a new user variable associated to VMs. * * @param variable */ - public final static native void vmVariableDeclare (String variable); - + public final static native void vmVariableDeclare (String variable); + /** * Set the value of a variable of a VM. * - * @param host + * @param vm * @param variable * @param value */ - public final static native void vmVariableSet (String vm, String variable, double value); + public final static native void vmVariableSet (String vm, String variable, double value); }