Class MudlibProcess

java.lang.Object

io.github.protasm.jvmud.execution.application.worker.MudlibProcess

All Implemented Interfaces:

AutoCloseable

public final class MudlibProcess
extends Object
implements AutoCloseable

Engine-side owner of a separate worker JVM for fault isolation. The engine never loads this mudlib's LPC classes or runtime objects. Workers run with the host account's OS permissions, not within a security sandbox.

Constructor Summary

Constructors

Constructor	Description
MudlibProcess(MudlibSpec spec, Path log, boolean trace)	Starts Java directly with per-worker JVM memory limits and requires readiness before returning.

Method Summary

Modifier and Type	Method	Description
AdminSession	administration()	Opens independent command state in the worker; grants have already been checked by the engine.
void	close()	Gives shutdown hooks a bounded opportunity, then terminates an unresponsive worker.
Socket	connectPlayer(String clientAddress)	Opens the authenticated private player channel and preserves the original client address.
ProcessHandle	handle()	Worker process identity for status reporting and supervision.
CompletableFuture<Process>	onExit()	Completes when the worker exits, including an unexpected crash.
WorkerWire.Ready	ready()	Reports immutable worker readiness metadata.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

MudlibProcess

public MudlibProcess(MudlibSpec spec,
 Path log,
 boolean trace)
              throws IOException

Starts Java directly with per-worker JVM memory limits and requires readiness before returning.

Throws:

IOException

Method Details

ready

public WorkerWire.Ready ready()

Reports immutable worker readiness metadata.

handle

public ProcessHandle handle()

Worker process identity for status reporting and supervision.

onExit

public CompletableFuture<Process> onExit()

Completes when the worker exits, including an unexpected crash.

connectPlayer

public Socket connectPlayer(String clientAddress)
                     throws IOException

Opens the authenticated private player channel and preserves the original client address.

Throws:

IOException

administration

public AdminSession administration()
                            throws IOException

Opens independent command state in the worker; grants have already been checked by the engine.

Throws:

IOException

close

public void close()

Gives shutdown hooks a bounded opportunity, then terminates an unresponsive worker.

Specified by:

close in interface AutoCloseable