Recent changes to SystemProcess

SystemProcess modified by ENGITEX

ENGITEX — Fri, 26 Jan 2024 18:51:52 -0000

--- v6
+++ v7
@@ -28,7 +28,7 @@
 `boolean SystemProcess.setProcessAffinity(char[] aff)`
 returns `true` if the requested affinity has been set and `false` otherwise.
 For example, affinity **'0001'** will assign the process to the 4th CPU.
-Statics method `boolean setProcessAffinity(int pid, char[] aff)` does the same for a process with a known PID.
+Static method `boolean setProcessAffinity(int pid, char[] aff)` does the same for a process with a known PID.

 Other static methods are:
 `int getCPUnumber()` - to get the number of CPUs assuming hyperthreading,

SystemProcess modified by ENGITEX

ENGITEX — Fri, 26 Jan 2024 02:03:01 -0000

--- v5
+++ v6
@@ -27,7 +27,7 @@

 `boolean SystemProcess.setProcessAffinity(char[] aff)`
 returns `true` if the requested affinity has been set and `false` otherwise.
-For example, affinity '0001' will assign the process to the 4th CPU.
+For example, affinity **'0001'** will assign the process to the 4th CPU.
 Statics method `boolean setProcessAffinity(int pid, char[] aff)` does the same for a process with a known PID.

 Other static methods are:

SystemProcess modified by ENGITEX

ENGITEX — Fri, 26 Jan 2024 02:02:39 -0000

--- v4
+++ v5
@@ -33,5 +33,5 @@
 Other static methods are:
 `int getCPUnumber()` - to get the number of CPUs assuming hyperthreading,
 `HashMap<integer, string=""> getProcesses()` - to get all processes on a machine,
-`ArrayList<integer> getProcessIDs(String pname, boolean printExceptionMsg`) - to get PIDs of all specific processes (e.g, "chrome.exe")
+`ArrayList<integer> getProcessIDs(String pname, boolean printExceptionMsg)` - to get PIDs of all specific processes (e.g, "chrome.exe")
 `void checkRMIregistry()` - checks whether RMI registry is running on a machine and tries to start it if not.
</integer></integer></integer,>

SystemProcess modified by ENGITEX

ENGITEX — Fri, 26 Jan 2024 02:02:19 -0000

--- v3
+++ v4
@@ -28,3 +28,10 @@
 `boolean SystemProcess.setProcessAffinity(char[] aff)`
 returns `true` if the requested affinity has been set and `false` otherwise.
 For example, affinity '0001' will assign the process to the 4th CPU.
+Statics method `boolean setProcessAffinity(int pid, char[] aff)` does the same for a process with a known PID.
+
+Other static methods are:
+`int getCPUnumber()` - to get the number of CPUs assuming hyperthreading,
+`HashMap<integer, string=""> getProcesses()` - to get all processes on a machine,
+`ArrayList<integer> getProcessIDs(String pname, boolean printExceptionMsg`) - to get PIDs of all specific processes (e.g, "chrome.exe")
+`void checkRMIregistry()` - checks whether RMI registry is running on a machine and tries to start it if not.
</integer></integer,>

SystemProcess modified by ENGITEX

ENGITEX — Fri, 26 Jan 2024 01:56:03 -0000

--- v2
+++ v3
@@ -1,3 +1,30 @@
 The library SystemProcess has several object methods as well as some static methods
 to start a system process, to attribute settings (e.g. CPU affinity), get its PID, destroy, check its current status, to get a list of all running processes.
 The attached source code file** SystemProcessExample.java** seems to be self-explanatory. It shows a few expected use cases of the library.
+
+
+`SystemProcess(List<string> commandArgs)`
+creates an object without actually starting the process.
+0th String in `commandArgs` is the executable name.
+
+`int pid = SystemProcess.start(String pname, boolean destroyIfUnknownPID)`
+starts the process with trying to get its PID.
+`destroyIfUnknownPID` defines whether to destroy a process whose PID could not be retrieved.
+`SystemProcessException` with "process id cannot be defined" message will be thrown in any case, no matter what `destroyIfUnknownPID` was.
+This method is a workaround for earlier Java versions (before 9.0) which have no built-in method to get the PID.
+
+An easier way to start a process without getting its PID is
+`void SystemProcess.start() `
+
+`void SystemProcess.waitForSeconds(int seconds)`
+and similar methods wait either for the process to finish or for the timeout to expire.
+The calling thread is blocked.
+
+`String SystemProcess.readLine()` and similar methods all wait for the process to start (if needed) blocking the calling thread and then return a line or an integer from the process output stream.
+
+`boolean SystemProcess.setProcessPriority(int priority)`
+is not implemented yet.
+
+`boolean SystemProcess.setProcessAffinity(char[] aff)`
+returns `true` if the requested affinity has been set and `false` otherwise.
+For example, affinity '0001' will assign the process to the 4th CPU.
</string>

SystemProcess modified by ENGITEX

ENGITEX — Fri, 26 Jan 2024 01:01:28 -0000

--- v1
+++ v2
@@ -0,0 +1,3 @@
+The library SystemProcess has several object methods as well as some static methods
+to start a system process, to attribute settings (e.g. CPU affinity), get its PID, destroy, check its current status, to get a list of all running processes.
+The attached source code file** SystemProcessExample.java** seems to be self-explanatory. It shows a few expected use cases of the library.

SystemProcess modified by ENGITEX

ENGITEX — Fri, 26 Jan 2024 00:59:38 -0000