getgrnam

Autres langues

Langue: es

Autres versions - même langue

Version: 24 Julio 1993 (fedora - 25/11/07)

Section: 3 (Bibliothèques de fonctions)

NOMBRE

getgrnam, getgrgid - obtienen una entrada del fichero de grupos

SINOPSIS

 #include <grp.h>
 #include <sys/types.h>
 
 struct group *getgrnam(const char *nombre);
 
 struct group *getgrgid(gid_t gid);
 

DESCRIPCIÓN

La función getgrnam() devuelve un puntero a una estructura que contiene la información de grupos de /etc/group para la entrada que concuerde con el nombre de grupo nombre.

La función getgrgid() devuelve un puntero a una estructura que contiene la información de grupos de /etc/group para la entrada que concuerde con el GID gid.

La estructura group se define en <grp.h> como sigue:

 
 struct group {
         char    *gr_name;        /* nomnbre del grupo */
         char    *gr_passwd;      /* contraseña del grupo */
         gid_t   gr_gid;          /* ID del grupo */
         char    **gr_mem;        /* miembros del grupo */
 };
 
 

VALOR DEVUELTO

Las funciones getgrnam() y getgrgid() devuelven la dirección de una estructura de información de grupo, o NULL si la entrada pedida no se ha encontrado o ha ocurrido un error.

ERRORES

ENOMEM
Memoria insuficiente para alojar la estructura de información de grupos.

FICHEROS

/etc/group
Fichero de grupos

CONFORME A

SVID 3, POSIX, BSD 4.3

VÉASE TAMBIÉN

fgetgrent(3), getgrent(3), setgrent(3), endgrent(3)