TITLE:   NOTES for Generic GSS-API Sample program
AUTHOR:  Kevin Smilak kcsmilak@tis.com
DATE:    6/30/97 (revised 7/23/97)

1.  Purpose:
	The project in security/gssapi/samples/generic_sample is a sample
	implementation of an application using gssapi   It compiles into
	a test program that demonstrates the use of gssapi.  It is also
	documented to allow for modifications or other programs to be 
	written from its example. 

2.  Overview:
	Make produces client and server.  Upon execution of the two, a 
	communication channel will be initatied by the client to the
	server.  If accepted, the server will respond OK and some test
	messages will be passed.  If the client needs a password to be
	accepted, the server will respond as such and the client will
	prompt the user for a password.  That password is then send to
	the server.  If accepted, the client is notified and the test
	messages are sent.  If rejected, the client shuts down and the
	server continues to listen for other conenctions.  Upon completion
	of the test messages, the client shuts down.

3.  Execution:
	0. > cp Makefile.<platform> Makefile
	1. > make clean
	2. > make
	3. > ./server &
	4. > ./client

	If the server is given an argument (any) it will use the default
	port of 8888.

	If the client is given arguments, they should follow the following
	format.  It too will use the default port of 8888.  If no target
	address is provided, localhost will be used.

	> client [target name] [target address]

4.  Source code:
	sample_init.c		Main client side routine
	sample_accept.c		Main server side routine
	sample_comm.c		Socket routines and Send/Receive pkt functions
	sample_comm.h		Header file for sample_comm.c

5.  Misc notes:

	+ define DEBUG in the Makefile for extensive debugging information
	  to be printed to the screen at runtime.

	+ sample_comm.c contains send and receive message functions.  Each
	  message is preceeded by the length of the message with an int
	  passed to the peer.  The message itself can be wrapped and
	  optionally encrypted.  Messages sent prior or during context
	  establishment should not be wrapped or unwrapped.

 
