| 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. |
| 4 |
|
| 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 |
| 7 |
point look at: |
| 8 |
|
| 9 |
http://www.yahoo.com/Computers_and_Internet/Standards/RFCs/ |
| 10 |
|
| 11 |
The RFC implemented in this distribution are |
| 12 |
|
| 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 |
| 19 |
|
| 20 |
AVAILABILITY |
| 21 |
|
| 22 |
The latest version of libnet is available from the Comprehensive Perl |
| 23 |
Archive Network (CPAN). To find a CPAN site near you see: |
| 24 |
|
| 25 |
http://search.cpan.org/~gbarr/libnet/ |
| 26 |
|
| 27 |
The subversion source repository can be browsed at |
| 28 |
|
| 29 |
http://svn.mutatus.co.uk/browse/libnet/ |
| 30 |
|
| 31 |
If 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 |
|
| 35 |
INSTALLATION |
| 36 |
|
| 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: |
| 40 |
|
| 41 |
perl Makefile.PL |
| 42 |
make |
| 43 |
make test |
| 44 |
make install |
| 45 |
|
| 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: |
| 49 |
|
| 50 |
perl Makefile.PL PREFIX=~/perl |
| 51 |
|
| 52 |
|
| 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 |
| 56 |
(described above). |
| 57 |
|
| 58 |
CONFIGURE |
| 59 |
|
| 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. |
| 66 |
|
| 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 |
| 70 |
|
| 71 |
Configure -d |
| 72 |
|
| 73 |
before running the Makefile.PL. |
| 74 |
|
| 75 |
DOCUMENTATION |
| 76 |
|
| 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. |
| 82 |
|
| 83 |
DEMOS |
| 84 |
|
| 85 |
The demos directory does contain a few demo scripts. These should be |
| 86 |
run from the top directory like |
| 87 |
|
| 88 |
demos/smtp.self -user my-email-address -debug |
| 89 |
|
| 90 |
However I do not guarantee these scripts to work. |
| 91 |
|
| 92 |
SUPPORT |
| 93 |
|
| 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>. |
| 97 |
|
| 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. |
| 101 |
|
| 102 |
COPYRIGHT |
| 103 |
|
| 104 |
© 1996-2004 Graham Barr. All rights reserved. |
| 105 |
|
| 106 |
This library is free software; you can redistribute it and/or modify |
| 107 |
it under the same terms as Perl itself. |
| 108 |
|
| 109 |
Share and Enjoy! |
