%
% $Log: irixeth.tex,v $
% Revision 1.2  1997/06/04 22:37:00  llp
% cleanup for Jun97 release
%
% Revision 1.1  1996/02/02  00:03:23  slm
% Initial revision
%
% Revision 1.1  1995/07/28  21:17:31  slm
% Initial revision
%
% Revision 1.1.1.3.1.1  1994/10/20  23:59:31  hkaram
% New branch
%
% Revision 1.1.1.3  1994/08/02  23:55:43  davidm
% Sectioning commands now use \protspec and \topic so latex2html has
% an easier time.
%
% Revision 1.1.1.2  1994/07/05  00:42:34  ho
% Indexed.
%
% Revision 1.1.1.1  1994/03/15  17:24:09  menze
% syntax problems
%
% Revision 1.1  1994/03/14  18:56:09  umass
% Initial revision
%

\subsection{IRIXETH}
\index{irixeth}

\topic{NAME}
IRIXETH (Raw Ethernet Driver (IRIX platform))

\topic{SPECIFICATION}

\noindent
IRIXETH is a user-space {\xk} ethernet driver that sends and receives
messages using IRIX raw sockets.

\topic{SYNOPSIS}

\noindent 
IRIXETH places and receives packets directly on the wire using the SGI
raw socket interface.  Using raw sockets is a priviledged operation,
so the user must be root or the running xkernel must be owned by root
and have the suid bit set.

\topic{REALM}

\noindent
IRIXETH is in the ANCHOR realm, supporting the ethernet driver interface
described in ETH.

\topic{PARTICIPANTS}

\noindent
IRIXETH supports the ethernet driver interface rather than a standard
xkernel UPI interface and thus makes no use of participant stacks.

\topic{CONTROL OPERATIONS}

\begin{description}

\item[{\tt MAC\_REGISTER\_ARP:}]
Used by an ARP instantiation to register itself with its corresponding
SIMETH driver.  IRIXETH has no need of this and simply consumes the
control operation.
\begin{description}
\item[{\rm Input:}] {\tt XObj /* ARP protocol object */ }
\item[{\rm Output:}] none
\end{description}

\item[{\tt MAC\_DUMP\_STATS:}]
If IRIXETH or PACKET\_STATS have been defined when the module is
compiled (the default), this causes the driver to print out relevant
statistics such as packets sent and received, broadcasts sent, errors, etc.
\begin{description}
\item[{\rm Input:}] none
\item[{\rm Output:}] none
\end{description}

\end{description}

\topic{EXTERNAL INTERFACE}

\noindent
IRIXETH adheres to the external interface defined by ETH.

\topic{CONFIGURATION}

\noindent
IRIXETH requires no lower protocol.  It can be configured in either the
driver section or the protocol section of graph.comp.

\medskip
\noindent
IRIXETH recognizes the following ROM options:

\smallskip
{\tt irixeth mmmm nnnn}:
This instantiation of irixeth should use IRIX raw socket send port
mmmm and receive port nnnn.  There must be such a line for each 
instantiation of IRIXETH in the \xk{}.

\topic{AUTHORS}

\noindent Jim Doyle
