fault.h File Reference

Bounded observation before retaining platform fail-stop. More...

#include "nexus/core/status.h"

Go to the source code of this file.

Enumerations
enum	nx_fault_domain_t { NX_FAULT_FREERTOS_ASSERT = 0 , NX_FAULT_FREERTOS_STACK , NX_FAULT_THREADX_ADAPTER , NX_FAULT_PLATFORM }
	Fault origin, without any product safety or recovery decision. More...

Functions
void	nx_fault_observe (nx_fault_domain_t domain, nx_result_t reason, const char *file, unsigned line)
	Observe a terminal fault before the caller retains effects.

Detailed Description

Bounded observation before retaining platform fail-stop.

Author

Nexus Team

Definition in file fault.h.

Enumeration Type Documentation

nx_fault_domain_t

enum nx_fault_domain_t

Fault origin, without any product safety or recovery decision.

Enumerator
NX_FAULT_FREERTOS_ASSERT
NX_FAULT_FREERTOS_STACK
NX_FAULT_THREADX_ADAPTER
NX_FAULT_PLATFORM

Definition at line 13 of file fault.h.

Function Documentation

nx_fault_observe()

void nx_fault_observe	(	nx_fault_domain_t	domain,
		nx_result_t	reason,
		const char *	file,
		unsigned	line )

Observe a terminal fault before the caller retains effects.

Parameters

[in]	domain	Actual reporting path, not a severity assessment.
[in]	reason	Observed failure, never permission to reclaim loans.
[in]	file	Static source literal or NULL; do not retain or read untrusted dynamic memory. No task name is dereferenced.
[in]	line	Diagnostic location, zero when unavailable.

Note

The weak default returns and has no state or side effects. A product may supply one strong implementation, bounded and allocation-free in every calling task/ISR/masked context. No functioning kernel, clock, stack, transport or peripheral may be assumed after corruption. This is best-effort observation, not stack repair, safe outputs or reset proof. The hook must not acquire OS locks, reenter the provider, change incoming masks, mutate accepted requests or release retained storage. If it returns, the terminal caller still parks. A product may perform a separately reviewed non-returning recovery action. No retained event, registry or worker is implicit.