feat(diagnostics): preserve Registry and resource fault context for PLN-0176 step 28
This commit is contained in:
@@ -56,4 +56,6 @@ pub struct TrapInfo {
|
|||||||
pub pc: u32,
|
pub pc: u32,
|
||||||
/// Optional source span information if debug symbols are available.
|
/// Optional source span information if debug symbols are available.
|
||||||
pub span: Option<SourceSpan>,
|
pub span: Option<SourceSpan>,
|
||||||
|
/// Machine-readable quota context; messages are not its serialization.
|
||||||
|
pub resource: Option<crate::ResourceFailure>,
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -8,6 +8,7 @@ pub mod model;
|
|||||||
mod opcode;
|
mod opcode;
|
||||||
mod opcode_spec;
|
mod opcode_spec;
|
||||||
mod program_image;
|
mod program_image;
|
||||||
|
mod resource_failure;
|
||||||
mod value;
|
mod value;
|
||||||
|
|
||||||
pub use abi::{
|
pub use abi::{
|
||||||
@@ -22,6 +23,7 @@ pub use disassembler::disassemble;
|
|||||||
pub use layout::{compute_function_layouts, FunctionLayout};
|
pub use layout::{compute_function_layouts, FunctionLayout};
|
||||||
pub use model::{BytecodeLoader, FunctionMeta, LoadError, SyscallDecl, PBX_MAGIC};
|
pub use model::{BytecodeLoader, FunctionMeta, LoadError, SyscallDecl, PBX_MAGIC};
|
||||||
pub use program_image::ProgramImage;
|
pub use program_image::ProgramImage;
|
||||||
|
pub use resource_failure::{ResourceFailure, ResourceReason, RuntimeResource};
|
||||||
pub use value::{string_materialization_count, HeapRef, Value};
|
pub use value::{string_materialization_count, HeapRef, Value};
|
||||||
|
|
||||||
pub mod load_limits;
|
pub mod load_limits;
|
||||||
|
|||||||
@@ -1,17 +1,25 @@
|
|||||||
//! Shared PBX v1 resource limits and structured validation failures.
|
//! Shared PBX v1 resource limits and structured validation failures.
|
||||||
//! Counters are deterministic; a failed reservation never changes usage.
|
//! Counters are deterministic; a failed reservation never changes usage.
|
||||||
|
use serde::{Deserialize, Serialize};
|
||||||
use std::fmt;
|
use std::fmt;
|
||||||
|
|
||||||
const MIB: u64 = 1_048_576;
|
const MIB: u64 = 1_048_576;
|
||||||
|
|
||||||
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
|
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
|
||||||
pub enum LoadCode {
|
pub enum LoadCode {
|
||||||
|
#[serde(rename = "LOAD_INVALID_FORMAT")]
|
||||||
InvalidFormat,
|
InvalidFormat,
|
||||||
|
#[serde(rename = "LOAD_UNSUPPORTED_FORMAT")]
|
||||||
UnsupportedFormat,
|
UnsupportedFormat,
|
||||||
|
#[serde(rename = "LOAD_INVALID_REFERENCE")]
|
||||||
InvalidReference,
|
InvalidReference,
|
||||||
|
#[serde(rename = "LOAD_INVALID_REGISTRY")]
|
||||||
InvalidRegistry,
|
InvalidRegistry,
|
||||||
|
#[serde(rename = "LOAD_INVALID_CODE")]
|
||||||
InvalidCode,
|
InvalidCode,
|
||||||
|
#[serde(rename = "LOAD_RESOURCE_LIMIT")]
|
||||||
ResourceLimit,
|
ResourceLimit,
|
||||||
|
#[serde(rename = "LOAD_INVALID_ENTRYPOINT")]
|
||||||
InvalidEntrypoint,
|
InvalidEntrypoint,
|
||||||
}
|
}
|
||||||
impl LoadCode {
|
impl LoadCode {
|
||||||
@@ -27,7 +35,7 @@ impl LoadCode {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
|
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
|
||||||
pub enum LoadReason {
|
pub enum LoadReason {
|
||||||
Magic,
|
Magic,
|
||||||
Version,
|
Version,
|
||||||
@@ -80,7 +88,7 @@ pub enum LoadReason {
|
|||||||
InvalidYield,
|
InvalidYield,
|
||||||
TypeMismatch,
|
TypeMismatch,
|
||||||
}
|
}
|
||||||
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
|
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
|
||||||
#[repr(usize)]
|
#[repr(usize)]
|
||||||
pub enum LoadResource {
|
pub enum LoadResource {
|
||||||
PbxBytes,
|
PbxBytes,
|
||||||
@@ -98,14 +106,14 @@ pub enum LoadResource {
|
|||||||
}
|
}
|
||||||
const RESOURCE_COUNT: usize = 12;
|
const RESOURCE_COUNT: usize = 12;
|
||||||
|
|
||||||
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
|
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
|
||||||
pub enum IdDomain {
|
pub enum IdDomain {
|
||||||
Type,
|
Type,
|
||||||
Function,
|
Function,
|
||||||
Implementation,
|
Implementation,
|
||||||
}
|
}
|
||||||
|
|
||||||
#[derive(Debug, Clone, PartialEq, Eq)]
|
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
|
||||||
pub struct LoadFailure {
|
pub struct LoadFailure {
|
||||||
pub code: LoadCode,
|
pub code: LoadCode,
|
||||||
pub reason: LoadReason,
|
pub reason: LoadReason,
|
||||||
|
|||||||
@@ -50,7 +50,7 @@ impl ProgramImage {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
TrapInfo { code, opcode, message, pc, span }
|
TrapInfo { code, opcode, message, pc, span, resource: None }
|
||||||
}
|
}
|
||||||
|
|
||||||
pub fn find_function_index(&self, pc: u32) -> Option<usize> {
|
pub fn find_function_index(&self, pc: u32) -> Option<usize> {
|
||||||
|
|||||||
@@ -0,0 +1,40 @@
|
|||||||
|
//! Resource fault context shared by the VM, native boundary and host tooling.
|
||||||
|
//! Accounting and product ceilings remain owned by the runtime budget.
|
||||||
|
use serde::{Deserialize, Serialize};
|
||||||
|
use std::fmt;
|
||||||
|
|
||||||
|
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
|
||||||
|
#[repr(usize)]
|
||||||
|
pub enum RuntimeResource {
|
||||||
|
GuestBytes,
|
||||||
|
HandleSlots,
|
||||||
|
AuxiliaryBytes,
|
||||||
|
TemporaryBytes,
|
||||||
|
StringBytes,
|
||||||
|
StringAllocations,
|
||||||
|
IndividualStringBytes,
|
||||||
|
CallDepth,
|
||||||
|
}
|
||||||
|
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
|
||||||
|
pub enum ResourceReason {
|
||||||
|
Limit,
|
||||||
|
SizeOverflow,
|
||||||
|
AllocationFailed,
|
||||||
|
}
|
||||||
|
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
|
||||||
|
pub struct ResourceFailure {
|
||||||
|
pub resource: RuntimeResource,
|
||||||
|
pub reason: ResourceReason,
|
||||||
|
pub requested: u64,
|
||||||
|
pub limit: u64,
|
||||||
|
}
|
||||||
|
impl fmt::Display for ResourceFailure {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
|
||||||
|
write!(
|
||||||
|
f,
|
||||||
|
"{:?}: {:?}, requested {}, limit {}",
|
||||||
|
self.resource, self.reason, self.requested, self.limit
|
||||||
|
)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
impl std::error::Error for ResourceFailure {}
|
||||||
@@ -55,6 +55,7 @@ mod tests {
|
|||||||
message: "type mismatch".into(),
|
message: "type mismatch".into(),
|
||||||
pc: 0x44,
|
pc: 0x44,
|
||||||
span: None,
|
span: None,
|
||||||
|
resource: None,
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
};
|
};
|
||||||
|
|||||||
@@ -79,6 +79,9 @@ pub enum DebugEvent {
|
|||||||
pc: Option<u32>,
|
pc: Option<u32>,
|
||||||
trap_code: Option<u32>,
|
trap_code: Option<u32>,
|
||||||
opcode: Option<u16>,
|
opcode: Option<u16>,
|
||||||
|
span: Option<prometeu_bytecode::SourceSpan>,
|
||||||
|
resource: Option<prometeu_bytecode::ResourceFailure>,
|
||||||
|
init: Option<serde_json::Value>,
|
||||||
},
|
},
|
||||||
#[serde(rename = "cert")]
|
#[serde(rename = "cert")]
|
||||||
Cert { rule: String, used: u64, limit: u64, frame_index: u64 },
|
Cert { rule: String, used: u64, limit: u64, frame_index: u64 },
|
||||||
@@ -138,6 +141,9 @@ mod tests {
|
|||||||
pc: Some(12),
|
pc: Some(12),
|
||||||
trap_code: Some(4),
|
trap_code: Some(4),
|
||||||
opcode: Some(0x70),
|
opcode: Some(0x70),
|
||||||
|
span: None,
|
||||||
|
resource: None,
|
||||||
|
init: None,
|
||||||
};
|
};
|
||||||
|
|
||||||
let json = serde_json::to_string(&event).unwrap();
|
let json = serde_json::to_string(&event).unwrap();
|
||||||
|
|||||||
@@ -5,6 +5,7 @@ use std::sync::Arc;
|
|||||||
/// Native producers describe their output before materializing guest content.
|
/// Native producers describe their output before materializing guest content.
|
||||||
/// The VM provides the session allocator; HAL does not own guest quotas.
|
/// The VM provides the session allocator; HAL does not own guest quotas.
|
||||||
pub trait GuestStringAllocator {
|
pub trait GuestStringAllocator {
|
||||||
|
fn byte_limit(&self) -> u64;
|
||||||
fn build(
|
fn build(
|
||||||
&mut self,
|
&mut self,
|
||||||
length: usize,
|
length: usize,
|
||||||
@@ -23,6 +24,16 @@ pub struct HostReturn<'a> {
|
|||||||
}
|
}
|
||||||
|
|
||||||
impl<'a> HostReturn<'a> {
|
impl<'a> HostReturn<'a> {
|
||||||
|
fn size_overflow(&mut self) -> VmFault {
|
||||||
|
let error = VmFault::ResourceLimit(prometeu_bytecode::ResourceFailure {
|
||||||
|
resource: prometeu_bytecode::RuntimeResource::StringBytes,
|
||||||
|
reason: prometeu_bytecode::ResourceReason::SizeOverflow,
|
||||||
|
requested: u64::MAX,
|
||||||
|
limit: self.strings.byte_limit(),
|
||||||
|
});
|
||||||
|
self.failure = Some(error.clone());
|
||||||
|
error
|
||||||
|
}
|
||||||
pub fn new(
|
pub fn new(
|
||||||
stack: &'a mut Vec<Value>,
|
stack: &'a mut Vec<Value>,
|
||||||
result_slots: usize,
|
result_slots: usize,
|
||||||
@@ -97,14 +108,14 @@ impl<'a> HostReturn<'a> {
|
|||||||
length = length.checked_add(part.len()).ok_or(std::fmt::Error)?;
|
length = length.checked_add(part.len()).ok_or(std::fmt::Error)?;
|
||||||
Ok(())
|
Ok(())
|
||||||
})
|
})
|
||||||
.map_err(|_| size_overflow())?;
|
.map_err(|_| self.size_overflow())?;
|
||||||
self.push_string_with_len(length, &mut |writer| {
|
self.push_string_with_len(length, &mut |writer| {
|
||||||
lossy_chunks(bytes, &mut |part| writer.write_str(part))
|
lossy_chunks(bytes, &mut |part| writer.write_str(part))
|
||||||
})
|
})
|
||||||
}
|
}
|
||||||
pub fn push_hex(&mut self, bytes: &[u8]) -> Result<(), VmFault> {
|
pub fn push_hex(&mut self, bytes: &[u8]) -> Result<(), VmFault> {
|
||||||
const HEX: &[u8; 16] = b"0123456789abcdef";
|
const HEX: &[u8; 16] = b"0123456789abcdef";
|
||||||
let length = bytes.len().checked_mul(2).ok_or_else(size_overflow)?;
|
let length = bytes.len().checked_mul(2).ok_or_else(|| self.size_overflow())?;
|
||||||
self.push_string_with_len(length, &mut |writer| {
|
self.push_string_with_len(length, &mut |writer| {
|
||||||
for &byte in bytes {
|
for &byte in bytes {
|
||||||
let pair = [HEX[(byte >> 4) as usize], HEX[(byte & 15) as usize]];
|
let pair = [HEX[(byte >> 4) as usize], HEX[(byte & 15) as usize]];
|
||||||
@@ -121,9 +132,9 @@ impl<'a> HostReturn<'a> {
|
|||||||
let mut length = 0usize;
|
let mut length = 0usize;
|
||||||
for (index, part) in parts.clone().enumerate() {
|
for (index, part) in parts.clone().enumerate() {
|
||||||
if index > 0 {
|
if index > 0 {
|
||||||
length = length.checked_add(separator.len()).ok_or_else(size_overflow)?;
|
length = length.checked_add(separator.len()).ok_or_else(|| self.size_overflow())?;
|
||||||
}
|
}
|
||||||
length = length.checked_add(part.len()).ok_or_else(size_overflow)?;
|
length = length.checked_add(part.len()).ok_or_else(|| self.size_overflow())?;
|
||||||
}
|
}
|
||||||
self.push_string_with_len(length, &mut |writer| {
|
self.push_string_with_len(length, &mut |writer| {
|
||||||
for (index, part) in parts.clone().enumerate() {
|
for (index, part) in parts.clone().enumerate() {
|
||||||
@@ -137,9 +148,6 @@ impl<'a> HostReturn<'a> {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
fn size_overflow() -> VmFault {
|
|
||||||
VmFault::Trap(prometeu_bytecode::TRAP_RESOURCE_LIMIT, "Native string length overflow".into())
|
|
||||||
}
|
|
||||||
fn lossy_chunks(
|
fn lossy_chunks(
|
||||||
mut bytes: &[u8],
|
mut bytes: &[u8],
|
||||||
emit: &mut dyn FnMut(&str) -> std::fmt::Result,
|
emit: &mut dyn FnMut(&str) -> std::fmt::Result,
|
||||||
@@ -169,6 +177,9 @@ mod tests {
|
|||||||
use super::*;
|
use super::*;
|
||||||
struct RejectStrings;
|
struct RejectStrings;
|
||||||
impl GuestStringAllocator for RejectStrings {
|
impl GuestStringAllocator for RejectStrings {
|
||||||
|
fn byte_limit(&self) -> u64 {
|
||||||
|
0
|
||||||
|
}
|
||||||
fn build(
|
fn build(
|
||||||
&mut self,
|
&mut self,
|
||||||
_length: usize,
|
_length: usize,
|
||||||
@@ -198,6 +209,9 @@ mod tests {
|
|||||||
|
|
||||||
struct Collect;
|
struct Collect;
|
||||||
impl GuestStringAllocator for Collect {
|
impl GuestStringAllocator for Collect {
|
||||||
|
fn byte_limit(&self) -> u64 {
|
||||||
|
u64::MAX
|
||||||
|
}
|
||||||
fn build(
|
fn build(
|
||||||
&mut self,
|
&mut self,
|
||||||
length: usize,
|
length: usize,
|
||||||
|
|||||||
@@ -39,7 +39,8 @@ pub enum LoadError {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/// Load-time error for PBX-declared syscall resolution.
|
/// Load-time error for PBX-declared syscall resolution.
|
||||||
#[derive(Debug, Clone, PartialEq, Eq)]
|
#[derive(Debug, Clone, PartialEq, Eq, serde::Serialize, serde::Deserialize)]
|
||||||
|
#[serde(tag = "reason", rename_all = "snake_case")]
|
||||||
pub enum DeclaredLoadError {
|
pub enum DeclaredLoadError {
|
||||||
UnknownSyscall {
|
UnknownSyscall {
|
||||||
module: String,
|
module: String,
|
||||||
|
|||||||
@@ -1,6 +1,7 @@
|
|||||||
#[derive(Debug, PartialEq, Clone)]
|
#[derive(Debug, PartialEq, Clone)]
|
||||||
pub enum VmFault {
|
pub enum VmFault {
|
||||||
Trap(u32, String),
|
Trap(u32, String),
|
||||||
|
ResourceLimit(prometeu_bytecode::ResourceFailure),
|
||||||
Panic(String),
|
Panic(String),
|
||||||
Unavailable,
|
Unavailable,
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,6 +1,7 @@
|
|||||||
use prometeu_bytecode::TrapInfo;
|
use prometeu_bytecode::TrapInfo;
|
||||||
use prometeu_vm::VmInitError;
|
use prometeu_vm::VmInitError;
|
||||||
use std::fmt;
|
use std::fmt;
|
||||||
|
mod init_diagnostic;
|
||||||
|
|
||||||
#[derive(Debug, Clone, PartialEq, Eq)]
|
#[derive(Debug, Clone, PartialEq, Eq)]
|
||||||
pub enum CrashReport {
|
pub enum CrashReport {
|
||||||
@@ -10,6 +11,20 @@ pub enum CrashReport {
|
|||||||
}
|
}
|
||||||
|
|
||||||
impl CrashReport {
|
impl CrashReport {
|
||||||
|
/// The same machine fields serve headless and desktop transports.
|
||||||
|
pub fn init_diagnostic(&self) -> Option<serde_json::Value> {
|
||||||
|
match self {
|
||||||
|
Self::VmInit { error } => Some(init_diagnostic::serialize(error)),
|
||||||
|
_ => None,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
pub fn resource_failure(&self) -> Option<prometeu_bytecode::ResourceFailure> {
|
||||||
|
match self {
|
||||||
|
Self::VmTrap { trap } => trap.resource,
|
||||||
|
Self::VmInit { error: VmInitError::RuntimeResourceLimit(resource) } => Some(*resource),
|
||||||
|
_ => None,
|
||||||
|
}
|
||||||
|
}
|
||||||
pub fn kind(&self) -> &'static str {
|
pub fn kind(&self) -> &'static str {
|
||||||
match self {
|
match self {
|
||||||
Self::VmTrap { .. } => "vm_trap",
|
Self::VmTrap { .. } => "vm_trap",
|
||||||
|
|||||||
@@ -0,0 +1,132 @@
|
|||||||
|
use prometeu_vm::VmInitError;
|
||||||
|
use serde_json::{Value, json};
|
||||||
|
|
||||||
|
pub(super) fn serialize(error: &VmInitError) -> Value {
|
||||||
|
let code = match error {
|
||||||
|
VmInitError::RegistryLoadFailed(_) => "registry_load_failed",
|
||||||
|
VmInitError::RuntimeResourceLimit(_) => "runtime_resource_limit",
|
||||||
|
VmInitError::InvalidFormat => "invalid_format",
|
||||||
|
VmInitError::UnsupportedFormat => "unsupported_format",
|
||||||
|
VmInitError::ImageLoadFailed(_) => "image_load_failed",
|
||||||
|
VmInitError::LoaderPatchFailed(_) => "loader_patch_failed",
|
||||||
|
VmInitError::EntrypointNotFound => "entrypoint_not_found",
|
||||||
|
VmInitError::EntrypointArgumentsInvalid { .. } => "entrypoint_arguments_invalid",
|
||||||
|
VmInitError::VerificationFailed(_) => "verification_failed",
|
||||||
|
};
|
||||||
|
let mut result = json!({"code":code,"message":format!("{error:?}")});
|
||||||
|
match error {
|
||||||
|
VmInitError::RegistryLoadFailed(load) => {
|
||||||
|
result["load"] = json!(load);
|
||||||
|
result["load"]["code"] = json!(load.code.tag());
|
||||||
|
}
|
||||||
|
VmInitError::RuntimeResourceLimit(resource) => result["resource"] = json!(resource),
|
||||||
|
VmInitError::EntrypointArgumentsInvalid { function, slot, trap_code } => {
|
||||||
|
result["entry"] = json!({"function":function,"slot":slot,"trapCode":trap_code});
|
||||||
|
}
|
||||||
|
VmInitError::LoaderPatchFailed(patch) => {
|
||||||
|
use prometeu_vm::LoaderPatchError as P;
|
||||||
|
result["binding"] = match patch {
|
||||||
|
P::ResolveFailed(native) => json!(native),
|
||||||
|
P::HostcallIndexOutOfBounds { pc, sysc_index, syscalls_len } => {
|
||||||
|
json!({"reason":"hostcall_index_out_of_bounds","pc":pc,"syscallIndex":sysc_index,"syscallsLength":syscalls_len})
|
||||||
|
}
|
||||||
|
P::RawSyscallInPreloadArtifact { pc, syscall_id } => {
|
||||||
|
json!({"reason":"raw_syscall","pc":pc,"syscallId":syscall_id})
|
||||||
|
}
|
||||||
|
P::UnusedSyscallDecl { sysc_index, module, name, version } => {
|
||||||
|
json!({"reason":"unused_syscall","syscallIndex":sysc_index,"module":module,"name":name,"version":version})
|
||||||
|
}
|
||||||
|
P::HostcallRemaining { pc, sysc_index } => {
|
||||||
|
json!({"reason":"hostcall_remaining","pc":pc,"syscallIndex":sysc_index})
|
||||||
|
}
|
||||||
|
P::DecodeFailed(_) => json!({"reason":"decode_failed"}),
|
||||||
|
};
|
||||||
|
}
|
||||||
|
_ => {}
|
||||||
|
}
|
||||||
|
result
|
||||||
|
}
|
||||||
|
|
||||||
|
#[cfg(test)]
|
||||||
|
mod tests {
|
||||||
|
use super::*;
|
||||||
|
use crate::CrashReport;
|
||||||
|
use prometeu_bytecode::{
|
||||||
|
ResourceFailure, ResourceReason, RuntimeResource,
|
||||||
|
load_limits::{IdDomain, LoadCode, LoadFailure, LoadReason},
|
||||||
|
};
|
||||||
|
#[test]
|
||||||
|
fn load_tag_and_reference_context_survive_without_fabricating_runtime_pc() {
|
||||||
|
let error = LoadFailure::new(LoadCode::InvalidReference, LoadReason::TypeId)
|
||||||
|
.at(6, 159)
|
||||||
|
.record(4)
|
||||||
|
.member(2)
|
||||||
|
.reference(IdDomain::Type, 77)
|
||||||
|
.in_function(3, Some(18));
|
||||||
|
let report = CrashReport::VmInit { error: VmInitError::RegistryLoadFailed(error) };
|
||||||
|
assert_eq!(report.pc(), None);
|
||||||
|
let wire = report.init_diagnostic().unwrap();
|
||||||
|
assert_eq!(wire["code"], "registry_load_failed");
|
||||||
|
assert_eq!(wire["load"]["code"], "LOAD_INVALID_REFERENCE");
|
||||||
|
for (field, value) in [
|
||||||
|
("section", 6),
|
||||||
|
("offset", 159),
|
||||||
|
("record", 4),
|
||||||
|
("member", 2),
|
||||||
|
("referenced_id", 77),
|
||||||
|
("function", 3),
|
||||||
|
("pc", 18),
|
||||||
|
] {
|
||||||
|
assert_eq!(wire["load"][field], value);
|
||||||
|
}
|
||||||
|
assert_eq!(wire["load"]["id_domain"], "Type");
|
||||||
|
assert_eq!(wire["load"]["reason"], "TypeId");
|
||||||
|
}
|
||||||
|
#[test]
|
||||||
|
fn native_abi_and_resource_context_are_machine_fields() {
|
||||||
|
let native = prometeu_hal::syscalls::DeclaredLoadError::AbiMismatch {
|
||||||
|
module: "system".into(),
|
||||||
|
name: "has_cart".into(),
|
||||||
|
version: 1,
|
||||||
|
declared_arg_slots: 0,
|
||||||
|
declared_ret_slots: 2,
|
||||||
|
expected_arg_slots: 0,
|
||||||
|
expected_ret_slots: 1,
|
||||||
|
};
|
||||||
|
let wire = serialize(&VmInitError::LoaderPatchFailed(
|
||||||
|
prometeu_vm::LoaderPatchError::ResolveFailed(native),
|
||||||
|
));
|
||||||
|
assert_eq!(wire["binding"]["reason"], "abi_mismatch");
|
||||||
|
assert_eq!(wire["binding"]["module"], "system");
|
||||||
|
assert_eq!(wire["binding"]["declared_ret_slots"], 2);
|
||||||
|
assert_eq!(wire["binding"]["expected_ret_slots"], 1);
|
||||||
|
let resource = ResourceFailure {
|
||||||
|
resource: RuntimeResource::CallDepth,
|
||||||
|
reason: ResourceReason::Limit,
|
||||||
|
requested: 3,
|
||||||
|
limit: 2,
|
||||||
|
};
|
||||||
|
let report = CrashReport::VmInit { error: VmInitError::RuntimeResourceLimit(resource) };
|
||||||
|
assert_eq!(report.resource_failure(), Some(resource));
|
||||||
|
let wire = report.init_diagnostic().unwrap();
|
||||||
|
assert_eq!(wire["resource"]["resource"], "CallDepth");
|
||||||
|
assert_eq!(wire["resource"]["reason"], "Limit");
|
||||||
|
assert_eq!(wire["resource"]["requested"], 3);
|
||||||
|
assert_eq!(wire["resource"]["limit"], 2);
|
||||||
|
}
|
||||||
|
#[test]
|
||||||
|
fn all_load_codes_serialize_to_the_normative_tags() {
|
||||||
|
for code in [
|
||||||
|
LoadCode::InvalidFormat,
|
||||||
|
LoadCode::UnsupportedFormat,
|
||||||
|
LoadCode::InvalidReference,
|
||||||
|
LoadCode::InvalidRegistry,
|
||||||
|
LoadCode::InvalidCode,
|
||||||
|
LoadCode::ResourceLimit,
|
||||||
|
LoadCode::InvalidEntrypoint,
|
||||||
|
] {
|
||||||
|
assert_eq!(json!(code), code.tag());
|
||||||
|
assert_eq!(serde_json::from_value::<LoadCode>(json!(code)).unwrap(), code);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -30,6 +30,7 @@ pub fn check_local_slot(
|
|||||||
message: format!("Local slot {} out of bounds for function (limit {})", slot, limit),
|
message: format!("Local slot {} out of bounds for function (limit {})", slot, limit),
|
||||||
pc,
|
pc,
|
||||||
span: None,
|
span: None,
|
||||||
|
resource: None,
|
||||||
})
|
})
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,21 +1,9 @@
|
|||||||
//! Session accounting shared by owners, with reservations refunded on failure/drop.
|
//! Session accounting shared by owners, with reservations refunded on failure/drop.
|
||||||
//! These quotas account VM domains, not process RSS or allocator metadata.
|
//! These quotas account VM domains, not process RSS or allocator metadata.
|
||||||
use std::collections::VecDeque;
|
use std::collections::VecDeque;
|
||||||
use std::fmt;
|
|
||||||
use std::sync::{Arc, Mutex, MutexGuard};
|
use std::sync::{Arc, Mutex, MutexGuard};
|
||||||
|
|
||||||
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
|
pub use prometeu_bytecode::{ResourceFailure, ResourceReason, RuntimeResource};
|
||||||
#[repr(usize)]
|
|
||||||
pub enum RuntimeResource {
|
|
||||||
GuestBytes,
|
|
||||||
HandleSlots,
|
|
||||||
AuxiliaryBytes,
|
|
||||||
TemporaryBytes,
|
|
||||||
StringBytes,
|
|
||||||
StringAllocations,
|
|
||||||
IndividualStringBytes,
|
|
||||||
CallDepth,
|
|
||||||
}
|
|
||||||
const COUNT: usize = 8;
|
const COUNT: usize = 8;
|
||||||
const MIB: u64 = 1_048_576;
|
const MIB: u64 = 1_048_576;
|
||||||
const CEILINGS: [u64; COUNT] =
|
const CEILINGS: [u64; COUNT] =
|
||||||
@@ -51,30 +39,6 @@ impl RuntimeLimits {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
|
|
||||||
pub enum ResourceReason {
|
|
||||||
Limit,
|
|
||||||
SizeOverflow,
|
|
||||||
AllocationFailed,
|
|
||||||
}
|
|
||||||
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
|
|
||||||
pub struct ResourceFailure {
|
|
||||||
pub resource: RuntimeResource,
|
|
||||||
pub reason: ResourceReason,
|
|
||||||
pub requested: u64,
|
|
||||||
pub limit: u64,
|
|
||||||
}
|
|
||||||
impl fmt::Display for ResourceFailure {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
|
|
||||||
write!(
|
|
||||||
f,
|
|
||||||
"{:?}: {:?}, requested {}, limit {}",
|
|
||||||
self.resource, self.reason, self.requested, self.limit
|
|
||||||
)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl std::error::Error for ResourceFailure {}
|
|
||||||
|
|
||||||
#[derive(Debug)]
|
#[derive(Debug)]
|
||||||
struct State {
|
struct State {
|
||||||
limits: RuntimeLimits,
|
limits: RuntimeLimits,
|
||||||
|
|||||||
@@ -1264,6 +1264,9 @@ impl VirtualMachine {
|
|||||||
self.operand_stack.truncate(stack_height_before);
|
self.operand_stack.truncate(stack_height_before);
|
||||||
}
|
}
|
||||||
native_result.map_err(|fault| match fault {
|
native_result.map_err(|fault| match fault {
|
||||||
|
VmFault::ResourceLimit(resource) => {
|
||||||
|
self.resource_trap(resource, opcode, pc_at_syscall)
|
||||||
|
}
|
||||||
VmFault::Trap(code, msg) => {
|
VmFault::Trap(code, msg) => {
|
||||||
self.trap(code, OpCode::Syscall as u16, msg, pc_at_syscall)
|
self.trap(code, OpCode::Syscall as u16, msg, pc_at_syscall)
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -18,7 +18,10 @@ impl VirtualMachine {
|
|||||||
opcode: OpCode,
|
opcode: OpCode,
|
||||||
pc: u32,
|
pc: u32,
|
||||||
) -> LogicalFrameEndingReason {
|
) -> LogicalFrameEndingReason {
|
||||||
self.trap(TRAP_RESOURCE_LIMIT, opcode as u16, error.to_string(), pc)
|
let mut trap =
|
||||||
|
self.program.create_trap(TRAP_RESOURCE_LIMIT, opcode as u16, error.to_string(), pc);
|
||||||
|
trap.resource = Some(error);
|
||||||
|
LogicalFrameEndingReason::Trap(trap)
|
||||||
}
|
}
|
||||||
|
|
||||||
pub fn trap(
|
pub fn trap(
|
||||||
|
|||||||
@@ -7,6 +7,9 @@ pub(super) struct SessionStringAllocator<'a> {
|
|||||||
pub budget: RuntimeBudget,
|
pub budget: RuntimeBudget,
|
||||||
}
|
}
|
||||||
impl prometeu_hal::host_return::GuestStringAllocator for SessionStringAllocator<'_> {
|
impl prometeu_hal::host_return::GuestStringAllocator for SessionStringAllocator<'_> {
|
||||||
|
fn byte_limit(&self) -> u64 {
|
||||||
|
self.budget.limit(RuntimeResource::StringBytes)
|
||||||
|
}
|
||||||
fn build(
|
fn build(
|
||||||
&mut self,
|
&mut self,
|
||||||
length: usize,
|
length: usize,
|
||||||
@@ -24,7 +27,7 @@ impl prometeu_hal::host_return::GuestStringAllocator for SessionStringAllocator<
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
fn resource_fault(resource: ResourceFailure) -> VmFault {
|
fn resource_fault(resource: ResourceFailure) -> VmFault {
|
||||||
VmFault::Trap(TRAP_RESOURCE_LIMIT, resource.to_string())
|
VmFault::ResourceLimit(resource)
|
||||||
}
|
}
|
||||||
|
|
||||||
impl VirtualMachine {
|
impl VirtualMachine {
|
||||||
|
|||||||
@@ -527,7 +527,7 @@ fn native_string_failures_cannot_publish_partial_results_even_if_handler_ignores
|
|||||||
// This synthetic native implementation tests the bounded writer, not the
|
// This synthetic native implementation tests the bounded writer, not the
|
||||||
// has-cart handler's ordinary Boolean semantic contract.
|
// has-cart handler's ordinary Boolean semantic contract.
|
||||||
assert!(
|
assert!(
|
||||||
matches!(report.reason,LogicalFrameEndingReason::Trap(info) if info.code==TRAP_RESOURCE_LIMIT && info.pc==0)
|
matches!(report.reason,LogicalFrameEndingReason::Trap(info) if info.code==TRAP_RESOURCE_LIMIT && info.pc==0 && info.resource.is_some_and(|resource|resource.resource==RuntimeResource::StringBytes && resource.requested==3 && resource.limit==2))
|
||||||
);
|
);
|
||||||
assert!(vm.operand_stack.is_empty());
|
assert!(vm.operand_stack.is_empty());
|
||||||
assert_eq!(vm.budget.used(RuntimeResource::StringBytes), 0);
|
assert_eq!(vm.budget.used(RuntimeResource::StringBytes), 0);
|
||||||
|
|||||||
@@ -379,6 +379,10 @@ impl HostDebugger {
|
|||||||
CrashReport::VmTrap { trap } => (Some(trap.code), Some(trap.opcode)),
|
CrashReport::VmTrap { trap } => (Some(trap.code), Some(trap.opcode)),
|
||||||
CrashReport::VmPanic { .. } | CrashReport::VmInit { .. } => (None, None),
|
CrashReport::VmPanic { .. } | CrashReport::VmInit { .. } => (None, None),
|
||||||
};
|
};
|
||||||
|
let span = match report {
|
||||||
|
CrashReport::VmTrap { trap } => trap.span.clone(),
|
||||||
|
_ => None,
|
||||||
|
};
|
||||||
|
|
||||||
self.send_event(DebugEvent::Fault {
|
self.send_event(DebugEvent::Fault {
|
||||||
kind: report.kind().to_string(),
|
kind: report.kind().to_string(),
|
||||||
@@ -386,6 +390,9 @@ impl HostDebugger {
|
|||||||
pc: report.pc(),
|
pc: report.pc(),
|
||||||
trap_code,
|
trap_code,
|
||||||
opcode,
|
opcode,
|
||||||
|
span,
|
||||||
|
resource: report.resource_failure(),
|
||||||
|
init: report.init_diagnostic(),
|
||||||
});
|
});
|
||||||
self.last_fault_summary = Some(summary);
|
self.last_fault_summary = Some(summary);
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -2,10 +2,11 @@ use base64::{Engine as _, engine::general_purpose::STANDARD};
|
|||||||
use prometeu_bytecode::Value as VmValue;
|
use prometeu_bytecode::Value as VmValue;
|
||||||
use prometeu_hal::InputSignals;
|
use prometeu_hal::InputSignals;
|
||||||
use prometeu_system::CrashReport;
|
use prometeu_system::CrashReport;
|
||||||
use prometeu_vm::VmInitError;
|
|
||||||
use serde::{Deserialize, Serialize};
|
use serde::{Deserialize, Serialize};
|
||||||
use serde_json::{Value, json};
|
use serde_json::{Value, json};
|
||||||
use std::io;
|
use std::io;
|
||||||
|
#[cfg(test)]
|
||||||
|
mod fault_tests;
|
||||||
|
|
||||||
use crate::{CapturedFrame, HostError, HostExecutionStatus, HostState};
|
use crate::{CapturedFrame, HostError, HostExecutionStatus, HostState};
|
||||||
|
|
||||||
@@ -282,24 +283,13 @@ pub(super) fn fault(report: &CrashReport) -> Value {
|
|||||||
match report {
|
match report {
|
||||||
CrashReport::VmTrap { trap } => {
|
CrashReport::VmTrap { trap } => {
|
||||||
result["trap"] = json!({"code":trap.code,"opcode":trap.opcode,
|
result["trap"] = json!({"code":trap.code,"opcode":trap.opcode,
|
||||||
"message":trap.message,"pc":trap.pc,"span":trap.span});
|
"message":trap.message,"pc":trap.pc,"span":trap.span,"resource":trap.resource});
|
||||||
}
|
}
|
||||||
CrashReport::VmPanic { message, .. } => {
|
CrashReport::VmPanic { message, .. } => {
|
||||||
result["message"] = json!(message);
|
result["message"] = json!(message);
|
||||||
}
|
}
|
||||||
CrashReport::VmInit { error } => {
|
CrashReport::VmInit { .. } => {
|
||||||
let code = match error {
|
result["initError"] = report.init_diagnostic().expect("initialization report");
|
||||||
VmInitError::RegistryLoadFailed(_) => "registry_load_failed",
|
|
||||||
VmInitError::RuntimeResourceLimit(_) => "runtime_resource_limit",
|
|
||||||
VmInitError::InvalidFormat => "invalid_format",
|
|
||||||
VmInitError::UnsupportedFormat => "unsupported_format",
|
|
||||||
VmInitError::ImageLoadFailed(_) => "image_load_failed",
|
|
||||||
VmInitError::LoaderPatchFailed(_) => "loader_patch_failed",
|
|
||||||
VmInitError::EntrypointNotFound => "entrypoint_not_found",
|
|
||||||
VmInitError::EntrypointArgumentsInvalid { .. } => "entrypoint_arguments_invalid",
|
|
||||||
VmInitError::VerificationFailed(_) => "verification_failed",
|
|
||||||
};
|
|
||||||
result["initError"] = json!({"code":code,"message":format!("{error:?}")});
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
result
|
result
|
||||||
|
|||||||
@@ -0,0 +1,47 @@
|
|||||||
|
use super::*;
|
||||||
|
use prometeu_bytecode::{
|
||||||
|
ResourceFailure, ResourceReason, RuntimeResource, SourceSpan, TRAP_RESOURCE_LIMIT, TrapInfo,
|
||||||
|
};
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn resource_trap_wire_preserves_native_fields_and_source_span() {
|
||||||
|
let report = CrashReport::VmTrap {
|
||||||
|
trap: TrapInfo {
|
||||||
|
code: TRAP_RESOURCE_LIMIT,
|
||||||
|
opcode: 0x90,
|
||||||
|
pc: 18,
|
||||||
|
message: "localized human wording".into(),
|
||||||
|
span: Some(SourceSpan { file_id: 7, start: 4, end: 9 }),
|
||||||
|
resource: Some(ResourceFailure {
|
||||||
|
resource: RuntimeResource::HandleSlots,
|
||||||
|
reason: ResourceReason::Limit,
|
||||||
|
requested: 3,
|
||||||
|
limit: 2,
|
||||||
|
}),
|
||||||
|
},
|
||||||
|
};
|
||||||
|
let wire = fault(&report);
|
||||||
|
assert_eq!(wire["trap"]["code"], 0x10);
|
||||||
|
assert_eq!(wire["trap"]["opcode"], 0x90);
|
||||||
|
assert_eq!(wire["trap"]["pc"], 18);
|
||||||
|
assert_eq!(wire["trap"]["span"]["file_id"], 7);
|
||||||
|
assert_eq!(wire["trap"]["resource"]["resource"], "HandleSlots");
|
||||||
|
assert_eq!(wire["trap"]["resource"]["requested"], 3);
|
||||||
|
assert_eq!(wire["trap"]["resource"]["limit"], 2);
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn load_failure_wire_uses_shared_structured_serializer_and_no_runtime_pc() {
|
||||||
|
use prometeu_bytecode::load_limits::{LoadCode, LoadFailure, LoadReason, LoadResource};
|
||||||
|
let mut error = LoadFailure::resource(LoadResource::Work, 23, 22).in_function(1, Some(6));
|
||||||
|
error.code = LoadCode::ResourceLimit;
|
||||||
|
error.reason = LoadReason::Limit;
|
||||||
|
let report = CrashReport::VmInit { error: prometeu_vm::VmInitError::RegistryLoadFailed(error) };
|
||||||
|
let wire = fault(&report);
|
||||||
|
assert_eq!(wire["pc"], Value::Null);
|
||||||
|
assert_eq!(wire["initError"], report.init_diagnostic().unwrap());
|
||||||
|
assert_eq!(wire["initError"]["load"]["code"], "LOAD_RESOURCE_LIMIT");
|
||||||
|
assert_eq!(wire["initError"]["load"]["resource"], "Work");
|
||||||
|
assert_eq!(wire["initError"]["load"]["requested"], 23);
|
||||||
|
assert_eq!(wire["initError"]["load"]["limit"], 22);
|
||||||
|
}
|
||||||
@@ -0,0 +1,46 @@
|
|||||||
|
use serde_json::{Value, json};
|
||||||
|
|
||||||
|
fn schema() -> jsonschema::Validator {
|
||||||
|
let full: Value = serde_json::from_str(include_str!(
|
||||||
|
"../../../../devtools/headless-protocol/response.schema.json"
|
||||||
|
))
|
||||||
|
.unwrap();
|
||||||
|
jsonschema::validator_for(&json!({"$defs":full["$defs"],"$ref":"#/$defs/fault"})).unwrap()
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn published_schema_accepts_structured_resource_fields_and_rejects_unknown_or_negative_values() {
|
||||||
|
let schema = schema();
|
||||||
|
let valid = json!({"kind":"vm_trap","pc":18,"summary":"human wording","trap":{
|
||||||
|
"code":16,"opcode":144,"pc":18,"message":"unrelated localized text","span":{"file_id":7,"start":4,"end":9},
|
||||||
|
"resource":{"resource":"HandleSlots","reason":"Limit","requested":3,"limit":2}}});
|
||||||
|
schema.validate(&valid).unwrap();
|
||||||
|
for (field, value) in [
|
||||||
|
("resource", json!("Bogus")),
|
||||||
|
("requested", json!(-1)),
|
||||||
|
("reason", json!("arbitrary text")),
|
||||||
|
] {
|
||||||
|
let mut invalid = valid.clone();
|
||||||
|
invalid["trap"]["resource"][field] = value;
|
||||||
|
assert!(schema.validate(&invalid).is_err());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn published_load_schema_requires_tag_context_and_the_matching_init_payload() {
|
||||||
|
let schema = schema();
|
||||||
|
let valid = json!({"kind":"vm_init","pc":null,"summary":"human wording","initError":{
|
||||||
|
"code":"registry_load_failed","message":"unrelated human text","load":{
|
||||||
|
"code":"LOAD_INVALID_REFERENCE","reason":"TypeId","section":6,"offset":159,"record":4,"member":2,
|
||||||
|
"id_domain":"Type","referenced_id":77,"function":3,"pc":18,"resource":null,"requested":null,"limit":null}}});
|
||||||
|
schema.validate(&valid).unwrap();
|
||||||
|
let mut invalid = valid.clone();
|
||||||
|
invalid["initError"]["load"]["referenced_id"] = json!(4294967296u64);
|
||||||
|
assert!(schema.validate(&invalid).is_err());
|
||||||
|
let mut invalid = valid.clone();
|
||||||
|
invalid["initError"]["load"]["code"] = json!("InvalidReference");
|
||||||
|
assert!(schema.validate(&invalid).is_err());
|
||||||
|
let mut invalid = valid.clone();
|
||||||
|
invalid["initError"]["code"] = json!("invalid_format");
|
||||||
|
assert!(schema.validate(&invalid).is_err());
|
||||||
|
}
|
||||||
@@ -396,9 +396,23 @@
|
|||||||
"minimum": 0
|
"minimum": 0
|
||||||
},
|
},
|
||||||
"span": {
|
"span": {
|
||||||
"type": [
|
"anyOf": [
|
||||||
"object",
|
{
|
||||||
"null"
|
"$ref": "#/$defs/sourceSpan"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "null"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"resource": {
|
||||||
|
"anyOf": [
|
||||||
|
{
|
||||||
|
"$ref": "#/$defs/resourceFailure"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "null"
|
||||||
|
}
|
||||||
]
|
]
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
@@ -407,7 +421,8 @@
|
|||||||
"opcode",
|
"opcode",
|
||||||
"message",
|
"message",
|
||||||
"pc",
|
"pc",
|
||||||
"span"
|
"span",
|
||||||
|
"resource"
|
||||||
],
|
],
|
||||||
"additionalProperties": false
|
"additionalProperties": false
|
||||||
}
|
}
|
||||||
@@ -465,20 +480,191 @@
|
|||||||
"const": "vm_init"
|
"const": "vm_init"
|
||||||
},
|
},
|
||||||
"initError": {
|
"initError": {
|
||||||
"type": "object",
|
"oneOf": [
|
||||||
"properties": {
|
{
|
||||||
"code": {
|
"type": "object",
|
||||||
"type": "string"
|
"properties": {
|
||||||
|
"code": {
|
||||||
|
"const": "registry_load_failed"
|
||||||
|
},
|
||||||
|
"message": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"load": {
|
||||||
|
"$ref": "#/$defs/loadFailure"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"code",
|
||||||
|
"message",
|
||||||
|
"load"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
},
|
},
|
||||||
"message": {
|
{
|
||||||
"type": "string"
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"code": {
|
||||||
|
"const": "runtime_resource_limit"
|
||||||
|
},
|
||||||
|
"message": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"resource": {
|
||||||
|
"$ref": "#/$defs/resourceFailure"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"code",
|
||||||
|
"message",
|
||||||
|
"resource"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"code": {
|
||||||
|
"const": "entrypoint_arguments_invalid"
|
||||||
|
},
|
||||||
|
"message": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"entry": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"function": {
|
||||||
|
"type": "integer",
|
||||||
|
"minimum": 0,
|
||||||
|
"maximum": 4294967295
|
||||||
|
},
|
||||||
|
"slot": {
|
||||||
|
"type": "integer",
|
||||||
|
"minimum": 0,
|
||||||
|
"maximum": 4294967295
|
||||||
|
},
|
||||||
|
"trapCode": {
|
||||||
|
"type": "integer",
|
||||||
|
"minimum": 0,
|
||||||
|
"maximum": 4294967295
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"function",
|
||||||
|
"slot",
|
||||||
|
"trapCode"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"code",
|
||||||
|
"message",
|
||||||
|
"entry"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"code": {
|
||||||
|
"const": "loader_patch_failed"
|
||||||
|
},
|
||||||
|
"message": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"binding": {
|
||||||
|
"$ref": "#/$defs/bindingFailure"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"code",
|
||||||
|
"message",
|
||||||
|
"binding"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"code": {
|
||||||
|
"const": "invalid_format"
|
||||||
|
},
|
||||||
|
"message": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"code",
|
||||||
|
"message"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"code": {
|
||||||
|
"const": "unsupported_format"
|
||||||
|
},
|
||||||
|
"message": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"code",
|
||||||
|
"message"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"code": {
|
||||||
|
"const": "image_load_failed"
|
||||||
|
},
|
||||||
|
"message": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"code",
|
||||||
|
"message"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"code": {
|
||||||
|
"const": "entrypoint_not_found"
|
||||||
|
},
|
||||||
|
"message": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"code",
|
||||||
|
"message"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"code": {
|
||||||
|
"const": "verification_failed"
|
||||||
|
},
|
||||||
|
"message": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"code",
|
||||||
|
"message"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
}
|
}
|
||||||
},
|
]
|
||||||
"required": [
|
|
||||||
"code",
|
|
||||||
"message"
|
|
||||||
],
|
|
||||||
"additionalProperties": false
|
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"required": [
|
"required": [
|
||||||
@@ -661,6 +847,521 @@
|
|||||||
"shutdownTimeoutMs"
|
"shutdownTimeoutMs"
|
||||||
],
|
],
|
||||||
"additionalProperties": false
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"resourceFailure": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"resource": {
|
||||||
|
"enum": [
|
||||||
|
"GuestBytes",
|
||||||
|
"HandleSlots",
|
||||||
|
"AuxiliaryBytes",
|
||||||
|
"TemporaryBytes",
|
||||||
|
"StringBytes",
|
||||||
|
"StringAllocations",
|
||||||
|
"IndividualStringBytes",
|
||||||
|
"CallDepth"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"reason": {
|
||||||
|
"enum": [
|
||||||
|
"Limit",
|
||||||
|
"SizeOverflow",
|
||||||
|
"AllocationFailed"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"requested": {
|
||||||
|
"type": "integer",
|
||||||
|
"minimum": 0
|
||||||
|
},
|
||||||
|
"limit": {
|
||||||
|
"type": "integer",
|
||||||
|
"minimum": 0
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"resource",
|
||||||
|
"reason",
|
||||||
|
"requested",
|
||||||
|
"limit"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"sourceSpan": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"file_id": {
|
||||||
|
"type": "integer",
|
||||||
|
"minimum": 0,
|
||||||
|
"maximum": 4294967295
|
||||||
|
},
|
||||||
|
"start": {
|
||||||
|
"type": "integer",
|
||||||
|
"minimum": 0,
|
||||||
|
"maximum": 4294967295
|
||||||
|
},
|
||||||
|
"end": {
|
||||||
|
"type": "integer",
|
||||||
|
"minimum": 0,
|
||||||
|
"maximum": 4294967295
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"file_id",
|
||||||
|
"start",
|
||||||
|
"end"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"loadFailure": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"code": {
|
||||||
|
"enum": [
|
||||||
|
"LOAD_INVALID_FORMAT",
|
||||||
|
"LOAD_UNSUPPORTED_FORMAT",
|
||||||
|
"LOAD_INVALID_REFERENCE",
|
||||||
|
"LOAD_INVALID_REGISTRY",
|
||||||
|
"LOAD_INVALID_CODE",
|
||||||
|
"LOAD_RESOURCE_LIMIT",
|
||||||
|
"LOAD_INVALID_ENTRYPOINT"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"reason": {
|
||||||
|
"enum": [
|
||||||
|
"Magic",
|
||||||
|
"Version",
|
||||||
|
"Endianness",
|
||||||
|
"Reserved",
|
||||||
|
"SectionKind",
|
||||||
|
"MissingSection",
|
||||||
|
"DuplicateSection",
|
||||||
|
"Overlap",
|
||||||
|
"Truncated",
|
||||||
|
"TrailingBytes",
|
||||||
|
"InvalidFlag",
|
||||||
|
"Utf8",
|
||||||
|
"Category",
|
||||||
|
"Builtin",
|
||||||
|
"TypeId",
|
||||||
|
"FunctionId",
|
||||||
|
"OwnerCategory",
|
||||||
|
"TraitCategory",
|
||||||
|
"DuplicateBuiltin",
|
||||||
|
"DuplicateArray",
|
||||||
|
"ArrayCycle",
|
||||||
|
"DuplicateImplementation",
|
||||||
|
"MethodCount",
|
||||||
|
"Signature",
|
||||||
|
"CodeRange",
|
||||||
|
"FrameSlots",
|
||||||
|
"ReturnSlots",
|
||||||
|
"Overflow",
|
||||||
|
"Limit",
|
||||||
|
"Allocation",
|
||||||
|
"ConstantTag",
|
||||||
|
"DebugRange",
|
||||||
|
"DuplicateSyscall",
|
||||||
|
"UnknownOpcode",
|
||||||
|
"LocalSlot",
|
||||||
|
"JumpTarget",
|
||||||
|
"InstructionBoundary",
|
||||||
|
"BooleanImmediate",
|
||||||
|
"ConstantIndex",
|
||||||
|
"NativeId",
|
||||||
|
"UnpatchedHostcall",
|
||||||
|
"StackUnderflow",
|
||||||
|
"StackOverflow",
|
||||||
|
"StackJoin",
|
||||||
|
"ReturnHeight",
|
||||||
|
"UnterminatedPath",
|
||||||
|
"UnknownClosureCallee",
|
||||||
|
"NotClosure",
|
||||||
|
"InvalidYield",
|
||||||
|
"TypeMismatch"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"section": {
|
||||||
|
"anyOf": [
|
||||||
|
{
|
||||||
|
"type": "integer",
|
||||||
|
"minimum": 0,
|
||||||
|
"maximum": 4294967295
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "null"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"record": {
|
||||||
|
"anyOf": [
|
||||||
|
{
|
||||||
|
"type": "integer",
|
||||||
|
"minimum": 0,
|
||||||
|
"maximum": 4294967295
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "null"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"member": {
|
||||||
|
"anyOf": [
|
||||||
|
{
|
||||||
|
"type": "integer",
|
||||||
|
"minimum": 0,
|
||||||
|
"maximum": 4294967295
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "null"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"referenced_id": {
|
||||||
|
"anyOf": [
|
||||||
|
{
|
||||||
|
"type": "integer",
|
||||||
|
"minimum": 0,
|
||||||
|
"maximum": 4294967295
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "null"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"function": {
|
||||||
|
"anyOf": [
|
||||||
|
{
|
||||||
|
"type": "integer",
|
||||||
|
"minimum": 0,
|
||||||
|
"maximum": 4294967295
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "null"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"pc": {
|
||||||
|
"anyOf": [
|
||||||
|
{
|
||||||
|
"type": "integer",
|
||||||
|
"minimum": 0,
|
||||||
|
"maximum": 4294967295
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "null"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"offset": {
|
||||||
|
"anyOf": [
|
||||||
|
{
|
||||||
|
"type": "integer",
|
||||||
|
"minimum": 0
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "null"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"id_domain": {
|
||||||
|
"enum": [
|
||||||
|
"Type",
|
||||||
|
"Function",
|
||||||
|
"Implementation",
|
||||||
|
null
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"resource": {
|
||||||
|
"enum": [
|
||||||
|
"PbxBytes",
|
||||||
|
"CodeBytes",
|
||||||
|
"Types",
|
||||||
|
"Functions",
|
||||||
|
"Implementations",
|
||||||
|
"NestedRecords",
|
||||||
|
"NameBytes",
|
||||||
|
"RegistryBytes",
|
||||||
|
"TemporaryBytes",
|
||||||
|
"Work",
|
||||||
|
"ConstantEntries",
|
||||||
|
"ConstantStringBytes",
|
||||||
|
null
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"requested": {
|
||||||
|
"anyOf": [
|
||||||
|
{
|
||||||
|
"type": "integer",
|
||||||
|
"minimum": 0
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "null"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"limit": {
|
||||||
|
"anyOf": [
|
||||||
|
{
|
||||||
|
"type": "integer",
|
||||||
|
"minimum": 0
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "null"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"code",
|
||||||
|
"reason",
|
||||||
|
"section",
|
||||||
|
"record",
|
||||||
|
"member",
|
||||||
|
"referenced_id",
|
||||||
|
"function",
|
||||||
|
"pc",
|
||||||
|
"offset",
|
||||||
|
"id_domain",
|
||||||
|
"resource",
|
||||||
|
"requested",
|
||||||
|
"limit"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"bindingFailure": {
|
||||||
|
"oneOf": [
|
||||||
|
{
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"reason": {
|
||||||
|
"const": "unknown_syscall"
|
||||||
|
},
|
||||||
|
"module": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"name": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"version": {
|
||||||
|
"type": "integer",
|
||||||
|
"minimum": 0,
|
||||||
|
"maximum": 65535
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"reason",
|
||||||
|
"module",
|
||||||
|
"name",
|
||||||
|
"version"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"reason": {
|
||||||
|
"const": "missing_capability"
|
||||||
|
},
|
||||||
|
"module": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"name": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"version": {
|
||||||
|
"type": "integer",
|
||||||
|
"minimum": 0,
|
||||||
|
"maximum": 65535
|
||||||
|
},
|
||||||
|
"required": {
|
||||||
|
"type": "integer",
|
||||||
|
"minimum": 0
|
||||||
|
},
|
||||||
|
"provided": {
|
||||||
|
"type": "integer",
|
||||||
|
"minimum": 0
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"reason",
|
||||||
|
"module",
|
||||||
|
"name",
|
||||||
|
"version",
|
||||||
|
"required",
|
||||||
|
"provided"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"reason": {
|
||||||
|
"const": "abi_mismatch"
|
||||||
|
},
|
||||||
|
"module": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"name": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"version": {
|
||||||
|
"type": "integer",
|
||||||
|
"minimum": 0,
|
||||||
|
"maximum": 65535
|
||||||
|
},
|
||||||
|
"declared_arg_slots": {
|
||||||
|
"type": "integer",
|
||||||
|
"minimum": 0,
|
||||||
|
"maximum": 65535
|
||||||
|
},
|
||||||
|
"declared_ret_slots": {
|
||||||
|
"type": "integer",
|
||||||
|
"minimum": 0,
|
||||||
|
"maximum": 65535
|
||||||
|
},
|
||||||
|
"expected_arg_slots": {
|
||||||
|
"type": "integer",
|
||||||
|
"minimum": 0,
|
||||||
|
"maximum": 65535
|
||||||
|
},
|
||||||
|
"expected_ret_slots": {
|
||||||
|
"type": "integer",
|
||||||
|
"minimum": 0,
|
||||||
|
"maximum": 65535
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"reason",
|
||||||
|
"module",
|
||||||
|
"name",
|
||||||
|
"version",
|
||||||
|
"declared_arg_slots",
|
||||||
|
"declared_ret_slots",
|
||||||
|
"expected_arg_slots",
|
||||||
|
"expected_ret_slots"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"reason": {
|
||||||
|
"const": "hostcall_index_out_of_bounds"
|
||||||
|
},
|
||||||
|
"pc": {
|
||||||
|
"type": "integer",
|
||||||
|
"minimum": 0
|
||||||
|
},
|
||||||
|
"syscallIndex": {
|
||||||
|
"type": "integer",
|
||||||
|
"minimum": 0,
|
||||||
|
"maximum": 4294967295
|
||||||
|
},
|
||||||
|
"syscallsLength": {
|
||||||
|
"type": "integer",
|
||||||
|
"minimum": 0
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"reason",
|
||||||
|
"pc",
|
||||||
|
"syscallIndex",
|
||||||
|
"syscallsLength"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"reason": {
|
||||||
|
"const": "raw_syscall"
|
||||||
|
},
|
||||||
|
"pc": {
|
||||||
|
"type": "integer",
|
||||||
|
"minimum": 0
|
||||||
|
},
|
||||||
|
"syscallId": {
|
||||||
|
"type": "integer",
|
||||||
|
"minimum": 0,
|
||||||
|
"maximum": 4294967295
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"reason",
|
||||||
|
"pc",
|
||||||
|
"syscallId"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"reason": {
|
||||||
|
"const": "unused_syscall"
|
||||||
|
},
|
||||||
|
"module": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"name": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"version": {
|
||||||
|
"type": "integer",
|
||||||
|
"minimum": 0,
|
||||||
|
"maximum": 65535
|
||||||
|
},
|
||||||
|
"syscallIndex": {
|
||||||
|
"type": "integer",
|
||||||
|
"minimum": 0,
|
||||||
|
"maximum": 4294967295
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"reason",
|
||||||
|
"module",
|
||||||
|
"name",
|
||||||
|
"version",
|
||||||
|
"syscallIndex"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"reason": {
|
||||||
|
"const": "hostcall_remaining"
|
||||||
|
},
|
||||||
|
"pc": {
|
||||||
|
"type": "integer",
|
||||||
|
"minimum": 0
|
||||||
|
},
|
||||||
|
"syscallIndex": {
|
||||||
|
"type": "integer",
|
||||||
|
"minimum": 0,
|
||||||
|
"maximum": 4294967295
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"reason",
|
||||||
|
"pc",
|
||||||
|
"syscallIndex"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"reason": {
|
||||||
|
"const": "decode_failed"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"reason"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
]
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -94,6 +94,19 @@ exact round-trippable string (including non-finite values). Faults expose kind,
|
|||||||
pc, summary and structural trap code/opcode/message/source span or init-error code.
|
pc, summary and structural trap code/opcode/message/source span or init-error code.
|
||||||
No client must parse a summary to distinguish trap, panic or initialization failure.
|
No client must parse a summary to distinguish trap, panic or initialization failure.
|
||||||
|
|
||||||
|
Resource traps include a nullable `trap.resource` object with `resource`, `reason`,
|
||||||
|
`requested` and `limit`; resource and reason are enumerated machine values.
|
||||||
|
`initError` is discriminated by `code`: `registry_load_failed` includes `load`,
|
||||||
|
`runtime_resource_limit` includes `resource`, `entrypoint_arguments_invalid`
|
||||||
|
includes `entry`, and `loader_patch_failed` includes `binding`. Other initialization
|
||||||
|
codes carry only their code and human message. `load.code` uses the stable
|
||||||
|
`LOAD_*` tag and retains typed reason, section/offset, record/member, ID domain,
|
||||||
|
referenced ID, function/PC and quota context, with null for unavailable fields.
|
||||||
|
Binding context preserves canonical native identity, version, capabilities or
|
||||||
|
declared/expected ABI counts as applicable. A load-relative PC remains nested
|
||||||
|
inside its diagnostic; initialization failure does not invent a runtime PC.
|
||||||
|
The published response schema rejects unknown fields and invalid contexts.
|
||||||
|
|
||||||
## Ordering, cancellation and lifecycle
|
## Ordering, cancellation and lifecycle
|
||||||
|
|
||||||
Only one host operation is admitted at a time. Conflicting work, including state
|
Only one host operation is admitted at a time. Conflicting work, including state
|
||||||
|
|||||||
Reference in New Issue
Block a user