Specify C runtime and compatibility interfaces #37

Manually merged
erikinkinen merged 70 commits from feature/docs-native-c-runtime-abi into feature/docs-native-filesystem-authority 2026-11-21 06:11:50 +01:00
Owner

Describe C startup, heap ownership, scalar records, byte and string operations, errors, descriptors and the native bindings used by runtime adapters. Keep native execution requirements distinct from the documented contracts.

Depends on #36. Related provider work: erix/lib-cstd#44, erix/lib-cstd#45 and erix/lib-cstd#64. Completed downstream documentation from #38–#45 remains included.

  • Document the C runtime and compatibility interfaces.
  • Register the terminal-parameter and native clock ownership fragments.
  • Publish the source-bound manual with both previously missing sections.

Includes the retained terminal flush specification from #47, merged at 513b4017f2d365b31f67a0e93d11eec33e938db3.

Describe C startup, heap ownership, scalar records, byte and string operations, errors, descriptors and the native bindings used by runtime adapters. Keep native execution requirements distinct from the documented contracts. Depends on #36. Related provider work: erix/lib-cstd#44, erix/lib-cstd#45 and erix/lib-cstd#64. Completed downstream documentation from #38–#45 remains included. - [x] Document the C runtime and compatibility interfaces. - [x] Register the terminal-parameter and native clock ownership fragments. - [x] Publish the source-bound manual with both previously missing sections. Includes the retained terminal flush specification from #47, merged at `513b4017f2d365b31f67a0e93d11eec33e938db3`.
erikinkinen added this to the Alpha 1 milestone 2026-10-30 13:58:29 +01:00
docs: Specify C runtime and compatibility interfaces
Some checks failed
CI / manual (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Failing after 14s
CI / manual (push) Successful in 10m42s
283552e74a
Describe C startup, heap ownership, scalar records and byte, string, error and descriptor interfaces. Document the native process and mediator bindings required by the runtime adapters.
docs: Repair Markdown paragraph wrapping
All checks were successful
CI / manual (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 11s
CI / manual (push) Successful in 9m45s
975950121f
Keep the original feature prose and all source inputs while correcting
Markdown spacing and line wrapping.
Author
Owner

The new speed-token prose in restricted-terminal-control and the native clock adapter prose in clock-resolution-and-wall-waits are absent from this exact-source published manual. Register both fragments in the relevant chapters. These missing manual sections keep this PR WIP.

The new speed-token prose in restricted-terminal-control and the native clock adapter prose in clock-resolution-and-wall-waits are absent from this exact-source published manual. Register both fragments in the relevant chapters. These missing manual sections keep this PR WIP.
fixup! docs: Specify C runtime and compatibility interfaces
All checks were successful
CI / manual (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 4s
CI / manual (push) Successful in 4m59s
d9597dca65
Include the terminal parameter and native clock adapter fragments under their owning service contracts. Keep local speed-token representation separate from native effects.
docs: Index POSIX and self-hosting contracts
All checks were successful
CI / markdown (push) Successful in 5s
CI / manual (push) Successful in 4m53s
3d53b51fbe
Link the current ABI, service and build documentation from the phase specification and repository overview. Use maintained contract pages in place of transient status reports.
docs: Merge index POSIX and self-hosting contracts
All checks were successful
CI / manual (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 4s
CI / manual (push) Successful in 4m44s
d39e0bd52e
Integrate the reviewed prepared history into feature/docs-native-c-runtime-abi. The feature tree and
original source branch remain unchanged. Upstream work retains its own
completion requirements.

#38
Move prior component checkpoints into topical history files. Keep the roadmap focused on current contracts and outstanding work while retaining the original evidence links.
docs: Remove obsolete work-policy wording from history
All checks were successful
CI / markdown (push) Successful in 4s
CI / manual (push) Successful in 4m47s
0e05f824ed
Keep the recorded source selections, results and unfinished acceptance requirements. Remove references to earlier testing waivers from the history preambles and individual entries without changing their technical contracts or evidence.
docs: Merge archive prior component checkpoints
All checks were successful
CI / manual (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 4s
CI / manual (push) Successful in 4m51s
b43d9718dc
Integrate the reviewed prepared history into feature/docs-native-c-runtime-abi. The feature tree and
original source branch remain unchanged. Upstream work retains its own
completion requirements.

#39
docs: Specify the native manual reader
All checks were successful
CI / markdown (push) Successful in 4s
CI / manual (push) Successful in 4m44s
fd657cf68e
Describe admitted manual-store input, terminal geometry and retained search and page state. Keep lookup and rendering within the selected store and terminal bindings.
docs: Merge specify the native manual reader
All checks were successful
CI / manual (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 6s
CI / manual (push) Successful in 5m13s
bbc856149a
Integrate the reviewed prepared history into feature/docs-native-c-runtime-abi. The feature tree and
original source branch remain unchanged. Upstream work retains its own
completion requirements.

#40
docs: Specify VM scenario ownership
All checks were successful
CI / markdown (push) Successful in 4s
CI / manual (push) Successful in 4m45s
82d27c736c
Describe selected VM inputs, physical probes, retained process completion and interruption cleanup. Record the evidence required for each scenario result.
docs: Merge specify VM scenario ownership
All checks were successful
CI / manual (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 3s
CI / manual (push) Successful in 4m50s
3873dfb099
Integrate the reviewed prepared history into feature/docs-native-c-runtime-abi. The feature tree and
original source branch remain unchanged. Upstream work retains its own
completion requirements.

#41
docs: Specify syscall and machine context
All checks were successful
CI / markdown (push) Successful in 4s
CI / manual (push) Successful in 4m43s
aa9bbd17da
Describe private register custody and native entry and return boundaries. Document processor geometry and the state retained by the original execution.
docs: Merge specify syscall and machine context
All checks were successful
CI / manual (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 4s
CI / manual (push) Successful in 4m41s
95fe4add4f
Integrate the reviewed prepared history into feature/docs-native-c-runtime-abi. The feature tree and
original source branch remain unchanged. Upstream work retains its own
completion requirements.

#42
docs: Specify startup profiling evidence
All checks were successful
CI / markdown (push) Successful in 4s
CI / manual (push) Successful in 4m45s
b8b3caa1f7
Describe startup boundaries, selected runtime profiles and TCG observations. Preserve the original inputs, resource accounting and measurement scope.
docs: Merge specify startup profiling evidence
All checks were successful
CI / manual (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 4s
CI / manual (push) Successful in 4m42s
b65845893a
Integrate the reviewed prepared history into feature/docs-native-c-runtime-abi. The feature tree and
original source branch remain unchanged. Upstream work retains its own
completion requirements.

#43
docs: Specify inherited command streams
All checks were successful
CI / markdown (push) Successful in 4s
CI / manual (push) Successful in 4m54s
8556c616b0
Describe complete inherited descriptions, explicit closed roles and original recipient ownership. Record short I/O, borrowed-view retirement and uncertain cleanup behavior.
docs: Merge specify inherited command streams
All checks were successful
CI / manual (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 4s
CI / manual (push) Successful in 4m43s
825f36832e
Integrate the reviewed prepared history into feature/docs-native-c-runtime-abi. The feature tree and
original source branch remain unchanged. Upstream work retains its own
completion requirements.

#44
docs: Specify native shell and command contracts
All checks were successful
CI / markdown (push) Successful in 4s
CI / manual (push) Successful in 4m55s
4368b0d81b
Describe command preparation, lexical state, raw selectors and admitted execution. Keep parsing and request descriptions subject to the original broker and stream authority.
docs: Merge specify native shell and command contracts
All checks were successful
CI / manual (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 4s
CI / manual (push) Successful in 4m45s
6dc475f830
Integrate the reviewed prepared history into feature/docs-native-c-runtime-abi. The feature tree and
original source branch remain unchanged. Upstream work retains its own
completion requirements.

#45
Author
Owner

Merged the approved downstream work from #38, #39, #40, #41, #42, #43, #44, #45. The upstream PR retains its own remaining scope and completion requirements.

Merged the approved downstream work from #38, #39, #40, #41, #42, #43, #44, #45. The upstream PR retains its own remaining scope and completion requirements.
erikinkinen changed title from WIP: Specify C runtime and compatibility interfaces to Specify C runtime and compatibility interfaces 2026-11-14 11:13:49 +01:00
Author
Owner

Both previously missing sections—terminal parameter representation and native clock adapter ownership—are now present in the published manual for this exact head. Their pages were checked visually. The documentation defect is resolved, so this PR is ready for review.

Both previously missing sections—terminal parameter representation and native clock adapter ownership—are now present in the published manual for this exact head. Their pages were checked visually. The documentation defect is resolved, so this PR is ready for review.
docs: Specify offline toolchain source closure
All checks were successful
CI / markdown (push) Successful in 4s
CI / manual (push) Successful in 4m48s
4923aa2322
Describe complete archive, patch, license and recipe inputs under the selected provenance record, and retain the extended-image source and guest-build contracts. Preserve the newer README navigation without restoring removed progress prose.
docs: Merge specify offline toolchain source closure
All checks were successful
CI / manual (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 5s
CI / manual (push) Successful in 4m50s
990fba4129
Integrate the reviewed prepared history into feature/docs-native-c-runtime-abi. The feature tree and
original source branch remain unchanged. Upstream work retains its own
completion requirements.

#46
Describe the selected input and output discard boundaries and their retained control ownership. Preserve unrelated directions and original caller cleanup.
Describe calibrated clock resolution, signed UTC waits, retained operation storage and cancellation without changing native authority. Preserve the current upstream terminal-control manual input and keep the clock reference linked from the published manual.
Describe native boot image assembly, partitioned image files and the boot-tool workflow. Preserve the newer upstream authority-invariant text and keep the image and partition references reachable from the technical manual.
Describe original terminal issuer pairs, explicitly selected control rights and view cleanup. Keep the clock reference and upstream manual input while integrating the restricted terminal attribute contract.
Describe the serial completion request and exact response framing. Require the original driver I/O authority and actual empty transmitter state.
Describe retained renderer and PTY producer ceilings. Keep later writes and unrelated sessions outside the admitted boundary.
Describe drain and deferred attribute replacement under the original terminal control view. Retain the output boundary and local state through completion.
Describe independent output suspension and configured STOP/START control. Preserve the original direction, control permission and pending operation.
Describe owned read publication and noncanonical completion rules. Retain the original byte buffers, thresholds and timing state through cancellation.
Describe the separate serial control pair and its original controller. Record native execution, transient register ownership and process cleanup requirements.
Describe the device-scoped pulse and retained output boundary. Require actual admitted IRQ timing and positive hardware clear before retirement.
Describe physical observation and application through the original serial controller. Reconcile local attributes with actual hardware readback and retain the operation through cancellation.
Describe verified DTR/RTS changes, divisor preservation and reception policy. Record the controller lifetime required before final-close modem behavior can be supported.
Describe caller-retained native packets, execution affinity and once-only collection and retirement for the hash command. Keep provider rollback, native retirement and complete command teardown distinct, without attributing authority to receipt payload bytes.
Describe partial chaining and the final-block exchange on aligned inputs, link the corrected source contracts and independent answers, and require explicit migration of any persisted nonstandard prototype ciphertext without automatic format fallback.
Describe selected primitive and runtime roles, CPU requirements and retained input ownership. Record secret erasure and the original source and build identity.
Describe the external pending callback and full signed yield result without conflating scheduling failure with native invocation retirement.
Describe SHA-2 command preparation, explicit input and output streams and checked diagnostics. Keep native operation and cleanup ownership through completion.
Specify corrected CBC-CS3 filename ordering. Integrate the reviewed feature into feature/docs-cryptographic-runtime-contracts while the upstream work retains its own completion requirements.

#97
Describe selected component sources, generated Cargo inputs, linker roles and original-object caches. Retain exact resolution and completion records through export and offline admission.
Document original native stream invocation custody. Integrate the reviewed feature into feature/docs-native-hash-command-contracts while the upstream work retains its own completion requirements.

#86
Describe symbol selection, export identity, relocation geometry and original image custody. Preserve checked loader and dynamic-linker ownership through materialization.
Describe counted pipe admission, C descriptor publication and original-controller SIGPIPE custody. Retain both directions and their cleanup obligations.
Integrate the reviewed prepared history into feature/docs-terminal-flush. The feature tree and
original source branch remain unchanged. Upstream work retains its own
completion requirements.

#48
Integrate the reviewed prepared history into feature/docs-terminal-flush. The feature tree and
original source branch remain unchanged. Upstream work retains its own
completion requirements.

#49
Integrate the reviewed prepared history into feature/docs-terminal-flush. The feature tree and
original source branch remain unchanged. Upstream work retains its own
completion requirements.

#50
Integrate the reviewed prepared history into feature/docs-terminal-flush. The feature tree and
original source branch remain unchanged. Upstream work retains its own
completion requirements.

#51
Integrate the reviewed prepared history into feature/docs-terminal-flush. The feature tree and
original source branch remain unchanged. Upstream work retains its own
completion requirements.

#52
Describe process actions, task masks, pending state and retained caught handoffs. Bind effects to the original admitted process and task lifetime.
Describe scoped socket framing, original pins, backlog and concurrent-call ownership. Record the remaining native listener and connection requirements.
Describe authenticated terminal association, retained lifecycle control and launch authority. Preserve cancellation, reply order and positive cleanup through the original bindings.
Integrate the reviewed prepared history into feature/docs-terminal-flush. The feature tree and
original source branch remain unchanged. Upstream work retains its own
completion requirements.

#53
Integrate the reviewed prepared history into feature/docs-terminal-flush. The feature tree and
original source branch remain unchanged. Upstream work retains its own
completion requirements.

#54
Integrate the reviewed prepared history into feature/docs-terminal-flush. The feature tree and
original source branch remain unchanged. Upstream work retains its own
completion requirements.

#55
Integrate the reviewed prepared history into feature/docs-terminal-flush. The feature tree and
original source branch remain unchanged. Upstream work retains its own
completion requirements.

#56
Integrate the reviewed prepared history into feature/docs-terminal-flush. The feature tree and
original source branch remain unchanged. Upstream work retains its own
completion requirements.

#57
Integrate the reviewed prepared history into feature/docs-terminal-flush. The feature tree and
original source branch remain unchanged. Upstream work retains its own
completion requirements.

#58
Integrate the reviewed prepared history into feature/docs-terminal-flush. The feature tree and
original source branch remain unchanged. Upstream work retains its own
completion requirements.

#59
Integrate the reviewed prepared history into feature/docs-terminal-flush. The feature tree and
original source branch remain unchanged. Upstream work retains its own
completion requirements.

#60
Integrate the reviewed prepared history into feature/docs-terminal-flush. The feature tree and
original source branch remain unchanged. Upstream work retains its own
completion requirements.

#61
Integrate the reviewed prepared history into feature/docs-terminal-flush. The feature tree and
original source branch remain unchanged. Upstream work retains its own
completion requirements.

#62
Integrate the reviewed prepared history into feature/docs-terminal-flush. The feature tree and
original source branch remain unchanged. Upstream work retains its own
completion requirements.

#63
Integrate the reviewed prepared history into feature/docs-terminal-flush. The feature tree and
original source branch remain unchanged. Upstream work retains its own
completion requirements.

#64
Integrate the reviewed prepared history into feature/docs-terminal-flush. The feature tree and
original source branch remain unchanged. Upstream work retains its own
completion requirements.

#65
Integrate the reviewed prepared history into feature/docs-terminal-flush. The feature tree and
original source branch remain unchanged. Upstream work retains its own
completion requirements.

#66
docs: Merge specify native terminal provisioning
All checks were successful
CI / markdown (push) Successful in 4s
CI / manual (push) Successful in 4m56s
3caea7da88
Integrate the reviewed prepared history into feature/docs-terminal-flush. The feature tree and
original source branch remain unchanged. Upstream work retains its own
completion requirements.

#67
docs: Merge retained terminal flush specification
All checks were successful
CI / manual (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 4s
CI / manual (push) Successful in 4m59s
513b4017f2
erikinkinen changed target branch from feature/docs-native-current-directory to feature/docs-native-filesystem-authority 2026-11-21 06:11:49 +01:00
erikinkinen manually merged commit ed3d2c07f5 into feature/docs-native-filesystem-authority 2026-11-21 06:11:50 +01:00
Sign in to join this conversation.
No description provided.