012c2f761b
As suggest here: https://gcc.gnu.org/onlinedocs/gcc/Attribute-Syntax.html#Attribute-Syntax "You may optionally specify attribute names with ‘__’ preceding and following the name. This allows you to use them in header files without being concerned about a possible macro of the same name. For example, you may use the attribute name __noreturn__ instead of noreturn. "
48 lines
1.9 KiB
C
48 lines
1.9 KiB
C
/* SPDX-License-Identifier: LGPL-2.1+ */
|
|
#pragma once
|
|
|
|
#include <stdbool.h>
|
|
|
|
#include "sd-bus.h"
|
|
|
|
#include "macro.h"
|
|
|
|
bool bus_error_is_dirty(sd_bus_error *e);
|
|
|
|
const char *bus_error_message(const sd_bus_error *e, int error);
|
|
|
|
int bus_error_setfv(sd_bus_error *e, const char *name, const char *format, va_list ap) _printf_(3,0);
|
|
int bus_error_set_errnofv(sd_bus_error *e, int error, const char *format, va_list ap) _printf_(3,0);
|
|
|
|
#define BUS_ERROR_OOM SD_BUS_ERROR_MAKE_CONST(SD_BUS_ERROR_NO_MEMORY, "Out of memory")
|
|
#define BUS_ERROR_FAILED SD_BUS_ERROR_MAKE_CONST(SD_BUS_ERROR_FAILED, "Operation failed")
|
|
|
|
/*
|
|
* There are two ways to register error maps with the error translation
|
|
* logic: by using BUS_ERROR_MAP_ELF_REGISTER, which however only
|
|
* works when linked into the same ELF module, or via
|
|
* sd_bus_error_add_map() which is the official, external API, that
|
|
* works from any module.
|
|
*
|
|
* Note that BUS_ERROR_MAP_ELF_REGISTER has to be used as decorator in
|
|
* the bus error table, and BUS_ERROR_MAP_ELF_USE has to be used at
|
|
* least once per compilation unit (i.e. per library), to ensure that
|
|
* the error map is really added to the final binary.
|
|
*/
|
|
|
|
#define BUS_ERROR_MAP_ELF_REGISTER \
|
|
__attribute__ ((__section__("BUS_ERROR_MAP"))) \
|
|
__attribute__ ((__used__)) \
|
|
__attribute__ ((__aligned__(8)))
|
|
|
|
#define BUS_ERROR_MAP_ELF_USE(errors) \
|
|
extern const sd_bus_error_map errors[]; \
|
|
__attribute__ ((__used__)) \
|
|
static const sd_bus_error_map * const CONCATENATE(errors ## _copy_, __COUNTER__) = errors;
|
|
|
|
/* We use something exotic as end marker, to ensure people build the
|
|
* maps using the macsd-ros. */
|
|
#define BUS_ERROR_MAP_END_MARKER -'x'
|
|
|
|
BUS_ERROR_MAP_ELF_USE(bus_standard_errors);
|