Backend implementation contract for the ra8_io block-device fabric. More...

#include <stdint.h>
#include "ra8_err.h"
#include "ra8_io_blockdev.h"

Include dependency graph for ra8_io_blockdev_backend.h:

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

Data Structures
struct	ra8_io_blockdev_iface
	Opaque to applications – backends implement this internally and export a binding helper through their own header. More...

Detailed Description

Backend implementation contract for the ra8_io block-device fabric.

Tag: [Ring 4 / PAL] {World: NS}

This implementer-facing header is the Dependency Inversion seam for storage backends. A library that presents an ra8_io_blockdev_t includes this header, defines one const ra8_io_blockdev_iface_t, and binds it into the public handle. Application consumers use only ra8_io_blockdev.h and never need the concrete callback table.

Keeping this contract under inc/ is intentional: adapters such as ra8_ftl are separate libraries and must be able to implement the abstraction without reaching into libs/ra8_io/src/. The callback contract remains free of platform and device types, so host, RAM, flash, SD, and future architectures substitute behind the same handle.

Copyright: Copyright (c) 2026 Brighton Sikarskie SPDX-License-Identifier: MIT

Since: 0.1.0

Definition in file ra8_io_blockdev_backend.h.

Data Structures

Detailed Description