Tools

Shared tooling that lives under tools/ in the source tree. Two things matter about this directory:

• It holds the CMake build infrastructure every module uses to compile, plus operator helper scripts for talking to a running agent and for the node’s sshd.

• tools/ is packaged into the installation .deb and .rpm, so everything here is available on a deployed node even when the yunetas source tree is absent — unlike scripts/, which is repo-only.

tools/
├── cmake/
│   └── project.cmake     # master build configuration, included by every module
├── agent/
│   ├── sync_binaries.py        # reconcile built yunos vs the agent's installed set
│   ├── sync_configs.py         # reconcile a directory's configs vs the agent's installed set
│   └── set_start_priorities.py # assign each managed yuno's start_priority by role
└── sshd/
    ├── audit-sshd.sh                  # report failures and improvements (read-only)
    ├── install-sshd-flood-guard.sh    # keep sshd reachable under a connection flood
    ├── install-fail2ban-sshd-jail.sh  # make fail2ban watch sshd
    ├── stop-sshd.sh                   # stop sshd, with a timer that starts it again
    └── start-sshd.sh                  # start sshd, cancel that timer

cmake/project.cmake — build infrastructure¶

project.cmake is the single build-configuration file included by every CMakeLists.txt in the project — kernel libraries, modules, yunos, utils, tests, performance, and stress. It gives them a consistent compiler setup, library definitions, and install paths, all driven by the Kconfig .config file generated by menuconfig.

What it provides:

• Loads ${YUNETAS_BASE}/.config and turns every KEY=VALUE into a CMake variable (y→1, n→0, "string"→string).

• add_yuno_executable(name ...) — the wrapper used by all yuno, test, performance and stress executables.

• Install destinations: headers → outputs/include, static libs → outputs/lib, yuno binaries → outputs/yunos. (CLI utilities under utils/c/ install to /yuneta/bin — see Utilities.)

• Pre-defined link variables (YUNETAS_KERNEL_LIBS, YUNETAS_EXTERNAL_LIBS, OPENSSL_LIBS / MBEDTLS_LIBS, …) that modules pick from in their target_link_libraries().

• ESP32 awareness: skips the Linux-only _GNU_SOURCE, external paths and linker flags when building under ESP-IDF.

Every module includes it with the same boilerplate:

cmake_minimum_required(VERSION 3.11)
project(my_module C)

if(DEFINED ENV{YUNETAS_BASE} AND IS_DIRECTORY "$ENV{YUNETAS_BASE}")
  set(YUNETAS_BASE "$ENV{YUNETAS_BASE}")
elseif(IS_DIRECTORY "/yuneta/development/yunetas")
  set(YUNETAS_BASE "/yuneta/development/yunetas")
else()
  message(FATAL_ERROR "YUNETAS_BASE not found.")
endif()

include("${YUNETAS_BASE}/tools/cmake/project.cmake")

The full reference (every variable, the conditional library table, the manual CMake invocation) lives in tools/README.md.

agent/ — operator helper scripts¶

Helpers for talking to a running yuneta_agent.

• sync_binaries.py — reconcile the freshly built yunos against the agent’s installed set and push the differences via install-binary / update-binary, with confirmation.

• sync_configs.py — reconcile the configs in the current directory (batches/<host>/) against the agent’s installed set and push the differences via create-config (alias install-config) / update-config, with confirmation.

• set_start_priorities.py — assign each managed yuno’s start_priority (its launch tier) by role, in one shot, via update-node.