%
% x-kernel v3.3
%
% Copyright (c) 1996,1993,1991,1990  Arizona Board of Regents
%

\section{Releasing a Protocol}\label{releasing}

Once you have debugged and tuned a new protocol, you can make it
available for others to use by creating a new directory in 
{\var /usr/xkernel/protocols}, copying your source files into that
directory, creating a makefile in that directory, and modifying the
makefile in {\var /usr/xkernel/protocols}.  If your protocol is a
device driver, instead put the source files in 
{\var /usr/xkernel/user\_level/platforms/PLATFORM/drivers}, where 
{\var PLATFORM} is one of {\var sunos}, {\var solaris}, {\var osf1}, 
{\var irix}, or {\var linux}. You should put any public {\var .h}
files in {\var /usr/xkernel/inclue/prot}. Finally, you need to update
the {\var prottbl} files in {\var /usr/xkernel/etc} to include
protocol numbers for your new protocol, and 
{\var /usr/xkernel/include/upi.h} to include a base control op number
for your protocol.

If you want to make your new protocol available to other sites, then
make a tar file of your protocol available and drop a note to 
{\var xkernel-help@cs.arizona.edu}.  We will include your protocol in the
next release.  You should also create a ``man page'' for you protocol
similar to those found in the Appendix.  The source files for these
man pages are in {\var /usr/xkernel/doc/manual/protocols}.