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::Packet::IPv4(3) User Contributed Perl Documentation Net::Packet::IPv4(3)

Net::Packet::IPv4 - Internet Protocol v4 layer 3 object

   use Net::Packet::Consts qw(:ipv4);
   require Net::Packet::IPv4;

   # Build a layer
   my $ip = Net::Packet::IPv4->new(
      flags => NP_IPv4_DONT_FRAGMENT,
      dst   => "192.168.0.1",
   );
   $layer->pack;

   print 'RAW: '.unpack('H*', $layer->raw)."\n";

   # Read a raw layer
   my $layer = Net::Packet::IPv4->new(raw => $raw);

   print $layer->print."\n";
   print 'PAYLOAD: '.unpack('H*', $layer->payload)."\n"
      if $layer->payload;

This modules implements the encoding and decoding of the IPv4 layer.

RFC: ftp://ftp.rfc-editor.org/in-notes/rfc791.txt

See also Net::Packet::Layer and Net::Packet::Layer3 for other attributes and methods.

id
IP ID of the datagram.
ttl
Time to live.
src
dst
Source and destination IP addresses.
protocol
Of which type the layer 4 is.
checksum
IP checksum.
flags
IP Flags.
offset
IP fragment offset.
version
IP version, here it is 4.
tos
Type of service flag.
length
Total length in bytes of the packet, including IP headers (that is, layer 3 + layer 4 + layer 7).
hlen
Header length in number of words, including IP options.
options
IP options, as a hexadecimal string.
noFixLen
Since the byte ordering of length attribute varies from system to system, a subroutine inside this module detects which byte order to use. Sometimes, like when you build Net::Packet::VLAN layers, you may have the need to avoid this. So set it to 1 in order to avoid fixing. Default is 0 (that is to fix).

new
Object constructor. You can pass attributes that will overwrite default ones. Default values:

version: 4

tos: 0

id: getRandom16bitsInt()

length: NP_IPv4_HDR_LEN

hlen: 5

flags: 0

offset: 0

ttl: 128

protocol: NP_IPv4_PROTOCOL_TCP

checksum: 0

src: $Env->ip

dst: "127.0.0.1"

options: ""

noFixLen: 0

pack
Packs all attributes into a raw format, in order to inject to network. Returns 1 on success, undef otherwise.
unpack
Unpacks raw data from network and stores attributes into the object. Returns 1 on success, undef otherwise.
getHeaderLength
Returns the header length in bytes, not including IP options.
getPayloadLength
Returns the length in bytes of encapsulated layers (that is, layer 4 + layer 7).
getOptionsLength
Returns the length in bytes of IP options.
haveFlagDf
haveFlagMf
haveFlagRf
Returns 1 if the specified flag is set in flags attribute, 0 otherwise.
isProtocolTcp
isProtocolUdp
isProtocolIpv6
isProtocolOspf
isProtocolIgmpv4
isProtocolIcmpv4
Returns 1 if the specified protocol is used at layer 4, 0 otherwise.

Load them: use Net::Packet::Consts qw(:ipv4);
NP_IPv4_PROTOCOL_TCP
NP_IPv4_PROTOCOL_UDP
NP_IPv4_PROTOCOL_ICMPv4
NP_IPv4_PROTOCOL_IPv6
NP_IPv4_PROTOCOL_OSPF
NP_IPv4_PROTOCOL_IGMPv4
Various protocol type constants.
NP_IPv4_MORE_FRAGMENT
NP_IPv4_DONT_FRAGMENT
NP_IPv4_RESERVED_FRAGMENT
Various possible flags.

Patrice <GomoR> Auffret

Copyright (c) 2004-2009, Patrice <GomoR> Auffret

You may distribute this module under the terms of the Artistic license. See LICENSE.Artistic file in the source distribution archive.

NetPacket, Net::RawIP, Net::RawSock

Hey! The above document had some coding errors, which are explained below:
Around line 287:
Non-ASCII character seen before =encoding in '# Build'. Assuming CP1252
2009-11-09 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.