table of contents
GETGRENT(3) | Linux-Programmierhandbuch | GETGRENT(3) |
BEZEICHNUNG¶
getgrent, setgrent, endgrent - holt einen Eintrag aus der GruppendateiÜBERSICHT¶
#include <sys/types.h> #include <grp.h>struct group *getgrent(void);void setgrent(void);void endgrent(void);
Mit Glibc erforderliche Makros (siehe feature_test_macros(7)):
_SVID_SOURCE || _BSD_SOURCE ||
_XOPEN_SOURCE >= 500 ||
_XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED ||
/* seit Glibc 2.12: */ _POSIX_C_SOURCE >= 200809L
_SVID_SOURCE || _BSD_SOURCE ||
_XOPEN_SOURCE >= 500 ||
_XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED
BESCHREIBUNG¶
Die Funktion getgrent() gibt einen Zeiger auf eine Struktur zurück, welche die Felder eines Eintrags in der Gruppendatenbank enthält (z.B. die lokale Gruppendatei /etc/group, NIS und LDAP). Beim ersten Aufruf gibt sie den ersten Eintrag zurück, danach bei jedem weiteren Aufruf die folgenden Einträge. Die Funktion setgrent() setzt den Dateizeiger auf den Anfang der Gruppendatenbank zurück, um wiederholte Abfragen zu ermöglichen. Die Funktion endgrent() wird dazu verwendet, die Gruppendatenbank zu schließen, nachdem die gesamte Verarbeitung durchgeführt wurde. Die Struktur group ist in <grp.h> wie folgt definiert:struct group { char *gr_name; /* Gruppenname */ char *gr_passwd; /* Gruppenpasswort */ gid_t gr_gid; /* Gruppenkennung */ char **gr_mem; /* Gruppenmitglieder */ };
Für weitere Informationen über die Felder dieser Struktur lesen Sie group(5).
RÜCKGABEWERT¶
Die Funktion getgrent() gibt einen Zeiger auf eine group-Struktur zurück oder NULL, falls es keine weiteren Einträge mehr gibt oder ein Fehler auftritt. Im Fehlerfall kann errno gesetzt werden. Wenn Sie errno nach dem Aufruf auswerten wollen, sollten Sie die Variable vorher auf Null setzen.FEHLER¶
- EINTR
- Es wurde ein Signal abgefangen.
- EIO
- E/A-Fehler
- EMFILE
- Der aufrufende Prozess hat schon zu viele offene Dateien.
- ENFILE
- Zu viele offene Dateien im System.
- ENOMEM
- Es ist nicht ausreichend Speicher für die Bereitstellung einer group-Struktur vorhanden.
- ERANGE
- zu wenig Pufferspeicher bereitgestellt
DATEIEN¶
- /etc/group
- lokale Gruppendatenbank-Datei
KONFORM ZU¶
SVr4, 4.3BSD, POSIX.1-2001.SIEHE AUCH¶
fgetgrent(3), getgrent_r(3), getgrgid(3), getgrnam(3), getgrouplist(3), putgrent(3), group(5)KOLOPHON¶
Diese Seite ist Teil der Veröffentlichung 3.42 des Projekts Linux- man-pages. Eine Beschreibung des Projekts und Informationen, wie Fehler gemeldet werden können, finden sich unter http://www.kernel.org/doc/man-pages/.ÜBERSETZUNG¶
Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann <debian@helgefjell.de> und Martin Eberhard Schauer <Martin.E.Schauer@gmx.de> erstellt.21. Oktober 2010 |