Return to README CVS log

Up to [Research Unix] / researchv8dc / netfs

Annotation of researchv8dc/netfs/README, revision 1.1.1.1

1.1       root        1: This junk goes into /usr/net.  That name is built into several programs.
                      2: You should have the following files:
                      3: friends fshare magic people setup teardown unmount
                      4: 
                      5: The files friends, setup, teardown, and unmount have to do with
                      6: you being able to look at files on other machines.
                      7: The files fshare, magic, and people have to do with your file system
                      8: being visible to others.
                      9: 
                     10: Friends is a table read by setup and teardown.  It contains information
                     11: on the machines you want to talk to.  The fields are:  machine name
                     12: (spelled peculiarly, see below), mount point (where you want the
                     13: other machine's file system to appear in yours), device number
                     14: (start at 48 or 64 and go up by one), and a debugging flag.
                     15: For each line in friends, setup tries to mount that file system
                     16: at the mount point.  It then sends keep alive messages to each machine.
                     17: When it can't talk to a machine it tries to unmount the file system.
                     18: Sending it a 1 signal (kill -1 ...) causes it to reread /usr/net/friends,
                     19: and connect to all the machines it is not connected to.
                     20: It also tries every 20 minutes, and within a minute after
                     21: /usr/net/friends is touched.  This need not
                     22: succeed for there are several inconvenient failure states.
                     23: Teardown is a shell script which tries to dismount all the network
                     24: file systems.
                     25: 
                     26: Fshare provides service to others.  There's a parent one, and one
                     27: for each machine connected to you.  /usr/net/people is your idea
                     28: of the permissions you want to grant to others using your file system.
                     29: The entries are sorted by machine.  The entries are pairs of pairs, each pair
                     30: being a user id and a group id.  The first pair in a pair is the
                     31: other machine's idea and the second represents yours.  For instance,
                     32: mh/astro/seki
                     33: (( 27 1) (814 2)) # pjw
                     34: means that user 27 on seki should be treated as having uid 814 and group 2
                     35: on your machine.  The stuff after # is a comment.  Default versions
                     36: of this file can be constructed using the shell script magic.
                     37: magic machine-name produces a file of pairs for the people who have
                     38: the same login name on your machine and machine-name.  Run
                     39: magic seki
                     40: and put its output after the last line of people, which should
                     41: be
                     42: mh/astro/seki
                     43: Similarly to include permissions for a machine named junko,
                     44: magic junko
                     45: then edit /usr/net/people to have
                     46: mh/cage/junko (or whatever) as its last line,
                     47: and then add junko-done (the output of magic junko).
                     48: 
                     49: The friends file contains names of directories where other machine's
                     50: file systems will be mounted.
                     51: 
                     52: Corresponding to the name /n/foo in /usr/net/friends, there must
                     53: be a directory /n/foo.
                     54: 
                     55: The code here assumes it is talking to Datakit in several places.
                     56: If you want to use another network, you'll have to fix things.
                     57: The only true requirement is that there be a stream driver for the
                     58: network.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.