* * Constructors * *
* * * */
/**
- * Construct an new task with the specified processing amount and amount
+ * Construct a new task with the specified processing amount and amount
* of data needed.
*
* @param name Task's name
*
* @param flopsAmount A value of the processing amount (in flop) needed to process the task.
* If 0, then it cannot be executed with the execute() method.
- * This value has to be >= 0.
+ * This value has to be ≥ 0.
*
* @param bytesAmount A value of amount of data (in bytes) needed to transfert this task.
* If 0, then it cannot be transfered with the get() and put() methods.
- * This value has to be >= 0.
+ * This value has to be ≥ 0.
*/
public Task(String name, double flopsAmount, double bytesAmount) {
create(name, flopsAmount, bytesAmount);
this.messageSize = bytesAmount;
}
/**
- * Construct an new parallel task with the specified processing amount and amount for each host
+ * Construct a new parallel task with the specified processing amount and amount for each host
* implied.
*
* @param name The name of the parallel task.
* @param hosts The list of hosts implied by the parallel task.
- * @param flopsAmount The amount of operations to be performed by each host of \a hosts.
- * @param bytesAmount A matrix describing the amount of data to exchange between hosts.
+ * @param flopsAmount The amount of operations to be performed by each host of hosts.
+ * flopsAmount[i] is the total number of operations that have to be
+ * performed on hosts[i].
+ * @param bytesAmount A matrix describing the amount of data to exchange between hosts. The
+ * length of this array must be hosts.length * hosts.length. It is actually
+ * used as a matrix with the lines being the source and the columns being
+ * the destination of the communications.
*/
public Task(String name, Host[]hosts, double[]flopsAmount, double[]bytesAmount) {
parallelCreate(name, hosts, flopsAmount, bytesAmount);
/**
* The natively implemented method to create a MSG task.
*
- * @param name The name of th task.
+ * @param name The name of the task.
* @param flopsAmount A value of the processing amount (in flop) needed
* to process the task. If 0, then it cannot be executed
* with the execute() method. This value has to be >= 0.
* The natively implemented method to create a MSG parallel task.
*
* @param name The name of the parallel task.
- * @param hosts The list of hosts implied by the parallel task.
+ * @param hosts The list of hosts implied by the parallel task.
* @param flopsAmount The total number of operations that have to be performed
* on the hosts.
* @param bytesAmount An array of doubles
/* * * *
* * Getters / Setters * *
* * * */
- /** Gets the name of a task */
+ /** Gets the name of the task */
public String getName() {
return name;
}
*/
public native void execute() throws HostFailureException,TaskCancelledException;
- /** Bound a computation to a certain load */
- public native void setBound(double load);
+ /** Changes the maximum CPU utilization of a computation task. Unit is flops/s. */
+ public native void setBound(double bound);
/** Cancels a task. */
public native void cancel();
- /** Deletes a task.
- *
- * @exception NativeException if the destruction failed.
- */
- protected void finalize() throws NativeException {
- destroy();
+ /** Deletes a task once the garbage collector reclaims it */
+ @Override
+ protected void finalize() {
+ try {
+ // Exceptions in finalizers lead to bad situations:
+ // http://stackoverflow.com/questions/7644556/troubleshooting-a-java-memory-leak-finalization
+ nativeFinalize();
+ bind=0; // to avoid segfaults if the impossible happens yet again making this task surviving its finalize()
+ } catch (Throwable e) {
+ e.printStackTrace();
+ }
}
- /**
- * The natively implemented method to destroy a MSG task.
- */
- protected native void destroy();
+ protected native void nativeFinalize();
/* * * *
* * Communication-related * *
* * * */
* @throws HostFailureException
* @throws TransferFailureException
*/
- public void send(String mailbox) throws TransferFailureException, HostFailureException, TimeoutException {
+ public void send(String mailbox) throws TransferFailureException, HostFailureException, TimeoutException, NativeException {
send(mailbox, -1);
}
* @throws HostFailureException
* @throws TransferFailureException
*/
- public native void send(String mailbox, double timeout) throws TransferFailureException, HostFailureException, TimeoutException;
+ public native void send(String mailbox, double timeout) throws TransferFailureException, HostFailureException, TimeoutException, NativeException;
/** Sends the task on the specified mailbox (capping the sending rate to \a maxrate)
*
*/
public native static int listenFrom(String mailbox);
/**
- * Listen whether there is a waiting task on the mailbox identified by the specified alias
+ * Listen whether there is a task waiting (either for a send or a recv) on the mailbox identified by the specified alias
*/
public native static boolean listen(String mailbox);
- /**
- * Counts the number of tasks waiting to be received on the \a mailbox identified by the specified alia and sended by the specified \a host.
- */
- public native static int listenFromHost(String alias, Host host);
-
/**
* Class initializer, to initialize various JNI stuff
*/
public static native void nativeInit();
static {
- Msg.nativeInit();
+ org.simgrid.NativeLib.nativeInit();
nativeInit();
}
