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.

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.