delonix system

O motor em si: events, info, df, prune, monitor, thermal.

The engine itself: events, info, df, prune, monitor, thermal.

Introspecção e manutenção. system prune é o GC (recupera espaço: containers parados, dirs órfãos, imagens dangling, blobs CAS, hostfwds órfãos, redes vazias); system df mostra o uso de disco; system monitor segue ligações/conntrack; system events o fluxo de eventos.

Introspection and maintenance. system prune is the GC (reclaims space: stopped containers, orphan dirs, dangling images, CAS blobs, orphan hostfwds, empty networks); system df shows disk usage; system monitor follows connections/conntrack; system events the event stream.

📄 Implementação real em Rust: cmd/system.rs

Usage: dlx system [OPTIONS] <COMMAND>

Commands:
  events   Engine events (create/start/die/remove/…), from oldest to most recent. With no daemon, the log is a shared append-only file — each command appends its own line (see `delonix_runtime_core::events`)
  info     Engine state: rootless?, cgroup delegation, network infra, counts
  setup    Diagnose — and, with `--delegate`, fix — cgroup delegation, the prerequisite for `--memory`/`--cpus`/`--pids-limit` to mean anything
  df       Disk usage by area (images, containers, volumes, VM images)
  virt     Host virtualization: hypervisor, KVM, virtio — and what there is to tune
  prune    Reclaim space: remove stopped containers, unused images, CAS blobs nobody references, empty cgroups and — the biggest space saver — **orphan container directories** (from nodes/containers that died abruptly without `rm`, with no registry entry)
  monitor  Active network connections per container (via conntrack): who comes in, who goes out, and between containers. Refreshes continuously (see `--no-stream`)
  thermal  Thermal governor: lowers Delonix's CPU budget when the CPU heats up and restores it when it cools down. Runs continuously (see `--once`)
  help     Print this message or the help of the given subcommand(s)

Options:
      --l18n <en|pt>  Output language: `en` (default) or `pt` (Portuguese, pt_AO). Also settable via `$DELONIX_L18N`. Global — works before any subcommand
  -h, --help          Print help

system thermal

Thermal governor: lowers Delonix's CPU budget when the CPU heats up and restores it when it cools down. Runs continuously (see --once)

Usage: dlx system thermal [OPTIONS]

Options:
      --high <HIGH>          Temperature (°C) at or above which it cools down [default: 85]
      --l18n <en|pt>         Output language: `en` (default) or `pt` (Portuguese, pt_AO). Also settable via `$DELONIX_L18N`. Global — works before any subcommand
      --low <LOW>            Temperature (°C) below which it restores [default: 70]
      --floor <FLOOR>        Minimum CPU percentage it drops to [default: 40]
      --interval <INTERVAL>  Seconds between readings [default: 5]
      --once                 One reading and exit (for cron/scripts, instead of the loop)
  -h, --help                 Print help

Exemplos

Temperatura e throttling do host
delonix system thermal

system monitor

Active network connections per container (via conntrack): who comes in, who goes out, and between containers. Refreshes continuously (see --no-stream)

Usage: dlx system monitor [OPTIONS]

Options:
      --interval <INTERVAL>  Milliseconds between refreshes (minimum 300) [default: 1000]
      --l18n <en|pt>         Output language: `en` (default) or `pt` (Portuguese, pt_AO). Also settable via `$DELONIX_L18N`. Global — works before any subcommand
      --no-stream            One sample and exit (without clearing the screen or repeating)
  -h, --help                 Print help

Exemplos

Acompanhar os eventos ao vivo
delonix system monitor

system virt

Host virtualization: hypervisor, KVM, virtio — and what there is to tune

Usage: dlx system virt [OPTIONS]

Options:
      --l18n <en|pt>  Output language: `en` (default) or `pt` (Portuguese, pt_AO). Also settable via `$DELONIX_L18N`. Global — works before any subcommand
      --tune          Apply the recommended tuning (needs root)
  -h, --help          Print help

Exemplos

O que o host oferece de virtualização, e o que há para afinar
delonix system virt
Aplicar a afinação recomendada
sudo delonix system virt --tune

system setup

Diagnose — and, with --delegate, fix — cgroup delegation, the prerequisite for --memory/--cpus/--pids-limit to mean anything.

Without it the flags are ACCEPTED and INERT: the container runs with no limit at all. That is the failure mode this command exists for, and it is invisible without asking.

Usage: dlx system setup [OPTIONS]

Options:
      --delegate
          Apply the fix instead of only reporting it. Writing the system-wide drop-in needs root; the per-session remedy never does

      --l18n <en|pt>
          Output language: `en` (default) or `pt` (Portuguese, pt_AO). Also settable via `$DELONIX_L18N`. Global — works before any subcommand

  -h, --help
          Print help (see a summary with '-h')

Exemplos

Diagnosticar a delegação de cgroup — porque é que -m/--cpus não pegam
delonix system setup
A 1.ª correcção: um scope delegado (sem root, sem reboot, vale já)
systemd-run --user --scope -p Delegate=yes -- delonix system setup
Só se a de cima ainda disser que falta o `cpu` (precisa de root, sobrevive ao reboot)
sudo delonix system setup --delegate

system events

Engine events (create/start/die/remove/…), from oldest to most recent. With no daemon, the log is a shared append-only file — each command appends its own line (see delonix_runtime_core::events)

Usage: dlx system events [OPTIONS]

Options:
  -f, --follow        Follow continuously (Ctrl-C to exit)
      --l18n <en|pt>  Output language: `en` (default) or `pt` (Portuguese, pt_AO). Also settable via `$DELONIX_L18N`. Global — works before any subcommand
  -n, --tail <TAIL>   Show only the last N (default: all)
  -h, --help          Print help

Exemplos

Ver o que o motor andou a fazer
delonix system events -n 20
Seguir em tempo real (Ctrl-C sai)
delonix system events --follow

system prune

Reclaim space: remove stopped containers, unused images, CAS blobs nobody references, empty cgroups and — the biggest space saver — orphan container directories (from nodes/containers that died abruptly without rm, with no registry entry)

Usage: dlx system prune [OPTIONS]

Options:
  -f, --force         Skip the confirmation prompt (REQUIRED when stdin is not a terminal)
      --l18n <en|pt>  Output language: `en` (default) or `pt` (Portuguese, pt_AO). Also settable via `$DELONIX_L18N`. Global — works before any subcommand
  -a, --all           Also remove unused images that DO have a tag (not just the dangling ones)
  -h, --help          Print help

Exemplos

Recuperar espaço (GC)
delonix system prune

system df

Disk usage by area (images, containers, volumes, VM images)

Usage: dlx system df [OPTIONS]

Options:
      --l18n <en|pt>  Output language: `en` (default) or `pt` (Portuguese, pt_AO). Also settable via `$DELONIX_L18N`. Global — works before any subcommand
  -h, --help          Print help

Exemplos

Uso de disco
delonix system df

system info

Engine state: rootless?, cgroup delegation, network infra, counts

Usage: dlx system info [OPTIONS]

Options:
      --l18n <en|pt>  Output language: `en` (default) or `pt` (Portuguese, pt_AO). Also settable via `$DELONIX_L18N`. Global — works before any subcommand
  -h, --help          Print help

Exemplos

delonix system info

LaboratórioLab

Enche disco com lixo (containers parados) e depois recupera-o.

for i in 1 2 3; do delonix container run --name lixo-$i alpine true; done
delonix system df
delonix system prune
delonix system df

Fill up disk with junk (stopped containers) and then reclaim it.

for i in 1 2 3; do delonix container run --name junk-$i alpine true; done
delonix system df
delonix system prune
delonix system df

DesafioChallenge

Segue system events num terminal enquanto corres container run/stop/rm noutro, e mapeia cada acção da CLI ao evento exacto que ela emite.

Follow system events in one terminal while running container run/stop/rm in another, and map each CLI action to the exact event it emits.