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
75 lines
3.7 KiB
C
75 lines
3.7 KiB
C
/* SPDX-License-Identifier: LicenseRef-Starship-1.0
|
|
* Copyright (c) 2023-2026 Robert A. James
|
|
*/
|
|
/* post.h -- POST, which is the kernel's. docs/v4.0.0/NUCLEUS.md section 6.
|
|
*
|
|
* As in v3, the kernel holds the cases and runs them on the node: nothing
|
|
* of POST is in the node's dictionary. A case is a name, its lines of
|
|
* FORTH, and what it must do. The table is generated from v3's own cases
|
|
* (v4/tools/mkpost.py -> v4/system/post_cases.c).
|
|
*/
|
|
#ifndef V4_POST_H
|
|
#define V4_POST_H
|
|
|
|
#include "v4/node.h"
|
|
|
|
#define V4_POST_STACK 0 /* its data stack and what it prints are compared */
|
|
#define V4_POST_DEPTH 1 /* only how many values it leaves; what it prints is not compared */
|
|
#define V4_POST_DEPTH_OUTPUT 2 /* how many values it leaves, and what it prints */
|
|
#define V4_POST_ERROR 3 /* it must end in an error; nothing else is compared */
|
|
|
|
typedef struct {
|
|
const char *name;
|
|
const char *const *lines; /* line_count of them, sent one at a time */
|
|
unsigned line_count;
|
|
int expect; /* V4_POST_* */
|
|
const long long *stack; /* V4_POST_STACK: depth values, the deepest first; else 0 */
|
|
unsigned depth;
|
|
const char *output; /* output_len characters */
|
|
unsigned output_len;
|
|
} v4_post_case;
|
|
|
|
extern const v4_post_case v4_post_cases[];
|
|
extern const unsigned v4_post_case_count;
|
|
|
|
/* THE RUNNER (v4/system/post.c). Whoever runs POST on a node supplies how a
|
|
* line is sent to it and where the console is. For each case the runner
|
|
* empties the node's data stack from outside; sends DECIMAL FORTH
|
|
* DEFINITIONS, the state every expected result was taken from; sends the
|
|
* case's lines one at a time, keeping what the node prints and showing none
|
|
* of it; and judges. A case passes when it ended in an error exactly if
|
|
* one was expected and, if none was, its stack and its printing are what
|
|
* the table has. It has ended in an error if any of its lines did. A
|
|
* case one of whose lines ends with QUIT fails: it went back to the
|
|
* terminal and did not complete. So does one whose starting state could
|
|
* not be set, and what the node said of that is shown. What
|
|
* the cases define is still in the node's dictionary when the runner
|
|
* returns: whoever runs POST puts the dictionary back afterwards, as v3
|
|
* does after each of its suites (v3/src/test_runner/test_common.c,
|
|
* run_test_suite: "to remove test-created words").
|
|
*
|
|
* If the node does not come back from a line -- it has stopped, or runs for
|
|
* ever -- that case fails and POST ends there: the runner says which case
|
|
* it was and how many were not run. */
|
|
#define V4_POST_OUT 1024u /* the most of a case's printing that is kept */
|
|
|
|
typedef struct {
|
|
void *self;
|
|
v4_node *n; /* the node: its data stack is read and emptied */
|
|
/* Send the node a line and run it to its end. What it prints is put at
|
|
* `out`, at most `cap` characters, and *len is how many it printed in
|
|
* all. Returns V4_TEXT_QUIT, V4_TEXT_COMPLETED or V4_TEXT_ERROR
|
|
* (message.h); or a negative number if the line did not come back. */
|
|
int (*line)(void *self, const char *text, unsigned text_len, char *out, unsigned cap, unsigned *len);
|
|
void (*say)(void *self, const char *text, unsigned len); /* the console */
|
|
} v4_post_host;
|
|
|
|
typedef struct { unsigned tests, pass, fail; } v4_post_tally;
|
|
|
|
/* Run the cases. Prints "POST FAIL: name out<...> stack<...>" for each
|
|
* failing case and then "PARITY:V4_POST tests=N pass=N fail=N", where tests
|
|
* is how many were run. Returns 1 if every case was run and none failed. */
|
|
int v4_post_run(const v4_post_host *h, const v4_post_case *cases, unsigned count, v4_post_tally *tally);
|
|
|
|
#endif /* V4_POST_H */
|