nlsgetcall(3N)                                               nlsgetcall(3N)

NAME
     nlsgetcall - Client-Daten, die durch den Listener übergeben wurden,
     zurückgeben

SYNTAX
     cc [flag ...] file ... -lnls [library ...]

     #include <listen.h>

     struct tcall *nlsgetcall(int fd);

BESCHREIBUNG
     nlsgetcall erlaubt Server-Prozessen, die durch den Listener-Prozeß
     gestartet wurden, auf die tcall-Struktur des Clients zuzugreifen,
     d. h. auf das Argument sndcall von tconnect(3N).

     Die Struktur tcall, die von nlsgetcall zurückgegeben wird, kann mit
     tfree(3N) freigegeben werden.

     nlsgetcall liefert die Adresse einer angelegten tcall-Struktur
     zurück, oder NULL, wenn die Struktur tcall nicht angelegt werden
     kann. Falls talloc erfolgreich war, werden undefinierte Umgebungsva-
     riablen durch ein negatives len-Feld in der entsprechenden netbuf-
     Struktur angezeigt. Ein len-Feld der Länge Null in der netbuf-Struktur
     ist korrekt, und bedeutet, daß der ursprüngliche Puffer in der
     tcall-Struktur des Listeners NULL war.

WARNUNG
     Das len-Feld in der netbuf-Struktur ist als unsigned definiert. Um
     Fehlerrückgabewerte zu überprüfen, sollte der Typ zuerst auf ein int
     umgeändert werden (cast).

     Der Listener-Prozeß begrenzt die Benutzerdatenmenge (udata) und Opti-
     onsdatenmenge (opt) auf jeweils 128 Bytes. Die Adreßdaten in addr sind
     auf 64 Bytes begrenzt. Falls die ursprünglichen Daten länger waren,
     wird kein Überlauf angezeigt.

DIAGNOSE
     Falls keine tcall-Struktur durch talloc angelegt werden kann, wird
     ein NULL-Zeiger zurückgegeben. terrno kann für genauere Fehlerinfor-
     mation verwendet werden. Undefinierte Umgebungsvariablen werden durch
     ein negatives Längenfeld (len) in der entsprechenden netbuf-Struktur
     angezeigt.

HINWEISE
     Bevor Server-Prozesse diese Routinen aufrufen, müssen sie tsync(3N)
     aufrufen.

DATEIEN
     /usr/lib/libnsl.so

     /usr/lib/libnls.a



Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

nlsgetcall(3N)                                               nlsgetcall(3N)

SIEHE AUCH
     nlsadmin(1M), getenv(3C), tconnect(3N), talloc(3N), tfree(3N),
     terror(3N).



















































Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98