t_rcvuderr(3N) t_rcvuderr(3N)
NAME
trcvuderr - Fehlerinformation über eine gesendete Dateneinheit emp-
fangen
SYNTAX
#include <sys/tiuser.h>
int trcvuderr(int fd, struct tuderr *uderr);
BESCHREIBUNG
Diese Funktion wird im verbindungslosen Modus dazu verwendet, Informa-
tionen zu empfangen, die einen Fehler bei einer zuvor abgeschickten
Dateneinheit betreffen. Sie sollte nur nach der Anzeige eines Fehlers
aufgerufen werden. Der Transportbenutzer wird darüber informiert, daß
bei einer Dateneinheit mit einer bestimmten Zieladresse und Protokoll-
optionen ein Fehler aufgetreten ist. fd kennzeichnet den lokalen
Transportendpunkt, über den die Fehlermeldung empfangen wird. uderr
verweist auf eine tuderr-Struktur, die folgende Elemente besitzt:
struct netbuf addr;
struct netbuf opt;
long error;
Das Feld maxlen von addr und opt muß gesetzt werden, bevor diese Funk-
tion aufgerufen wird, um jeweils die maximale Puffergröße anzugeben.
Bei der Rückkehr von diesem Aufruf gibt die Struktur addr die Ziel-
Protokolladresse der fehlerhaften Dateneinheit an und die Struktur opt
kennzeichnet die protokollspezifischen Optionen, die mit der Datenein-
heit verbunden waren. error enthält einen protokollabhängigen Fehler-
code.
Wenn der Benutzer die Dateneinheit, die den Fehler erzeugt hat nicht
ermitteln will, so muß uderr auf NULL gesetzt werden und trcvuderr
wird lediglich die Fehlermeldung entfernen, ohne irgendwelche Informa-
tionen an den Benutzer zu liefern.
FEHLER
Im Fehlerfall wird terrno auf einen der folgenden Werte gesetzt:
TBADF Der angegebene Dateideskriptor verweist nicht auf
einen Transportendpunkt.
TNOUDERR Es liegt im Augenblick keine Fehlermeldung einer
Dateneinheit auf dem angegebenen Transportendpunkt
vor.
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98
t_rcvuderr(3N) t_rcvuderr(3N)
TBUFOVFLW Die Anzahl der Bytes, die für die ankommende Proto-
kolladresse oder für die Optionen reserviert wurden,
sind nicht ausreichend, um die Information zu spei-
chern. Die Fehlerinformation über die Dateneinheit,
die in uderr zurückgeliefert werden soll, wird
gelöscht.
TNOTSUPPORT Diese Funktion wird von der darunterliegenden Trans-
portvorrichtung nicht zur Verfügung gestellt.
TSYSERR Während der Ausführung dieser Funktion ist ein System-
fehler aufgetreten.
DIAGNOSE
trcvuderr liefert bei erfolgreicher Beendigung eine 0 zurück. Im Feh-
lerfall wird -1 zurückgegeben und terrno wird gesetzt, um den Fehler
anzugeben.
SIEHE AUCH
trcvudata(3N), tsndudata(3N).
Seite 2 Reliant UNIX 5.44 Gedruckt 11/98