systemd-soft-reboot.service(8)

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

[Unit]
SurviveFinalKillSignal=yes
IgnoreOnIsolate=yes
DefaultDependencies=no

/* SPDX-License-Identifier: MIT-0 */
/* A D-Bus service that automatically reconnects when the system bus is
\n
 * restarted.
\n
 *
\n
 * Compile with 'cc sd_bus_service_reconnect.c $(pkg-config --libs --cflags libsystemd)'
\n
 *
\n
 * To allow the program to take ownership of the name 'org.freedesktop.ReconnectExample',
\n
 * add the following as /etc/dbus-1/system.d/org.freedesktop.ReconnectExample.conf
\n
 * and then reload the broker with 'systemctl reload dbus':
<?xml version="1.0"?> <!--*-nxml-*-->
<!DOCTYPE busconfig PUBLIC "-//freedesktop//DTD D-BUS Bus Configuration 1.0//EN"
\n
  "http://www.freedesktop.org/standards/dbus/1.0/busconfig.dtd">
<busconfig>
\n
  <policy user="root">
\n
    <allow own="org.freedesktop.ReconnectExample"/>
\n
    <allow send_destination="org.freedesktop.ReconnectExample"/>
\n
    <allow receive_sender="org.freedesktop.ReconnectExample"/>
\n
  </policy>
\n
  <policy context="default">
\n
    <allow send_destination="org.freedesktop.ReconnectExample"/>
\n
    <allow receive_sender="org.freedesktop.ReconnectExample"/>
\n
  </policy>
</busconfig>
\n
 *
\n
 * To get the property via busctl:
\n
 *
\n
 * $ busctl --user get-property org.freedesktop.ReconnectExample \
\n
 *                              /org/freedesktop/ReconnectExample \
\n
 *                              org.freedesktop.ReconnectExample \
\n
 *                              Example
\n
 * s "example"
\n
 */
#include <errno.h>
#include <stdio.h>
#include <stdlib.h>
#include <systemd/sd-bus.h>
#define _cleanup_(f) __attribute__((cleanup(f)))
static int log_error(int r, const char *str) {
\n
  fprintf(stderr, "%s failed: %s\n", str, strerror(-r));
\n
  return r;
}
typedef struct object {
\n
  const char *example;
\n
  sd_bus **bus;
\n
  sd_event **event;
} object;
static int property_get(
\n
                sd_bus *bus,
\n
                const char *path,
\n
                const char *interface,
\n
                const char *property,
\n
                sd_bus_message *reply,
\n
                void *userdata,
\n
                sd_bus_error *error) {
\n
  object *o = userdata;
\n
  if (strcmp(property, "Example") == 0)
\n
    return sd_bus_message_append(reply, "s", o->example);
\n
  return sd_bus_error_setf(error,
\n
                           SD_BUS_ERROR_UNKNOWN_PROPERTY,
\n
                           "Unknown property '%s'",
\n
                           property);
}
/* https://www.freedesktop.org/software/systemd/man/sd_bus_add_object.html */
static const sd_bus_vtable vtable[] = {
\n
  SD_BUS_VTABLE_START(0),
\n
  SD_BUS_PROPERTY(
\n
    "Example", "s",
\n
    property_get,
\n
    0,
\n
    SD_BUS_VTABLE_PROPERTY_CONST),
\n
  SD_BUS_VTABLE_END
};
static int setup(object *o);
static int on_disconnect(sd_bus_message *message, void *userdata, sd_bus_error *ret_error) {
\n
  int r;
\n
  r = setup((object *)userdata);
\n
  if (r < 0) {
\n
    object *o = userdata;
\n
    r = sd_event_exit(*o->event, r);
\n
    if (r < 0)
\n
      return log_error(r, "sd_event_exit()");
\n
  }
\n
  return 1;
}
/* Ensure the event loop exits with a clear error if acquiring the well-known
\n
 * service name fails */
static int request_name_callback(sd_bus_message *m, void *userdata, sd_bus_error *ret_error) {
\n
  int r;
\n
  if (!sd_bus_message_is_method_error(m, NULL))
\n
    return 1;
\n
  const sd_bus_error *error = sd_bus_message_get_error(m);
\n
  if (sd_bus_error_has_names(error, SD_BUS_ERROR_TIMEOUT, SD_BUS_ERROR_NO_REPLY))
\n
    return 1; /* The bus is not available, try again later */
\n
  fprintf(stderr, "Failed to request name: %s\n", error->message);
\n
  object *o = userdata;
\n
  r = sd_event_exit(*o->event, -sd_bus_error_get_errno(error));
\n
  if (r < 0)
\n
    return log_error(r, "sd_event_exit()");
\n
  return 1;
}
static int setup(object *o) {
\n
  int r;
\n
  /* If we are reconnecting, then the bus object needs to be closed, detached
\n
   * from the event loop and recreated.
\n
   * https://www.freedesktop.org/software/systemd/man/sd_bus_detach_event.html
\n
   * https://www.freedesktop.org/software/systemd/man/sd_bus_close_unref.html
\n
   */
\n
  if (*o->bus) {
\n
    r = sd_bus_detach_event(*o->bus);
\n
    if (r < 0)
\n
      return log_error(r, "sd_bus_detach_event()");
\n
    *o->bus = sd_bus_close_unref(*o->bus);
\n
  }
\n
  /* Set up a new bus object for the system bus, configure it to wait for D-Bus
\n
   * to be available instead of failing if it is not, and start it. All the
\n
   * following operations are asynchronous and will not block waiting for D-Bus
\n
   * to be available.
\n
   * https://www.freedesktop.org/software/systemd/man/sd_bus_new.html
\n
   * https://www.freedesktop.org/software/systemd/man/sd_bus_set_address.html
\n
   * https://www.freedesktop.org/software/systemd/man/sd_bus_set_bus_client.html
\n
   * https://www.freedesktop.org/software/systemd/man/sd_bus_negotiate_creds.html
\n
   * https://www.freedesktop.org/software/systemd/man/sd_bus_set_watch_bind.html
\n
   * https://www.freedesktop.org/software/systemd/man/sd_bus_set_connected_signal.html
\n
   * https://www.freedesktop.org/software/systemd/man/sd_bus_start.html
\n
   */
\n
  r = sd_bus_new(o->bus);
\n
  if (r < 0)
\n
    return log_error(r, "sd_bus_new()");
\n
  r = sd_bus_set_address(*o->bus, "unix:path=/run/dbus/system_bus_socket");
\n
  if (r < 0)
\n
    return log_error(r, "sd_bus_set_address()");
\n
  r = sd_bus_set_bus_client(*o->bus, 1);
\n
  if (r < 0)
\n
    return log_error(r, "sd_bus_set_bus_client()");
\n
  r = sd_bus_negotiate_creds(*o->bus, 1, SD_BUS_CREDS_UID|SD_BUS_CREDS_EUID|SD_BUS_CREDS_EFFECTIVE_CAPS);
\n
  if (r < 0)
\n
    return log_error(r, "sd_bus_negotiate_creds()");
\n
  r = sd_bus_set_watch_bind(*o->bus, 1);
\n
  if (r < 0)
\n
    return log_error(r, "sd_bus_set_watch_bind()");
\n
  r = sd_bus_start(*o->bus);
\n
  if (r < 0)
\n
    return log_error(r, "sd_bus_start()");
\n
  /* Publish an interface on the bus, specifying our well-known object access
\n
   * path and public interface name.
\n
   * https://www.freedesktop.org/software/systemd/man/sd_bus_add_object.html
\n
   * https://dbus.freedesktop.org/doc/dbus-tutorial.html
\n
   */
\n
  r = sd_bus_add_object_vtable(*o->bus,
\n
                               NULL,
\n
                               "/org/freedesktop/ReconnectExample",
\n
                               "org.freedesktop.ReconnectExample",
\n
                               vtable,
\n
                               o);
\n
  if (r < 0)
\n
    return log_error(r, "sd_bus_add_object_vtable()");
\n
  /* By default, the service is only assigned an ephemeral name. Also add a
\n
   * well-known one, so that clients know whom to call. This needs to be
\n
   * asynchronous, as D-Bus might not be yet available. The callback will check
\n
   * whether the error is expected or not, in case it fails.
\n
   * https://www.freedesktop.org/software/systemd/man/sd_bus_request_name.html
\n
   */
\n
  r = sd_bus_request_name_async(*o->bus,
\n
                                NULL,
\n
                                "org.freedesktop.ReconnectExample",
\n
                                0,
\n
                                request_name_callback,
\n
                                o);
\n
  if (r < 0)
\n
    return log_error(r, "sd_bus_request_name_async()");
\n
  /* When D-Bus is disconnected this callback will be invoked, which will set up
\n
   * the connection again. This needs to be asynchronous, as D-Bus might not yet
\n
   * be available.
\n
   * https://www.freedesktop.org/software/systemd/man/sd_bus_match_signal_async.html
\n
   */
\n
  r = sd_bus_match_signal_async(*o->bus,
\n
                                NULL,
\n
                                "org.freedesktop.DBus.Local",
\n
                                NULL,
\n
                                "org.freedesktop.DBus.Local",
\n
                                "Disconnected",
\n
                                on_disconnect,
\n
                                NULL,
\n
                                o);
\n
  if (r < 0)
\n
    return log_error(r, "sd_bus_match_signal_async()");
\n
  /* Attach the bus object to the event loop so that calls and signals are
\n
   * processed.
\n
   * https://www.freedesktop.org/software/systemd/man/sd_bus_attach_event.html
\n
   */
\n
  r = sd_bus_attach_event(*o->bus, *o->event, 0);
\n
  if (r < 0)
\n
    return log_error(r, "sd_bus_attach_event()");
\n
  return 0;
}
int main(int argc, char **argv) {
\n
  /* The bus should be relinquished before the program terminates. The cleanup
\n
   * attribute allows us to do it nicely and cleanly whenever we exit the block.
\n
   */
\n
  _cleanup_(sd_bus_flush_close_unrefp) sd_bus *bus = NULL;
\n
  _cleanup_(sd_event_unrefp) sd_event *event = NULL;
\n
  object o = {
\n
    .example = "example",
\n
    .bus = &bus,
\n
    .event = &event,
\n
  };
\n
  int r;
\n
  /* Create an event loop data structure, with default parameters.
\n
   * https://www.freedesktop.org/software/systemd/man/sd_event_default.html
\n
   */
\n
  r = sd_event_default(&event);
\n
  if (r < 0)
\n
    return log_error(r, "sd_event_default()");
\n
  /* By default, the event loop will terminate when all sources have disappeared,
\n
   * so we have to keep it 'occupied'. Register signal handling to do so.
\n
   * https://www.freedesktop.org/software/systemd/man/sd_event_add_signal.html
\n
   */
\n
  r = sd_event_add_signal(event, NULL, SIGINT|SD_EVENT_SIGNAL_PROCMASK, NULL, NULL);
\n
  if (r < 0)
\n
    return log_error(r, "sd_event_add_signal(SIGINT)");
\n
  r = sd_event_add_signal(event, NULL, SIGTERM|SD_EVENT_SIGNAL_PROCMASK, NULL, NULL);
\n
  if (r < 0)
\n
    return log_error(r, "sd_event_add_signal(SIGTERM)");
\n
  r = setup(&o);
\n
  if (r < 0)
\n
    return EXIT_FAILURE;
\n
  /* Enter the main loop, it will exit only on sigint/sigterm.
\n
   * https://www.freedesktop.org/software/systemd/man/sd_event_loop.html
\n
   */
\n
  r = sd_event_loop(event);
\n
  if (r < 0)
\n
    return log_error(r, "sd_event_loop()");
\n
  /* https://www.freedesktop.org/software/systemd/man/sd_bus_release_name.html */
\n
  r = sd_bus_release_name(bus, "org.freedesktop.ReconnectExample");
\n
  if (r < 0)
\n
    return log_error(r, "sd_bus_release_name()");
\n
  return 0;
}