Provided by: manpages-de-dev_0.10-1_all bug

NAME
       setpgid, getpgid, setpgrp, getpgrp - setze/hole Prozessgruppe

       Diese  Handbuchseite ist eventuell veraltet. Im Zweifelsfall ziehen Sie
       die englischsprachige Handbuchseite zu Rate, indem Sie

              man -LC 2 setpgid

       eingeben.


"UBERSICHT
       #include <unistd.h>

       int setpgid(pid_t pid, pid_t pgid);
       pid_t getpgid(pid_t pid);
       int setpgrp(void);
       pid_t getpgrp(void);


BESCHREIBUNG
       setpgid setzt die Prozessgruppenkennung (Process Group  ID)  des  durch
       pid  angegebenen  Prozesses  auf  pgid.   Wenn  pid  Null  ist wird die
       aktuelle  Prozesskennung  benutzt.   Wenn  pgid  Null  ist   wird   die
       Prozesskennung des durch pid angegebenen Prozesses benutzt.

       getpgid  gibt die Prozessgruppenkennung des Prozesses zuruck, der durch
       pid angegeben ist.  Wenn pid Null  ist,  wird  die  Prozesskennung  des
       aktuellen Prozesses benutzt.

       In  der  Bibliothek  Linux  DLL 4.4.1 ruft setpgrp einfach setpgid(0,0)
       auf.

       getpgrp ist aquivalent zu getpgid(0).

       Prozessgruppen werden benutzt zur  Verbreitung  von  Signalen  und  von
       Terminals  zum  Verteilen  von Eingabeanforderungen: Prozesses, die die
       gleiche Prozessgruppe haben wie das Terminal, sind im  Vordergrund  und
       durfen  lesen, wahrend andere mit einem Signal blockiert sind, wenn sie
       versuchen zu lesen.

       Diese Aufrufe sind werden also benutzt von Programmen  wie  csh(1),  um
       Prozessgruppen  zu  erzeugen,  um  Job-Kontrolle  zu  realisieren.  Die
       Aufrufe TIOCGPGRP und TIOCSPGRP, die in  termios(4)  beschrieben  sind,
       werden  benutzt, um die Prozessgruppe des kontrollierenden Terminals zu
       lesen/zu setzen.


R"UCKGABEWERT
       Bei Erfolg geben setpgid und setpgrp Null zuruck.  Im  Fehlerfall  wird
       -1 zuruckgegeben und errno entsprechend gesetzt.

       getpgid  gibt bei Erfolg eine Prozessgruppe zuruck.  Im Fehlerfall wird
       -1 zuruckgegeben und errno entsprechend gesetzt.

       getpgrp gibt immer die aktuelle Prozessgruppe zuruck.


FEHLER
       EINVAL pgid ist kleiner als 0.

       EPERM  Verschiedene Zugriffsrechteprobleme.

       ESRCH  pid entspricht keinem Prozess.


SIEHE AUCH
       getuid(2), setsid(2), tcsetpgrp(3), termios(4).