nlsrequest(3N)                                               nlsrequest(3N)

NAME
     nlsrequest - Dienstanforderungsnachricht formatieren und senden

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

     #include <listen.h>

     int nlsrequest(int fd, char *servicecode);

     extern int nlslog, terrno;
     extern char *nlsrmsg;

BESCHREIBUNG
     Bei gegebener virtueller Verbindung zu einem Listener-Prozeß (fd) und
     einem Dienst-Code eines Server-Prozesses, formatiert und sendet
     nlsrequest eine Dienstanforderungsnachricht an den entfernten
     Listener-Prozeß, die ihm mitteilt, daß der angegebene Dienst gestartet
     werden soll. nlsrequest wartet, bis er vom Listener-Prozeß eine Ant-
     wortmeldung auf die Dienstanfrage bekommt. Die Antwort ist dann für
     den Aufrufer in dem statischen Datenpuffer (der mit Null endet) ver-
     fügbar ist, auf den nlsrmsg zeigt. Die Antwortmeldung auf die Dienst-
     anfrage enthält einen Code für Erfolgs- und Fehlermeldungen und eine
     Nachricht in Form von lesbarem Text. Die Nachricht ist vollständig
     druckbar.

DIAGNOSE
     Der Code für eine erfolgreiche bzw. fehlerhafte Durchführung ist der
     Ganzzahlwert, der von nlsrequest zurückgeliefert wird. Null zeigt eine
     erfolgreiche Durchführung an. Negative Werte zeigen Fehler von
     nlsrequest an. Folgende Fehlerwerte sind möglich:

     -1  Fehler in nlsrequest aufgetreten [siehe terror(3N)].

     Positive Werte sind Fehlerrückgabewerte vom Listener-Prozeß. Mnemo-
     technische Abkürzungen für diese Codes sind in <listen.h> definiert.

     2   Anfragenmeldung nicht interpretierbar.

     3   Anfrage-Dienstcode nicht bekannt.

     4   Dienstcode bekannt, aber im Augenblick nicht aktiviert.

     Wenn nlsrmsg nicht null ist, enthält er einen Verweis auf einen sta-
     tischen, mit Null endenden Zeichenpuffer, der die Antwortmeldung auf
     die Dienstanfrage enthält. Beachten Sie, daß nlsrmsg und der Daten-
     puffer beide durch jeden Aufruf von nlsrequest überschrieben werden.

     Falls nlslog nicht Null ist, gibt nlsrequest Fehlermeldungen auf
     stderr aus. Standardwert für nlslog ist Null.





Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

nlsrequest(3N)                                               nlsrequest(3N)

WARNUNG
     nlsrequest kann nicht immer sicher sein, daß der entfernte Server-
     Prozeß erfolgreich gestartet wurde. In diesem Fall kehrt nlsrequest
     ohne Fehleranzeige zurück. Der Aufrufer erhält eine Benachrichtigung,
     daß die Verbindung abgebaut wurde, über eine TLOOK-Fehlerabfrage vor
     oder während des ersten Aufrufs von tsnd oder trcv.

DATEIEN
     /usr/lib/libnsl.so

     /usr/lib/libnls.a

SIEHE AUCH
     nlsadmin(1M), terror(3N).








































Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98