aboutsummaryrefslogtreecommitdiff
path: root/doc/manual/src/architecture/store
diff options
context:
space:
mode:
authorValentin Gagarin <valentin.gagarin@tweag.io>2022-04-28 01:15:27 +0200
committerValentin Gagarin <valentin.gagarin@tweag.io>2022-08-04 12:37:47 +0200
commit7b5c00f67f729bb3c0d026f3f4d14e727c4cf420 (patch)
tree05576be92f2da8f4845b960ab662b22645aa4e95 /doc/manual/src/architecture/store
parentc8c1b705ad5cdf115997cef387d83c4b04fe0660 (diff)
add concrete store examples, reword note on file system
Diffstat (limited to 'doc/manual/src/architecture/store')
-rw-r--r--doc/manual/src/architecture/store/store.md17
1 files changed, 12 insertions, 5 deletions
diff --git a/doc/manual/src/architecture/store/store.md b/doc/manual/src/architecture/store/store.md
index b52fe8255..688c7e1a2 100644
--- a/doc/manual/src/architecture/store/store.md
+++ b/doc/manual/src/architecture/store/store.md
@@ -4,11 +4,18 @@ A Nix store is a collection of [store objects](objects.md) and associated operat
These store objects can hold arbitrary data, and Nix makes no distinction if they are used as build inputs, build results, or build plans.
-Store objects are accessible in a file system through [store paths](paths.md).
-Every store has a *store directory*, which contains that store’s objects and is a prefix of their store paths.
-It defaults to `/nix/store`, but is in principle arbitrary.
-
-A Nix store can perform builds, that is, transform build inputs using instructions from the build plans into build outputs. It also keeps track of *references* between data and can therefore garbage-collect unused store objects.
+A Nix store allows to add and retrieve store objects.
+It can perform builds, that is, transform build inputs using instructions from the build plans into build outputs.
+It also keeps track of *references* between data and can therefore garbage-collect unused store objects.
+
+There exist different types of stores, which all follow this model.
+Examples:
+- store on the local file system
+- remote store accessible via SSH
+- binary cache store accessible via HTTP
+
+Every store with a file system representation has a *store directory*, which contains that store’s objects accessible through [store paths](paths.md).
+The store directory defaults to `/nix/store`, but is in principle arbitrary.
## A Rosetta stone for the Nix store.