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.

Utilities

Command-line tools shipped with Yuneta. All binaries are installed into $YUNETAS_OUTPUTS/bin/ by yunetas build.

Source: utils/c/

Control Plane

BinaryDescription
ycommandControl-plane CLI — sends commands and stats requests to a running yuno over a local socket or WebSocket. Supports single-command and interactive shell modes.
ybatchBatch command runner — executes a script of commands against a yuno. Useful for automation, provisioning, and smoke tests.
ystatsReal-time statistics subscriber — displays live stats from a yuno with configurable refresh interval and filtering.
ytestsTest-suite runner against a live service — supports repeat/interval options for soak testing.
ylistList running yunos on the local machine with process information. Use --pids for scripting.
yshutdownShut down all Yuneta processes on the local machine. Supports selective modes (--agent-only, --keep-agent).

Data Inspection

BinaryDescription
tr2listList records from a timeranger2 topic. Supports time-range filtering, field selection, metadata display, and local timestamps.
tr2keysList all keys (primary ids) stored in a timeranger2 topic.
tr2searchSearch records inside a timeranger2 topic by content filters and key, with optional base64 decoding.
tr2migrateMigrate data from legacy timeranger (v1) to timeranger2.
treedb_listList nodes of a TreeDB graph database — walks topics and their hook/fkey relationships.
msg2db_listList messages from a msg2db database (dict-style message store on timeranger2).
list_queue_msgs2List messages from a msg2db persistent queue.
stats_listList persisted statistics with filtering by group, variable, metric, units, and time range.
json_diffSemantic diff of two JSON files — supports unordered array comparison and metadata/private-key filtering.

Code Generation

BinaryDescription
yuno-skeletonCreate a new yuno from a pre-defined template. Use --list to see available skeletons.
ymake-skeletonGenerate a yuno skeleton from an existing project, renaming identifiers to match a new role.
yclone-gclassClone a GClass template under a new name — rewrites file names and identifiers automatically.
yclone-projectClone a whole Yuneta project (yuno, util, …) under a new name.
yscapecEscape a file’s contents into a C string literal. Handy for embedding JSON, SQL, or HTML in .c source.

Diagnostics

BinaryDescription
fs_watcherTest harness for the fs_watcher library — prints every filesystem event on a path.
inotifyRaw Linux inotify diagnostic tool — decodes and prints inotify event flags.
ytestconfigValidate a JSON configuration file — exits non-zero on parse failure.
time2dateBidirectional converter between Unix timestamps and ASCII date/time strings.
time2rangeConvert a Unix timestamp into a human-friendly time range (seconds → years).
static_binary_testSmoke test for fully-static builds (CONFIG_FULLY_STATIC).

Security

BinaryDescription
keycloak_pkey_to_jwksConvert an RSA private key (base64 DER) to a JWKS document for OAuth 2 / JWT providers.