]> git.ipfire.org Git - thirdparty/glibc.git/commit
stdio-common: Introduce buffers for implementing printf
authorFlorian Weimer <fweimer@redhat.com>
Thu, 18 Aug 2022 06:49:54 +0000 (08:49 +0200)
committerFlorian Weimer <fweimer@redhat.com>
Mon, 12 Dec 2022 14:38:32 +0000 (15:38 +0100)
commit9e6084af5260c144509be67a906696db99dc5ddf
treefc42731f860d6971fb40baa337029f5ee03f99b8
parentc0dee012ab097481adfd3826e83a84decd0f87a2
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.
28 files changed:
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]