1 /* 2 * This file and its contents are supplied under the terms of the 3 * Common Development and Distribution License ("CDDL"), version 1.0. 4 * You may only use this file in accordance with the terms of version 5 * 1.0 of the CDDL. 6 * 7 * A full copy of the text of the CDDL should have accompanied this 8 * source. A copy of the CDDL is also available via the Internet at 9 * http://www.illumos.org/license/CDDL. 10 */ 11 12 /* 13 * Copyright 2025 Oxide Computer Company 14 */ 15 16 #ifndef _SYS_ILSTR_H 17 #define _SYS_ILSTR_H 18 19 #ifdef _KERNEL 20 #include <sys/types.h> 21 #include <sys/varargs.h> 22 #include <sys/stdbool.h> 23 #else 24 #include <stdarg.h> 25 #include <stddef.h> 26 #include <stdbool.h> 27 #endif 28 29 #ifdef __cplusplus 30 extern "C" { 31 #endif 32 33 typedef enum ilstr_errno { 34 ILSTR_ERROR_OK = 0, 35 ILSTR_ERROR_NOMEM, 36 ILSTR_ERROR_OVERFLOW, 37 ILSTR_ERROR_PRINTF, 38 } ilstr_errno_t; 39 40 typedef enum ilstr_flag { 41 ILSTR_FLAG_PREALLOC = (1 << 0), 42 } ilstr_flag_t; 43 44 typedef struct ilstr { 45 char *ils_data; 46 size_t ils_datalen; 47 size_t ils_strlen; 48 ilstr_errno_t ils_errno; 49 int ils_kmflag; 50 ilstr_flag_t ils_flag; 51 } ilstr_t; 52 53 extern void ilstr_init(ilstr_t *, int); 54 extern void ilstr_init_prealloc(ilstr_t *, char *, size_t); 55 extern void ilstr_reset(ilstr_t *); 56 extern void ilstr_fini(ilstr_t *); 57 extern void ilstr_append_str(ilstr_t *, const char *); 58 extern void ilstr_prepend_str(ilstr_t *, const char *); 59 extern void ilstr_append_char(ilstr_t *, char); 60 extern void ilstr_prepend_char(ilstr_t *, char); 61 extern ilstr_errno_t ilstr_errno(ilstr_t *); 62 extern const char *ilstr_cstr(ilstr_t *); 63 extern size_t ilstr_len(ilstr_t *); 64 extern bool ilstr_is_empty(ilstr_t *); 65 extern const char *ilstr_errstr(ilstr_t *); 66 void ilstr_aprintf(ilstr_t *, const char *, ...); 67 void ilstr_vaprintf(ilstr_t *, const char *, va_list); 68 69 #ifdef __cplusplus 70 } 71 #endif 72 73 #endif /* _SYS_ILSTR_H */ 74