timod(7) timod(7)
NAME
timod - STREAMS-Modul für die Zusammenarbeit mit der Transport-
Schnittstelle
BESCHREIBUNG
timod ist ein STREAMS-Modul für die Verwendung mit den Funktionen der
Transport-Schnittstelle (Transport Interface, TI) der Netzdienste-
Bibliothek (Network Services Library). Das timod-Modul wandelt eine
Menge von ioctl(2)-Aufrufen in STREAMS-Nachrichten um, die von einem
Transport-Protokoll-Anbieter gelesen werden können, der die
Transport-Schnittstelle unterstützt. Dadurch erlaubt es dem Benutzer,
bestimmte TI-Funktionen als atomare Operationen auszulösen.
Das timod-Modul darf nur in einen Stream eingeklinkt werden, der bei
einem Transport-Protokoll-Anbieter endet, der seinerseits das TI
unterstützt.
Alle STREAMS-Nachrichten, mit Ausnahme der von den unten beschriebenen
ioctl-Kommandos erzeugten Nachrichten, werden transparent an das
benachbarte STREAMS-Modul oder den Treiber weitergeleitet. Die von den
folgenden ioctl-Kommandos erzeugten Nachrichten werden erkannt und vom
timod-Modul verarbeitet. Das Format des ioctl-Aufrufs ist:
#include <sys/stropts.h>
-
-
struct strioctl strioctl;
-
-
strioctl.iccmd = cmd;
strioctl.ictimeout = INFTIM;
strioctl.iclen = size;
ioctl(fildes, ISTR, &strioctl);
Wobei beim Aufruf size die Größe der entsprechenden TI-Nachricht ist,
die an den Transport-Anbieter gesendet werden soll. Nach der Rückkehr
ist size die Größe der entsprechenden TI-Nachricht des Transport-
Anbieters als Antwort auf die aufgerufene TI-Nachricht. buf ist ein
Zeiger auf einen Puffer, der groß genug ist, den Inhalt der jeweiligen
TI-Nachrichten aufzunehmen. Die TI-Nachrichtentypen sind in
<sys/tihdr.h> definiert. Die möglichen Werte für die Komponente cmd
sind:
TIBIND Binde eine Adresse an den zugrundeliegenden Transport-
Protokoll-Anbieter. Die Nachricht, die für das ioctl-
Kommando TIBIND aufgerufen wird, ist äquivalent zur
TI-Nachrichtenart TBINDREQ, und die nach der erfol-
greichen Beendigung von ioctl zurückgelieferte Nach-
richt ist äquivalent zur TI-Nachrichtenart TBINDACK.
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98
timod(7) timod(7)
TIUNBIND Bindung einer Adresse zum zugrundeliegenden Transport-
Protokoll-Anbieter auflösen. Die Nachricht, die für das
ioctl-Kommando TIUNBIND aufgerufen wird, ist äquiva-
lent zur TI-Nachrichtenart TUNBINDREQ, und die nach
der erfolgreichen Beendigung von ioctl zurückgelieferte
Nachricht ist äquivalent zur TI-Nachrichtenart
TOKACK.
TIGETINFO Ermittle die TI-protokoll-spezifischen Informationen
vom Transport-Protokoll-Anbieter. Die Nachricht, die
für das ioctl-Kommando TIGETINFO aufgerufen wird, ist
äquivalent zur TI-Nachrichtenart TINFOREQ, und die
nach der erfolgreichen Beendigung von ioctl zurückge-
lieferte Nachricht ist äquivalent zur TI-Nachrichtenart
TINFOACK.
TIOPTMGMT Lese, setze oder verändere protokoll-spezifische Optio-
nen des Transport-Protokoll-Anbieters. Die Nachricht,
die für das ioctl-Kommando TIOPTMGMT aufgerufen wird,
ist äquivalent zur TI-Nachrichtenart TOPTMGMTREQ, und
die nach der erfolgreichen Beendigung von ioctl zurück-
gelieferte Nachricht ist äquivalent zur TI-Nachrichten-
art TOPTMGMTACK.
DIAGNOSE
Wenn der Systemaufruf ioctl mit einem Wert größer als 0 zurückkehrt,
dann stellen die niederwertigen acht Bit des Ergebnisses einen der
TI-Fehlercodes dar, die in <sys/tiuser.h> definiert sind. Ist der TI-
Fehler von der Art TSYSERR, dann enthalten die nächsten acht Bit des
Ergebnisses einen Fehler, wie er in <sys/errno.h> definiert ist [siehe
introprm2(2)].
DATEIEN
<sys/timod.h>
<sys/tiuser.h>
<sys/tihdr.h>
<sys/errno.h>
SIEHE AUCH
tirdwr(7).
Leitfaden für Programmierer: STREAMS
Leitfaden für Programmierer: Netzwerkschnittstellen
Seite 2 Reliant UNIX 5.44 Gedruckt 11/98