#+TITLE: NixOS Modules
#+AUTHOR: spacefrogg
#+EMAIL: git@spacefrogg.net
#+startup: showall

* Modules
** tinydns
A replacement for the upstream tinydns module.  This module extends the service
in an incompatible way.  You instantiate a service by adding an attribute
=<ipv4-address>= under =services.tinydns=.  This flake comes with an extended
=lib= attribute, which you must use in your nixos configuration (e.g. in the
call to =nixpkgs#lib.nixosSystem=) to have special functions under =lib.tinydns=
available that create tinydns records from functions and arguments.  See the
module documentation for currently available functions.


* Development
This comes with a self-contained redo toolchain to help in working with the
flake. It basically deploys any input flake into the =tmp= directory for easier
access.

redo targets under =tmp/= come in three kinds:
- =clean= :: will remove all build products under =tmp/=
- =<flake>= :: will make sure a store path to =<flake>= exists and puts an
  indirect root into =tmp/<flake>=.
- =<flake>.rw= :: will make sure a store path to =<flake>= exists and will copy
  its contents to =tmp/.<flake>.rw= and will link to it from
  =tmp/<flake>.rw=. (Rationale: On Linux, directories cannot denote reliable
  targets due to their non-trivial relation to modification time.)