2017-11-18 17:09:20 +01:00
|
|
|
/* SPDX-License-Identifier: LGPL-2.1+ */
|
2013-03-19 20:03:16 +01:00
|
|
|
#pragma once
|
|
|
|
|
|
|
|
|
2013-11-19 21:12:59 +01:00
|
|
|
#include <stdbool.h>
|
|
|
|
|
2013-03-19 20:03:16 +01:00
|
|
|
#include "sd-bus.h"
|
2015-11-18 22:46:33 +01:00
|
|
|
|
2013-12-15 23:43:47 +01:00
|
|
|
#include "macro.h"
|
2013-03-19 20:03:16 +01:00
|
|
|
|
2013-03-20 13:10:12 +01:00
|
|
|
bool bus_error_is_dirty(sd_bus_error *e);
|
2013-03-21 22:50:25 +01:00
|
|
|
|
|
|
|
const char *bus_error_message(const sd_bus_error *e, int error);
|
2013-10-16 06:10:04 +02:00
|
|
|
|
2013-12-15 23:43:47 +01:00
|
|
|
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);
|
2014-12-06 02:39:15 +01:00
|
|
|
|
|
|
|
#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[]; \
|
2014-12-10 19:06:43 +01:00
|
|
|
__attribute__ ((used)) static const sd_bus_error_map * const CONCATENATE(errors ## _copy_, __COUNTER__) = errors;
|
2014-12-06 02:39:15 +01:00
|
|
|
|
|
|
|
/* We use something exotic as end marker, to ensure people build the
|
|
|
|
* maps using the macsd-ros. */
|
|
|
|
#define BUS_ERROR_MAP_END_MARKER -'x'
|
|
|
|
|
2014-12-10 19:00:46 +01:00
|
|
|
BUS_ERROR_MAP_ELF_USE(bus_standard_errors);
|