plaintext.at

Einen Daemon in C erstellen

Daemons sind Programme auf Unix-artigen Betriebssystemen, die im Hintergrund arbeiten. Diese Notiz zeigt die nötigen Schritte und ein einfaches Grundgerüst für einen Prozess-Daemon in C.

Einen Prozess-Daemon in C erstellen

Daemons sind Programme auf Unix-artigen Betriebssystemen, die im Hintergrund arbeiten und zu keinem TTY gehören. Deshalb können stdout/stderr nicht wie gewohnt verwendet werden. Für das Protokollieren von Meldungen in Dateien (Debug, Fehler, …) wird üblicherweise ein Syslog-Daemon (syslogd) verwendet. Daemons erledigen meist wichtige, wiederkehrende Aufgaben, ohne dass der Benutzer es mitbekommt.

Um einen Prozess zum Daemon zu machen, sind einige notwendige Schritte nötig:

  • fork – Vom Elternprozess abspalten und ihn beenden, wenn das Forken erfolgreich war. → Weil der Elternprozess beendet ist, läuft der Kindprozess jetzt im Hintergrund.
  • setsid – Eine neue Session erstellen. Der aufrufende Prozess wird Leiter der neuen Session und Leiter der neuen Prozessgruppe. Der Prozess ist jetzt von seinem steuernden Terminal (CTTY) getrennt.
  • Signale abfangen – Signale ignorieren und/oder behandeln.
  • erneut forken und den Elternprozess beenden, damit der Session-Leiter-Prozess wegfällt. (Nur Session-Leiter können wieder ein TTY bekommen.)
  • chdir – Das Arbeitsverzeichnis des Daemons wechseln.
  • umask – Die Dateimodus-Maske an die Bedürfnisse des Daemons anpassen.
  • close – Alle offenen Dateideskriptoren schließen, die vom Elternprozess geerbt sein könnten.

Quellcode – Grundgerüst eines klassischen Prozess-Daemons

Der Quellcode des Daemons ist auch auf GitHub verfügbar: Creating a process daemon in C

/*
 * daemonize.c
 * This example daemonizes a process, writes a few log messages,
 * sleeps 20 seconds and terminates afterwards.
 * This is an answer to the stackoverflow question:
 * https://stackoverflow.com/questions/17954432/creating-a-daemon-in-linux/17955149#17955149
 * Fork this code: https://github.com/pasce/daemon-skeleton-linux-c
 */

#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <signal.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <syslog.h>

static void skeleton_daemon()
{
    pid_t pid;

    /* Fork off the parent process */
    pid = fork();

    /* An error occurred */
    if (pid < 0)
        exit(EXIT_FAILURE);

    /* Success: Let the parent terminate */
    if (pid > 0)
        exit(EXIT_SUCCESS);

    /* On success: The child process becomes session leader */
    if (setsid() < 0)
        exit(EXIT_FAILURE);

    /* Catch, ignore and handle signals */
    /*TODO: Implement a working signal handler */
    signal(SIGCHLD, SIG_IGN);
    signal(SIGHUP, SIG_IGN);

    /* Fork off for the second time*/
    pid = fork();

    /* An error occurred */
    if (pid < 0)
        exit(EXIT_FAILURE);

    /* Success: Let the parent terminate */
    if (pid > 0)
        exit(EXIT_SUCCESS);

    /* Set new file permissions */
    umask(0);

    /* Change the working directory to the root directory */
    /* or another appropriated directory */
    chdir("/");

    /* Close all open file descriptors */
    int x;
    for (x = sysconf(_SC_OPEN_MAX); x>=0; x--)
    {
        close (x);
    }

    /* Open the log file */
    openlog ("firstdaemon", LOG_PID, LOG_DAEMON);
}
int main()
{
    skeleton_daemon();

    while (1)
    {
        //TODO: Insert daemon code here.
        syslog (LOG_NOTICE, "First daemon started.");
        sleep (20);
        break;
    }

    syslog (LOG_NOTICE, "First daemon terminated.");
    closelog();

    return EXIT_SUCCESS;
}

Code kompilieren und ausführen

  • Code kompilieren: gcc -o firstdaemon daemonize.c
  • Daemon starten: ./firstdaemon
  • Prüfen, ob alles richtig funktioniert: ps -xj | grep firstdaemon

Die Ausgabe verstehen

Die Ausgabe sollte ungefähr so aussehen:

+------+------+------+------+-----+-------+------+------+------+-----+
| PPID | PID  | PGID | SID  | TTY | TPGID | STAT | UID  | TIME | CMD |
+------+------+------+------+-----+-------+------+------+------+-----+
|    1 | 3387 | 3386 | 3386 | ?   |    -1 | S    | 1000 | 0:00 | ./  |
+------+------+------+------+-----+-------+------+------+------+-----+

Was wir hier sehen

  • Der Daemon hat kein steuerndes Terminal (TTY = ?)
  • Die ID des Elternprozesses (PPID) ist 1 (der init-Prozess)
  • PID != SID, unser Prozess ist also NICHT der Session-Leiter (wegen des zweiten fork())
  • Weil PID != SID ist, kann der Prozess nicht wieder die Kontrolle über ein TTY übernehmen

Das Syslog lesen

  • Finde deine Syslog-Datei. Unter Ubuntu liegt sie wahrscheinlich hier: /var/log/syslog
  • Im Terminal eingeben: grep firstdaemon /var/log/syslog
  • Die Ausgabe sollte ungefähr so aussehen:
firstdaemon[3387]: First daemon started.
firstdaemon[3387]: First daemon terminated.

Ein Hinweis: Normalerweise möchtest du zusätzlich einen Signal-Handler implementieren und das Logging sauber einrichten (Dateien, Log-Level …).

Schlagwörtercdaemonlinux