innetgr, getnetgrent, setnetgrent oder endnetgrent Subroutine

Zweck

Verarbeitet die Gruppennetzeinträge.

Bibliothek

Standard-C-Bibliothek (libc.a)

Syntax

#include <netdb.h>

void setnetgrent (NetGroup)
char *NetGroup

void endnetgrent ()

Beschreibung

Die Subroutine Innetgr ist threadsicher. Der Rückgabewert verweist jedoch auf statische Daten, die durch nachfolgende Aufrufe überschrieben werden. Diese Daten müssen kopiert werden, damit sie für nachfolgende Aufrufe gespeichert werden können.

Die Subroutine Innetgr gibt 1 oder 0zurück, je nachdem, ob Netzgruppe das Triple Maschine, Benutzer, Domäne als Member enthält. Jede dieser drei Zeichenfolgen, Maschine, Benutzeroder Domäne, kann NULL sein. In diesem Fall gibt sie ein Platzhalterzeichen an.

Die Subroutine Getnetgrent gibt das nächste Mitglied einer Netzgruppe zurück. Nach dem Aufruf enthält Maschinenzeiger einen Zeiger auf eine Zeichenfolge, die den Namen des Maschinenteils des Netzgruppenmitglieds enthält. Ähnliches gilt für Benutzerzeiger und Domänenzeiger. Wenn einer der Werte Maschinenzeiger, Benutzerzeigeroder Domänenzeiger als Nullzeiger zurückgegeben wird, bedeutet dies ein Platzhalterzeichen. Die Subroutine Getnetgrent verwendet malloc, um Speicherplatz für den Namen zuzuordnen. Dieser Speicherbereich wird freigegeben, sobald die Subroutine Endnetzgruppe aufgerufen wird. Getnetgrent gibt 1 zurück, wenn es erfolgreich war, ein weiteres Mitglied der Netzgruppe abzurufen, oder 0, wenn es das Ende der Gruppe erreicht hat.

Die Subroutine Setnetgrent richtet die Netzgruppe ein, aus der die Subroutine Getnetgrent Member abruft, und startet Aufrufe der Subroutine Getnetgrent ab dem Anfang der Liste erneut. Wenn der vorherige setnetgrent () -Aufruf an eine andere Netzgruppe gesendet wurde, wird ein endnetgrent () -Aufruf impliziert. endnetgrent () gibt den während der getnetgrent () -Aufrufe zugeordneten Speicherbereich frei.

Parameter

Rückgabewerte

Dateien