BEZEICHNUNG

       setgid - setzt die Gruppenidentität (GID)

ÜBERSICHT

       #include <sys/types.h>
       #include <unistd.h>

       int setgid(gid_t gid);

BESCHREIBUNG

       setgid()  setzt  die  effektive  Gruppen-ID des aufrufenden Prozesses. Wird diese Funktion
       durch den Superuser aufgerufen, werden  auch  die  reale  und  die  gesicherte  Gruppen-ID
       gesetzt.

       Unter   Linux   ist  setgid()  wie  die  POSIX-Version  mit  dem  _POSIX_SAVED_IDS-Merkmal
       implementiert. Das ermöglicht einem setgid-Programm, das nicht  vom  Superuser  aufgerufen
       wurde,  alle  seine  Gruppenprivilegien  abzugeben, einige nicht privilegierte Arbeiten zu
       erledigen und dann auf sichere Art und Weise weiter die ursprüngliche effektive Gruppen-ID
       zu nutzen.

RÜCKGABEWERT

       Bei  Erfolg  wird  Null  zurückgegeben.  Bei  einem Fehler wird -1 zurückgegeben und errno
       entsprechend gesetzt.

FEHLER

       EPERM  Der  aufrufende  Prozess  ist  nicht   privilegiert   (verfügt   nicht   über   die
              CAP_SETGID-Capability)  und  gid  entspricht  nicht  der realen Gruppen-ID oder der
              gespeicherten »set-group«-ID des aufrufenden Prozesses.

KONFORM ZU

       SVr4, POSIX.1-2001.

ANMERKUNGEN

       Der ursprüngliche setgid()-Systemaufruf unterstützte nur 16-Bit-Gruppen-IDs. Danach führte
       Linux 2.4 mit setgid32() die Unterstützung für 32-Bit-IDs hinzu. Die Glibc-Wrapperfunktion
       setgid() behandelt die Unterschiede zwischen den Kernel-Versionen transparent.

SIEHE AUCH

       getgid(2), setegid(2), setregid(2), capabilities(7), credentials(7)

KOLOPHON

       This page is part of release 3.54 of the Linux man-pages project.  A  description  of  the
       project,     and    information    about    reporting    bugs,    can    be    found    at
       http://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG

       Die   deutsche   Übersetzung    dieser    Handbuchseite    wurde    von    Stefan    Janke
       <gonzo@burg.studfb.unibw-muenchen.de>        und       Martin       Eberhard       Schauer
       <Martin.E.Schauer@gmx.de> 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>.