blob: 97948a33844d2c4ff26051ac7c18c867f1c716d1 [file] [log] [blame]
Guido van Rossumda164d21992-12-21 14:32:38 +00001This is a Python interface to Sun RPC, designed and implemented mostly
2by reading the Internet RFCs about the subject.
3
Guido van Rossumbf66c641996-08-19 22:24:21 +00004*** NOTE: xdr.py has evolved into the standard module xdrlib.py ***
5
Guido van Rossumda164d21992-12-21 14:32:38 +00006There 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.
Guido van Rossum2f5dd881992-12-17 17:32:10 +000014
15To test the nfs client, run it from the shell with something like this:
16
Guido van Rossumda164d21992-12-21 14:32:38 +000017 python -c 'import nfsclient; nfsclient.test()' [hostname [filesystemname]]
Guido van Rossum2f5dd881992-12-17 17:32:10 +000018
19When called without a filesystemname, it lists the filesystems at the
Guido van Rossumda164d21992-12-21 14:32:38 +000020host; default host is the local machine.
21
22Other clients are tested similarly.
Guido van Rossum2f5dd881992-12-17 17:32:10 +000023
24For hostname, use e.g. wuarchive.wustl.edu or gatekeeper.dec.com (two
25hosts that are known to export NFS filesystems with little restrictions).
Martin v. Löwis401a76d2001-10-11 19:23:28 +000026
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/).