Yuneta Directories

The Yuneta SDK is structured into the following top folders:

• docs: Documentation of Yuneta.

• kernel: Kernel in several languages.

• modules: Modules in several languages.

• packages: Debian packaging for the Yuneta Agent.

• performance: Performance tests.

• scripts: Auxiliary scripts added to the shell PATH.

• stress: Stress tests.

• tests: Tests.

• tools: Compilation or building tools.

• utils: Utilities for Yuneta.

• yunos: Yunos supplied by the SDK.

docs¶

• doc.yuneta.io: Yuneta’s Documentation built with MyST Markdown.

kernel¶

The core framework of Yuneta, implemented in multiple languages.

• C:

  • gobj-c: G-Objects, implementation of classes and objects based on a simple Finite State Machine, attributes based on JSON, a comprehensive table of class methods, and an API to facilitate communication between objects through events, with an integrated publish/subscribe pattern.

  • linux-ext-libs: External libraries used by c/root-linux. These are statically compiled and self-contained.

  • root-esp32: Kernel for the ESP32 microcontroller based on esp-idf. List of components ordered by dependency (bottom = higher dependency):

      - esp_jansson
      - esp_gobj          (depends on esp_jansson)
      - esp_yuneta        (depends on esp_gobj)
      - esp_c_prot        (depends on esp_yuneta)

    It is only necessary to include the component with the highest dependency.

  • root-linux: Kernel for Linux systems.

  • timeranger2: Timeranger2, a time-series key-value database using flat files.

  • yev_loop: Library for asynchronous input/output, built on io_uring.

  • libjwt: JWT (JSON Web Token) authentication library.

  • ytls: TLS library to manage encryption using multiple backends, such as OpenSSL and mbedTLS.

• JS:

  • gobj-js: Kernel implementation for JavaScript.

modules¶

Contains additional protocol and functionality modules.

• C:

  • console: C_CONSOLE support (terminal/CLI interface).

  • modbus: C_MODBUS support (Modbus protocol).

  • mqtt: C_MQTT support (MQTT client protocol).

  • postgres: C_POSTGRES support (PostgreSQL database).

  • test: C_TEST support (testing utilities).

packages¶

Debian packaging for the Yuneta Agent. Builds .deb packages that install the complete runtime — agent binaries, CLI tools, web server, init scripts, kernel tuning, TLS certificate management and a dedicated yuneta system user — under the /yuneta hierarchy.

• make-yuneta-agent-deb.sh: builds the .deb.

• AMD64.sh / ARM32.sh / ARMhf.sh / RISCV64.sh: per-architecture build wrappers.

• templates: agent configuration samples baked into the package.

performance¶

Performance testing utilities for key Yuneta components.

• C:

  • perf_c_tcp: Performance test of TCP-based gobjs.

  • perf_c_tcps: Performance test of TCP gobjs with encryption.

  • perf_yev_ping_pong: Performance test of the yev_loop library.

  • perf_yev_ping_pong2: Additional performance tests for the yev_loop library.

scripts¶

Auxiliary scripts shipped with the source tree. This directory is added to PATH by yunetas-env.sh, so they are runnable by name from any cwd inside a sourced yuneta shell.

• check_doc_line_refs.py: audits and links the source references in the docs.

• verify_api_coverage.py: checks that the api/ reference covers the public API.

• migratev6tov7.py: migrates data/config from Yuneta v6 to v7.

stress¶

Stress-test programs that push Yuneta components under sustained load.

• C:

  • auth_bff: stress test of the authentication backend-for-frontend.

  • listen: stress test of the listen/accept path.

tests¶

Tests for Yuneta components.

• C: C tests are created using CMake and include:

  • c_mqtt

  • c_node_link_events

  • c_subscriptions

  • c_tcp

  • c_tcp2

  • c_tcps

  • c_tcps2

  • c_timer

  • c_timer0

  • kw

  • msg_interchange

  • timeranger2

  • tr_msg

  • tr_queue

  • tr_treedb

  • tr_treedb_link_events

  • yev_loop

tools¶

Auxiliary tools for building and compiling Yuneta projects.

• cmake:

  • Contains reusable CMake files and configurations.

utils¶

Utility scripts and CLI tools for Yuneta.

• C:

  • fs_watcher: Monitors filesystem changes.

  • inotify: Tracks file events using inotify.

  • json_diff: JSON diff utility.

  • list_queue_msgs2: Lists queue messages.

  • mqtt_tui: Interactive MQTT client (text-based UI).

  • msg2db_list: Lists msg2db records.

  • pkey_to_jwks: Converts public keys to JWKS format.

  • stats_list: Lists statistics.

  • test-static: Tests for static builds.

  • time2date: Converts timestamps to dates.

  • time2range: Converts timestamps to time ranges.

  • tr2keys: Processes keys in Timeranger2.

  • tr2list: Lists entries in Timeranger2.

  • tr2migrate: Migrates data between Timeranger2 instances.

  • tr2search: Searches in Timeranger2.

  • treedb_list: Lists TreeDB entries.

  • ybatch: Batch operations for yunos.

  • ycli: Interactive ncurses CLI for yunos.

  • yclone-gclass: Clones a GClass template.

  • yclone-project: Clones a project template.

  • ycommand: Control-plane CLI for running yunos.

  • ylist: Lists yunos.

  • ymake-skeleton: Generates project skeletons.

  • yscapec: Escapes C strings.

  • yshutdown: Shuts down yunos.

  • ystats: Retrieves yuno statistics.

  • ytestconfig: Tests configuration files.

  • ytests: Test runner.

  • yuno-skeleton: Generates yuno skeletons.

yunos¶

Pre-supplied full applications built with Yuneta.

• C:

  • auth_bff: Authentication backend-for-frontend.

  • controlcenter: Control center service.

  • dba_postgres: PostgreSQL database agent.

  • emailsender: Email sending service.

  • emu_device: Device emulator.

  • logcenter: Log aggregation center.

  • mqtt_broker: MQTT v3.1.1 + v5.0 broker with persistence.

  • sgateway: Service gateway.

  • watchfs: Filesystem watcher service.

  • yuno_agent: Yuno lifecycle manager (start/stop/update).

  • yuno_agent22: Yuno agent v2.

• JS:

  • gui_yunetas.js: Graphical User Interface (GUI) for managing Yuneta.