-/* Copyright (c) 2006-2016. The SimGrid Team. All rights reserved. */
+/* Copyright (c) 2006-2020. 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. */
*
* @param name Task's name
*
- * @param flopsAmount A value of the processing amount (in flop) needed to process 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.
*
* @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.
+ * If 0, then it cannot be transferred with the get() and put() methods.
* This value has to be ≥ 0.
- */
+ */
public Task(String name, double flopsAmount, double bytesAmount) {
if (flopsAmount<0)
throw new IllegalArgumentException("Task flopsAmount (" + flopsAmount + ") cannot be negative");
*
* @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 hosts.
- * flopsAmount[i] is the total number of operations that have to be
+ * @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
+ * @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) {
if (flopsAmount == null)
- throw new NullPointerException("Parallel task flops amounts is null");
+ throw new IllegalArgumentException("Parallel task flops amounts is null");
if (bytesAmount == null)
- throw new NullPointerException("Parallel task bytes amounts is null");
+ throw new IllegalArgumentException("Parallel task bytes amounts is null");
if (hosts == null)
- throw new NullPointerException("Host list is null");
+ throw new IllegalArgumentException("Host list is null");
if (name == null)
- throw new NullPointerException("Parallel task name is null");
+ throw new IllegalArgumentException("Parallel task name is null");
parallelCreate(name, hosts, flopsAmount, bytesAmount);
this.name = name;
* The natively implemented method to create a MSG task.
*
* @param name The name of the task.
- * @param flopsAmount A value of the processing amount (in flop) needed
+ * @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.
- * @param bytesAmount A value of amount of data (in bytes) needed to transfert
- * this task. If 0, then it cannot be transfered this task.
- * If 0, then it cannot be transfered with the get() and put()
+ * @param bytesAmount A value of amount of data (in bytes) needed to transfert
+ * this task. If 0, then it cannot be transferred this task.
+ * If 0, then it cannot be transferred with the get() and put()
* methods. This value has to be >= 0.
* @exception IllegalArgumentException if compute duration <0 or message size <0
*/
public native Process getSender();
/** Gets the source of the task (or null if not sent yet). */
- public native Host getSource();
+ public native Host getSource();
/** Gets the remaining amount of flops to execute in this task
- *
+ *
* If it's ongoing, you get the exact amount at the present time. If it's already done, it's 0.
*/
public native double getFlopsAmount();
* the other ones.
*
* @param priority The new priority of the task.
- */
+ */
public native void setPriority(double priority);
/** Set the computation amount needed to process the task
- *
+ *
* Warning if the execution is already started and ongoing, this call does nothing.
* @param flopsAmount the amount of computation needed to process the task
*/
public native void setFlopsAmount(double flopsAmount);
/**
* Set the amount of bytes to exchange the task
- *
+ *
* Warning if the communication is already started and ongoing, this call does nothing.
* @param bytesAmount the size of the task
*/
public native void execute() throws HostFailureException,TaskCancelledException;
/** Changes the maximum CPU utilization of a computation task. Unit is flops/s. */
- public native void setBound(double bound);
+ public native void setBound(double bound);
- /** Cancels a task. */
+ /** Cancels a task. */
public native void cancel();
- /** Deletes a task once the garbage collector reclaims it */
- @Override
+ /**
+ * Deletes a task once the garbage collector reclaims it
+ * @deprecated (from Java9 onwards)
+ */
+ @Deprecated @Override
protected void finalize() throws Throwable{
nativeFinalize();
bind=0; // to avoid segfaults if the impossible happens yet again making this task surviving its finalize()
* * Communication-related * *
* * * */
- /** Send the task asynchronously on the specified mailbox,
+ /** Send the task asynchronously on the specified mailbox,
* with no way to retrieve whether the communication succeeded or not
- *
+ *
*/
public native void dsendBounded(String mailbox, double maxrate);
- /** Send the task asynchronously on the specified mailbox,
+ /** Send the task asynchronously on the specified mailbox,
* with no way to retrieve whether the communication succeeded or not
- *
+ *
*/
public native void dsend(String mailbox);
/**
- * Sends the task on the specified mailbox
+ * Sends the task on the specified mailbox
*
* @param mailbox where to send the message
* @throws TimeoutException
- * @throws HostFailureException
- * @throws TransferFailureException
+ * @throws HostFailureException
+ * @throws TransferFailureException
*/
public void send(String mailbox) throws TransferFailureException, HostFailureException, TimeoutException {
send(mailbox, -1);
- }
+ }
/**
* Sends the task on the specified mailbox (wait at most \a timeout seconds)
*
* @param mailbox where to send the message
* @param timeout
- * @throws TimeoutException
- * @throws HostFailureException
- * @throws TransferFailureException
+ * @throws TimeoutException
+ * @throws HostFailureException
+ * @throws TransferFailureException
*/
- public native void send(String mailbox, double timeout) throws TransferFailureException, HostFailureException, TimeoutException;
+ public void send(String mailbox, double timeout) throws TransferFailureException, HostFailureException, TimeoutException {
+ sendBounded(mailbox, timeout, -1);
+ }
- /** Sends the task on the specified mailbox (capping the sending rate to \a maxrate)
+ /** Sends the task on the specified mailbox (capping the sending rate to \a maxrate)
*
* @param mailbox where to send the message
- * @param maxrate
+ * @param maxrate
* @throws TransferFailureException
* @throws HostFailureException
* @throws TimeoutException
*/
public void sendBounded(String mailbox, double maxrate) throws TransferFailureException, HostFailureException, TimeoutException {
- sendBounded(mailbox,-1,maxrate);
+ sendBounded(mailbox, -1, maxrate);
}
*
* @param mailbox where to send the message
* @param timeout
- * @param maxrate
+ * @param maxrate
* @throws TransferFailureException
* @throws HostFailureException
* @throws TimeoutException
* @return a Comm handler
*/
public static native Comm irecv(String mailbox);
+
/**
- * Retrieves next task from the mailbox identified by the specified name
+ * Retrieves next task on the mailbox identified by the specified alias
*
* @param mailbox
* @return a Task
*/
public static Task receive(String mailbox) throws TransferFailureException, HostFailureException, TimeoutException {
- return receive(mailbox, -1.0, null);
+ return receive(mailbox, -1.0);
}
/**
- * Retrieves next task on the mailbox identified by the specified name (wait at most \a timeout seconds)
+ * Retrieves next task on the mailbox identified by the specified alias (wait at most \a timeout seconds)
*
* @param mailbox
* @param timeout
* @return a Task
*/
- public static Task receive(String mailbox, double timeout) throws TransferFailureException, HostFailureException, TimeoutException {
- return receive(mailbox, timeout, null);
- }
-
- /**
- * Retrieves next task sent by a given host on the mailbox identified by the specified alias
- *
- * @param mailbox
- * @param host
- * @return a Task
- */
-
- public static Task receive(String mailbox, Host host) throws TransferFailureException, HostFailureException, TimeoutException {
- return receive(mailbox, -1.0, host);
- }
-
- /**
- * Retrieves next task sent by a given host on the mailbox identified by the specified alias (wait at most \a timeout seconds)
- *
- * @param mailbox
- * @param timeout
- * @param host
- * @return a Task
- */
- public static native Task receive(String mailbox, double timeout, Host host) throws TransferFailureException, HostFailureException, TimeoutException;
+ public static native Task receive(String mailbox, double timeout) throws TransferFailureException, HostFailureException, TimeoutException;
/**
* Starts listening for receiving a task from an asynchronous communication with a capped rate
*/
public static Task receiveBounded(String mailbox, double rate) throws TransferFailureException, HostFailureException, TimeoutException {
- return receiveBounded(mailbox, -1.0, null, rate);
+ return receiveBounded(mailbox, -1.0, rate);
}
/**
* @param timeout
* @return a Task
*/
- public static Task receiveBounded(String mailbox, double timeout, double rate) throws TransferFailureException, HostFailureException, TimeoutException {
- return receiveBounded(mailbox, timeout, null, rate);
- }
-
- /**
- * Retrieves next task sent by a given host on the mailbox identified by the specified alias with a capped rate
- *
- * @param mailbox
- * @param host
- * @return a Task
- */
-
- public static Task receiveBounded(String mailbox, Host host, double rate) throws TransferFailureException, HostFailureException, TimeoutException {
- return receiveBounded(mailbox, -1.0, host, rate);
- }
-
- /**
- * Retrieves next task sent by a given host on the mailbox identified by the specified alias (wait at most \a timeout seconds)
- * with a capped rate
- *
- * @param mailbox
- * @param timeout
- * @param host
- * @return a Task
- */
- public static native Task receiveBounded(String mailbox, double timeout, Host host, double rate) throws TransferFailureException, HostFailureException, TimeoutException;
+ public static native Task receiveBounded(String mailbox, double timeout, double rate) throws TransferFailureException, HostFailureException, TimeoutException;