DYSNOMIA-CONTAINERS(1)

📦 version 0.10.2, in nixos 26.05, nixpkgs unstable

💅 DYSNOMIA-CONTAINERS(1) 💅

okay so bestie, welcome to dysnomia-containers — it lives in your User Commands section and it's genuinely the main character of container management. grab a snack, we're going in 🍓

✨ NAME ✨

dysnomia-containers — the whole entire job of managing the contents of a set of Dysnomia containers. like, all of it. the mutable stuff. the vibes. everything 🫶

✨ SYNOPSIS ✨

dysnomia-containers [OPTION] OPERATION

that's it. that's the whole thing. option, then operation, and you're literally done ✨

✨ DESCRIPTION ✨

so the command dysnomia-containers can be used to manage all mutable components deployed to a set of containers. that's not me being vague, that's genuinely the scope — every mutable thing, every container, all of it. it's giving "one tool to rule them all" and honestly? iconic 👑

✨ OPTIONS ✨

🌸 Operations:

  • --query-containers — asks the question "which containers do we even have?" and tells you. reconnaissance era 🔍
  • --query-available-components — lists all the available mutable components that can be deployed to containers. the potential. the could-be's ✨
  • --query-activated-components — same energy but for the ones that are actually activated and deployed to containers. the ones that made it 💅
  • --generate-expr — generates a Nix expression out of all the container configurations and their properties. nix girlies rise 🧚
  • --generate-dot — generates a dot file that visualizes the available components per container. pretty little diagram, no cap 🌈
  • -o, --operation=OPERATION — executes the given operation on all mutable components deployed to a container. you pick the operation, it does the thing everywhere 🎀
  • --deploy — deploys all unactivated available mutable components and undeploys obsolete deployed components. two jobs, one flag, she's efficient 🔥
  • --snapshot — snapshots the state of all mutable components. save point, bestie 📸
  • --restore — restores the state of all mutable components. rewind time, we love a comeback 😭
  • --collect-garbage — removes the state of all mutable components that have been marked as garbage. taking out the trash, but make it glam 🗑️
  • -h, --help — shows the usage of this command. the "help me help you" moment 🫶
  • -v, --version — shows the version of this command. who are you, really 🦋

🌷 General parameters:

  • -C, --container=CONTAINER — restricts the operations to the given container. tunnel vision, but on purpose 💜
  • -y — auto confirms when destructive operations are performed. ⚠️ yes this is real — it says yes for you on the destructive stuff. only use it when you actually mean it, bestie, no cap.

✨ ENVIRONMENT ✨

  • DYSNOMIA_COMPONENTS_PATH — specifies the search directories of the components. so here's the deal: if the component is an ordinary string (i.e. not starting with / or ./), Dysnomia goes looking in the folders provided in this colon-separated string. defaults to: /etc/dysnomia/components. it's giving "where my components at" 🧐
  • DYSNOMIA_CONTAINERS_PATH — specifies the search directories of the containers. same rule, container edition: if the container is an ordinary string (not starting with / or ./), Dysnomia searches in the folders provided in this colon-separated string. defaults to: /etc/dysnomia/containers. know your containers, love your containers 💖
  • DYSNOMIA_PROPERTIES — the file capturing general machine properties. defaults to: /etc/dysnomia/properties. the lil fact sheet about your machine 📝
  • DYSNOMIA_STATEDIR — specifies where the snapshots must be stored on the coordinator machine. defaults to: /var/state/dysnomia. your snapshot closet 🌸

Copyright © 2009-2021 Sander van der Burg

all the flags, all the env vars, all the defaults — nothing got left behind, we keep every detail in this house 💅 periodt.

that's the whole page, bestie. this one comes to you from the dysnomia-containers package (the manpage itself is signed dysnomia ...), dated January 1980 — yes really, January 1980, vintage icon behavior 👑🦋 go forth and manage those containers 💖

📦 where this page comes from