Return to README CVS log

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

Annotation of 43BSDTahoe/new/xns/README, revision 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.