BEZEICHNUNG

       setsid - erzeugt eine neue Sitzung und setzt die Prozessgruppen-ID

ÜBERSICHT

       #include <unistd.h>

       pid_t setsid(void);

BESCHREIBUNG

       setsid()  erzeugt  eine  neue  Sitzung,  wenn  der aufrufende Prozess kein Prozessgruppen-Führer ist. Der
       aufrufende Prozess wird dann Führer der  neuen  Sitzung  (seine  Sitzungs-ID  ist  die  gleiche  wie  die
       Prozess-ID).  Der aufrufende Prozess wird außerdem zum Führer einer neuen Prozessgruppe in dieser Sitzung
       (seine Prozessgruppen-ID ist die gleiche wie die Prozess-ID).

       Der aufrufende Prozess wird der einzige Prozess in der neuen Prozessgruppe und der  neuen  Sitzung  sein.
       Die neue Sitzung hat kein steuerndes Terminal.

RÜCKGABEWERT

       Bei  Erfolg  wird die (neue) Sitzungs-ID des aufrufenden Prozesses zurückgeliefert. Im Fehlerfall ist der
       Rückgabewert (pid_t) -1 und errno wird entsprechend gesetzt.

FEHLER

       EPERM  Die Prozessgruppen-ID  irgendeines  Prozesses  der  Prozessgruppe  ist  die  PID  des  aufrufenden
              Prozesses.  Somit  schlägt  der  Aufruf  von  setsid() insbesondere dann fehl, wenn der aufrufende
              Prozess bereits ein Prozessgruppen-Führer ist.

KONFORM ZU

       POSIX.1-2001, POSIX.1-2008, SVr4.

ANMERKUNGEN

       Ein mittels fork(2) erzeugter Kindprozess erbt die Sitzungs-ID seines Vorfahren. Die  Sitzungs-ID  bleibt
       über einen Aufruf von execve(2) erhalten.

       Ein  Prozessgruppen-Führer  ist  ein  Prozess,  dessen Prozessgruppen-ID und Prozess-ID gleich sind. Wenn
       einem  Prozessgruppen-Führer  verboten  wird,  setsid()  aufzurufen,  wird  auch  verhindert,  dass   der
       Prozessgruppen-Führer  sich  selbst  in  einer  neuen  Sitzung  platziert, während andere Prozesse in der
       Prozessgruppe in ihrer Originalsitzung verbleiben. Solch  ein  Szenario  würde  die  strikte  zweistufige
       Hierarchie  von Sitzungen und Prozessgruppen verletzen. Um sicher zu stellen, dass setsid() funktioniert,
       rufen Sie fork(2) und _exit(2) auf, und lassen Sie setsid() durch den Kindprozess ausführen.

SIEHE AUCH

       setsid(1), getsid(2), setpgid(2), setpgrp(2), tcgetsid(3), credentials(7)

KOLOPHON

       Diese Seite ist Teil der Veröffentlichung  4.04  des  Projekts  Linux-man-pages.  Eine  Beschreibung  des
       Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden
       sich unter http://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG

       Die   deutsche   Übersetzung  dieser  Handbuchseite  wurde  von  Stefan  Janke  <gonzo@burg.studfb.unibw-
       muenchen.de>,   Martin    Eberhard    Schauer    <Martin.E.Schauer@gmx.de>    und    Mario    Blättermann
       <mario.blaettermann@gmail.com> erstellt.

       Diese  Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer
       bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

       Wenn Sie Fehler in der Übersetzung dieser  Handbuchseite  finden,  schicken  Sie  bitte  eine  E-Mail  an
       <debian-l10n-german@lists.debian.org>.

Linux                                            8. August 2015                                        SETSID(2)