stdio-common: Introduce buffers for implementing printf
commit659fe9fdd14b0772f4e9722b751b9b010665e053
authorFlorian Weimer <fweimer@redhat.com>
Mon, 19 Dec 2022 17:56:54 +0000 (19 18:56 +0100)
committerFlorian Weimer <fweimer@redhat.com>
Mon, 19 Dec 2022 17:56:54 +0000 (19 18:56 +0100)
tree3098a69345fbd3474154bbba45e8f21de449f266
parentffde06c915d10c0717a0980508ccb28506c6ec63
stdio-common: Introduce buffers for implementing printf

These buffers will eventually be used instead of FILE * objects
to implement printf functions.  The multibyte buffer is struct
__printf_buffer, the wide buffer is struct __wprintf_buffer.

To enable writing type-generic code, the header files
printf_buffer-char.h and printf_buffer-wchar_t.h define the
Xprintf macro differently, enabling Xprintf (buffer) to stand
for __printf_buffer and __wprintf_buffer as appropriate.  For
common cases, macros like Xprintf_buffer are provided as a more
syntactically convenient shortcut.

Buffer-specific flush callbacks are implemented with a switch
statement instead of a function pointer, to avoid hardening issues
similar to those of libio vtables.  struct __printf_buffer_as_file
is needed to support custom printf specifiers because the public
interface for that requires passing a FILE *, which is why there
is a trapdoor back from these buffers to FILE * streams.

Since the immediate user of these interfaces knows when processing
has finished, there is no flush callback for the end of processing,
only a flush callback for the intermediate buffer flush.

Reviewed-by: Adhemerval Zanella <adhemerval.zanella@linaro.org>
29 files changed:
elf/Makefile
include/printf_buffer.h [new file with mode: 0644]
stdio-common/Makefile
stdio-common/Xprintf_buffer_done.c [new file with mode: 0644]
stdio-common/Xprintf_buffer_flush.c [new file with mode: 0644]
stdio-common/Xprintf_buffer_pad_1.c [new file with mode: 0644]
stdio-common/Xprintf_buffer_putc_1.c [new file with mode: 0644]
stdio-common/Xprintf_buffer_puts_1.c [new file with mode: 0644]
stdio-common/Xprintf_buffer_write.c [new file with mode: 0644]
stdio-common/printf_buffer-char.h [new file with mode: 0644]
stdio-common/printf_buffer-wchar_t.h [new file with mode: 0644]
stdio-common/printf_buffer_as_file.c [new file with mode: 0644]
stdio-common/printf_buffer_as_file.h [new file with mode: 0644]
stdio-common/printf_buffer_done.c [new file with mode: 0644]
stdio-common/printf_buffer_flush.c [new file with mode: 0644]
stdio-common/printf_buffer_pad_1.c [new file with mode: 0644]
stdio-common/printf_buffer_putc_1.c [new file with mode: 0644]
stdio-common/printf_buffer_puts_1.c [new file with mode: 0644]
stdio-common/printf_buffer_to_file.c [new file with mode: 0644]
stdio-common/printf_buffer_to_file.h [new file with mode: 0644]
stdio-common/printf_buffer_write.c [new file with mode: 0644]
stdio-common/wprintf_buffer_as_file.c [new file with mode: 0644]
stdio-common/wprintf_buffer_done.c [new file with mode: 0644]
stdio-common/wprintf_buffer_flush.c [new file with mode: 0644]
stdio-common/wprintf_buffer_pad_1.c [new file with mode: 0644]
stdio-common/wprintf_buffer_putc_1.c [new file with mode: 0644]
stdio-common/wprintf_buffer_puts_1.c [new file with mode: 0644]
stdio-common/wprintf_buffer_to_file.c [new file with mode: 0644]
stdio-common/wprintf_buffer_write.c [new file with mode: 0644]