This function returns 'false' if the group is not found.
posix_getgrnam
(PHP 4, PHP 5)
posix_getgrnam — Devolver información sobre un grupo mediante su nombre
Descripción
array posix_getgrnam
( string
$name
)Obtiene información sobre un grupo, proporcioinado su nombre.
Parámetros
-
name -
EL nombre del grupo
Valores devueltos
Los elementos del array devuelto son:
| 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. Debería ser el mismo que el del
parámetro name usado al
llamar a la función, y por lo tanto redundante.
|
| 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 en forma numérica. |
| members | Consiste en un array de strings de todos los miembros del grupo. |
Historial de cambios
| Versión | Descripción |
|---|---|
| 4.2.0 | Antes de esta versión, members era simplemente un entero que representaba el número de miembros del grupo, y los nombres de los miembros eran devueltos con índices numéricos. |
Ejemplos
Ejemplo #1 Ejemplo de uso de posix_getgrnam()
<?php
$groupinfo = posix_getgrnam("toons");
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_getgrgid() - Devolver información sobre un grupo mediante un id de grupo
- filegroup() - Obtiene el grupo de un archivo
- stat() - Da información acerca de un fichero
- safe_mode_gid
- POSIX man page GETGRNAM(3)
