justin/jsix
1
1
Fork 0
mirror of https://github.com/justinian/jsix.git synced 2025-12-10 08:24:32 -08:00
Code Issues Packages Projects Releases Wiki Activity

[util] Move remaining *printf impementations to util::format

Browse Source 
I added util::format as a replacement for other printf implementations
last year, but it sat there only being used by the kernel all this time.
Now I've templated it so that it can be used by the bootloader, and
removed printf from panic.serial as well.
This commit is contained in:
Justin C. Miller
2023-02-01 22:25:17 -08:00
parent eba0127645
commit 86d458fc6c
9 changed files with 105 additions and 1518 deletions
Download Patch File Download Diff File Expand all files Collapse all files

17
src/kernel/panic.serial/display.cpp
View File

@@ -1,4 +1,4 @@
#include "printf/printf.h"
#include <util/format.h>
#include "cpu.h"
#include "display.h"
@@ -29,7 +29,7 @@ print_header(
out.write(":");
char linestr[6];
snprintf(linestr, sizeof(linestr), "%ld", line);
util::format({linestr, sizeof(linestr)}, "%ld", line);
out.write(linestr);
}
@@ -38,7 +38,7 @@ print_cpu(serial_port &out, cpu_data &cpu)
{
out.write("\n \e[0;31m==[ CPU: ");
char cpuid[7];
snprintf(cpuid, sizeof(cpuid), "%4x", cpu.id);
util::format({cpuid, sizeof(cpuid)}, "%4x", cpu.id);
out.write(cpuid);
out.write(" ]====================================================================\n");
}
@@ -54,7 +54,7 @@ print_callstack(serial_port &out, symbol_table &syms, frame const *fp)
if (!name)
name = "<unknown>";
snprintf(message, sizeof(message),
util::format({message, sizeof(message)},
" \e[0;33mframe %2d: <0x%016lx> \e[1;33m%s\n",
count++, fp->return_addr, name);
@@ -68,7 +68,7 @@ print_reg(serial_port &out, const char *name, uint64_t val, const char *color)
{
char message[512];
snprintf(message, sizeof(message), " \e[0;%sm%-3s %016lx\e[0m", color, name, val);
util::format({message, sizeof(message)}, " \e[0;%sm%3s %016lx\e[0m", color, name, val);
out.write(message);
}
@@ -124,11 +124,11 @@ print_rip(serial_port &out, uintptr_t addr)
out.write("\n");
for (unsigned i = 0; i < per_line*3; i += per_line) {
snprintf(bit, sizeof(bit), "\e[0;33m%20lx: \e[0m", addr + i);
util::format({bit, sizeof(bit)}, "\e[0;33m%20lx: \e[0m", addr + i);
out.write(bit);
for (unsigned j = 0; j < per_line; ++j) {
snprintf(bit, sizeof(bit), "%02x ", data[i+j]);
util::format({bit, sizeof(bit)}, "%02x ", data[i+j]);
out.write(bit);
}
out.write("\n");
@@ -155,6 +155,3 @@ print_user_state(serial_port &out, const cpu_state &regs)
}
} // namespace panicking
// For printf.c
extern "C" void putchar_(char c) {}

1
src/kernel/panic.serial/serial.module
View File

@@ -13,5 +13,4 @@ panic = module("panic.serial",
"main.cpp",
"serial.cpp",
"symbol_table.cpp",
"../printf/printf.c",
])

1184
src/kernel/printf/printf.c
View File

File diff suppressed because it is too large Load Diff

151
src/kernel/printf/printf.h
View File

@@ -1,151 +0,0 @@
/**
* @author (c) Eyal Rozenberg <eyalroz1@gmx.com>
* 2021, Haifa, Palestine/Israel
* @author (c) Marco Paland (info@paland.com)
* 2014-2019, PALANDesign Hannover, Germany
*
* @note Others have made smaller contributions to this file: see the
* contributors page at https://github.com/eyalroz/printf/graphs/contributors
* or ask one of the authors.
*
* @brief Small stand-alone implementation of the printf family of functions
* (`(v)printf`, `(v)s(n)printf` etc., geared towards use on embedded systems with
* a very limited resources.
*
* @note the implementations are thread-safe; re-entrant; use no functions from
* the standard library; and do not dynamically allocate any memory.
*
* @license The MIT License (MIT)
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
#ifndef PRINTF_H_
#define PRINTF_H_
#include <stdarg.h>
#include <stddef.h>
#ifdef __cplusplus
extern "C" {
#endif
#ifdef __GNUC__
# define ATTR_PRINTF(one_based_format_index, first_arg) \
__attribute__((format(__printf__, (one_based_format_index), (first_arg))))
# define ATTR_VPRINTF(one_based_format_index) ATTR_PRINTF(one_based_format_index, 0)
#else
# define ATTR_PRINTF(one_based_format_index, first_arg)
# define ATTR_VPRINTF(one_based_format_index)
#endif
#ifndef PRINTF_ALIAS_STANDARD_FUNCTION_NAMES
#define PRINTF_ALIAS_STANDARD_FUNCTION_NAMES 0
#endif
#if PRINTF_ALIAS_STANDARD_FUNCTION_NAMES
# define printf_ printf
# define sprintf_ sprintf
# define vsprintf_ vsprintf
# define snprintf_ snprintf
# define vsnprintf_ vsnprintf
# define vprintf_ vprintf
#endif
/**
* Output a character to a custom device like UART, used by the printf() function
* This function is declared here only. You have to write your custom implementation somewhere
* @param character Character to output
*/
void putchar_(char character);
/**
* Tiny printf implementation
* You have to implement putchar_ if you use printf()
* To avoid conflicts with the regular printf() API it is overridden by macro defines
* and internal underscore-appended functions like printf_() are used
* @param format A string that specifies the format of the output
* @return The number of characters that are written into the array, not counting the terminating null character
*/
int printf_(const char* format, ...) ATTR_PRINTF(1, 2);
/**
* Tiny sprintf/vsprintf implementation
* Due to security reasons (buffer overflow) YOU SHOULD CONSIDER USING (V)SNPRINTF INSTEAD!
* @param buffer A pointer to the buffer where to store the formatted string. MUST be big enough to store the output!
* @param format A string that specifies the format of the output
* @param va A value identifying a variable arguments list
* @return The number of characters that are WRITTEN into the buffer, not counting the terminating null character
*/
int sprintf_(char* buffer, const char* format, ...) ATTR_PRINTF(2, 3);
int vsprintf_(char* buffer, const char* format, va_list va) ATTR_VPRINTF(2);
/**
* Tiny snprintf/vsnprintf implementation
* @param buffer A pointer to the buffer where to store the formatted string
* @param count The maximum number of characters to store in the buffer, including a terminating null character
* @param format A string that specifies the format of the output
* @param va A value identifying a variable arguments list
* @return The number of characters that COULD have been written into the buffer, not counting the terminating
* null character. A value equal or larger than count indicates truncation. Only when the returned value
* is non-negative and less than count, the string has been completely written.
*/
int snprintf_(char* buffer, size_t count, const char* format, ...) ATTR_PRINTF(3, 4);
int vsnprintf_(char* buffer, size_t count, const char* format, va_list va) ATTR_VPRINTF(3);
/**
* Tiny vprintf implementation
* @param format A string that specifies the format of the output
* @param va A value identifying a variable arguments list
* @return The number of characters that are WRITTEN into the buffer, not counting the terminating null character
*/
int vprintf_(const char* format, va_list va) ATTR_VPRINTF(1);
/**
* printf/vprintf with output function
* You may use this as dynamic alternative to printf() with its fixed _putchar() output
* @param out An output function which takes one character and an argument pointer
* @param arg An argument pointer for user data passed to output function
* @param format A string that specifies the format of the output
* @param va A value identifying a variable arguments list
* @return The number of characters that are sent to the output function, not counting the terminating null character
*/
int fctprintf(void (*out)(char character, void* arg), void* arg, const char* format, ...) ATTR_PRINTF(3, 4);
int vfctprintf(void (*out)(char character, void* arg), void* arg, const char* format, va_list va) ATTR_VPRINTF(3);
#ifdef __cplusplus
}
#endif
#if PRINTF_ALIAS_STANDARD_FUNCTION_NAMES
# undef printf_
# undef sprintf_
# undef vsprintf_
# undef snprintf_
# undef vsnprintf_
# undef vprintf_
#endif
#endif // PRINTF_H_

10
src/kernel/printf/printf_config.h
View File

@@ -1,10 +0,0 @@
#pragma once
// \file printf_config.h
// Configuration for eyalroz/printf
#define PRINTF_SUPPORT_DECIMAL_SPECIFIERS 0
#define PRINTF_SUPPORT_EXPONENTIAL_SPECIFIERS 0
#define PRINTF_SUPPORT_WRITEBACK_SPECIFIER 0
#define PRINTF_SUPPORT_LONG_LONG 1
#define PRINTF_ALIAS_STANDARD_FUNCTION_NAMES 1