Crate microsandbox_utils 

Shared constants and utilities for the microsandbox project.

Modules

copy

Sparse-aware fast copy with reflink fallback.

log_text

Text helpers for parsing/rendering captured log lines.

size

Byte-size types and conversion helpers.

ttl_reverse_index

TTL-indexed reverse map from keys to members, with fast member-to-keys lookup.

wake_pipe

Cross-platform wake notification built on pipe().

Constants

AGENTD_BINARY

Guest agent binary name.

BASE_DIR_NAME

Name of the microsandbox home directory (relative to user’s home).

BIN_SUBDIR

Subdirectory for helper binaries.

CACHE_SUBDIR

Subdirectory for OCI layer cache.

CONFIG_FILENAME

Global configuration filename.

DB_FILENAME

Database filename.

DB_SUBDIR

Subdirectory for the database.

GITHUB_ORG

GitHub organization.

LIBKRUNFW_ABI

libkrunfw ABI version (soname major). Keep in sync with justfile.

LIBKRUNFW_VERSION

libkrunfw release version. Keep in sync with justfile.

LIB_SUBDIR

Subdirectory for shared libraries (libkrunfw).

LOGS_SUBDIR

Subdirectory for logs.

METRICS_REGISTRY_NAME_FILENAME

Filename of the optional registry-name diagnostic file under run/metrics.

METRICS_RUN_SUBDIR

Subdirectory under run for metrics-related diagnostic artifacts.

METRICS_SHM_PREFIX

Prefix used when constructing the POSIX shared-memory object name for the live metrics registry. Combined with a stable hash of GlobalConfig::home() so concurrent MSB_HOME-isolated environments do not collide.

MICROSANDBOX_REPO

Main repository name.

MSB_BINARY

CLI binary name.

PREBUILT_VERSION

Version for downloading prebuilt release artifacts.

RUN_SUBDIR

Subdirectory for ephemeral runtime artifacts that should not be backed up.

SANDBOXES_SUBDIR

Subdirectory for per-sandbox state.

SANDBOXFILE_NAME

Project-local sandbox configuration filename.

SECRETS_SUBDIR

Subdirectory for secrets.

SNAPSHOTS_SUBDIR

Subdirectory for snapshot artifacts.

SSH_SUBDIR

Subdirectory for SSH keys.

TLS_SUBDIR

Subdirectory for TLS certificates.

VOLUMES_SUBDIR

Subdirectory for named volumes.

Functions

agentd_download_url

Returns the GitHub release download URL for the agentd binary.

bundle_download_url

Returns the GitHub release download URL for the microsandbox bundle tarball.

libkrunfw_download_url

Returns the GitHub release download URL for libkrunfw.

libkrunfw_filename

Returns the platform-specific libkrunfw filename.

looks_like_local_path_text

Returns true when a user-provided text value should be interpreted as a local filesystem path rather than a named resource or OCI reference.

resolve_home

Resolve the microsandbox home directory.

stable_hash_path

Derive a short, stable identifier from a path.