home *** CD-ROM | disk | FTP | other *** search
/ PC World 2005 December (Special) / PCWorld_2005-12_Special_cd.bin / Bezpecnost / lsti / lsti.exe / framework-2.5.exe / README.libnet < prev    next >
Text File  |  2005-01-27  |  4KB  |  110 lines
  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!
  110.