t_error(3N) t_error(3N)
NAME
terror - Fehlermeldung generieren
SYNTAX
#include <sys/tiuser.h>
void terror(char *errmsg);
extern int terrno;
extern char *terrlist[];
extern int tnerr;
BESCHREIBUNG
terror schreibt eine Meldung auf die Standard-Fehlerausgabe, wobei
die Meldung den zuletzt aufgetretenen Fehler beim Aufruf einer Trans-
portfunktion beschreibt. Das Zeichenfolge-Argument errmsg ist eine vom
Benutzer übergebene Meldung, die den Fehler im Kontext beschreibt.
terror gibt die vom Benutzer übergebene Fehlermeldung gefolgt von
einem Doppelpunkt und der Standard-Fehlerausgabe der Transportfunktion
für den aktuellen Wert in terrno aus. Wenn terrno den Wert TSYSERR
besitzt, gibt terror die Standardfehlermeldung auch für den aktuellen
Wert in errno [siehe introprm2(2)] aus.
terrlist ist eine Liste (Array) von Meldungen (als Zeichenfolgen),
die die Formatierung der Benutzermeldungen zu ermöglichen. terrno
kann als Index für dieses Array verwendet werden, um die Fehlermeldung
(als Zeichenkette) zu bekommen (ohne Zeilenendeabschluß). tnerr ist
der maximale Indexwert für das Array terrlist.
terrno wird gesetzt, wenn ein Fehler auftritt, wird jedoch bei dar-
auffolgenden erfolgreichen Aufrufen nicht gelöscht.
BEISPIELE
Wenn die Funktion tconnect auf dem Transportendpunkt fd2 fehlschlägt,
weil eine ungültige Adresse angegeben wurde, kann dem Fehler der fol-
gende Aufruf folgen:
terror("tconnect auf fd2 fehlgeschlagen");
Folgende Meldung wird ausgeben:
tconnect auf fd2 fehlgeschlagen: Falsches Transportadreßformat
"t_connect auf fd2 fehlgeschlagen" teilt dem Benutzer mit, welche
Funktion auf welchem Transportendpunkt fehlgeschlagen ist. "Falsches
Transportadreßformat" zeigt den spezifischen Fehler an, der aufgetre-
ten ist.
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98