The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Net::Frame::Layer::ICMPv6 - Internet Control Message Protocol v6 layer object

SYNOPSIS

   use Net::Frame::Simple;
   use Net::Frame::Layer::ICMPv6 qw(:consts);

   my $icmp = Net::Frame::Layer::ICMPv6->new(
      type     => NF_ICMPv6_TYPE_ECHO_REQUEST,
      code     => NF_ICMPv6_CODE_ZERO,
      checksum => 0,
   );

   # Build an ICMPv6 echo-request
   use Net::Frame::Layer::ICMPv6::Echo;
   my $echo = Net::Frame::Layer::ICMPv6::Echo->new(payload => 'echo');

   my $echoReq = Net::Frame::Simple->new(layers => [ $icmp, $echo ]);
   print $echoReq->print."\n";

   # Build an ICMPv6 neighbor-solicitation
   use Net::Frame::Layer::ICMPv6::NeighborSolicitation;
   my $solicit = Net::Frame::Layer::ICMPv6::NeighborSolicitation->new(
      targetAddress => $targetIpv6Address,
   );
   $icmp->type(NF_ICMPv6_TYPE_NEIGHBORSOLICITATION);

   my $nsReq = Net::Frame::Simple->new(layers => [ $icmp, $solicit ]);
   print $nsReq->print."\n";

   #
   # Read a raw layer
   #

   my $layer = Net::Frame::Layer::ICMPv6->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 ICMPv6 layer.

RFC: http://www.rfc-editor.org/rfc/rfc4861.txt

RFC: http://www.rfc-editor.org/rfc/rfc4389.txt

RFC: http://www.rfc-editor.org/rfc/rfc4191.txt

RFC: http://www.rfc-editor.org/rfc/rfc3775.txt

RFC: http://www.rfc-editor.org/rfc/rfc2463.txt

RFC: http://www.rfc-editor.org/rfc/rfc2461.txt

RFC: http://www.rfc-editor.org/rfc/rfc2460.txt

See also Net::Frame::Layer for other attributes and methods.

ATTRIBUTES

type
code

Type and code fields. See CONSTANTS.

checksum

The checksum of ICMPv6 header.

The following are inherited attributes. See Net::Frame::Layer for more information.

raw
payload
nextLayer

METHODS

new
new (hash)

Object constructor. You can pass attributes that will overwrite default ones. See SYNOPSIS for default values.

computeChecksums

Computes the ICMPv6 checksum.

getKey
getKeyReverse

These two methods are basically used to increase the speed when using recv method from Net::Frame::Simple. Usually, you write them when you need to write match method.

match (Net::Frame::Layer::ICMPv6 object)

This method is mostly used internally. You pass a Net::Frame::Layer::ICMPv6 layer as a parameter, and it returns true if this is a response corresponding for the request, or returns false if not.

The following are inherited methods. Some of them may be overridden in this layer, and some others may not be meaningful in this layer. See Net::Frame::Layer for more information.

layer
computeLengths
computeChecksums
pack
unpack
encapsulate
getLength
getPayloadLength
print
dump

CONSTANTS

Load them: use Net::Frame::Layer::ICMPv6 qw(:consts);

Various types and codes for ICMPv6 header.

NF_ICMPv6_CODE_ZERO
NF_ICMPv6_TYPE_DESTUNREACH
NF_ICMPv6_CODE_NOROUTE
NF_ICMPv6_CODE_ADMINPROHIBITED
NF_ICMPv6_CODE_NOTASSIGNED
NF_ICMPv6_CODE_ADDRESSUNREACH
NF_ICMPv6_CODE_PORTUNREACH
NF_ICMPv6_CODE_FAILPOLICY
NF_ICMPv6_CODE_REJECTROUTE
NF_ICMPv6_TYPE_TOOBIG
NF_ICMPv6_TYPE_TIMEEXCEED
NF_ICMPv6_CODE_HOPLIMITEXCEED
NF_ICMPv6_CODE_FRAGREASSEMBLYEXCEEDED
NF_ICMPv6_TYPE_PARAMETERPROBLEM
NF_ICMPv6_CODE_ERRONEOUSHERDERFIELD
NF_ICMPv6_CODE_UNKNOWNNEXTHEADER
NF_ICMPv6_CODE_UNKNOWNOPTION
NF_ICMPv6_TYPE_ECHO_REQUEST
NF_ICMPv6_TYPE_ECHO_REPLY
NF_ICMPv6_TYPE_MLDQUERY
NF_ICMPv6_TYPE_MLDREPORTv1
NF_ICMPv6_TYPE_MLDDONE
NF_ICMPv6_TYPE_ROUTERSOLICITATION
NF_ICMPv6_TYPE_ROUTERADVERTISEMENT
NF_ICMPv6_TYPE_NEIGHBORSOLICITATION
NF_ICMPv6_TYPE_NEIGHBORADVERTISEMENT
NF_ICMPv6_TYPE_MLDREPORTv2
NF_ICMPv6_OPTION_SOURCELINKLAYERADDRESS
NF_ICMPv6_OPTION_TARGETLINKLAYERADDRESS
NF_ICMPv6_OPTION_PREFIXINFORMATION
NF_ICMPv6_OPTION_REDIRECTEDHEADER
NF_ICMPv6_OPTION_MTU

Various flags for some ICMPv6 messages.

NF_ICMPv6_FLAG_ROUTER
NF_ICMPv6_FLAG_SOLICITED
NF_ICMPv6_FLAG_OVERRIDE
NF_ICMPv6_FLAG_MANAGEDADDRESSCONFIGURATION
NF_ICMPv6_FLAG_OTHERCONFIGURATION
NF_ICMPv6_FLAG_MOBILEIPv6HOMEAGENT
NF_ICMPv6_FLAG_ROUTERSELECTIONPREFHIGH
NF_ICMPv6_FLAG_ROUTERSELECTIONPREFMEDIUM
NF_ICMPv6_FLAG_ROUTERSELECTIONPREFLOW
NF_ICMPv6_FLAG_ROUTERSELECTIONPREFRESERVED
NF_ICMPv6_FLAG_NEIGHBORDISCOVERYPROXY

SEE ALSO

Net::Frame::Layer

AUTHOR

Patrice <GomoR> Auffret

COPYRIGHT AND LICENSE

Copyright (c) 2006-2019, Patrice <GomoR> Auffret

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