DataMuseum.dk

top - download

    Length: 2782 (0xade)
    Types: TextFile
    Names: »READ_ME«

└─⟦87ddcff64⟧ Bits:30001253 CPHDIST85 Tape, 1985 Autumn Conference Copenhagen
    └─ ⟦this⟧ »cph85dist/rman/READ_ME« 

TextFile

Notes on installing the remote man system                        21 August 1985
=========================================                        ==============

Compile-time flags
------------------

"mand":
    STRICT         - default whether or not to allow unknown hosts.
    TIMEOUT        - close connection after this many minutes
    SERVICES       - use /etc/services?

"rman":
    LOCAL          - default path to /usr/man for local check if no MANPATH set
    SERVICES       - use /etc/services?
    EXEC_ON_ERROR  - try to exec /usr/ucb/man if remote connection fails


Notes
-----

Client:

  o Edit client/man.hosts to reflect the addresses and names of the hosts
    that each client should try to connect to, then install in 
    LIB/man.hosts on each host.

  o If you want to have rman as a _replacement_ for /usr/ucb/man, make sure
    that you REMOVE the "-DEXEC_ON_ERROR" part from the CFLAGS macro in the
    makefile, as it will just keep invoking ucb/man (itself) on errors!!!!

  o If you want, remove all man pages from your machine (you may want to
    install the local pages on a server), and do a "df" and enjoy ...

  o Install in a suitable location - /usr/ucb/[r]man or /usr/local/[r]man

  o You will probably also want to remember to set up apropos and whatis
    as links to [r]man - it will do the right thing ...

Server:

  o Edit the file "mand.cf" to properly reflect the organization of your
    machine's man pages, adding any extra sections desired, etc, and 
    install in the directory LIB as defined in Makefile (usually /usr/lib)

  o Copy the "mand.hf" help file to the LIB directory

  o Edit the file "mand.hosts" to include the addresses and types of
    any local machines that need special sections (or ALL machines if
    you use the "secure" option.)

  o Copy the binary to somewhere useful, ie. /etc or /usr/lib

  o Edit /etc/rc.local to start up the daemon when the machine reboots.
    (You may want to use some of the flags --- read the man page...:-)

  o Start it initially by hand by typing "mand".


BOTH:

  o Either put an entry for "man" in /etc/services - at Berkeley we use 9535
    because there is no need to use a reserved port. Entry is like this:
        
        man     9535/tcp        # remote manual server
        man     9535/udp        # more of same
    
    (ports MUST be the same for both), or remove the "-DSERVICES" from
    the Makefile.

  o Do a "make -n install" to be sure it wants to put the stuff where
    you want it, then "make install", start the daemon, and you should be set.

  o Install the man pages on a suitable server.

  o Please report any bugs, fixes, or modifications to me at this address:
    
        broome@ucb-vax.berkeley.edu
     or:
        ...!ucbvax!broome