src/libelogind/sd-bus/bus-error.h

   1 #pragma once
   2
   3 /***
   4   This file is part of systemd.
   5
   6   Copyright 2013 Lennart Poettering
   7
   8   systemd is free software; you can redistribute it and/or modify it
   9   under the terms of the GNU Lesser General Public License as published by
  10   the Free Software Foundation; either version 2.1 of the License, or
  11   (at your option) any later version.
  12
  13   systemd is distributed in the hope that it will be useful, but
  14   WITHOUT ANY WARRANTY; without even the implied warranty of
  15   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  16   Lesser General Public License for more details.
  17
  18   You should have received a copy of the GNU Lesser General Public License
  19   along with systemd; If not, see <http://www.gnu.org/licenses/>.
  20 ***/
  21
  22 #include <stdbool.h>
  23
  24 #include "sd-bus.h"
  25
  26 #include "macro.h"
  27
  28 bool bus_error_is_dirty(sd_bus_error *e);
  29
  30 const char *bus_error_message(const sd_bus_error *e, int error);
  31
  32 int bus_error_setfv(sd_bus_error *e, const char *name, const char *format, va_list ap) _printf_(3,0);
  33 int bus_error_set_errnofv(sd_bus_error *e, int error, const char *format, va_list ap) _printf_(3,0);
  34
  35 #define BUS_ERROR_OOM SD_BUS_ERROR_MAKE_CONST(SD_BUS_ERROR_NO_MEMORY, "Out of memory")
  36 #define BUS_ERROR_FAILED SD_BUS_ERROR_MAKE_CONST(SD_BUS_ERROR_FAILED, "Operation failed")
  37
  38 /*
  39  * There are two ways to register error maps with the error translation
  40  * logic: by using BUS_ERROR_MAP_ELF_REGISTER, which however only
  41  * works when linked into the same ELF module, or via
  42  * sd_bus_error_add_map() which is the official, external API, that
  43  * works from any module.
  44  *
  45  * Note that BUS_ERROR_MAP_ELF_REGISTER has to be used as decorator in
  46  * the bus error table, and BUS_ERROR_MAP_ELF_USE has to be used at
  47  * least once per compilation unit (i.e. per library), to ensure that
  48  * the error map is really added to the final binary.
  49  */
  50
  51 #define BUS_ERROR_MAP_ELF_REGISTER                                      \
  52         __attribute__ ((__section__("BUS_ERROR_MAP")))                  \
  53         __attribute__ ((__used__))                                      \
  54         __attribute__ ((aligned(8)))
  55
  56 #define BUS_ERROR_MAP_ELF_USE(errors)                                   \
  57         extern const sd_bus_error_map errors[];                         \
  58         __attribute__ ((used)) static const sd_bus_error_map * const CONCATENATE(errors ## _copy_, __COUNTER__) = errors;
  59
  60 /* We use something exotic as end marker, to ensure people build the
  61  * maps using the macsd-ros. */
  62 #define BUS_ERROR_MAP_END_MARKER -'x'
  63
  64 BUS_ERROR_MAP_ELF_USE(bus_standard_errors);