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