implements remain of capabilities
This commit is contained in:
@@ -88,9 +88,11 @@ Example:
|
||||
At cartridge load time:
|
||||
|
||||
1. The cartridge declares required syscalls using canonical identities.
|
||||
2. The host verifies capabilities.
|
||||
3. The host resolves each canonical identity to a numeric `syscall_id`.
|
||||
4. The VM stores the resolved table for fast execution.
|
||||
2. The cartridge bytecode encodes host-backed call sites as `HOSTCALL <sysc_index>` into that declaration table.
|
||||
3. The host verifies capabilities from the cartridge manifest before execution begins.
|
||||
4. The host resolves each canonical identity to a numeric `syscall_id`.
|
||||
5. The loader rewrites every `HOSTCALL <sysc_index>` into `SYSCALL <id>`.
|
||||
6. The VM stores the patched executable image for fast execution.
|
||||
|
||||
At runtime, the VM executes:
|
||||
|
||||
@@ -99,12 +101,21 @@ SYSCALL <id>
|
||||
```
|
||||
|
||||
Only numeric IDs are used during execution.
|
||||
Raw `SYSCALL <id>` is not valid in a PBX pre-load artifact and must be rejected by the loader.
|
||||
|
||||
---
|
||||
|
||||
## 4 Syscall Instruction Semantics
|
||||
|
||||
The VM provides a single instruction:
|
||||
The VM provides two relevant instruction forms across the load pipeline:
|
||||
|
||||
Pre-load PBX artifact:
|
||||
|
||||
```
|
||||
HOSTCALL <sysc_index>
|
||||
```
|
||||
|
||||
Final executable image:
|
||||
|
||||
```
|
||||
SYSCALL <id>
|
||||
@@ -112,13 +123,14 @@ SYSCALL <id>
|
||||
|
||||
Where:
|
||||
|
||||
* `<sysc_index>` is an index into the program-declared syscall table.
|
||||
* `<id>` is a 32-bit integer identifying the syscall.
|
||||
|
||||
Execution steps:
|
||||
|
||||
1. The VM looks up syscall metadata using `<id>`.
|
||||
2. The VM verifies that enough arguments exist on the stack.
|
||||
3. The VM checks capability requirements.
|
||||
3. The VM checks capability requirements defensively.
|
||||
4. The syscall executes in the host environment.
|
||||
5. The syscall leaves exactly `ret_slots` values on the stack.
|
||||
|
||||
@@ -160,7 +172,7 @@ Fields:
|
||||
| `may_allocate` | Whether the syscall may allocate VM heap objects |
|
||||
| `cost_hint` | Expected cycle cost |
|
||||
|
||||
The verifier uses this table to validate stack effects.
|
||||
The loader uses this table to resolve canonical identities, validate declared ABI shape, and enforce capability gating. The verifier uses the final numeric metadata to validate stack effects after patching.
|
||||
|
||||
---
|
||||
|
||||
@@ -369,4 +381,4 @@ status, progress = asset.status(id)
|
||||
|
||||
|
||||
|
||||
< [Back](chapter-15.md) | [Summary](table-of-contents.md) >
|
||||
< [Back](chapter-15.md) | [Summary](table-of-contents.md) >
|
||||
|
||||
Reference in New Issue
Block a user