perl-libnet.git  about / heads / tags
Unnamed repository; edit this file 'description' to name the repository.
$ git log --pretty=format:'%h %s (%cs)%d' v1.28 --
3260178 Release 1.28 (2014-10-08)
	(tag: v1.28)
b3e899d Fix a warning introduced by the previous commit (2014-10-07)
6b249e0 Improve code()/message() initialization and error handling in Net::Cmd (2014-10-07)
d3f979b Don't use the ALLO command on FTP servers that don't support it (2014-10-04)
8bb4384 Improve support for $ftp->supported(CMD) (2014-10-04)
6cda6a9 Better skipping of tests requiring fork() (2014-10-03)
12da672 Document new IPv6 & SSL methods (2014-06-27)
273744b Add some missing commas (2014-06-27)
0b6051a Note that IPv6 & SSL support has been added to Net::NNTP (2014-06-27)
5f0021c Merge pull request #6 from noxxi/ipv6_nntp (2014-06-27)
...

$ git cat-file blob v1.28:README
libnet is a collection of Perl modules which provides a simple
and consistent programming interface (API) to the client side
of various protocols used in the internet community.

For details of each protocol please refer to the RFC. RFC's
can be found a various places on the WEB, for a starting
point look at:

    http://www.yahoo.com/Computers_and_Internet/Standards/RFCs/

The RFC implemented in this distribution are

Net::FTP        RFC959          File Transfer Protocol
Net::SMTP       RFC821          Simple Mail Transfer Protocol
Net::Time       RFC867          Daytime Protocol
Net::Time       RFC868          Time Protocol
Net::NNTP       RFC977          Network News Transfer Protocol
Net::POP3       RFC1939         Post Office Protocol 3

AVAILABILITY

The latest version of libnet is available from the Comprehensive Perl
Archive Network (CPAN). To find a CPAN site near you see:

    http://search.cpan.org/dist/libnet/

The GitHub source repository can be browsed at

    http://github.com/steve-m-hay/perl-libnet

If you have a Git client, then you can checkout the latest code with

    git clone http://github.com/steve-m-hay/perl-libnet.git

INSTALLATION

In order to use this package you will need Perl version 5.8.1 or
better.  You install libnet, as you would install any perl module
library, by running these commands:

   perl Makefile.PL
   make
   make test
   make install

If you want to install a private copy of libnet in your home
directory, then you should try to produce the initial Makefile with
something like this command:

  perl Makefile.PL PREFIX=~/perl


The Makefile.PL program will start out by checking your perl
installation for a few packages that are recommended to be installed
together with libnet.  These packages should be available on CPAN
(described above).

CONFIGURE

Normally when Makefile.PL is run it will run Configure which will
ask some questions about your system. The results of these questions
will be stored in a file called libnet.cfg which will be installed
alongside the other perl modules in this distribution. Makefile.PL
will run Configure in an interactive mode unless these exists a file
called libnet.cfg in the build directory or Makefile.PL itself is being
run non-interactively or via cpan, cpanp or cpanm.

If you are on a system which cannot run this script you can create an
empty file to make Makefile.PL skip running Configure. If you want to
keep your existing settings and not run interactivly then simply run

  perl Configure -d

before running Makefile.PL.

DOCUMENTATION

See ChangeLog for recent changes.  POD style documentation is included
in all modules and scripts.  These are normally converted to manual
pages and installed as part of the "make install" process.  You should
also be able to use the 'perldoc' utility to extract documentation from
the module files directly.

DEMOS

The demos directory does contain a few demo scripts. These should be
run from the top directory like

    demos/smtp.self -user my-email-address -debug

However I do not guarantee these scripts to work.

SUPPORT

Questions about how to use this library should be directed to the
comp.lang.perl.modules USENET Newsgroup.  Bug reports and suggestions
for improvements can be reported on the CPAN request tracker at

    http://rt.cpan.org/Dist/Display.html?Name=libnet

Most of the modules in this library have an option to output a debug
transcript to STDERR. When reporting bugs/problems please, if possible,
include a transcript of a run.

COPYRIGHT

  Versions up to 1.22_01 (C) 1996-2007 Graham Barr. All rights reserved.
  Changes in Version 1.22_02 onwards Copyright (C) 2013-2014 Steve Hay.
  All rights reserved.

This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself.

Share and Enjoy!

# heads (aka `branches'):
$ git for-each-ref --sort=-creatordate refs/heads \
	--format='%(HEAD) %(refname:short) %(subject) (%(creatordate:short))'
  nntp-compress Net::NNTP: support COMPRESS DEFLATE (RFC8054) (2019-07-03)
  read-early   Net::Cmd: fix ->getline if SSL_read overreads (2019-07-02)
* master       Use L<> for links (2017-12-15)

# tags:
$ git for-each-ref --sort=-creatordate refs/tags \
	--format='%(refname:short) %(subject) (%(creatordate:short))'
v3.11        Release 3.11 (2017-11-14) tar.gz
v3.10        Release 3.10 (2016-08-01) tar.gz
v3.09        Release 3.09 (2016-07-19) tar.gz
v3.08        Release 3.08 (2016-01-05) tar.gz
v3.07        Release 3.07 (2015-07-17) tar.gz
v3.06        Release 3.06 (2015-07-06) tar.gz
v3.05        Release 3.05 (2015-01-12) tar.gz
v3.04        Release 3.04 (2014-11-29) tar.gz
v3.03        Release 3.03 (2014-11-28) tar.gz
v3.02        Release 3.02 (2014-10-11) tar.gz
...

git clone https://80x24.org/perl-libnet.git