diff --git a/docs/cmu-user/internet.tex b/docs/cmu-user/internet.tex index fac580a0b65e28289bcc28aafa59e1bb36bfd6c9..f7b8e894f3a0bf7adbd19649a3ed0db027e92030 100644 --- a/docs/cmu-user/internet.tex +++ b/docs/cmu-user/internet.tex @@ -174,10 +174,13 @@ remote hosts. \end{defun} \section{Out-of-Band Data} +\label{internet-oob} Out-of-band data is data transmitted with a higher priority than ordinary data. This is usually used by either side of the connection -to signal exceptional conditions. +to signal exceptional conditions. Due to the fact that most TCP/IP +implementations are broken in this respect, only single characters can +reliably be sent this way. \begin{defun}{extensions:}{add-oob-handler}{% \args{\var{fd} \var{char} \var{handler}}} @@ -191,8 +194,8 @@ to signal exceptional conditions. \begin{defun}{extensions:}{remove-oob-handler}{% \args{\var{fd} \var{char}}} - - Removes the handler for the character \var{char} on the connection + + Removes the handler for the character \var{char} from the connection with the file descriptor \var{fd} \end{defun} @@ -262,11 +265,3 @@ Finally, the function Closes the socket given by the file descriptor \var{socket}. \end{defun} - -%(export '(htonl ntohl htons ntohs lookup-host-entry host-entry host-entry-name -% host-entry-aliases host-entry-addr-list host-entry-addr -% create-unix-socket connect-to-unix-socket create-inet-socket -% connect-to-inet-socket create-inet-listener accept-tcp-connection -% close-socket ipproto-tcp ipproto-udp inaddr-any add-oob-handler -% remove-oob-handler remove-all-oob-handlers -% send-character-out-of-band))