README
1Demo Applet: Echo Server
2===========================
3
4This RPC application implements a simple single-function RPC server
5interface. The function ReverseIt() accepts as input an array of
6strings. It reverses the order of characters in the strings, and
7returns the results to the client.
8
9Build Instructions
10------------------
11
12 - echo_client and echo_server build by default with the
13 Linux build.
14
15 - The Makefile can be edited to compile the demo app on
16 Solaris with Transarc DCE and AIX with IBM's DCE product.
17 Edit the makefile and run make.
18
19Running the Application
20-----------------------
21
22 1. The RPC endpoint mapper daemon needs to be running on
23 the machine where the Echo server runs. If you are
24 running vendor DCE, this already handled for you by the
25 'dced' process. On Linux, you can start rpcd if it is not
26 already running. As root:
27
28 # /etc/rc.d/init.d/ rc.dcerpcd start
29
30 2. Start the echo_server, you do not need to be root to
31 do this:
32
33 ./echo_server
34
35 3. The Echo client can be run on any machine on the internet,
36 or it can simply be run on the same host as that the
37 echo server runs on.
38
39 Run the echo_client, telling it the host where to look
40 for the echo server. i.e.:
41
42 ./echo_client -h acs4.bu.edu
43
44 Additionally, you can tell it to specifically use the
45 TCP registration -or- the UDP registration that the
46 server is listening on.
47
48 ./echo_client -h acs4.bu.edu -u <= call using UDP RPC
49 ./echo_client -h acs4.bu.edu -t <= call using TCP RPC
50
51 4. You can feed the echo client large gobs of text from
52 a flatfile as well as from the prompt. Here's how you can
53 see what a Unix man page looks like printed in reverse. :)
54
55 $ man gcc > /tmp/blah
56 $ ./echo_client -h localhost < /tmp/blah
57