ketraterm-core/io.github.ketraterm.core.api/TerminalResponseChannel/requestDeviceStatusReport

requestDeviceStatusReport

abstract fun requestDeviceStatusReport(mode: Int, decPrivate: Boolean)

Enqueues a device status report (DSR) response.

Allowlisted requests are ANSI 5 (operating status), ANSI/private 6 (cursor position), and private 996 (host color scheme). The latter replies with CSI ?997;1n for dark or CSI ?997;2n for light using the host theme palette, independently of application color overrides. Unsupported requests stay silent; the color-scheme protocol defines no failure reply. Host adapters must enforce terminal-response policy before calling this API.

Parameters

mode

The DSR mode parameter.

decPrivate

true if this is a DEC private DSR (? prefix), false for standard ANSI.