The header scan (Captain Bob, 2026-11-10): 788 source files -- 351 with the
SL-1.0 header, 12 with the old name (docs/working/experiments, kept by
ruling), 31 under someone else's licence (tools/kconfig, Linux's, GPL-2.0:
kept), and 394 with none. Ruled: the SPDX form; capsules (.4th, .f18) and
proofs (.thy) left for a ruling of their own (mkcapsule's 64x16 block format,
content-addressed capsules).
253 files now begin
SPDX-License-Identifier: LicenseRef-Starship-1.0
Copyright (c) 2023-2026 Robert A. James
as a /* */ block (C, headers, assembly, linker scripts) or # lines (scripts,
Makefiles, Kconfig; below a shebang or a coding line); tools/mkcapsule.c,
which had the copyright line, gets the SPDX line only.
Not touched: docs/working/ (archive and old campaign material, as the
ruling kept the experiments); v4/system/post_cases.c (generated by
v4/tools/mkpost.py, "do not edit" -- the generator has the header).
Comments only: the kernel builds on amd64, aarch64, riscv64; make -C v4
test-32: 39 programs, 0 failures; every changed script parses.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01GE3SDvQn5EoxdGufk84zz2
69 lines
2.9 KiB
C
69 lines
2.9 KiB
C
/* SPDX-License-Identifier: LicenseRef-Starship-1.0
|
|
* Copyright (c) 2023-2026 Robert A. James
|
|
*/
|
|
/* message.h -- a message, as it is written to a port and read from one.
|
|
* docs/v4.0.0/MESH.md section 6.
|
|
*
|
|
* The ports are the transport; the message is what is transported. It is
|
|
* v3's Hermes message with what it carries, a word at a time:
|
|
*
|
|
* word 0 to: the node it is for
|
|
* word 1 from: the node that sent it
|
|
* word 2 type
|
|
* word 3 heat and TTL
|
|
* word 4 ACL tag: the sender's identity fingerprint
|
|
* word 5 sequence
|
|
* word 6 how many characters of text follow, 0 to 1024
|
|
* word 7.. the text, four characters to a word, the first lowest
|
|
*
|
|
* Words 3, 4 and 5 are carried and not yet used: checking them is the
|
|
* router's, and awaits rulings (MESH.md section 3).
|
|
*
|
|
* This is for whatever is on the other end of a node's port and is not a
|
|
* node -- a console, a host -- to speak what the nodes speak (v4/capsule/
|
|
* core.f18 and quit.f18 are the same thing in the node). Nothing here uses
|
|
* the C library.
|
|
*/
|
|
#ifndef V4_MESSAGE_H
|
|
#define V4_MESSAGE_H
|
|
|
|
#include "v4/cell.h"
|
|
|
|
#define V4_MSG_HEADER 7u
|
|
#define V4_MSG_MAX_CHARS 1024u /* a block */
|
|
#define V4_MSG_MAX_WORDS (V4_MSG_HEADER + V4_MSG_MAX_CHARS / 4u)
|
|
|
|
#define V4_MSG_TEXT 1 /* text to be interpreted */
|
|
#define V4_MSG_OUTPUT 2 /* what a node printed */
|
|
#define V4_MSG_DONE 3 /* how the text ended: one word, V4_TEXT_* */
|
|
#define V4_MSG_NACK 4 /* a message was refused: one word, the node it was for (MESH.md 7b) */
|
|
#define V4_MSG_GONE 5 /* a node is gone: one word, its number */
|
|
|
|
/* how text ended */
|
|
#define V4_TEXT_QUIT 0 /* QUIT: nothing is to be said */
|
|
#define V4_TEXT_COMPLETED 1 /* a console says " ok" */
|
|
#define V4_TEXT_ERROR 2 /* the message is printed; a console says " ERROR" */
|
|
|
|
typedef struct {
|
|
v4_cell word[V4_MSG_MAX_WORDS];
|
|
unsigned count; /* words in it */
|
|
} v4_message;
|
|
|
|
/* A message of `len` characters, at most V4_MSG_MAX_CHARS. Returns how many
|
|
* words it is, or 0 if `len` is too many. */
|
|
unsigned v4_message_text(v4_message *m, v4_cell to, v4_cell from, v4_cell type, const char *chars, unsigned len);
|
|
|
|
/* A message arriving a word at a time. Start with m->count = 0 and give
|
|
* each word as it comes: returns 1 when the message is whole, 0 if there is
|
|
* more to come. A length that is not 0 to V4_MSG_MAX_CHARS is taken as 0. */
|
|
int v4_message_word(v4_message *m, v4_cell word);
|
|
|
|
/* Its parts. */
|
|
#define v4_message_to(m) ((m)->word[0])
|
|
#define v4_message_from(m) ((m)->word[1])
|
|
#define v4_message_type(m) ((m)->word[2])
|
|
unsigned v4_message_length(const v4_message *m); /* characters of text */
|
|
char v4_message_char(const v4_message *m, unsigned i); /* the i-th of them */
|
|
|
|
#endif /* V4_MESSAGE_H */
|