*** PLEASE READ THE FILE ``README.DEBUG'' BEFORE POSTING BUG REPORTS ***

Read INSTALL for instructions on how to configure and install the distribution

This is the README file for the libnet distribution. It combines and replaces
several of my previous distributions

    Net-Domain
    Net-FTP
    Net-SMTP

libnet contains

  Net::FTP     (RFC959)
  Net::SMTP    (RFC821)
  Net::Netrc
  Net::Cmd
  Net::Domain
  Net::Telnet  (RFC854)
  Net::Time    (RFC867 & RFC868)
  Net::NNTP    (RFC977)
  Net::POP3    (RFC1939)
  Net::SNPP    (RFC1861) (not tested)
  Net::PH
  Net::Config

some possible future packages might be 

 Net::Finger (RFC1288)
 Net::Resolv

Net::FTP is a perl5 package which implements the client side of
a FTP connection as per RFC959

In order to use this distribution you will need Perl version 5.001m or
better. The File::Listing package can be found in the libwww distribution.
To use the complete libwww distribution you require 5.002, If you
do not have 5.002 File::Listing can be extracted from libwww and will work
with 5.001

See ChangeLog for recent changes. POD style documentation is included in
all/most modules and scripts. You should be able to use the 'perldoc'
utility to extract documentation from these files.

Hostname.pm.eg is an example module that can be use in place of Sys::Hostname
it will cause Sys::Hostname to use Net::Domain and if used in a perl -w
will inform of the use of Sys::Hostname

Net::Domain only *attempts* to locate the current hostname and DNS domainname
I cannot gaurantee that it will. It has been found at least once where
a machine had no way at all of locating its FQDN. If this is so you
results from the test.pl script included may look something like

Domainname = hostname
Hostname   = hostname
Hostdomain = 

The demos directory does contain a few demo scripts. These should be run from
the top directory like

    demos/smtp.self -user my-email-address -debug

Please report any bugs/suggestions to <Graham.Barr@tiuk.ti.com>

When reporting bugs/problems please, if possible, include a transcript of
a run with the Debug option turned on.

Copyright 1996 Graham Barr. All rights reserved.

This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself.

Share and Enjoy!
Graham <Graham.Barr@tiuk.ti.com>