NAME

systm — access to general kernel functionality from Lua

SYNOPSIS

local systm = require 'systm'

systm.print(msg)

systm.print_nolog(msg)

systm.uprint(msg)

systm.aprint_normal(msg)

systm.aprint_naive(msg)

systm.aprint_verbose(msg)

systm.aprint_debug(msg)

systm.aprint_error(msg)

count = systm.aprint_get_error_count()

systm.panic(msg)

DESCRIPTION

The systm Lua binding provides access to general kernel functionality like printing messages on the console. The systm.aprint functions are meant to be using during kernel autoconfiguration.

systm.print(msg)

Send msg to the console.

systm.print_nolog(msg)

The systm.print_nolog() function is identical to the systm.print() function, except is does not send msg to the system log.

systm.uprint(msg)

Send msg to the current process's controlling tty.

systm.aprint_normal(msg)

Send msg to the console unless AB_QUIET is set. Always sends to the log.

systm.aprint_naive(msg)

Send msg to the console only if AB_QUIET is set. Never sends to the log.

systm.aprint_verbose(msg)

Send msg to the console only if AB_VERBOSE is set. Always sends to the log.

systm.aprint_debug(msg)

Send msg to the console and the log only if AB_DEBUG is set.

systm.aprint_error(msg)

Like systm.aprint_normal(), but also keeps track of the number of times called. This allows a subsystem to report the number of errors that occurred during a quiet or silent initialization phase.

count = systm.aprint_get_error_count()

The systm.aprint_get_error_count() function reports the number of errors and resets the counter to 0.

systm.panic(msg)

The systm.panic() function terminates the NetBSD system. The message msg is printed to the console and saved in the variable panicstr for later retrieval via core dump inspection. A newline character is added at the end automatically.

VARIABLES

Upon initialisation, the systm module sets the following variables with the values of the corresponding kernel variable:

systm.copyright

systm.cpu_model

systm.machine

systm.machine_arch

systm.osrelease

systm.ostype

systm.kernel_ident

systm.version

systm.ncpu

SEE ALSO

lua(1), luac(1), lua(4), intro(9lua)

HISTORY

An systm manual appeared in NetBSD 7.0.

AUTHORS

The systm Lua binding was written by Marc Balmer <mbalmer@NetBSD.org>.