posix_getgrnam
(PHP 4, PHP 5, PHP 7, PHP 8)
posix_getgrnam — Retorna informação sobre um grupo a partir do nome
Descrição
Obtém informação sobre um grupo a partir do nome fornecido.
Parâmetros
name
-
O nome do grupo
Valor Retornado
Retorna um array em caso de sucesso, ou false
em caso de falha.
Os elementos de array retornados são:
Elemento | Descrição |
---|---|
name |
Este elemento contém o nome do grupo. É um "identificador"
curto do grupo, normalmente com menos de 16 caracteres,
e não o nome real completo. Deve ser igual ao
parâmetro name usado ao
chamar a função e, portanto, reduntante.
|
passwd | Este elemento contém a senha do grupo em um formato criptografado. Frequentemente, por exemplo, em um sistema que emprega senhas "ofuscadas", um asterisco é retornado. |
gid | ID do grupo em formato numérico. |
members | Este elemento consistem em um array de strings para todos os membros no grupo. |
Exemplos
Example #1 Exemplo de uso de posix_getgrnam()
<?php
$groupinfo = posix_getgrnam("toons");
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_getgrgid() - Retorna informação sobre um grupo a partir de um ID de grupo
- filegroup() - Lê o grupo do arquivo
- stat() - Obtém informações sobre um arquivo
- Página GETGRNAM(3) do manual POSIX