X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/6d3f858df02279918d1973a2eb86704bd3c3d490..5749413e83be55dd188d8ea755b55b4da4a11f35:/src/bindings/java/org/simgrid/msg/Process.java?ds=sidebyside diff --git a/src/bindings/java/org/simgrid/msg/Process.java b/src/bindings/java/org/simgrid/msg/Process.java index 6c06550e87..c198186c6f 100644 --- a/src/bindings/java/org/simgrid/msg/Process.java +++ b/src/bindings/java/org/simgrid/msg/Process.java @@ -1,28 +1,28 @@ -/* Copyright (c) 2006-2018. The SimGrid Team. All rights reserved. */ +/* Copyright (c) 2006-2021. 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.msg; -import java.util.Arrays; import java.util.ArrayList; +import java.util.Arrays; /** - * A process may be defined as a code, with some private data, executing + * A process may be defined as a code, with some private data, executing * in a location (host). All the process used by your simulation must be * declared in the deployment file (XML format). - * To create your own process you must inherit your own process from this - * class and override the method "main()". For example if you want to use - * a process named Slave proceed as it : + * To create your own process you must inherit your own process from this + * class and override the method "main()". For example if you want to use + * a process named Worker proceed as it : * * (1) import the class Process of the package simgrid.msg * import simgrid.msg.Process; - * - * public class Slave extends simgrid.msg.Process { + * + * public class Worker extends simgrid.msg.Process { * * (2) Override the method function - * + * * \verbatim * public void main(String[] args) { * System.out.println("Hello MSG"); @@ -30,13 +30,13 @@ import java.util.ArrayList; * \endverbatim * } * The name of your process must be declared in the deployment file of your simulation. - * For the example, for the previous process Slave this file must contains a line : - * <process host="Maxims" function="Slave"/>, where Maxims is the host of the process - * Slave. All the process of your simulation are automatically launched and managed by Msg. - * A process use tasks to simulate communications or computations with another process. - * For more information see Task. For more information on host concept + * For the example, for the previous process Worker this file must contains a line : + * <process host="Maxims" function="Worker"/>, where Maxims is the host of the process + * Worker. All the process of your simulation are automatically launched and managed by Msg. + * A process use tasks to simulate communications or computations with another process. + * For more information see Task. For more information on host concept * see Host. - * + * */ public abstract class Process implements Runnable { @@ -70,10 +70,10 @@ public abstract class Process implements Runnable { * @param name The name of the process. * * @exception HostNotFoundException if no host with this name exists. - * + * * */ - public Process(String hostname, String name) throws HostNotFoundException { + protected Process(String hostname, String name) throws HostNotFoundException { this(Host.getByName(hostname), name, null); } /** @@ -86,19 +86,19 @@ public abstract class Process implements Runnable { * * @exception HostNotFoundException if no host with this name exists. * - */ - public Process(String hostname, String name, String[] args) throws HostNotFoundException { + */ + protected Process(String hostname, String name, String[] args) throws HostNotFoundException { this(Host.getByName(hostname), name, args); } /** - * Constructs a new process from a host and his name. The method function of the + * Constructs a new process from a host and his name. The method function of the * process doesn't have argument. * * @param host Where to create the process. * @param name The name of the process. * */ - public Process(Host host, String name) { + protected Process(Host host, String name) { this(host, name, null); } /** @@ -109,7 +109,7 @@ public abstract class Process implements Runnable { * @param name The name of the process. * @param argsParam The arguments of main method of the process. */ - public Process(Host host, String name, String[]argsParam) + protected Process(Host host, String name, String[]argsParam) { if (host == null) throw new IllegalArgumentException("Cannot create a process on the null host"); @@ -134,7 +134,7 @@ public abstract class Process implements Runnable { * @param killTime Kill time of the process * */ - public Process(Host host, String name, String[]args, double startTime, double killTime) { + protected Process(Host host, String name, String[]args, double startTime, double killTime) { this(host, name, args); this.startTime = startTime; this.killTime = killTime; @@ -147,15 +147,8 @@ public abstract class Process implements Runnable { /** * This method kills all running process of the simulation. - * - * @param resetPID Should we reset the PID numbers. A negative number means no reset - * and a positive number will be used to set the PID of the next newly - * created process. - * - * @return The function returns the PID of the next created process. - * - */ - public static native int killAll(int resetPID); + */ + public static native void killAll(); /** Simply kills the receiving process. * @@ -172,8 +165,8 @@ public abstract class Process implements Runnable { public native void resume(); /** Tests if a process is suspended. * - * @see #suspend() - * @see #resume() + * @see suspend() + * @see resume() */ public native boolean isSuspended(); @@ -182,7 +175,7 @@ public abstract class Process implements Runnable { /** * Specify whether the process should restart when its host restarts after a failure - * + * * A process naturally stops when its host stops. It starts again only if autoRestart is set to true. * Otherwise, it just disappears when the host stops. */ @@ -198,7 +191,7 @@ public abstract class Process implements Runnable { /** * Returns the host of the process. * @return The host instance of the process. - */ + */ public Host getHost() { return this.host; } @@ -208,17 +201,17 @@ public abstract class Process implements Runnable { * @param pid The process identifier of the process to get. * * @return The process with the specified PID. - */ + */ public static native Process fromPID(int pid); /** * This method returns the PID of the process. * * @return The PID of the process. * - */ + */ public int getPID() { if (pid == -1) // Don't traverse the JNI barrier if you already have the answer - pid = nativeGetPID(); + pid = nativeGetPID(); return pid; } // This should not be used: the PID is supposed to be initialized from the C directly when the actor is created, @@ -229,12 +222,12 @@ public abstract class Process implements Runnable { * * @return The PID of the parent of the process. * - */ + */ public int getPPID() { return ppid; } /** - * Returns the value of a given process property. + * Returns the value of a given process property. */ public native String getProperty(String name); @@ -249,7 +242,7 @@ public abstract class Process implements Runnable { * * @return The current process. * - */ + */ public static native Process getCurrentProcess(); /** * Migrates a process to another host. @@ -260,17 +253,17 @@ public abstract class Process implements Runnable { public native void migrate(Host host); /** * Makes the current process sleep until millis milliseconds have elapsed. - * You should note that unlike "waitFor" which takes seconds, this method takes milliseconds. - * FIXME: Not optimal, maybe we should have two native functions. + * You should note that unlike "waitFor" which takes seconds (as usual in SimGrid), this method takes milliseconds (as usual for sleep() in Java). + * * @param millis the length of time to sleep in milliseconds. */ public static void sleep(long millis) throws HostFailureException { sleep(millis,0); } /** - * Makes the current process sleep until millis milliseconds and nanos nanoseconds + * Makes the current process sleep until millis milliseconds and nanos nanoseconds * have elapsed. - * Unlike {@link #waitFor(double)} which takes seconds, this method takes + * Unlike {@link #waitFor(double)} which takes seconds, this method takes * milliseconds and nanoseconds. * Overloads Thread.sleep. * @param millis the length of time to sleep in milliseconds. @@ -280,8 +273,8 @@ public abstract class Process implements Runnable { /** * Makes the current process sleep until time seconds have elapsed. * @param seconds The time the current process must sleep. - */ - public native void waitFor(double seconds) throws HostFailureException; + */ + public native void waitFor(double seconds) throws HostFailureException; /** * This method actually creates and run the process. * It is a noop if the process is already launched. @@ -306,9 +299,7 @@ public abstract class Process implements Runnable { Msg.info("Unexpected behavior. Stopping now"); System.exit(1); } - catch(ProcessKilledError pk) { - /* The process was killed before its end. With a kill() or something. */ - } + /* Let the ProcessKilledError (that we'd get if the process is forcefully killed) flow back to the caller */ } /** @@ -335,7 +326,13 @@ public abstract class Process implements Runnable { * This static method returns the current amount of processes running * * @return The count of the running processes - */ + */ public static native int getCount(); + public static void debugAllThreads() { + // Search remaining threads that are not main nor daemon + for (Thread t : Thread.getAllStackTraces().keySet()) + if (! t.isDaemon() && !t.getName().equals("main")) + System.err.println("Thread "+t.getName()+" is still running! Please report that bug"); + } }