ilyakooo0/urbit
1
0
Fork 0
mirror of https://github.com/ilyakooo0/urbit.git synced 2024-12-21 13:51:50 +03:00
Code Issues Packages Projects Releases Wiki Activity

conn: update header comment

Browse Source
This commit is contained in:
Jōshin 2022-03-03 16:26:09 -06:00
parent 7d9ac764a7
commit df25781c37
No known key found for this signature in database
GPG Key ID: A8BE5A9A521639D0
1 changed files with 18 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
pkg/urbit/vere/io/conn.c
View File

@ -5,13 +5,13 @@
**
** the control plane nominally consumes input described by:
**
** $: request-id=@ :: id for response
** $% [%fyrd fyrd-args=*] :: run a thread
** [%peek peek-args=*] :: scry
** [%peel peel-args=*] :: runtime peek
** [%ovum ovum-args=*] :: inject raw ovum
** [%urth urth-args=*] :: runtime command
** == == ::
** $: request-id=@ :: id for response
** $% [%fyrd fyrd-args=*] :: run a thread
** [%peek peek-args=*] :: scry
** [%peel peel-args=*] :: runtime peek
** [%ovum ovum-args=*] :: inject raw ovum
** [%urth urth-args=*] :: runtime command
** == == ::
**
** request-id is a client-supplied atomic identifier that will
** be returned along with the response, to allow correlating
@ -21,21 +21,22 @@
** described in the ++khan section of sys/lull.hoon. to
** summarize:
**
** +$ task $%(... [%fyrd p=fyrd]) ::
** +$ fyrd [=bear name=term =out=mark data=(cask)] :: thread request
** +$ bear $@(desk beak) :: partial $beak
** +$ task $%(... [%fyrd p=(fyrd cast)]) ::
** +$ bear $@(desk beak) :: partial $beak
** +$ cast (pair mark page) :: output mark +input
** ++ fyrd |$ [a] [=bear name=term args=a] :: thread run request
**
** the passed mark is applied to the output. the cask (short for
** (cask *)) at data contains the input mark. e.g. to run -code
** with ~ as input, receiving output as a +tape, with request-id
** set to 32, send the +jam of this noun over the socket with
** newt framing:
** the cast's mark is applied to the output. the page (untyped
** cage, or pair of mark and noun) in args contains the input
** mark. e.g. to run -hi with the ship ~zod as input, receiving
** output as a tape, with request-id set to 32, send the +jam of
** this noun over the socket with newt framing:
**
** [32 %fyrd [%base %code %tape [%noun ~]]]
** [32 %fyrd [%base %hi %tape [%ship ~zod]]]
**
** responses to %fyrd are either %fail if something went wrong
** in the driver, or %avow to indicate success or failure from
** %khan. $avow is: (each (cask) goof).
** %khan. the body of avow is (each page goof).
**
** %peek is a namespace read request (aka scry), and will be
** forwarded directly to arvo. its arguments are the nom of the