X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/611d822b02f836d7abe031cced6adc4281ef4356..5ed37babb2fa9097abe82df299c0aa259ed84d5a:/src/bindings/java/org/simgrid/msg/VM.java diff --git a/src/bindings/java/org/simgrid/msg/VM.java b/src/bindings/java/org/simgrid/msg/VM.java index 8a9b10868f..05d7acfd43 100644 --- a/src/bindings/java/org/simgrid/msg/VM.java +++ b/src/bindings/java/org/simgrid/msg/VM.java @@ -1,6 +1,6 @@ /* Java bindings of the s4u::VirtualMachine */ -/* Copyright (c) 2006-2018. The SimGrid Team. All rights reserved. */ +/* Copyright (c) 2006-2023. 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. */ @@ -14,10 +14,10 @@ public class VM extends Host { private int coreAmount = 1; /** - * Create a `basic' VM : 1 core and 1GB of RAM. + * Create a `basic` VM : 1 core and 1GB of RAM. * @param host Host node * @param name name of the machine - */ + */ public VM(Host host, String name) { this(host,name, /*coreAmount*/1, 1024, 0, 0); } @@ -27,7 +27,7 @@ public class VM extends Host { * @param host Host node * @param name name of the machine * @param coreAmount the amount of cores of the VM - */ + */ public VM(Host host, String name, int coreAmount) { this(host,name, coreAmount, 1024, 0, 0); } @@ -37,9 +37,9 @@ public class VM extends Host { * @param host Host node * @param name name of the machine * @param ramSize size of the RAM that should be allocated (in MBytes) - * @param migNetSpeed (network bandwith allocated for migrations in MB/s, if you don't know put zero ;)) + * @param migNetSpeed (network bandwidth allocated for migrations in MB/s, if you don't know put zero ;)) * @param dpIntensity (dirty page percentage according to migNetSpeed, [0-100], if you don't know put zero ;)) - */ + */ public VM(Host host, String name, int ramSize, int migNetSpeed, int dpIntensity){ this(host, name, /*coreAmount*/1, ramSize, migNetSpeed, dpIntensity); } @@ -50,7 +50,7 @@ public class VM extends Host { * @param name name of the machine * @param coreAmount the amount of cores of the VM * @param ramSize size of the RAM that should be allocated (in MBytes) - * @param migNetSpeed (network bandwith allocated for migrations in MB/s, if you don't know put zero ;)) + * @param migNetSpeed (network bandwidth allocated for migrations in MB/s, if you don't know put zero ;)) * @param dpIntensity (dirty page percentage according to migNetSpeed, [0-100], if you don't know put zero ;)) */ public VM(Host host, String name, int coreAmount, int ramSize, int migNetSpeed, int dpIntensity){ @@ -67,33 +67,37 @@ public class VM extends Host { /** Retrieve a VM from its name */ public static native VM getVMByName(String name); - /* Make sure that the GC also destroys the C object */ + /** + * Make sure that the GC also destroys the C object + * @deprecated (from Java9 onwards) + */ + @Deprecated @Override protected void finalize() throws Throwable { nativeFinalize(); } private native void nativeFinalize(); - /** Returns whether the given VM is currently suspended */ - public native int isCreated(); + /** Returns whether the given VM is currently suspended */ + public native boolean isCreated(); /** Returns whether the given VM is currently running */ - public native int isRunning(); + public native boolean isRunning(); /** Returns whether the given VM is currently running */ - public native int isMigrating(); + public native boolean isMigrating(); - /** Returns whether the given VM is currently suspended */ - public native int isSuspended(); + /** Returns whether the given VM is currently suspended */ + public native boolean isSuspended(); /** Returns the amount of virtual CPUs provided */ public int getCoreAmount() { return coreAmount; } - + /** * Natively implemented method create the VM. * @param ramSize size of the RAM that should be allocated (in MB) - * @param migNetSpeed (network bandwith allocated for migrations in MB/s, if you don't know put zero ;)) + * @param migNetSpeed (network bandwidth allocated for migrations in MB/s, if you don't know put zero ;)) * @param dpIntensity (dirty page intensity, a percentage of migNetSpeed [0-100], if you don't know put zero ;)) */ private native void create(Host host, String name, int coreAmount, int ramSize, int migNetSpeed, int dpIntensity); @@ -119,29 +123,29 @@ public class VM extends Host { /** Change the host on which all processes are running * (pre-copy is implemented) - */ + */ public void migrate(Host destination) throws HostFailureException{ try { this.nativeMigration(destination); } catch (Exception e){ Msg.info("Migration of VM "+this.getName()+" to "+destination.getName()+" is impossible ("+e.getMessage()+")"); - throw new HostFailureException(); + throw new HostFailureException(e.getMessage()); } - // If the migration correcly returned, then we should change the currentHost value. + // If the migration correctly returned, then we should change the currentHost value. this.currentHost = destination; } private native void nativeMigration(Host destination) throws MsgException; /** Immediately suspend the execution of all processes within the given VM * - * No suspension cost occurs. If you want to simulate this too, you want to use a \ref File.write() before or + * No suspension cost occurs. If you want to simulate this too, you want to use a @ref File.write() before or * after, depending on the exact semantic of VM suspend to you. - */ + */ public native void suspend(); /** Immediately resumes the execution of all processes within the given VM * - * No resume cost occurs. If you want to simulate this too, you want to use a \ref File.read() before or after, + * No resume cost occurs. If you want to simulate this too, you want to use a @ref File.read() before or after, * depending on the exact semantic of VM resume to you. */ public native void resume();