_{Official ZPE/YASS documentation}Process

Introduction

The ProcessObject represents a running system process.

It is typically returned by functions that launch external programs or commands and provides limited control and inspection capabilities.

Internally, it wraps a java.lang.Process instance.

All functions exposed by this object require a permission level of 0.

Process object functions

The following is a list of internal functions the ProcessObject exposes. All functions are ZPEObjectNativeFunctions therefore run in native code.

stop() ⇒ boolean

Forcibly terminates the running process. Returns true once the termination request has been issued.

info() ⇒ map

Returns a map containing information about the running process. The returned map contains:

• command — The command used to launch the process
• arguments — The arguments supplied to the command
• user — The user running the process
• cpu_duration — Total CPU time consumed by the process

Examples

Assuming a process has been started and returned as a ProcessObject:

$proc = run("ping google.com")   # Hypothetical example

$info = $proc->info()

print($info["command"])
print($info["cpu_duration"])

Stopping a running process:

$proc->stop()

Notes:

• Process origin: ProcessObject instances are typically created internally when launching external commands.
• Forceful termination: The stop() method uses a forceful termination mechanism.
• System-dependent: Available process information may vary depending on the operating system.