git.iko.soy/urbit.org
on master help sign in
room
e416463drbeefsupreme
arvo/clay/data-types.md+15−21
compare with master
unifiedsplit
@@ -30,7 +30,7 @@ this section isn't too long, so many readers may wish to quickly read through
30all of it. If you get bored, though, just skip to the next section. You can
30all of it. If you get bored, though, just skip to the next section. You can
31always come back when you need to.
31always come back when you need to.
32
32
33−### `++raft`, formal state
33+### `$raft`, formal state
34
34
35```hoon
35```hoon
36+$ raft :: filesystem
36+$ raft :: filesystem
@@ -51,47 +51,41 @@ calls to Clay is stored in this state.
51where all the "real" data we know is stored; the rest is "just
51where all the "real" data we know is stored; the rest is "just
52bookkeeping".
52bookkeeping".
53
53
54−`rom` is our domestic state. It consists of a `duct` to
54+`rom` is the state for all local desks. It consists of a `duct` to
55[Dill](@/docs/arvo/dill/dill.md) and a collection of `desk`s.
55[Dill](@/docs/arvo/dill/dill.md) and a collection of `desk`s.
56
56
57−`hoy` is a collection of foreign ships for which we know something about their
57+`hoy` is the state for all foreign desks.
58−Clay.
59
58
60−`ran` is the object store. It has maps of commit hashes to commits and content
59+`ran` is the global, hash-addressed object store. It has maps of commit hashes
61−hashes to content.
60+to commits and content hashes to content.
62
61
63`mon` is a collection of Unix mount points. `term` is the mount point (relative
62`mon` is a collection of Unix mount points. `term` is the mount point (relative
64to th pier) and `beam` is a domestic Clay directory.
63to th pier) and `beam` is a domestic Clay directory.
65
64
66−`hez` is the Unix duct that `%ergo` `%gift`s should be sent to.
65+`hez` is the duct used to sync with Unix.
67
66
68`cez` is a collection of named permission groups.
67`cez` is a collection of named permission groups.
69
68
70`pud` is an update that's waiting on a kernel upgrade.
69`pud` is an update that's waiting on a kernel upgrade.
71
70
72
71
73−#### `++room`, filesystem per domestic ship
72+#### `$room`, filesystem per domestic ship
74
73
75```hoon
74```hoon
76− ++ room :: fs per ship
75++$ room :: fs per ship
77− $: hun=duct :: terminal duct
76+ $: hun=duct :: terminal duct
78− hez=(unit duct) :: sync duch
79− dos=(map desk dojo) :: native desk
77+ dos=(map desk dojo) :: native desk
80− == ::
78+ == ::
81```
79```
82
80
83This is the representation of the filesystem of a ship on our pier.
81This is the representation of the filesystem of a ship on our pier.
84
82
85−`hun` is the duct we use to send messages to dill to display
83+`hun` is the duct we use to send messages to [Dill](@/docs/arvo/dill/dill.md) to
86−notifications of filesystem changes. Only `%note` gifts should be
84+display notifications of filesystem changes. Only `%note` `%gift`s should be
87−produced along this duct. This is set by the `%init` kiss.
85+produced along this `duct`. This is set by the `%init` `move`.
88−
89−`hez`, if present, is the duct we use to send sync messages to unix so
90−that they end up in the pier unix directory. Only `%ergo` gifts should
91−be producd along this duct. This is set by `%into` and `%invo` kisses.
92
86
93`dos` is a well-known operating system released in 1981. It is also the
87`dos` is a well-known operating system released in 1981. It is also the
94−set of desks on this ship, mapped to their data.
88+set of desks on this ship, mapped to their desk state.
95
89
96#### `++desk`, filesystem branch
90#### `++desk`, filesystem branch
97
91