Skip to content

docs: DECnet Phase IV configuration + usage guide (vms-30e) - #1097

Merged
baron-3dl merged 3 commits into
mainfrom
work/vms-decnet-docs
Sep 10, 2026
Merged

docs: DECnet Phase IV configuration + usage guide (vms-30e)#1097
baron-3dl merged 3 commits into
mainfrom
work/vms-decnet-docs

Conversation

@baron-3dl

Copy link
Copy Markdown
Contributor

Summary

  • Adds docs/decnet-configuration-guide.md, the DECnet operator/admin guide — the sibling of docs/cluster-configuration-guide.md.
  • Covers architecture (NETACP, userspace Phase IV engine over AF_PACKET, object model, the ONE authenticator), NCP node/executor configuration with worked examples, inbound + outbound SET HOST, and a honest "current status & limitations" table sourced from docs/compat/facilities/decnet.yaml.
  • Grounding correction vs. the task brief: the brief assumed COPY NODE:: reports %COPY-I-NETNOTWIRED and that FAL/DAP is "partial/real". Neither is true on origin/maindecnet$task-to-task (which explicitly covers FAL) is absent in the register, dcl_cmd_file.c's cmd_copy() has no NODE:: handling at all (no NETNOTWIRED string exists anywhere in the codebase), and decnetd.c comments confirm object 17/FAL is "not built". The guide documents this honestly: COPY over DECnet does not work today, and the FAL/DAP oracle (docs/oracle/vax-copy-fal-dap.md) is ground truth for a future implementation, not a shipped feature.

Test plan

  • grep every decnet$* id cited in the guide against docs/compat/facilities/decnet.yaml — the only absent-status id referenced (decnet$task-to-task) is documented in the guide as absent, not as working.
  • grep for cleartext credentials in the guide — none present (the FAL example uses the placeholder "user pw", matching the oracle's own redaction convention).
  • Every NCP/SET HOST/COPY command shown matches the real parser: SET/SHOW EXECUTOR, SET/SHOW/CLEAR NODE, SHOW KNOWN NODES verified against src/vmsdecnet/ncp/ncp.c's argv grammar (including exact SHOW output spacing, byte-checked with printf); SET HOST <node> /USERNAME= verified against src/vmsdcl/dcl_cmd_set.c:cmd_set_host; the "COPY does not special-case NODE::" claim verified by reading all of src/vmsdcl/dcl_cmd_file.c:cmd_copy.
  • Docs-only change; no code test applies.

🤖 Generated with Claude Code

https://claude.ai/code/session_01T4csyFSMUsS8k1D2MgMxk2

baron-3dl and others added 3 commits September 9, 2026 21:58
Operator-facing guide for the DECnet layered product, the sibling of
docs/cluster-configuration-guide.md. Covers NCP node/executor
configuration, inbound and outbound SET HOST, and honestly scopes out
COPY/FAL-DAP as not-yet-implemented (decnet$task-to-task is absent in
the register; cmd_copy() has no NODE:: handling and the FAL/DAP oracle
capture is ground truth for a future implementation, not a shipped
feature). Every capability claim is grounded in
docs/compat/facilities/decnet.yaml and verified against ncp.c,
dcl_cmd_set.c, and dcl_cmd_file.c on origin/main.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01T4csyFSMUsS8k1D2MgMxk2
…s (vms-8c2/#1096)

The guide was grounded on origin/main (pre-#1096), so §4 documented COPY-over-
DECnet as not-yet-built. Since the guide (#1097) and FAL (#1096) both land in
V0.6-13, augment §4 + the status table to the post-#1096 state: authenticated
inbound FAL (object 17, connect-carried creds checked via SYSUAF/Purdy + disabled
gate BEFORE accept, bad-pw refused), real DAP codec (bounded/fuzz-clean), RMS-over-
ACP. Honest deferred: outbound DCL COPY bridge reports %COPY-I-NETNOTWIRED (rd
vms-ea8), advanced DAP, byte-level stock-VAX interop. Clarified the ONE-authenticator
bullet (interactive→LOGINOUT via $CREPRC; FAL→SYSUAF directly).

MUST merge AFTER #1096 (it describes FAL, which #1096 delivers).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01T4csyFSMUsS8k1D2MgMxk2
@baron-3dl
baron-3dl merged commit da2fd34 into main Sep 10, 2026
117 checks passed
@baron-3dl
baron-3dl deleted the work/vms-decnet-docs branch September 10, 2026 02:45
baron-3dl added a commit that referenced this pull request Sep 10, 2026
…cated SET HOST (hard-gated x86_64+Alpha+VAX)

Version bump (identity + os-release in step, INV-1 SSOT gate). V0.6-13 ships:
- DECnet Phase IV file COPY (FAL/DAP): object-17 FAL server + DAP codec + COPY
  client, authenticated against the real SYSUAF/Purdy with RMS-over-ACP transfer,
  byte-verified both directions (#1096, vms-8c2).
- The authenticated inbound SET HOST -> LOGINOUT proof is now a HARD GATE on all
  three rails: DECNETD.EXE staged onto the VAX sysvol + Alpha boot image, so
  DECNETD-CTERM-ACCEPT + DECNETD-ISOLATION assert+PASS on x86_64 + Alpha + VAX —
  the login frontier is substrate-agnostic (#1099, vms-c1f).
- DECnet Phase IV configuration + usage guide (#1097, vms-30e).
- Compatibility-register honesty: cluster-dlm evidence repointed off deleted
  src/vmsscs paths to the executive-resident src/kernel-core, and the 4 cluster-dlm
  rows whose multi-node /dev/vms proof was retired in #1052 downgraded
  verified->implemented (#1100/#1101; multi-node proof re-establishment gated in
  vms-1ee).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018q4jvj6GCkdbYjRvpy7Vwu
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant