posix_getgrgid

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

posix_getgrgidRetorna informação sobre um grupo a partir de um ID de grupo

Descrição

posix_getgrgid(int $group_id): array|false

Obtém informação sobre um grupo a partir de seu ID fornecido.

Parâmetros

group_id

O ID de grupo.

Valor Retornado

Os elementos de array retornados são:

O array de informação de grupo
Elemento Descrição
name Este elemento contém o nome do grupo. É um nome curto, geralmente um "identificador" do grupo com menos de 16 caracteres, mas não o nome real, completo, do grupo.
passwd Ese elemento contém a senha do grupo em um formato criptografado. Muitas vezes, por exemplo, em um sistema que emprega senhas "ofuscadas", um asterisco é retornado.
gid ID do grupo, deve ser o mesmo que o parâmetro group_id usado na chamada à função e, por isso, redundante.
members Consiste em um array de strings para todos os membros do grupo.
A função retorna false em caso de falha.

Exemplos

Exemplo #1 Exemplo de uso de posix_getgrgid()

<?php

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

print_r($groupinfo);
?>

O exemplo acima produzirá algo semelhante a:

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

Veja Também

  • posix_getegid() - Retorna o ID do grupo efetivo do processo atual
  • posix_getgrnam() - Retorna informação sobre um grupo a partir do nome
  • filegroup() - Lê o grupo do arquivo
  • stat() - Obtém informações sobre um arquivo
  • Página GETGRNAM(3) do manual POSIX

adicione uma nota

Notas Enviadas por Usuários (em inglês) 4 notes

up
1
tech at dslip dot com dot au
23 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; }    }
up
0
cweiske at php dot net
16 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".
up
0
james at jfc dot org dot uk
22 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
up
0
rcgraves+php at brandeis dot edu
25 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
To Top