[Unit]
Description=Mein überlebender Dienst
SurviveFinalKillSignal=yes
IgnoreOnIsolate=yes
DefaultDependencies=no
After=basic.target
Conflicts=reboot.target
Before=reboot.target
Conflicts=kexec.target
Before=kexec.target
Conflicts=poweroff.target
Before=poweroff.target
Conflicts=halt.target
Before=halt.target
Conflicts=rescue.target
Before=rescue.target
Conflicts=emergency.target
Before=emergency.target
[Service]
Type=oneshot
ExecStart=sleep infinity


      

/* SPDX-License-Identifier: MIT-0 */
/* Implementiert einen D-Bus-Dienst, der sich automatisch neu verbindet, wenn der Systembus neu gestartet wird.


 *


 * Kompilieren Sie mit »cc sd_bus_service_reconnect.c $(pkg-config --libs --cflags libsystemd)«


 *


 * Um dem Programm zu erlauben, die Eigentümerschaft des Namen »org.freedesktop.ReconnectExample« anzunehmen,


 * fügen Sie folgendes als /etc/dbus-1/system.d/org.freedesktop.ReconnectExample.conf hinzu


 * und laden Sie den Verwalter mit »systemctl reload dbus« neu:
<?xml version="1.0"?> <!--*-nxml-*-->
<!DOCTYPE busconfig PUBLIC "-//freedesktop//DTD D-BUS Bus Configuration 1.0//EN"


        "http://www.freedesktop.org/standards/dbus/1.0/busconfig.dtd">
<busconfig>


        <policy user="root">


                <allow own="org.freedesktop.ReconnectExample"/>


                <allow send_destination="org.freedesktop.ReconnectExample"/>


                <allow receive_sender="org.freedesktop.ReconnectExample"/>


        </policy>


        <policy context="default">


                <allow send_destination="org.freedesktop.ReconnectExample"/>


                <allow receive_sender="org.freedesktop.ReconnectExample"/>


        </policy>
</busconfig>


 *


 * Um die Eigenschaften mittel busctl zu erlangen:


 *


 * $ busctl --user get-property org.freedesktop.ReconnectExample \


 *                              /org/freedesktop/ReconnectExample \


 *                              org.freedesktop.ReconnectExample \


 *                              Example


 *   s "example"


 */
#include <errno.h>
#include <stdio.h>
#include <stdlib.h>
#include <systemd/sd-bus.h>
#define _cleanup_(f) __attribute__((cleanup(f)))
#define check(x) ({                             \


  int _r = (x);                                 \


  errno = _r < 0 ? -_r : 0;                     \


  printf(#x ": %m\n");                          \


  if (_r < 0)                                   \


    return EXIT_FAILURE;                        \


  })
typedef struct object {


  const char *example;


  sd_bus **bus;


  sd_event **event;
} object;
static int property_get(


                sd_bus *bus,


                const char *path,


                const char *interface,


                const char *property,


                sd_bus_message *reply,


                void *userdata,


                sd_bus_error *error) {


  object *o = userdata;


  if (strcmp(property, "Example") == 0)


    return sd_bus_message_append(reply, "s", o->example);


  return sd_bus_error_setf(error,


                           SD_BUS_ERROR_UNKNOWN_PROPERTY,


                           "Unbekannte Eigenschaft »%s«",


                           property);
}
/* https://www.freedesktop.org/software/systemd/man/sd_bus_add_object.html */
static const sd_bus_vtable vtable[] = {


  SD_BUS_VTABLE_START(0),


  SD_BUS_PROPERTY(


    "Example", "s",


    property_get,


    0,


    SD_BUS_VTABLE_PROPERTY_CONST),


  SD_BUS_VTABLE_END
};
static int setup(object *o);
static int on_disconnect(sd_bus_message *message, void *userdata, sd_bus_error *ret_error) {


  check(setup((object *)userdata));


  return 0;
}
/* Sicherstellen, dass sich die Ereignisschleife mit einem klaren Fehler beendet, falls das Erlangen des gut bekannten Dienstenamens fehlschlägt */
static int request_name_callback(sd_bus_message *m, void *userdata, sd_bus_error *ret_error) {


  if (!sd_bus_message_is_method_error(m, NULL))


    return 1;


  const sd_bus_error *error = sd_bus_message_get_error(m);


  if (sd_bus_error_has_names(error, SD_BUS_ERROR_TIMEOUT, SD_BUS_ERROR_NO_REPLY))


    return 1; /* Der Bus ist nicht verfügbar, später erneut versuchen */


  printf("Fehlschlag beim Anfragen des Namens: %s\n", error->message);


  object *o = userdata;


  check(sd_event_exit(*o->event, -sd_bus_error_get_errno(error)));


  return 1;
}
static int setup(object *o) {


  /* Falls es eine Neuverbindung ist, muss das Busobjekt geschlossen, abgehängt von


   * der Ereignisschleife und neu erstellt werden.


   * https://www.freedesktop.org/software/systemd/man/sd_bus_detach_event.html


   * https://www.freedesktop.org/software/systemd/man/sd_bus_close_unref.html


   */


  if (*o->bus) {


    check(sd_bus_detach_event(*o->bus));


    *o->bus = sd_bus_close_unref(*o->bus);


  }


  /* Einrichten eines neuen Busobjekts für den Systembus, dessen Konfiguration, auf die Verfügbarkeit


   * des D-Busses zu warten, statt bei Nichtverfügbarkeit fehlzuschlagen und ihn zu starten. Alle


   * folgenden Aktionen sind asyncron und blockieren nicht beim Warten auf die Verfügbarkeit des D-Bus.


   * https://www.freedesktop.org/software/systemd/man/sd_bus_new.html


   * https://www.freedesktop.org/software/systemd/man/sd_bus_set_address.html


   * https://www.freedesktop.org/software/systemd/man/sd_bus_set_bus_client.html


   * https://www.freedesktop.org/software/systemd/man/sd_bus_negotiate_creds.html


   * https://www.freedesktop.org/software/systemd/man/sd_bus_set_watch_bind.html


   * https://www.freedesktop.org/software/systemd/man/sd_bus_set_connected_signal.html


   * https://www.freedesktop.org/software/systemd/man/sd_bus_start.html


   */


  check(sd_bus_new(o->bus));


  check(sd_bus_set_address(*o->bus, "unix:path=/run/dbus/system_bus_socket"));


  check(sd_bus_set_bus_client(*o->bus, 1));


  check(sd_bus_negotiate_creds(*o->bus, 1, SD_BUS_CREDS_UID|SD_BUS_CREDS_EUID|SD_BUS_CREDS_EFFECTIVE_CAPS));


  check(sd_bus_set_watch_bind(*o->bus, 1));


  check(sd_bus_start(*o->bus));


  /* Veröffentlicht eine Schnittstelle auf dem Bus unter Angabe des gut bekannte Objektzugriffspfades


     und des öffentlichen Schnittstellennamens.


   * https://www.freedesktop.org/software/systemd/man/sd_bus_add_object.html


   * https://dbus.freedesktop.org/doc/dbus-tutorial.html


   */


  check(sd_bus_add_object_vtable(*o->bus,


                                 NULL,


                                 "/org/freedesktop/ReconnectExample",


                                 "org.freedesktop.ReconnectExample",


                                 vtable,


                                 o));


  /* Standardmäßig ist dem Dienst nur ein flüchtiger Name zugewiesen. Der gut bekannte


   * wird hinzugefügt, damit Clients ihn für den Aufruf kennen. Dies muss asynchron erfolgen


   * da der D-Bus noch nicht verfügbar sein könnte. Der Rückruf wird prüfen, ob der Fehler


   * erwartet wurde oder nicht, falls er fehlschlägt.


   * https://www.freedesktop.org/software/systemd/man/sd_bus_request_name.html


   */


  check(sd_bus_request_name_async(*o->bus,


                                  NULL,


                                  "org.freedesktop.ReconnectExample",


                                  0,


                                  request_name_callback,


                                  o));


  /* Wenn der D-Bus abgetrennt wird, wird dieser Rückruf aufgerufen, der die Verbindung


   * erneut einrichtet. Dies muss asynchron erfolgen, da der D-Bus noch nicht verfügbar


   * sein könnte.


   * https://www.freedesktop.org/software/systemd/man/sd_bus_match_signal_async.html


   */


  check(sd_bus_match_signal_async(*o->bus,


                                  NULL,


                                  "org.freedesktop.DBus.Local",


                                  NULL,


                                  "org.freedesktop.DBus.Local",


                                  "Disconnected",


                                  on_disconnect,


                                  NULL,


                                  o));


  /* Das Bus-Objekt an die Ereignisschleife anhängen, so dass Aufrufe und Signale verarbeitet


   * werden.


   * https://www.freedesktop.org/software/systemd/man/sd_bus_attach_event.html


   */


  check(sd_bus_attach_event(*o->bus, *o->event, 0));


  return 0;
}
int main(int argc, char **argv) {


  /* Der Bus sollte aufgegeben werden, bevor sich das Programm beendet. Die


   * Aufräumattribute ermöglichen es, dass dies beim Verlassen des Blocks nett


   * und sauber erfolgt.


   */


  _cleanup_(sd_bus_flush_close_unrefp) sd_bus *bus = NULL;


  _cleanup_(sd_event_unrefp) sd_event *event = NULL;


  object o = {


    .example = "example",


    .bus = &bus,


    .event = &event,


  };


  /* Erzeugt eine Ereignisschleifen-Datenstruktur mit Standard-Parametern.


   * https://www.freedesktop.org/software/systemd/man/sd_event_default.html


   */


  check(sd_event_default(&event));


  /* Standardmäßig wird sich die Ereignisschleife beenden, wenn alle Quellen verschwunden


   * sind, daher muss sie »belegt« bleiben. Dafür wird Signalverarbeitung registriert.


   * https://www.freedesktop.org/software/systemd/man/sd_event_add_signal.html


   */


  check(sd_event_add_signal(event, NULL, SIGINT|SD_EVENT_SIGNAL_PROCMASK, NULL, NULL));


  check(sd_event_add_signal(event, NULL, SIGTERM|SD_EVENT_SIGNAL_PROCMASK, NULL, NULL));


  check(setup(&o));


  /* Eintreten in die Hauptschleife, sie wird nur bei Sigint/Sigterm verlassen.


   * https://www.freedesktop.org/software/systemd/man/sd_event_loop.html


   */


  check(sd_event_loop(event));


  /* https://www.freedesktop.org/software/systemd/man/sd_bus_release_name.html */


  check(sd_bus_release_name(bus, "org.freedesktop.ReconnectExample"));


  return 0;
}