The library documents itself · System programming
stzProcess
35 own methods · 2 forms written with extensions, listed under their method
the source: base/system/stzProcess.ring(opens in a new tab) · All classes · The area reference: System programming
Under each method, its extensions (Q CS XT Z ZZ IB W U): bold and ticked, it exists; struck, it does not. The extensions and what they mean
No method of this class is run on this page: the class reaches files, the network, processes, the clock, chance or sound, and an example run here would only be an example of its effects. Each method carries the explanation the library gives of itself.
Method
Explanation, as the source carries it
init
(no comment in the source: the name reads as a sentence) initno extension
Spawn
EFFECTFUL. Spawning, killing -- the operations a Virtual System twin will later rehearse and gate behind an UpdatePlan. The USAGE CONTRACT (to avoid a pipe deadlock): read the output to EOF, THEN Wait(); keep stderr modest unless you also drain it.QCSXTZZZIBWU
HasChild
TRUE if this object is managing a spawned child.also written: IsChildno extension
ChildPid
The OS process id of the spawned child.no extension
ReadOutput
Reads the next available chunk of the child's stdout. Blocks until at least one byte arrives, or returns "" at end of stream. This is the STREAMING read -- call it in a loop.also written: ReadStdoutno extension
ReadOutputAll
Reads the child's stdout to the end, returning all of it.also written: Outputno extension
ReadError
wait / kill)also written: ReadStderrno extension
ReadErrorAll
wait / kill)also written: Errorno extension
Wait
Waits for the child to exit and returns its exit code. Idempotent.no extension
ExitCode
The exit code after Wait() (Wait() is called for you if you have not).no extension
Succeeded
wait / kill)no extension
Failed
wait / kill)no extension
Kill
EFFECTFUL. Terminates the child now. Returns TRUE on success.also written: Terminateno extension
Close
Frees the child handle. If the child is still running it is killed first, so a dropped handle never leaks a process. Haro has no destructors -- call this when done with a child.QCSXTZZZIBWU
Free
Same as Close: Frees the child handle. If the child is still running it is killed first, so a dropped handle never leaks a process. Haro has no destructors -- call this when done with a child.no extension
Id
(no comment in the source: the name reads as a sentence) idalso written: Pid · ProcessIdin the section this process -- identityno extension
Uptime
Seconds since this process started (real monotonic uptime, not epoch wall-clock).also written: UptimeInSecondsno extension
UptimeInMilliseconds
(no comment in the source: the name reads as a sentence) uptime in millisecondsalso written: UptimeMsin the section this process -- identityno extension
UptimeInNanoseconds
(no comment in the source: the name reads as a sentence) uptime in nanosecondsalso written: UptimeNsin the section this process -- identityno extension
MemoryBytes
The engine senses (perf P1, stz_perf.dll): what THIS process weighs and computes. Sensing-kind reads, no side effects. Current resident memory (working set), in bytes.also written: Rssno extension
PeakMemoryBytes
The high-water mark: the most memory this process EVER held. A crash-sized leak announces itself here first.no extension
CpuTimeNs
CPU time actually computed (user + kernel). Advances only when this process WORKS -- a sleeping process gains uptime but no CPU time. Utilization over a window = delta(cpu) / (delta(uptime) * cores).no extension
CpuTimeMs
(no comment in the source: the name reads as a sentence) cpu time msin the section this process -- identityno extension
EngineArchitecture
The raw engine architecture tag, as Zig names it: "x86_64", "aarch64"...also written: EngineArchno extension
Architecture
The canonical Softanza architecture name: x64 / arm64 / x86 / arm. THE ONE reconciliation seam between Zig's vocabulary and Softanza's.also written: Archno extension
OperatingSystem
The OS tag as the engine reports it: "windows", "linux", "macos"...also written: OS · OSNameno extension
IsLittleEndian
0 = little-endian, 1 = big-endian.no extension
IsBigEndian
is the single source)no extension
Endianness
is the single source)no extension
PointerSize
Native pointer size in BYTES (4 or 8).also written: PointerSizeInBytesno extension
BitSize
Native word size in BITS (32 or 64) -- pointer size * 8. This is the fact stzOperatingSystem.BitSize() should agree with, because both now read the ONE engine source.also written: WordSizeno extension
Is64Bit
is the single source)no extension
Is32Bit
is the single source)no extension
Info
All the process facts in one named-pair list -- handy for logging or feeding into a knowledge graph.no extension
Show
snapshotno extension