ketraterm-pty/io.github.ketraterm.pty/PtyConnector

PtyConnector

TerminalConnector backed by a local PTY process.

This connector owns PTY reader and watcher threads. It only moves bytes and lifecycle events between the PTY process and a connector listener; parser, core, cursor, attribute, and input-encoder behavior are owned by terminal-session and lower layers.

Parameters

process

the underlying PTY process.

readBufferSize

size of the read buffer in bytes.

readerThreadName

name for the daemon PTY stdout reader thread.

watcherThreadName

name for the daemon process exit watcher thread.

Constructors

PtyConnector

constructor(process: PtyProcess, readBufferSize: Int = DEFAULT_READ_BUFFER_SIZE, readerThreadName: String = DEFAULT_READER_THREAD_NAME, watcherThreadName: String = DEFAULT_WATCHER_THREAD_NAME)

Creates a connector for a raw PTY4J process.

Properties

exitCode

@Volatile

var exitCode: Int?

Process exit code after the watcher observes process termination.

failure

@Volatile

var failure: IOException?

Captured transport read failure, or null when no reader failure occurred.

isAlive

val isAlive: Boolean

Returns true while the underlying PTY process reports it is alive.

Functions

open override fun close()

foregroundProcessName

open override fun foregroundProcessName(): String?

Reads the Unix foreground process-group leader or uses the newest live descendant on Windows. The Windows result is a heuristic and may identify a background child. Returns only a basename, or null on closure/unavailable metadata; applications inside SSH or WSL are not inspected.

resize

open override fun resize(columns: Int, rows: Int)

start

open override fun start(listener: TerminalConnectorListener)

waitFor

fun waitFor(): Int

Waits for the child process to exit and returns its exit code.

write

open override fun write(bytes: ByteArray, offset: Int, length: Int)