on master help sign in
plea triggers send which are in response to born
141b5c6JONATHAN PAPROCKI
reference/vane-apis/ames.md+10−2
@@ -124,6 +124,11 @@ Ames also `pass`es a `%plea` `note` to another vane when it receives a message o
124"forward flow" from a peer, originally passed from one of the peer's vanes to the
124"forward flow" from a peer, originally passed from one of the peer's vanes to the
125peer's Ames.
125peer's Ames.
126
126
127+Ultimately `%plea` causes `%send` `gift`(s) to be sent to Unix, which tells
128+Unix to send packets. In terms of `%pass`/`%give` semantics, this is in
129+response to the `%born` `task`, which came along the Unix `duct`, rather than a
130+response to the `%plea`.
131+
127#### Accepts
132#### Accepts
128
133
129```hoon
134```hoon
@@ -141,8 +146,7 @@ route on the receiving ship, and `payload` is the semantic message content.
141
146
142#### Returns
147#### Returns
143
148
144−This `task` causes Ames to `give` `%send` `gift`(s) to Unix.
149+This `task` returns no `gift`s.
145−
146
150
147## System and Lifecycle Tasks
151## System and Lifecycle Tasks
148
152
@@ -158,6 +162,10 @@ Each time you start your Urbit, the Arvo kernel calls the `%born` task for Ames.
158
162
159In response to a `%born` `task`, Ames `%give`s Jael a `%turf` `gift`.
163In response to a `%born` `task`, Ames `%give`s Jael a `%turf` `gift`.
160
164
165+The `duct` along which `%born` comes is Ames' only duct to Unix, so `%send`
166+`gift`s (which are instructions for Unix to send a packet) are also returned in
167+response to `%born`.
168+
161
169
162### `%crud`
170### `%crud`
163
171