posix_getgrgid

(PHP 4, PHP 5, PHP 7, PHP 8)

posix_getgrgid — Devolver información sobre un grupo mediante un id de grupo

Descripción

posix_getgrgid(int $gid): array

Obtiene información sobre un grupo porporcionando su id.

Parámetros

gid: El id del grupo.

Valores devueltos

Los elementos del array devueltos son:

**El array de información de grupo**
Elemento	Descripción
name	El elemento name contiene el nombre del grupo. Es una abreviatura, normalmente menos de 16 caracteres "soportan" el groupo, no el nombre real completo.
passwd	El elemento passwd contiene la contraseña del grupo en un formato encriptado. A menudo, por ejemplo bajo un sistema que emplea contraseñas "shadow", se devuelve un asterisco en su lugar.
gid	El ID del grupo, debería ser el mismo que el del parámetro `gid` usado al llamar a la función, y por lo tanto redundante.
members	Consiste en un array de strings de todos los miembros del grupo.

Ejemplos

Ejemplo #1 Ejemplo de uso deposix_getgrgid()

<?php

$groupid   = posix_getegid();
$groupinfo = posix_getgrgid($groupid);

print_r($groupinfo);
?>

El resultado del ejemplo sería algo similar a:

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

Ver también

posix_getegid() - Devuelve el ID efectivo de grupo del proceso actual
posix_getgrnam() - Devolver información sobre un grupo mediante su nombre
filegroup() - Obtiene el grupo de un archivo
stat() - Da información acerca de un fichero
POSIX man page GETGRNAM(3)

Improve This Page

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 4 notes

down

tech at dslip dot com dot au ¶

22 years ago

okies...

This code should be considered as an OPTION only, it works under MY set of circumstances, and that is all I intended. The below funtion will return the NAME of the GROUP if provided with the Group ID#

  function RC_posix_getgrgid($gid) 
    {
    $LocationGroup = "/etc/group"; //EDIT THIS IF YOU HAVE A DIFFERENT OS. mine = debian
    $fp = fopen ("/etc/group","r");
    while ($groupinfo = fscanf ($fp, "%[a-zA-Z0-9]:x:%[0-9]:%[a-zA-Z0-9]\n")) 
        {
        list ($name, $groupID, $nfi) = $groupinfo;
        if ($groupID == $gid)
            {
            $returnval = $name;
            }
        }
    fclose($fp);
    if($returnval) { return $returnval; } else { return 0; }
    }

down

cweiske at php dot net ¶

15 years ago

When posix_getgrgid() fails (e.g. an invalid/unknown group id), it returns false.
This is except for Mac OSX on which you get an array with name "nogroup" and gid of "-1".

down

james at jfc dot org dot uk ¶

21 years ago

in php-4.3 the array returned seems to have changed.

it now returns:

["name"] group name
["passwd"] group password
["members"] group members (array of usernames)
["gid"] numeric group id

down

rcgraves+php at brandeis dot edu ¶

24 years ago

Returns an array containing the elements of the group structure. The array has both numeric indices, each of which is a string naming one member of the group, and named string indices. The array elements are:



$_["name"]  string groupname (users)

$_["gid"] integer gidnumber (e.g. 0 for wheel/root)

$_["members"] int number of users in group

$_[0]..$_[n] string usernames in the group

＋add a note