about summary refs log tree commit diff
path: root/tvix/docs/src/nix-daemon/index.md
diff options
context:
space:
mode:
authorFlorian Klink <flokli@flokli.de>2024-06-13T18·55+0300
committerclbot <clbot@tvl.fyi>2024-06-13T19·23+0000
commitc30fded8807e333b1037cf3170bdb3bfe7b6eecc (patch)
treeafa4fd2bfd6bde9153e91f681ed5b4dc6d9b9aea /tvix/docs/src/nix-daemon/index.md
parentd947f61d36b95fbed1014e5dc3f1e86684e1d78c (diff)
chore(tvix/docs): move daemon protocol to its own chapter r/8264
… and add an introductionary page at the root.

Change-Id: I89ce69a4221c332b7c0d99ac26b4e26bfd248341
Reviewed-on: https://cl.tvl.fyi/c/depot/+/11806
Autosubmit: flokli <flokli@flokli.de>
Tested-by: BuildkiteCI
Reviewed-by: Brian Olsen <me@griff.name>
Diffstat (limited to 'tvix/docs/src/nix-daemon/index.md')
-rw-r--r--tvix/docs/src/nix-daemon/index.md15
1 files changed, 15 insertions, 0 deletions
diff --git a/tvix/docs/src/nix-daemon/index.md b/tvix/docs/src/nix-daemon/index.md
new file mode 100644
index 000000000000..e47c20151e0d
--- /dev/null
+++ b/tvix/docs/src/nix-daemon/index.md
@@ -0,0 +1,15 @@
+# Nix Daemon Protocol
+
+The Nix Daemon protocol is what's used to communicate with the `nix-daemon`,
+either on the local system (in which case the communication happens via a Unix
+domain socket), or with a remote Nix (in which this is tunneled over SSH).
+
+It uses a custom binary format which isn't too documented. The subpages here
+collect serve as an in-depth detail about some of the inner workings, data types
+etc.
+
+A first implementation of this exists in
+[griff/Nix.rs](https://github.com/griff/Nix.rs/tree/main).
+
+Work is underway to port / factor this out into reusable building blocks into
+the [nix-compat] crate.