posix_getgrnam

(PHP 4, PHP 5, PHP 7)

posix_getgrnamLiefert zu einem Gruppennamen Informationen über diese Gruppe

Beschreibung

posix_getgrnam ( string $name ) : array

Gibt Informationen über die durch Gruppenname angegebene Gruppe zurück.

Parameter-Liste

name

Der Name der Gruppe

Rückgabewerte

Gibt im Erfolgsfall ein Array zurück. Im Fehlerfall wird FALSE zurückgegeben. Die Elemente des zurückgegebenen Arrays sind:

Das Array mit Gruppeninformationen
Element Beschreibung
name Das name-Element enthält den Namen der Gruppe. Es handelt sich dabei nicht um den wirklichen, kompletten Namen, sondern um einen kurzen "Bezeichner" der Gruppe mit normalerweise weniger als 16 Zeichen. Er sollte derselbe sein wie der Parameter name, der beim Aufruf der Funktion verwendet wurde und ist von daher redundant.
passwd Das passwd-Element enthält das Passwort der Gruppe in verschlüsselter Form. Häufig, zum Beispiel wenn auf einem System "shadow"-Passwörter verwendet werden, wird stattdessen ein Sternchen zurückgegeben.
gid Die Gruppen-ID in numerischem Format
members Besteht aus einem Array von Strings aller Gruppenmitglieder.

Beispiele

Beispiel #1 Beispiel für die Verwendung von posix_getgrnam()

<?php

$gruppeninfo 
posix_getgrnam("toons");

print_r($gruppeninfo);
?>

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

Array
(
    [name]    => toons
    [passwd]  => x
    [members] => Array
        (
            [0] => tom
            [1] => jerry
        )
    [gid]     => 42
)

Siehe auch

  • posix_getegid() - Liefert die effektive Gruppen-ID des aktuellen Prozesses
  • posix_getgrgid() - Liefert zu einer Gruppen-ID Informationen über diese Gruppe
  • filegroup() - Liefert die Gruppenzugehörigkeit einer Datei
  • stat() - Sammelt Informationen über eine Datei
  • POSIX GETGRNAM(3)-Manpage