mdl_cli_stream.c File Reference

Bounded byte-stream composition helpers for mdl diagnostics. More...

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

Include dependency graph for mdl_cli_stream.c:

Go to the source code of this file.

Enumerations
enum	mdl_cli_part_limit_t : uint8_t { k_mdl_cli_part_limit = 16 }
	Maximum fragments accepted by one CLI diagnostic operation. More...

Functions
ra8_err_t	priv_mdl_cli_put_parts (ra8_io_stream_t *stream, const char *const *parts, size_t count)
	Write a bounded ordered vector of NUL-terminated text fragments.
ra8_err_t	priv_mdl_cli_reject_parts (ra8_io_stream_t *stream, const char *const *parts, size_t count)
	Write a rejection diagnostic and return invalid-argument status.

Detailed Description

Bounded byte-stream composition helpers for mdl diagnostics.

Implements fixed-fragment and bounded integer rendering over the injected diagnostic stream without variadic formatting.

Copyright

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

Definition in file mdl_cli_stream.c.

Enumeration Type Documentation

mdl_cli_part_limit_t

enum mdl_cli_part_limit_t : uint8_t

Maximum fragments accepted by one CLI diagnostic operation.

Enumerator
k_mdl_cli_part_limit	Fixed bound for ordered text fragments.

Definition at line 14 of file mdl_cli_stream.c.

Function Documentation

priv_mdl_cli_put_parts()

ra8_err_t priv_mdl_cli_put_parts	(	ra8_io_stream_t *	stream,
		const char *const *	parts,
		size_t	count )

Write a bounded ordered vector of NUL-terminated text fragments.

Parameters

[in,out]	stream	Bound destination stream.
[in]	parts	Array of borrowed text pointers.
[in]	count	Number of entries in parts.

Returns

Canonical stream or argument status.

Return values

k_ra8_ok	Every fragment was accepted in order.
k_ra8_err_null_ptr	A required pointer or fragment was null.
k_ra8_err_invalid_size	count exceeds the fixed fragment ceiling.
other	The destination rejected a fragment.

Precondition

parts covers count readable pointer entries.

Every non-null fragment is NUL-terminated.

Postcondition

Success writes the concatenation without separators or terminators.

Failure stops at the first rejected or invalid fragment.

Note

Thread-safe across distinct streams.

Since

0.1.0

Writes fragments in order through the injected stream. The first sink error stops later writes and is returned unchanged.

Definition at line 18 of file mdl_cli_stream.c.

References k_mdl_cli_part_limit, k_ra8_err_invalid_size, k_ra8_err_null_ptr, k_ra8_ok, ra8_io_stream_puts(), RA8_LOOP_BOUND, and RA8_PRIV.

Referenced by internal_cli_reject_limit(), internal_cli_usage_actions(), internal_cli_usage_discovery(), mdl_cli_usage(), and priv_mdl_cli_reject_parts().

priv_mdl_cli_reject_parts()

ra8_err_t priv_mdl_cli_reject_parts	(	ra8_io_stream_t *	stream,
		const char *const *	parts,
		size_t	count )

Write a rejection diagnostic and return invalid-argument status.

Parameters

[in,out]	stream	Bound diagnostic stream.
[in]	parts	Ordered fragments forming one complete diagnostic.
[in]	count	Number of entries in parts.

Returns

Invalid-argument after a complete write, or the stream failure.

Return values

k_ra8_err_invalid_arg	Every diagnostic fragment was accepted.
other	Argument validation or destination write failed first.

Precondition

parts includes any required prefix and newline.

stream is exclusively owned for the call.

Postcondition

A successful diagnostic is never reported as command success.

Stream failures are not hidden behind validation status.

Note

Thread-safe across distinct streams.

Since

0.1.0

Writes fragments in order through the injected stream. The first sink error stops later writes and is returned unchanged.

Definition at line 41 of file mdl_cli_stream.c.

References k_ra8_err_invalid_arg, k_ra8_ok, priv_mdl_cli_put_parts(), and RA8_PRIV.

Referenced by internal_cli_invalid(), internal_cli_parse_chapter_pick(), internal_cli_reject_integer(), internal_cli_reject_limit(), internal_cli_validate_num_ranges(), internal_prepare_run_policy(), and internal_validate_allowed_args().