NOMBRE
getgrent, setgrent, endgrent − obtiene una entrada del fichero de grupos
SINOPSIS
#include
<grp.h>
#include <sys/types.h>
struct group *getgrent(void);
void setgrent(void);
void endgrent(void);
DESCRIPCIÓN
La función getgrent() devuelve un puntero a una estructura que contiene la información de grupo de /etc/group. La primera vez que se la llama devuelve la primera entrada; a partir de ahí devuelve las entradas sucesivas.
La función setgrent() rebobina el apuntador de posición del fichero al principio del fichero /etc/group.
La función endgrent() cierra el fichero /etc/group.
La estructura group se define en <grp.h> como sigue:
struct group {
char *gr_name; /* nombre del grupo */
char *gr_passwd; /* contraseña del grupo */
gid_t gr_gid; /* id. del grupo */
char **gr_mem; /* miembros del grupo */
};
VALOR DEVUELTO
La función getgrent() devuelve la dirección de la estructura con información del grupo, o NULL si no hay más entradas o ha ocurrido un error.
ERRORES
|
ENOMEM |
No hay bastante memoria como para alojar la estructura con la información del grupo. |
FICHEROS
/etc/group
fichero con la base de datos de grupos
CONFORME A
SVID 3, BSD 4.3