Readme for the sample stack server program
==========================================

This is a simple-integer-stack-server implementation to demonstrate
MIG stubs and the Hurd server mechanism.

This programs uses the trivfs library to get registered in to the
filesystem as a Hurd translator as there is no explicit name-server is
available.

To compile the sample code,
--------------------------
1) type "make" will give you two binaries "stack-server" and "stack-client".
2) type "make start" to register the "stack-server" in the Hurd
file-system (i.e., to start the "stack-server" as a translator using
"settrans" command).
3) type "make end" to stop or quit the running "stack-server".

To use the stack-server methods,
-------------------------------
1) type "./stack-client" will give you a "stack->" prompt where you
can use any of the following commands :

"p" : Push an integer - when entered in the prompt will ask you for an
integer to push in to the stack.

"o" : Pop an integer from the stack.

"t" : Retrieve the "top" element from the stack.

"e" : Empties the stack.

"q" : Quit from the "stack-client".

Examples:
=========

hurd:~#./stack-client

Stack : Initialize : Success!!
stack-> p
10
Displaying the contents of the stack :
10
stack-> p
20
Displaying the contents of the stack :
20
10
stack-> t
Top element of the stack is 20
Displaying the contents of the stack :
20
10
stack-> o
Popped element from the stack is 20
Displaying the contents of the stack :
10
stack-> q

hurd:~#