rte_nvm.h File Reference

OS Abstraction Layer - Non-Volatile Memory service. More...

#include "rte/utils/status/rte_status.h"
#include "rte/utils/types/rte_types.h"

Include dependency graph for rte_nvm.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	rte_nvm_config_t
	Configuration for rte_nvm_open(). More...

Typedefs
typedef struct rte_nvm_impl_s *	rte_nvm_handle_t
	Opaque handle to an open NVM region, returned by rte_nvm_open().

Functions
	RTE_DECLARE_STORAGE (rte_nvm_storage_t, 64U)
	Caller-owned, fixed-size storage backing one rte_nvm_handle_t.
rte_status_t	rte_nvm_open (rte_nvm_storage_t *storage, const rte_nvm_config_t *config, rte_nvm_handle_t *out_handle)
	Opens (creating if necessary) a named NVM region.
rte_status_t	rte_nvm_read (rte_nvm_handle_t handle, size_t offset, void *out_buffer, size_t buffer_size)
	Reads and integrity-checks data from an NVM region.
rte_status_t	rte_nvm_write (rte_nvm_handle_t handle, size_t offset, const void *buffer, size_t buffer_size)
	Writes data and its integrity metadata to an NVM region.
rte_status_t	rte_nvm_sync (rte_nvm_handle_t handle)
	Forces any buffered writes to durable storage.
rte_status_t	rte_nvm_close (rte_nvm_handle_t handle)
	Closes an NVM region handle.

Detailed Description

OS Abstraction Layer - Non-Volatile Memory service.

Persistent storage for safety-related data (e.g. train/track database state) with mandatory integrity checking on read. See ADR-001.

REQ-OAL-NVM-001: every read shall be integrity-checked (e.g. CRC or redundant-copy voting) before data is returned to the caller. REQ-OAL-NVM-002: no dynamic allocation; caller supplies storage/buffers.

Definition in file rte_nvm.h.