mirror of
https://github.com/ibm-s390-linux/s390-tools.git
synced 2026-08-05 02:14:52 +00:00
b627b8d8e1
This commit is based on the s390-tools-1.39.0 version. Changes on top of s390-tools-1.39.0: - Add MIT license to all source files - Add LICENSE file - Transform REAMDE to README.md (markdown) - Add AUTHORS.md file - Add CONTRIBUTING.md file - Move changelog from README to CHANGELOG.md file Reviewed-by: Stefan Haberland <sth@linux.vnet.ibm.com> Signed-off-by: Michael Holzheu <holzheu@linux.vnet.ibm.com>
129 lines
3.7 KiB
C
129 lines
3.7 KiB
C
/**
|
|
* @defgroup util_libc_h util_libc: Libc wrapper interface
|
|
* @{
|
|
* @brief Handle standard errors for libc functions
|
|
*
|
|
* Copyright IBM Corp. 2016, 2017
|
|
*
|
|
* s390-tools is free software; you can redistribute it and/or modify
|
|
* it under the terms of the MIT license. See LICENSE for details.
|
|
*/
|
|
|
|
#ifndef LIB_UTIL_LIBC_H
|
|
#define LIB_UTIL_LIBC_H
|
|
|
|
#include <stdio.h>
|
|
|
|
/**
|
|
* Allocate memory or panic in case of failure
|
|
*
|
|
* @param[in] size Number of bytes to be allocated
|
|
*
|
|
* @returns Pointer to memory buffer created with malloc()
|
|
*/
|
|
#define util_malloc(size) \
|
|
__util_malloc(__func__, __FILE__, __LINE__, size)
|
|
|
|
void *__util_malloc(const char *func, const char *file, int line, size_t size);
|
|
|
|
/**
|
|
* Allocate zero-initialized memory or panic in case of failure
|
|
*
|
|
* @param[in] size Number of bytes to be allocated
|
|
*
|
|
* @returns Pointer to memory buffer created with calloc()
|
|
*/
|
|
#define util_zalloc(size) \
|
|
__util_zalloc(__func__, __FILE__, __LINE__, size)
|
|
|
|
void *__util_zalloc(const char *func, const char *file, int line, size_t size);
|
|
|
|
/**
|
|
* Re-allocate memory or exit in case of failure
|
|
*
|
|
* @param[in] ptr Pointer ot old memory buffer
|
|
* @param[in] size Number of bytes to be allocated
|
|
*
|
|
* @returns Pointer to memory buffer created with realloc()
|
|
*/
|
|
#define util_realloc(ptr, size) \
|
|
__util_realloc(__func__, __FILE__, __LINE__, ptr, size)
|
|
|
|
void *__util_realloc(const char *func, const char *file, int line,
|
|
void *ptr, size_t size);
|
|
|
|
/**
|
|
* Duplicate a string buffer or exit in case of failure
|
|
*
|
|
* @param[in] str String to be duplicated
|
|
*
|
|
* @returns Pointer to copied string allocated with malloc()
|
|
*/
|
|
#define util_strdup(str) \
|
|
__util_strdup(__func__, __FILE__, __LINE__, str)
|
|
|
|
void *__util_strdup(const char *func, const char *file, int line,
|
|
const char *str);
|
|
|
|
/**
|
|
* Print to allocated string or exit in case of failure
|
|
*
|
|
* @param[in,out] strp Pointer for returned string allocated with malloc()
|
|
* @param[in] fmt Format string for generation of string
|
|
* @param[in] ap Parameters for format string
|
|
*
|
|
* @returns num Number of formatted characters
|
|
*/
|
|
#define util_vasprintf(strp, fmt, ap) \
|
|
__util_vasprintf(__func__, __FILE__, __LINE__, strp, fmt, ap)
|
|
|
|
#define UTIL_VASPRINTF(strp, fmt, ap) \
|
|
do { \
|
|
va_start(ap, fmt); \
|
|
util_vasprintf(strp, fmt, ap); \
|
|
va_end(ap); \
|
|
} while (0)
|
|
|
|
int __util_vasprintf(const char *func, const char *file, int line,
|
|
char **strp, const char *fmt, va_list ap);
|
|
|
|
/**
|
|
* Print to newly allocated string or exit in case of failure
|
|
*
|
|
* @param[in,out] strp Pointer for returned string allocated with malloc()
|
|
* @param[in] ... Format string and parameters for format string
|
|
*
|
|
* @returns num Number of formatted characters
|
|
*/
|
|
#define util_asprintf(strp, ...) \
|
|
__util_asprintf(__func__, __FILE__, __LINE__, strp, ##__VA_ARGS__)
|
|
|
|
int __util_asprintf(const char *func, const char *file, int line,
|
|
char **strp, const char *fmt, ...);
|
|
|
|
/**
|
|
* Print to string buffer or exit in case of failure
|
|
*
|
|
* @param[in] str String buffer
|
|
* @param[in] fmt Format string for generation of string
|
|
* @param[in] ap Parameters for format string
|
|
*
|
|
* @returns num Number of formatted characters
|
|
*/
|
|
#define util_vsprintf(str, fmt, ap) \
|
|
__util_vsprintf(__func__, __FILE__, __LINE__, str, fmt, ap)
|
|
|
|
#define UTIL_VSPRINTF(str, fmt, ap) \
|
|
do { \
|
|
va_start(ap, fmt); \
|
|
util_vsprintf(str, fmt, ap); \
|
|
va_end(ap); \
|
|
} while (0)
|
|
|
|
int __util_vsprintf(const char *func, const char *file, int line,
|
|
char *str, const char *fmt, va_list ap);
|
|
char *util_strcat_realloc(char *str1, const char *str2);
|
|
void util_str_toupper(char *str);
|
|
|
|
#endif /** LIB_UTIL_LIBC_H @} */
|