1libnet is a collection of Perl modules which provides a simple
2and consistent programming interface (API) to the client side
3of various protocols used in the internet community.
4
5For details of each protocol please refer to the RFC. RFC's
6can be found a various places on the WEB, for a starting
7point look at:
8
9    http://www.yahoo.com/Computers_and_Internet/Standards/RFCs/
10
11The RFC implemented in this distribution are
12
13Net::FTP 	RFC959		File Transfer Protocol
14Net::SMTP	RFC821		Simple Mail Transfer Protocol
15Net::Time	RFC867		Daytime Protocol
16Net::Time	RFC868		Time Protocol
17Net::NNTP	RFC977		Network News Transfer Protocol
18Net::POP3	RFC1939		Post Office Protocol 3
19
20AVAILABILITY
21
22The latest version of libnet is available from the Comprehensive Perl
23Archive Network (CPAN). To find a CPAN site near you see:
24
25    http://search.cpan.org/~gbarr/libnet/
26
27The subversion source repository can be browsed at
28
29    http://svn.mutatus.co.uk/browse/libnet/
30
31If you have a subversion client, then you can checkout the latest code with
32
33  svn co http://svn.mutatus.co.uk/repos/libnet/trunk libnet
34
35INSTALLATION
36
37In order to use this package you will need Perl version 5.002 or
38better.  You install libnet, as you would install any perl module
39library, by running these commands:
40
41   perl Makefile.PL
42   make
43   make test
44   make install
45
46If you want to install a private copy of libnet in your home
47directory, then you should try to produce the initial Makefile with
48something like this command:
49
50  perl Makefile.PL PREFIX=~/perl
51
52
53The Makefile.PL program will start out by checking your perl
54installation for a few packages that are recommended to be installed
55together with libnet.  These packages should be available on CPAN
56(described above).
57
58CONFIGURE
59
60Normally when perl Makefile.PL is run it will run Configure which will
61ask some questions about your system. The results of these questions
62will be stored in a file called libnet.cfg which will be installed
63alongside the other perl modules in this distribution. The Makefile.PL
64will run Configure in an interactive mode unless these exists a file
65called libnet.cfg in the build directory.
66
67If you are on a system which cannot run this script you can create an
68empty file to make Makefile.PL skip running Configure. If you want to
69keep your existing settings and not run interactivly the simple run
70
71  Configure -d
72
73before running the Makefile.PL.
74
75DOCUMENTATION
76
77See ChangeLog for recent changes.  POD style documentation is included
78in all modules and scripts.  These are normally converted to manual
79pages and installed as part of the "make install" process.  You should
80also be able to use the 'perldoc' utility to extract documentation from
81the module files directly.
82
83DEMOS
84
85The demos directory does contain a few demo scripts. These should be
86run from the top directory like
87
88    demos/smtp.self -user my-email-address -debug
89
90However I do not guarantee these scripts to work.
91
92SUPPORT
93
94Questions about how to use this library should be directed to the
95comp.lang.perl.modules USENET Newsgroup.  Bug reports and suggestions
96for improvements can be sent to me at <gbarr@pobox.com>.
97
98Most of the modules in this library have an option to output a debug
99transcript to STDERR. When reporting bugs/problems please, if possible,
100include a transcript of a run.
101
102COPYRIGHT
103
104  � 1996-2004 Graham Barr. All rights reserved.
105
106This library is free software; you can redistribute it and/or modify
107it under the same terms as Perl itself.
108
109Share and Enjoy!
110