Return to README CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / new / xns

Annotation of 43BSDTahoe/new/xns/README, revision 1.1.1.1

1.1       root        1: This directory contains the version of the UNIX XNS/Courier implementation
                      2: currently under development by JQJ@CORNELL.  It is still a test version.
                      3: This file last updated 31 Dec 1986 (Ed Flint).
                      4: 
                      5: To install the XNS Courier package:
                      6: 
                      7: 1/     install 4.3BSD, including support for XNS protocols by K. Sklower.
                      8:        The Courier system is known to work on VAXes and Gould Powernode
                      9:        systems running 4.3BSD.  It probably works on a SUN with XNS
                     10:        support.  Note that it assumes that the routine ns_addr() is in
                     11:        /lib/libc; this was not the case for the 4.3BSD Beta distribution.
                     12: 2/     make sure an interface has been enabled for xns e.g.:
                     13:                ifconfig en0 ns 2273            (if en0 is connected to
                     14:        XNS network number 2273)
                     15: 3/     edit the Makefile in this directory and modify the user-tunable
                     16:        parameters CHDEFAULT, DESTDIR, DESTBIN, DESTLIB, DESTINCLUDE and
                     17:        DESTCOURIER. At a minimum, CHDEFAULT should be changed to the
                     18:        default :domain:organization for the system being installed; the
                     19:        remaining parameters will default to appropriate directories
                     20:        within the 4.3BSD system.
                     21: 4/     do ``make all'' on this directory. This will build the package
                     22:        and deposit the necessary files in the bin, lib, include and
                     23:        xnscourier subdirectories.
                     24:        A simple ``make'' won't do, since some things require previous
                     25:        installation of earlier things.
                     26: 5/     do ``make install'' on this directory.  Note that you MUST use
                     27:        ``make install'', and will probably need to be logged in as root.
                     28:        This will copy the previously made files to the appropriate system
                     29:        level directories as specified by the user-tunable parameters in
                     30:        the Makefile.
                     31: 6/     edit /etc/rc.local to automatically run
                     32:        /usr/new/lib/xnscourier/xnscourierd at system startup. This is the
                     33:        daemon that listens for incoming Courier connections.  When it 
                     34:        receives a connection, it looks up the remote program in
                     35:        /usr/new/lib/xnscourier/Courierservices and runs that program.
                     36: 
                     37: Notes:
                     38: 1/     The file ./morexnslib/ch/clearinghouse.addresses may contain 
                     39:        the address of a local clearinghouse and a list of the domains 
                     40:        served.  This file will be created during the make; the package
                     41:        will build a program called xnsbfs which finds local clearinghouses
                     42:        and the output of this program will be used to create
                     43:        clearinghouse.addresses, and the result stored as the file 
                     44:        ./lib/xnscourier/CH.addrs.
                     45:        Note that you MUST have a Xerox-provided or compatible (3Com won't
                     46:        do) Clearinghouse on your local network.
                     47: 2/     Some programs in this package use the contents of the file
                     48:        ./lib/xnscourier/CH.default as a default if no domain 
                     49:        is specified, e.g. "gaptelnet foo" defaults domain and 
                     50:        organization on foo based on this file.  The file
                     51:        ./morexnslib/ch/CH.default is built by the package to contain this 
                     52:        default value, as specified in CHDEFAULT in the Makefile.
                     53: 
                     54: Problems:
                     55: 1/     The compiler is incomplete:  it does not handle forward references,
                     56:        recursive declarations, constants containing a non-trivial CHOICE,
                     57:        or recursive DEPENDencies.
                     58: 2/     The client runtimes are incomplete:  they do not correctly handle BDT
                     59:        Abort messages; they require a static file (clearinghouse.addresses)
                     60:        containing a local Clearinghouse rather than performing an expanding-
                     61:        ring search.
                     62: 3/     The server runtimes are incompletely tested.
                     63: 4/     Providing Courier services is quite expensive.  In general, at least
                     64:        one process per SPP connection is required.
                     65: 
                     66: On the other hand, the package is adequate for writing non-trivial Courier
                     67: client and server programs.  Of particular note are the example subdirectories
                     68: print, gap, and filing, which contain Courier applications for (1) printing
                     69: an Interpress master on a Xerox printer, (2) telnet (chat, aka GAP) from Unix 
                     70: to file servers or from ViewPoint to UNIX, (3) an ftp-like interface to filing,
                     71: allowing a Unix user to store and retrieve files from a Xerox file server and
                     72: a XDE FileTool compatible Unix file service.
                     73: 
                     74: Note that in order to use XDE Chat, ViewPoint remote system administration or
                     75: FileTool to your UNIX system you will need to register the UNIX system with
                     76: the Xerox Clearinghouse.  To do so, use the program registerhost contained on
                     77: the examples/ch directory.

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