t_snddis() - Verbindung zurückweisen oder abbrechen

#include <xti.h>

int t_snddis(int fd, struct t_call *call);

Beschreibung

Mit der Funktion t_snddis() kann der Benutzer folgende Aktionen veranlassen:

• Verbindungsanforderung zurückweisen

• sofortigen Abbau (abortive release) einer bestehenden Verbindung einleiten

Der Parameter fd spezifiziert den lokalen Transportendpunkt der abzubauenden bzw. angeforderten Verbindung.

Der Parameter call zeigt auf ein Objekt vom Typ struct t_call.

Die Struktur t_call ist in <xti.h> wie folgt deklariert:

struct t_call {
   struct netbuf addr;
   struct netbuf opt;
   struct netbuf udata;
   int sequence;
};

Je nachdem, ob mit t_snddis() eine Verbindungsanforderung zurückgewiesen oder eine Verbindung abgebaut werden soll, wird der Parameter call unterschiedlich verwendet:

• Soll eine Verbindungsanforderung zurückgewiesen werden, darf beim Aufruf von t_snddis() für call nicht der Null-Zeiger übergeben werden. In call->sequence muss der Benutzer einen Wert spezifizieren, der die abgelehnte Verbindungsanforderung gegenüber dem Transportanbieter identifiziert. Die Inhalte von call->addr, call->opt und call->udata werden von t_snddis() ignoriert.

• Soll eine Verbindung abgebaut werden, darf call der Null-Zeiger sein.

Returnwert

0:

Bei Erfolg.

-1:

Bei Fehler. t_ errno wird gesetzt, um den Fehler anzuzeigen.

Fehler

TBADF

Der angegebene Dateideskriptor verweist nicht auf einen Transportendpunkt.

TBADSEQ

Es wurde eine ungültige Folgenummer angegeben, oder bei Ablehnung einer Verbindungsanforderung wurde für call der Null-Zeiger angegeben. Die abgehende Warteschlange des Transportanbieters wird gelöscht, was Datenverlust zur Folge haben kann.

TLOOK

Auf dem durch fd übergebenen Transportendpunkt ist ein asynchrones Ereignis eingetreten und erfordert sofortige Bearbeitung.

TNOTSUPPORT

Diese Funktion wird vom darunter liegenden Transportanbieter nicht unterstützt.

TOUTSTATE

Innerhalb einer Sequenz von XTI-Funktionsaufrufen für den Transportendpunkt fd wurde die Funktion an der falschen Stelle aufgerufen. Die abgehende Warteschlange des Transportanbieters kann gelöscht werden, was Datenverlust zur Folge haben kann.

TSYSERR

Während der Ausführung dieser Funktion ist ein Systemfehler aufgetreten.

Siehe auch

t_connect(), t_getinfo(), t_listen(), t_open()