302 lines
18 KiB
HTML
302 lines
18 KiB
HTML
<HTML>
|
|
<HEAD>
|
|
<TITLE>Int 7C/AX=0007h
|
|
</TITLE>
|
|
<META NAME="Description" CONTENT="
|
|
Int 7C/AX=0007h - SK-UPPS Data Link Interface API - REGISTER PROTOCOL -
|
|
AX = 0007h
|
|
ES:BX - Protocol Control Block (see #03849)
|
|
Return: AX = completion code (see #03846)
|
|
Program: SK-UPPS is the Schneider & Koch Universal Portable Protocol Stack,
|
|
which provides an API on top of its Data Link Interface, allowing the
|
|
use of any of several network transport layers
|
|
SeeAlso: AX=0008h,AX=000Bh
|
|
Format of SK-UPPS Protocol Control Block (PCB):
|
|
Offset Size Description (Table 03849)
|
|
">
|
|
<META NAME="robots" CONTENT="none">
|
|
</HEAD>
|
|
<BODY BGCOLOR="#FFD0A0">
|
|
<center>
|
|
<h2>Int 7C/AX=0007h
|
|
</h2>
|
|
</center><p>
|
|
<table border=1 cellpadding=3 cellspacing=1>
|
|
<td>
|
|
<a href="rb-7925.htm" tppabs="http://www.ctyme.com/intr/rb-7925.htm">
|
|
<img src="lup.gif" tppabs="http://graphics.ctyme.com/gif/lup.gif" border=0 alt=Prev></a>
|
|
<a href="rb-7927.htm" tppabs="http://www.ctyme.com/intr/rb-7927.htm">
|
|
<img src="ldown.gif" tppabs="http://graphics.ctyme.com/gif/ldown.gif" border=0 alt=Next></a>
|
|
<a href="javascript:if(confirm('http://www.ctyme.com/rbrown.htm \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/rbrown.htm'" tppabs="http://www.ctyme.com/rbrown.htm">
|
|
<img src="lhome.gif" tppabs="http://graphics.ctyme.com/gif/lhome.gif" border=0 alt=Ralf Brown Page></a>
|
|
<td><a href="int.htm" tppabs="http://www.ctyme.com/intr/int.htm">Interrups</a></td>
|
|
<td><a href="cat.htm" tppabs="http://www.ctyme.com/intr/cat.htm">Categories</a></td>
|
|
<td><a href="alpha.htm" tppabs="http://www.ctyme.com/intr/alpha.htm">Contents</a></td>
|
|
</td></table><p>
|
|
<p><img src="rbline.gif" tppabs="http://graphics.ctyme.com/gif/rbline.gif" width="100%" alt="------"><p>
|
|
<h3><font color=#C00040>SK-UPPS Data Link Interface API - REGISTER PROTOCOL</font></h3>
|
|
<PRE>
|
|
AX = 0007h
|
|
ES:BX -> Protocol Control Block <a href="rb-7926.htm#Table3849" tppabs="http://www.ctyme.com/intr/rb-7926.htm#Table3849">(see #03849)</a><br>
|
|
<p><b>Return:</b><br>AX = completion code (see #03846)
|
|
</PRE>
|
|
<p><b>Program:</b>
|
|
SK-UPPS is the Schneider & Koch Universal Portable Protocol Stack,
|
|
which provides an API on top of its Data Link Interface, allowing the
|
|
use of any of several network transport layers
|
|
<p><b>See Also:</b>
|
|
<a href="rb-7927.htm" tppabs="http://www.ctyme.com/intr/rb-7927.htm">AX=0008h</a> - <a href="rb-7930.htm" tppabs="http://www.ctyme.com/intr/rb-7930.htm">AX=000Bh</a>
|
|
<PRE>
|
|
<p>
|
|
Format of SK-UPPS Protocol Control Block (PCB):
|
|
<a name=table3849></a>
|
|
Offset Size Description (Table 03849)
|
|
00h WORD (big-endian) protocol type
|
|
02h WORD protocol mode <a href="rb-7926.htm#Table3850" tppabs="http://www.ctyme.com/intr/rb-7926.htm#Table3850">(see #03850)</a>
|
|
04h DWORD -> Receive Upcall routine <a href="rb-7926.htm#Table3851" tppabs="http://www.ctyme.com/intr/rb-7926.htm#Table3851">(see #03851)</a>
|
|
08h DWORD -> Transmit Upcall routine
|
|
0Ch DWORD -> Event Upcall routine <a href="rb-7926.htm#Table3853" tppabs="http://www.ctyme.com/intr/rb-7926.htm#Table3853">(see #03853)</a>
|
|
10h DWORD -> ASCIZ protocol name (zero if none)
|
|
14h WORD protocol ID will be returned here (always non-zero)
|
|
<p>
|
|
Bitfields for SK-UPPS protocol mode:
|
|
<a name=table3850></a>
|
|
Bit(s) Description (Table 03850)
|
|
0 promiscuous mode; protocol receives all frames regardless of their
|
|
destination (PROTOCOL TYPE must be FFFFh)
|
|
1 if set, protocol's Event Upcall will be called on entry and exit of the
|
|
DLI's Interrupt Service Routine <a href="rb-7926.htm#Table3854" tppabs="http://www.ctyme.com/intr/rb-7926.htm#Table3854">(see #03854)</a>
|
|
2 DLI 2.2+ hook mode; protocol receives all directed frames destined for
|
|
this station (PROTOCOL TYPE must be FFFFh)
|
|
3 DLI 2.3+ receive error frames (only valid in promiscuous mode (0))
|
|
4-5 DLI 2.5+ frame type:.
|
|
00 Ethernet II; specify type code in PROTOCOL TYPE field (high-low).
|
|
01 IEEE 802.2; specify Service Access Point (SAP) in MSB
|
|
(offset 0) of PROCOTOL TYPE field; LSB must be zero.
|
|
10 IEEE 802.2 with SNAP header; specify type code in PROTOCOL TYPE
|
|
field (high-low).
|
|
11 reserved (currently unused)
|
|
6 DLI 2.5+ if set, protocol's Event Upcall will be called with event code
|
|
EV_BUFFER_WANTED, when DLI runs out of Mbufs
|
|
7 DLI 2.7+ chain mode; if set, client allows the specified frame type to
|
|
be shared with other clients
|
|
8 DLI 2.8+ receive non-LLC frames rather than LLC frames
|
|
9 DLI 2.8+ receive all multicast frames (see also AX=0009h)
|
|
10-15 reserved (currently unused; must be zero)
|
|
</PRE>
|
|
<p><b>Notes:</b>
|
|
If PROTOCOL TYPE is FFFFh and neither the "promiscuous" nor the "hook"
|
|
mode is set, the protocol receives all frames that did not match
|
|
any registered frame type (demultiplexor mode)..
|
|
Protocols using "promiscuous", "hook" or "chain" mode should always
|
|
return from the Receive Upcall with the received Mbuf in ES:BX and
|
|
the Carry Flag set. The DLI will then pass the Mbuf to the FEED BACK
|
|
BUFFER function (see AX=000Fh)..
|
|
Some DLIs do not support all or even any of the "promiscuous",
|
|
"receive non-LLC" and "receive all multicasts" mode bits.
|
|
<p><b>See Also:</b>
|
|
#03849
|
|
<PRE>
|
|
<p>
|
|
<a name=table3851></a>
|
|
(Table 03851)
|
|
Values SK-UPPS Receive Upcall is called with:.
|
|
ES:BX -> Mbuf.
|
|
AX = receive status <a href="rb-7926.htm#Table3852" tppabs="http://www.ctyme.com/intr/rb-7926.htm#Table3852">(see #03852)</a> (also stored in Mbuf's RECEIVE STATUS field).
|
|
Interrupts disabled<br>
|
|
<p><b>Return:</b><br>Nothing
|
|
</PRE>
|
|
<p><b>See Also:</b>
|
|
#03853
|
|
<PRE>
|
|
<p>
|
|
Bitfields for SK-UPPS receive status:
|
|
<a name=table3852></a>
|
|
Bit(s) Description (Table 03852)
|
|
0-2 reserved (0), currently unused
|
|
3 frame check sequence (FCS) error
|
|
4 overflow (frame too long)
|
|
5 framing error
|
|
6 reserved (0), currently unused
|
|
7 non-LLC frame <a href="javascript:if(confirm('http://www.ctyme.com/intr/rb-0000.htm \n\nThis file was not retrieved by Teleport Pro, because it was unavailable, or its retrieval was aborted, or the project was stopped too soon. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/intr/rb-0000.htm#Table0'" tppabs="http://www.ctyme.com/intr/rb-0000.htm#Table0"></a>(see #03850 [bit 8])
|
|
8-15 reserved (0), currently unused
|
|
</PRE>
|
|
<p><b>Notes:</b>
|
|
The protocol's Receive Upcall routine will be called whenever a frame
|
|
matching the specified frame type is received. A received frame is
|
|
passed to the protocol in the Mbuf's DATA area at OFFSET and its size
|
|
is LENGTH bytes..
|
|
The receive status passed to the Receive Upcall in register AL is
|
|
always zero, except for protocols using "non-LLC" mode (8 of PCB's
|
|
protocol mode field) or "promiscuous" mode together with "receive
|
|
error frames" (0 & 3)..
|
|
Upcalls are FAR routines and must return with a RET FAR. If the Carry
|
|
Flag is set on return from a Receive or Transmit Upcall, then ES:BX
|
|
must point to an Mbuf, which the DLI will then pass to the RELEASE
|
|
BUFFER function (see AX=0005h). See also notes for PROTOCOL MODE.
|
|
<PRE>
|
|
<p>
|
|
<a name=table3853></a>
|
|
(Table 03853)
|
|
Values SK-UPPS Event Upcall is called with:.
|
|
AX = event code <a href="rb-7926.htm#Table3854" tppabs="http://www.ctyme.com/intr/rb-7926.htm#Table3854">(see #03854)</a><br>
|
|
<p><b>Return:</b><br>Nothing
|
|
</PRE>
|
|
<p><b>Note:</b>
|
|
All Event Upcalls may be ignored by the protocol.
|
|
<p><b>See Also:</b>
|
|
#03851
|
|
<PRE>
|
|
<p>
|
|
<a name=table3854></a>
|
|
(Table 03854)
|
|
Values for SK-UPPS Event Upcall event code:
|
|
00h EV_BUFFER_AVAILABLE client may now call REQUEST BUFFER (AX=0004h)
|
|
01h EV_ISR_START start of Interrupt Service Routine
|
|
02h EV_ISR_END end of ISR <a href="javascript:if(confirm('http://www.ctyme.com/intr/rb-0000.htm \n\nThis file was not retrieved by Teleport Pro, because it was unavailable, or its retrieval was aborted, or the project was stopped too soon. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/intr/rb-0000.htm#Table0'" tppabs="http://www.ctyme.com/intr/rb-0000.htm#Table0"></a>(see #03850 [bit 1])
|
|
03h EV_BUFFER_WANTED DLI temporarily out of Mbufs
|
|
04h EV_NETWORK_STATUS DLI 2.8+ network status -- DX=status <a href="rb-7926.htm#Table3855" tppabs="http://www.ctyme.com/intr/rb-7926.htm#Table3855">(see #03855)</a>
|
|
05h EV_IO_CONTROL DLI 2.8+ I/O control -- DX=subfunc (see AX=0016h)
|
|
</PRE>
|
|
<p><b>See Also:</b>
|
|
#03853
|
|
<PRE>
|
|
<p>
|
|
Bitfields for EV_NETWORK_STATUS in register DX:
|
|
<a name=table3855></a>
|
|
Bit(s) Description (Table 03855).
|
|
Token-Ring FDDI
|
|
15 SIGNAL_LOSS SIGNAL_LOSS
|
|
14 HARD_ERROR HARD_ERROR
|
|
13 SOFT_ERROR SOFT_ERROR
|
|
12 TRANSMIT_BEACON TRANSMIT_BEACON
|
|
11 LOBE_WIRE_FAULT PATH_TEST_FAILED
|
|
10 AUTO_REMOVAL SELF_TEST_REQUIRED
|
|
9 reserved reserved
|
|
8 REMOVE_RECEIVED REMOTE_DISCONNECT
|
|
7 COUNTER_OVERFLOW reserved
|
|
6 SINGLE_STATION DUPLICATE_ADDRESS
|
|
5 RING_RECOVERY NO_RING_OP_STATUS
|
|
4 reserved VERSION_MISMATCH
|
|
3 reserved STUCK_BYPASS
|
|
2 reserved FDDI_EVENT
|
|
1 reserved RING_OP_CHANGE
|
|
0 reserved reserved
|
|
</PRE>
|
|
<p><b>Note:</b>
|
|
EV_NETWORK_STATUS is not supported on Ethernet
|
|
<p>
|
|
<b>Category: <a href="cat-027.htm" tppabs="http://www.ctyme.com/intr/cat-027.htm">
|
|
Network</a>
|
|
- <a href="int-7c-1.htm" tppabs="http://www.ctyme.com/intr/int-7C.htm">
|
|
Int 7Ch</a>
|
|
- <a href="alpha-s.htm" tppabs="http://www.ctyme.com/intr/alpha-s.htm">
|
|
S</a>
|
|
</b><p><p><img src="rbline.gif" tppabs="http://graphics.ctyme.com/gif/rbline.gif" width="100%" alt="------"><p>
|
|
<table border=1 cellpadding=3 cellspacing=1>
|
|
<td>
|
|
<a href="rb-7925.htm" tppabs="http://www.ctyme.com/intr/rb-7925.htm">
|
|
<img src="lup.gif" tppabs="http://graphics.ctyme.com/gif/lup.gif" border=0 alt=Prev></a>
|
|
<a href="rb-7927.htm" tppabs="http://www.ctyme.com/intr/rb-7927.htm">
|
|
<img src="ldown.gif" tppabs="http://graphics.ctyme.com/gif/ldown.gif" border=0 alt=Next></a>
|
|
<a href="javascript:if(confirm('http://www.ctyme.com/rbrown.htm \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/rbrown.htm'" tppabs="http://www.ctyme.com/rbrown.htm">
|
|
<img src="lhome.gif" tppabs="http://graphics.ctyme.com/gif/lhome.gif" border=0 alt=Ralf Brown Page></a>
|
|
<td><a href="int.htm" tppabs="http://www.ctyme.com/intr/int.htm">Interrups</a></td>
|
|
<td><a href="cat.htm" tppabs="http://www.ctyme.com/intr/cat.htm">Categories</a></td>
|
|
<td><a href="alpha.htm" tppabs="http://www.ctyme.com/intr/alpha.htm">Contents</a></td>
|
|
</td></table><p>
|
|
|
|
<!-- Bottom Link Start -->
|
|
|
|
<center>
|
|
|
|
<p><table border=1 bgcolor="#ffff99"><tr><td>
|
|
<table border=0 height=80>
|
|
<tr align=center><td width="65">
|
|
|
|
<a href="javascript:if(confirm('http://www.ctyme.com/sponsor.htm \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/sponsor.htm'" tppabs="http://www.ctyme.com/sponsor.htm">
|
|
<img src="tip.gif" tppabs="http://graphics.ctyme.com/gif/tip.gif" ALT="Sponsors" height="40" width="40"></a>
|
|
<br><a href="javascript:if(confirm('http://www.ctyme.com/sponsor.htm \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/sponsor.htm'" tppabs="http://www.ctyme.com/sponsor.htm">Shopping</a>
|
|
|
|
</td><td width="65">
|
|
|
|
<a href="javascript:if(confirm('http://talk.ctyme.com/webx.cgi?13@@.ee6b2be \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://talk.ctyme.com/webx.cgi?13@@.ee6b2be'" tppabs="http://talk.ctyme.com/webx.cgi?13@@.ee6b2be">
|
|
<img src="comment.gif" tppabs="http://graphics.ctyme.com/gif/comment.gif" ALT="Forum" height="40" width="40"></a>
|
|
<br><a href="javascript:if(confirm('http://talk.ctyme.com/webx.cgi?13@@.ee6b2be \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://talk.ctyme.com/webx.cgi?13@@.ee6b2be'" tppabs="http://talk.ctyme.com/webx.cgi?13@@.ee6b2be">Forum</a>
|
|
|
|
</td><td width="65">
|
|
|
|
<a href="javascript:if(confirm('http://www.ctyme.com/mail.htm \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/mail.htm'" tppabs="http://www.ctyme.com/mail.htm">
|
|
<img src="mail.gif" tppabs="http://graphics.ctyme.com/gif/mail.gif" ALT="email" height="40" width="40"></a>
|
|
<br><a href="javascript:if(confirm('http://www.ctyme.com/mail.htm \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/mail.htm'" tppabs="http://www.ctyme.com/mail.htm">EMail</a>
|
|
|
|
</td><td width="65">
|
|
|
|
<a href="javascript:if(confirm('http://www.ctyme.com/map.htm \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/map.htm'" tppabs="http://www.ctyme.com/map.htm">
|
|
<img src="toc.gif" tppabs="http://graphics.ctyme.com/gif/toc.gif" ALT="Index" height="40" width="40"></a>
|
|
<br><a href="javascript:if(confirm('http://www.ctyme.com/map.htm \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/map.htm'" tppabs="http://www.ctyme.com/map.htm">Index</a>
|
|
|
|
</td><td width="65">
|
|
|
|
<a href="javascript:if(confirm('http://www.ctyme.com/ \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/'" tppabs="http://www.ctyme.com/">
|
|
<img src="home.gif" tppabs="http://graphics.ctyme.com/gif/home.gif" ALT="Home" height="40" width="40"></a>
|
|
<br><a href="javascript:if(confirm('http://www.ctyme.com/ \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/'" tppabs="http://www.ctyme.com/">Home</a>
|
|
|
|
</td><td width="90">
|
|
|
|
<center>
|
|
<FORM ACTION="https://secure.paypal.com/cgi-bin/webscr" tppabs="https://secure.paypal.com/cgi-bin/webscr" METHOD="POST" traget="_blank">
|
|
<INPUT TYPE="hidden" NAME="cmd" VALUE="_xclick">
|
|
<INPUT TYPE="hidden" NAME="business" VALUE="marc@perkel.com">
|
|
<INPUT TYPE="hidden" NAME="return" VALUE="http://www.perkel.com">
|
|
<INPUT TYPE="hidden" NAME="item_name" VALUE="Donation To Support this Site">
|
|
<INPUT TYPE="hidden" NAME="no_intl" VALUE="1">
|
|
<INPUT TYPE="image" SRC="x-click-but7.gif" tppabs="http://images.paypal.com/images/x-click-but7.gif" vspace=9
|
|
NAME="submit" ALT="Make payments with PayPal - it's fast, free and secure!">
|
|
</FORM>
|
|
|
|
</td></tr></table></td></tr></table><p>
|
|
|
|
|
|
<center>
|
|
<p>
|
|
<a href="javascript:if(confirm('http://www.ctyme.com/hosting/index.htm \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/hosting/index.htm'" tppabs="http://www.ctyme.com/hosting/index.htm" target="_blank">
|
|
<img src="ctymehost.gif" tppabs="http://graphics.ctyme.com/gif/ctymehost.gif"
|
|
border=3 height=60 width=468></a>
|
|
<p>
|
|
<!-- Ad End --->
|
|
|
|
</center>
|
|
<FORM ACTION="http://service.bfast.com/bfast/click" target="_blank">
|
|
<INPUT TYPE="hidden" NAME="siteid" VALUE="30472466" >
|
|
<INPUT TYPE="hidden" NAME="bfpage" VALUE="horizontal">
|
|
<INPUT TYPE="hidden" NAME="bfmid" VALUE="27253343" >
|
|
<INPUT TYPE="hidden" NAME="num" VALUE="30">
|
|
|
|
<table bgcolor=white border=3><tr><td>
|
|
<table bgcolor=white border=0>
|
|
<tr><td>
|
|
<IMG SRC="serve-bfmid=27253343&siteid=30472466&bfpage=horizontal.gif" tppabs="http://service.bfast.com/bfast/serve?bfmid=27253343&siteid=30472466&bfpage=horizontal" BORDER="0" WIDTH="1" HEIGHT="1" align=right NOSAVE >
|
|
<center><b>Search the web with Google</b></center>
|
|
</td></tr><tr><td>
|
|
<TABLE cellpadding=0 cellspacing=5 bgcolor="#FFFFFF">
|
|
<tr><td bgcolor="#0000cc"><IMG SRC="cleardot.gif" tppabs="http://www.google.com/images/cleardot.gif" height=1 border="0" ALT="Google"></td></tr><tr><td>
|
|
<IMG SRC="affiliate_logo.gif" tppabs="http://www.google.com/affiliates/affiliate_logo.gif" border="0" ALT="Google" align="center">
|
|
<INPUT TYPE=text name=q size=30 maxlength=255 value="">
|
|
<INPUT type=submit name=sa VALUE="Go">
|
|
</td></tr>
|
|
<tr><td bgcolor="#0000cc"><IMG SRC="cleardot.gif" tppabs="http://www.google.com/images/cleardot.gif" height=1 border="0" ALT="Google"></td></tr></TABLE>
|
|
</td></tr></table>
|
|
</tr></td></table>
|
|
</FORM>
|
|
|
|
</center>
|
|
|
|
|
|
<p><img src="rbline.gif" tppabs="http://graphics.ctyme.com/gif/rbline.gif" width="100%" alt="------"><p>
|
|
|
|
<!-- Bottom Link End -->
|
|
|
|
</BODY>
|
|
</HTML>
|