49 lines
2 KiB
C
49 lines
2 KiB
C
/* SPDX-License-Identifier: LGPL-2.1-or-later */
|
|
#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 \
|
|
_section_("SYSTEMD_BUS_ERROR_MAP") \
|
|
_used_ \
|
|
_alignptr_ \
|
|
_variable_no_sanitize_address_
|
|
|
|
#define BUS_ERROR_MAP_ELF_USE(errors) \
|
|
extern const sd_bus_error_map errors[]; \
|
|
_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);
|