posix_getgrnam

(PHP 4, PHP 5)

posix_getgrnam — Liefert zu einem Gruppennamen Informationen über diese Gruppe

Beschreibung

array posix_getgrnam ( string $name )

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

Parameter-Liste

name: Der Name der Gruppe

Rückgabewerte

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.

Changelog

Version	Beschreibung
4.2.0	Vor dieser Version war members nur eine Ganzzahl, die die Anzahl der Gruppenmitglieder angab, und die Namen der Mitglieder wurden mit numerischen Indizes zurückgegeben.

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() - Liefert diverse Informationen über eine Datei
safe_mode_gid
POSIX GETGRNAM(3)-Manpage

add a note User Contributed Notes
posix_getgrnam

marques at displague dot com
02-Apr-2009 04:12


This function returns 'false' if the group is not found.

add a note

posix_getgroups

posix_getgrgid

Last updated: Fri, 30 Oct 2009