posix_getgrgid
posix_getgroups
POSIX Funktionen
PHP Manual

# posix_getgrnam

(PHP 4, PHP 5)

posix_getgrnam — Liefert zu einem Gruppennamen Informationen über diese Gruppe

### Beschreibung

array posix_getgrnam ( string `$Gruppenname` )

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

### Parameter-Liste

`Gruppenname`

  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 Zeichenketten 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 posix_getgrnam() Beispiel

`<?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()
- posix_getgrgid()
- filegroup()
- stat()
- safe_mode_gid
- POSIX GETGRNAM(3)-Manpage

posix_getgrgid
posix_getgroups
POSIX Funktionen
PHP Manual