| Commit | Line | Data |
|---|
| 406c51ee |
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 staring |
| 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 | Net::SNPP RFC1861 Simple Network Pager Protocol |
| 20 | |
| 21 | The distribution also contains a module (Net::PH) which facilitates |
| 22 | comunicate with with servers using the CCSO Nameserver Server-Client |
| 23 | Protocol |
| 24 | |
| 25 | FUTURE WORK |
| 26 | |
| 27 | AVAILABILITY |
| 28 | |
| 29 | The latest version of libnet is available from the Comprehensive Perl |
| 30 | Archive Network (CPAN). To find a CPAN site near you see: |
| 31 | |
| 32 | http://www.perl.com/CPAN |
| 33 | ^ no slash here !! |
| 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 ask some |
| 61 | questions about your system. The results of these questions will be stored in |
| 62 | the Net::Config package. If you are on a system when this script cannot be run |
| 63 | for some reason then the file Config.eg can be edited manually and installed |
| 64 | as Net::Config (Net/Comfig.pm) |
| 65 | |
| 66 | DOCUMENTATION |
| 67 | |
| 68 | See ChangeLog for recent changes. POD style documentation is included |
| 69 | in all modules and scripts. These are normally converted to manual |
| 70 | pages and installed as part of the "make install" process. You should |
| 71 | also be able to use the 'perldoc' utility to extract documentation from |
| 72 | the module files directly. |
| 73 | |
| 74 | DEMOS |
| 75 | |
| 76 | The demos directory does contain a few demo scripts. These should be |
| 77 | run from the top directory like |
| 78 | |
| 79 | demos/smtp.self -user my-email-address -debug |
| 80 | |
| 81 | However I do not guarantee these scripts to work. |
| 82 | |
| 83 | SUPPORT |
| 84 | |
| 85 | Questions about how to use this library should be directed to the |
| 86 | comp.lang.perl.modules USENET Newsgroup. Bug reports and suggestions |
| 87 | for improvements can be sendt to me at <gbarr@pobox.com>. |
| 88 | |
| 89 | Most of the modules in this library have an option to output a debug |
| 90 | transcript to STDERR. When reporting bugs/problems please, if possible, |
| 91 | include a transcript of a run. |
| 92 | |
| 93 | COPYRIGHT |
| 94 | |
| 95 | © 1996-98 Graham Barr. All rights reserved. |
| 96 | |
| 97 | This library is free software; you can redistribute it and/or modify |
| 98 | it under the same terms as Perl itself. |
| 99 | |
| 100 | Share and Enjoy! |
projects / p5sagit/p5-mst-13.2.git / blame