Return to README CVS log

Up to [Research Unix] / researchv8dc / netfs

Annotation of researchv8dc/netfs/README, revision 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.