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


Manual Reference Pages  -  NET::PACKET::IPV4 (3)

.ds Aq ’

NAME

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

CONTENTS

SYNOPSIS



   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;



DESCRIPTION

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

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

See also <B>Net::Packet::LayerB> and <B>Net::Packet::Layer3B> for other attributes and methods.

ATTRIBUTES

<B>idB> IP ID of the datagram.
<B>ttlB> Time to live.
<B>srcB>
<B>dstB> Source and destination IP addresses.
<B>protocolB> Of which type the layer 4 is.
<B>checksumB> IP checksum.
<B>flagsB> IP Flags.
<B>offsetB> IP fragment offset.
<B>versionB> IP version, here it is 4.
<B>tosB> Type of service flag.
<B>lengthB> Total length in bytes of the packet, including IP headers (that is, layer 3 + layer 4 + layer 7).
<B>hlenB> Header length in number of words, including IP options.
<B>optionsB> IP options, as a hexadecimal string.
<B>noFixLenB> Since the byte ordering of <B>lengthB> attribute varies from system to system, a subroutine inside this module detects which byte order to use. Sometimes, like when you build <B>Net::Packet::VLANB> 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).

METHODS

<B>newB> 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

<B>packB> Packs all attributes into a raw format, in order to inject to network. Returns 1
on success, undef otherwise.
<B>unpackB> Unpacks raw data from network and stores attributes into the object. Returns 1 on success, undef otherwise.
<B>getHeaderLengthB> Returns the header length in bytes, not including IP options.
<B>getPayloadLengthB> Returns the length in bytes of encapsulated layers (that is, layer 4 + layer 7).
<B>getOptionsLengthB> Returns the length in bytes of IP options.
<B>haveFlagDfB>
<B>haveFlagMfB>
<B>haveFlagRfB> Returns 1 if the specified flag is set in <B>flagsB> attribute, 0 otherwise.
<B>isProtocolTcpB>
<B>isProtocolUdpB>
<B>isProtocolIpv6B>
<B>isProtocolOspfB>
<B>isProtocolIgmpv4B>
<B>isProtocolIcmpv4B> Returns 1 if the specified protocol is used at layer 4, 0 otherwise.

CONSTANTS

Load them: use Net::Packet::Consts qw(:ipv4);
<B>NP_IPv4_PROTOCOL_TCPB>
<B>NP_IPv4_PROTOCOL_UDPB>
<B>NP_IPv4_PROTOCOL_ICMPv4B>
<B>NP_IPv4_PROTOCOL_IPv6B>
<B>NP_IPv4_PROTOCOL_OSPFB>
<B>NP_IPv4_PROTOCOL_IGMPv4B> Various protocol type constants.
<B>NP_IPv4_MORE_FRAGMENTB>
<B>NP_IPv4_DONT_FRAGMENTB>
<B>NP_IPv4_RESERVED_FRAGMENTB> Various possible flags.

AUTHOR

Patrice <GomoR> Auffret

COPYRIGHT AND LICENSE

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.

RELATED MODULES

NetPacket, Net::RawIP, Net::RawSock

POD ERRORS

Hey! <B>The above document had some coding errors, which are explained below:B>
Around line 287: Non-ASCII character seen before =encoding in ’# Build’. Assuming ISO8859-1
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 NET::PACKET::IPV4 (3) 2009-11-09

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