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