Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Net::Works(3)	      User Contributed Perl Documentation	 Net::Works(3)

NAME
       Net::Works - Sane APIs for IP addresses and networks

VERSION
       version 0.22

DESCRIPTION
       The NetAddr::IP module is very complete,	correct, and useful. However,
       its API design is a bit crufty. This distro provides an alternative API
       that aims to address the	biggest	problems with that module's API, as
       well as adding some additional features.

       This distro contains two	modules, Net::Works::Address and
       Net::Works::Network.

       NOTE: This distro's APIs	are still in flux. Use at your own risk.

Net::Works VERSUS NetAddr::IP
       Here are	some of	the key	differences between the	two distributions:

       o   Separation of address from network

	   "Net::Works"	provides two classes, one for single IP	addresses and
	   one for networks (and subnets). With	NetAddr::IP a single address
	   is represented as a /32 or /128 subnet. This	is technically correct
	   but can make	the API	harder to use. Whenever	you want a single IP
	   you're always stuck checking	that the object	you're working with is
	   the size of a single	address	subnet.

       o   Multiple constructors

	   Net::Works allows you to construct an IP address from a string
	   ("192.0.2.1") or an integer (3221225985) using separate
	   constructors.

       o   Next	& previous IP

	   You can get the next	and previous address from Net::Works::Address
	   object, regardless of whether or not	that address is	in the same
	   subnet.

       o   Constructors	throw exceptions

	   If you pass bad data	to a constructor you'll	get an exception.

       o   Sane	iterator and first/last

	   The iterator	provided by Net::Works::Network	has no confusing
	   special cases. It always returns all	the addresses in a network,
	   including the network and broadcast addresses. Similarly, the
	   "$network->first()" and "$network->last()" do not return different
	   results for different sized networks.

       o   Split a range into subnets

	   The Net::Works::Network class provides a
	   "Net::Works::Network->range_as_subnets" method that takes a start
	   and end IP address and splits this into a set of subnets that
	   include all addresses in the	range.

       o   Does	less

	   This	distro does not	support	every method provided by NetAddr::IP.
	   Patches to add more features	are welcome, however.

BUGS
       Please report any bugs or feature requests to
       "bug-net-works@rt.cpan.org", or through the web interface at
       <http://rt.cpan.org>.  I	will be	notified, and then you'll
       automatically be	notified of progress on	your bug as I make changes.

AUTHORS
       o   Dave	Rolsky <autarch@urth.org>

       o   Greg	Oschwald <oschwald@cpan.org>

       o   Olaf	Alders <oalders@wundercounter.com>

CONTRIBUTORS
       o   Alexander Hartmaier <abraxxa@cpan.org>

       o   Dave	Rolsky <drolsky@maxmind.com>

       o   Greg	Oschwald <goschwald@maxmind.com>

       o   TJ Mather <tjmather@maxmind.com>

       o   William Stevenson <wstevenson@maxmind.com>

COPYRIGHT AND LICENSE
       This software is	copyright (c) 2016 by MaxMind, Inc.

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

perl v5.24.1			  2016-08-21			 Net::Works(3)

NAME | VERSION | DESCRIPTION | Net::Works VERSUS NetAddr::IP | BUGS | AUTHORS | CONTRIBUTORS | COPYRIGHT AND LICENSE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Net::Works&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help