getgrnam

Autres langues

Langue: es

Autres versions - même langue

Version: 24 Julio 1993 (openSuse - 09/10/07)

Section: 3 (Bibliothèques de fonctions)

Sommaire

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)