posix_getgrnam

(PHP 4, PHP 5)

posix_getgrnam — Return info about a group by name

Descrição

array posix_getgrnam ( string $name )

Gets information about a group provided its name.

Parâmetros

name: The name of the group

Valor Retornado

The array elements returned are:

**The group information array**
Element	Description
name	The name element contains the name of the group. This is a short, usually less than 16 character "handle" of the group, not the real, full name. This should be the same as the `name` parameter used when calling the function, and hence redundant.
passwd	The passwd element contains the group's password in an encrypted format. Often, for example on a system employing "shadow" passwords, an asterisk is returned instead.
gid	Group ID of the group in numeric form.
members	This consists of an array of string's for all the members in the group.

Histórico

Versão	Descrição
4.2.0	Prior to this version, members was simply an integer representing the number of members in the group, and the member names were returned with numerical indices.

Exemplos

Exemplo #1 Example use of posix_getgrnam()


<?php

$groupinfo = posix_getgrnam("toons");

print_r($groupinfo);
?>

O exemplo acima irá imprimir algo similar a:

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

Veja Também

posix_getegid() - Return the effective group ID of the current process
posix_getgrgid() - Return info about a group by group id
filegroup() - Lê o grupo do arquivo
stat() - Obtem informações sobre um arquivo
safe_mode_gid
POSIX man page GETGRNAM(3)

add a note User Contributed Notes
posix_getgrnam

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


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

add a note

posix_getgroups

posix_getgrgid

Last updated: Fri, 13 Nov 2009