Skip to article frontmatterSkip to article content
Site not loading correctly?

This may be due to an incorrect BASE_URL configuration. See the MyST Documentation for reference.

System GClasses

Core runtime, file-system watcher, pseudo-terminal, OTA updates, and miscellaneous system services.

Source: kernel/c/root-linux/src/c_yuno.c, c_fs.c, c_pty.c, c_ota.c, c_gss_udp_s.c


C_YUNO

Main yuno GClass — the root grandmother of every yuno application. Manages services, configuration, logging, tracing, IP filtering, and system-wide commands.

PropertyValue
StatesST_STOPPED, ST_IDLE

Commands (selection)

CommandDescription
view-gclass-registerList all registered GClasses.
view-services / view-top-servicesList services.
view-gobj / view-gobj-treeInspect the gobj tree.
enable-gobj / disable-gobjEnable or disable a gobj.
write-attr / view-attrs / attrs-schemaRead/write gobj attributes.
set-global-trace / set-gclass-trace / set-gobj-traceConfigure trace levels.
reset-all-traces / set-deep-traceTrace management.
info-global-traceShow trace configuration.
view-configShow yuno configuration.
info-memMemory usage info.
info-cpus / info-ifs / info-osSystem information.
list-allowed-ips / add-allowed-ipIP access control.
truncate-log-fileTruncate the log file.
view-log-countersShow log event counters.
add-log-handler / del-log-handler / list-log-handlersLog handler management.

See also the Yuno API for C helper functions.


C_FS

File-system watcher — monitors directory changes using the fs_watcher engine.

PropertyValue
StatesST_STOPPED, ST_IDLE
Output eventsEV_ON_MESSAGE (directory change notifications)

Key attributes

AttributeTypeDescription
pathstringDirectory to watch.
recursiveboolWatch subdirectories recursively.
infoboolReport found subdirectories on startup.

C_PTY

Pseudo-terminal — spawns a shell or process in a PTY and provides bidirectional I/O.

PropertyValue
StatesST_STOPPED, ST_DISCONNECTED, ST_CONNECTED
Input eventsEV_TX_DATA, EV_DROP
Output eventsEV_RX_DATA, EV_CONNECTED, EV_DISCONNECTED

Key attributes

AttributeTypeDescription
processstringCommand to execute (default: user’s shell).
rowsintegerTerminal rows.
colsintegerTerminal columns.
cwdstringWorking directory.
max_tx_queueintegerMaximum transmit queue size.

process is remote-settable (the agent’s authz-gated open-console command), so since 7.6.0 it is resolved against a fixed trusted-dir allowlist, never the inherited $PATH: an absolute path is accepted only if executable, a bare name is resolved against /bin, /usr/bin, /sbin, /usr/sbin, /usr/local/bin (in order), a relative-with-slash name is rejected, and anything else fails closed (no exec). The spawn uses execv, not execvp, so a planted $PATH entry cannot hijack a bare process name.


C_OTA

Over-the-air update manager — downloads and applies firmware updates.

PropertyValue
StatesST_STOPPED, ST_IDLE, ST_WAIT_RESPONSE

Key attributes

AttributeTypeDescription
url_otastringOTA server URL.
cert_pemstringTLS certificate (PEM).
ota_statestringCurrent OTA state (read-only).
forceboolForce update even if role differs.
timeout_validateintegerValidation timeout in seconds.

Commands

CommandDescription
download-firmwareStart firmware download.

C_GSS_UDP_S

Gossamer UDP server — manages multiple virtual channels over a single UDP socket.

PropertyValue
StatesST_STOPPED, ST_IDLE
Input eventsEV_RX_DATA, EV_TX_DATA, EV_TIMEOUT, EV_STOPPED
Output eventsEV_ON_MESSAGE, EV_ON_OPEN, EV_ON_CLOSE

Key attributes

AttributeTypeDescription
urlstringUDP listening URL.
timeout_baseintegerBase timeout in seconds.
seconds_inactivityintegerChannel inactivity timeout.
disable_end_of_frameboolDisable end-of-frame detection.