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
SVID 3, POSIX, BSD 4.3
VÉASE TAMBIÉN¶
fgetgrent(3),
getgrent(3),
setgrent(3),
endgrent(3)