GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
Net::Works(3) User Contributed Perl Documentation Net::Works(3)

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

version 0.22

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.

Here are some of the key differences between the two distributions:
  • 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.

  • 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.

  • 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.

  • Constructors throw exceptions

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

  • 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.

  • 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.

  • Does less

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

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.

  • Dave Rolsky <autarch@urth.org>
  • Greg Oschwald <oschwald@cpan.org>
  • Olaf Alders <oalders@wundercounter.com>

  • Alexander Hartmaier <abraxxa@cpan.org>
  • Dave Rolsky <drolsky@maxmind.com>
  • Greg Oschwald <goschwald@maxmind.com>
  • TJ Mather <tjmather@maxmind.com>
  • William Stevenson <wstevenson@maxmind.com>

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.

2016-08-21 perl v5.32.1

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.