This is dnprogs, the user programs for the Linux DECnet socket layer.

This collection comprises all the programs and libraries you will need
to get DECnet for Linux working. It assumes you already have the
kernel patch installed and built.


INSTALLATION
------------

First, compile and install the programs:

   make ; make install

This should put all the user-level programs in /usr/local/bin, all the
system programs in /usr/local/sbin and the man pages under /usr/local/man.

Libraries will be installed in /usr/lib. If you would prefer them to be in
/usr/local/lib then edit Makefile.common and change libprefix.
If you do this you need to ensure that the libraries will be found by either
adding /usr/local/bin to the file /etc/ld.so.conf or by setting the 
environment variable LD_LIBRARY_PATH. See the man page for ld.so for more
information.

[Please don't send me mail about compiler warnings on libc5 based systems, I 
know. It compiles fine on libc6 systems (I can recommend Debian 2) because the
header files are more POSIX compliant.]

It will also install a startup script appropriate to your distribution. You
will need to set up your system so that this script is run at system startup
time. 

Debian: 
------
The startup script is "/etc/init.d/decnet.sh"
This should be linked to "/etc/rcS.d/S39decnet.sh"

Redhat:
-------
The startup script is "/etc/rc.d/init.d/decnet"
It should be linked to "/etc/rc.d/rc3.d/S09decnet"
You can use control-panel or tksysv to do this.

Slackware   
---------
The startup script is "/etc/rc.decnet"
Put a call to this very near the start of your /etc/rc.d/rc.inet1 file.

S.u.S.E.
--------
The startup script is "/sbin/init.d/decnet"
It should be linked to "/sbin/init.d/rc2.d/S05decnet


NOTE: Wherever you put call the startup script from it *MUST* be run before 
the TCP/IP initialisation because it needs to set the MAC address of the
ethernet card.

You will also now have an example configuration file (called 
/etc/decnet.conf.sample). You should copy this to /etc/decnet.conf and edit it
to contain the details for your Linux machine (the executor) and all DECnet
nodes with which you want to communicate - see the man page for more details.

Alternatively you can use the script in scripts/setup.sh to aid in setting
up your DECnet configuration. This will prompt you for the necessary information
and create an /etc/decnet.conf file for you. This script is run automatically
when you first install a binary distribution.

You may also want to configure a DECnet proxies file for FAL. See the FAL 
documentation (or the decnet.proxy(5) man page) for more information.

DOCUMENTATION
-------------
man pages are provided for all the programs and also the routines in libdnet.
Also you will find some documentation in the Documentation/ directory of this
distribution.

If you have any problems then please consult the FAQ at 
http://linux.dreamtime.org/decnet/faq/html before emailing the list with 
questions.


PROGRAMS
--------

Provided programs are:

in /usr/local/bin:
dncopy	    -  copy files between VMS and Linux
dntype      -  view VMS files
dndir       -  show VMS directories
dndel       -  delete VMS files
sethost     -  connect a terminal session to VMS
dnping      -  "ping" a VMS machine
dnsubmit    -  submit batch jobs to a VMS queue
dnprint     -  print files on a VMS printer

in /usr/local/sbin:
startnet    -  needed to start the DECnet socket layer
ctermd      -  SET HOST server
fal         -  file access listener
dnmirror    -  server side of dnping
dnmount     -  mount a VMS filesystem (still beta - requires dapfs in kernel 2.1)
vmsmaild    -  daemon to collect mail from VMSmail
sendvmsmail -  mail delivery filter to send mail from Linux to VMS

ALSO INCLUDED
-------------
This distribution also contains uulib from the uudeview suite by Frank Pilhofer
(fp@informatik.uni-frankfurt.de). 

I have supplied it here pre-configured for Linux and it seems OK for me on
libc5 and 6 system Intel and SPARC.

If you have problems or you want the rest of the uudeview distribution or want to 
try a later version of uulib you can download it from
http://www.informatik.uni-frankfurt.de/~fp/uudeview.

Thanks to Frank for a great set of encoders/decoders - I use them a lot.


SUPPORT
-------
These programs have been tested on Linux 2.0, 2.1 and 2.2 on Intel, Alpha and
SPARC machines (though not necessarily all combinations!)

This package is maintained by Patrick Caulfield (patrick@pandh.demon.co.uk)
though many of the programs were originally written by Eduardo Serrat
(emserrat@hotmail.com).

We encourage all users to join the linux-decnet mailing list by sending 
a message to majordomo@dreamtime.org containing the text

subscribe linux-decnet

in the body.

If you need help with the software, think you have found a bug or would 
like to request a feature then please send your messages to this mailing list.

Note that while we cannot guarantee to provide support for these programs
we will endeavour to help where possible.

