README
1This is a Python interface to Sun RPC, designed and implemented mostly
2by reading the Internet RFCs about the subject.
3
4*** NOTE: xdr.py has evolved into the standard module xdrlib.py ***
5
6There are two library modules, xdr.py and rpc.py, and several example
7clients: mountclient.py, nfsclient.py, and rnusersclient.py,
8implementing the NFS Mount protocol, (part of) the NFS protocol, and
9the "rnusers" protocol (used by rusers(1)), respectively. The latter
10demonstrates the use of broadcast via the Port mapper's CALLIT
11procedure.
12
13There is also a way to create servers in Python.
14
15To test the nfs client, run it from the shell with something like this:
16
17 python -c 'import nfsclient; nfsclient.test()' [hostname [filesystemname]]
18
19When called without a filesystemname, it lists the filesystems at the
20host; default host is the local machine.
21
22Other clients are tested similarly.
23
24For hostname, use e.g. wuarchive.wustl.edu or gatekeeper.dec.com (two
25hosts that are known to export NFS filesystems with little restrictions).
26
27There are now two different RPC compilers:
28
291) Wim Lewis rpcgen.py found on http://www.omnigroup.com/~wiml/soft/stale-index.html#python.
30
312) Peter �strands rpcgen.py, which is part of "pynfs" (http://www.cendio.se/~peter/pynfs/).
32