Backend-author interface for binding concrete filesystem ports. More...

#include <stdint.h>
#include "fw_if_fs.h"

Include dependency graph for fw_if_fs_backend.h:

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

Data Structures
struct	fw_fs_namespace_iface
	Namespace backend operations. More...
struct	fw_fs_stream_iface
	Open-file backend operations over caller-supplied state. More...
struct	fw_fs_transaction_iface
	Staged-publication backend operations over caller-supplied state. More...

Functions
ra8_err_t	fw_fs_bind (fw_fs_t out, const fw_fs_namespace_iface_t namespace_iface, const fw_fs_stream_iface_t stream_iface, const fw_fs_transaction_iface_t transaction_iface, void ctx, const fw_fs_caps_t caps)
	Bind segregated vtables and one context into a complete facade.

Detailed Description

Backend-author interface for binding concrete filesystem ports.

Tag: [Ring 2 / Interface] {World: Any}

Applications do not construct these vtables. A concrete adapter exports one _init() function which passes immutable vtables, a caller-owned context, and truthful capabilities to fw_fs_bind.

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

Since: 0.1.0

Definition in file fw_if_fs_backend.h.

Function Documentation

◆ fw_fs_bind()

ra8_err_t fw_fs_bind	(	fw_fs_t *	out,
		const fw_fs_namespace_iface_t *	namespace_iface,
		const fw_fs_stream_iface_t *	stream_iface,
		const fw_fs_transaction_iface_t *	transaction_iface,
		void *	ctx,
		const fw_fs_caps_t *	caps )

nodiscard

Bind segregated vtables and one context into a complete facade.

Namespace and stream capabilities/interfaces are mandatory. Optional operation pointers must agree with their advertised capability bits.

Definition at line 427 of file fw_if_fs.c.

References fw_fs_namespace_t::caps, fw_fs_stream_port_t::caps, fw_fs_t::caps, fw_fs_transaction_port_t::caps, fw_fs_namespace_t::ctx, fw_fs_stream_port_t::ctx, fw_fs_transaction_port_t::ctx, fw_fs_path_validate(), fw_fs_namespace_t::iface, fw_fs_stream_port_t::iface, fw_fs_transaction_port_t::iface, internal_fw_fs_caps_validate(), internal_interfaces(), k_ra8_err_null_ptr, k_ra8_ok, fw_fs_t::names, fw_fs_t::streams, and fw_fs_t::transactions.

Referenced by fw_fs_ra8_vfs_init(), and priv_fs_posix_bind_interfaces().

Data Structures

Functions

Detailed Description

Function Documentation

◆ fw_fs_bind()