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)