NAME

       Net::Frame::Layer::UDP - User Datagram Protocol layer object

SYNOPSIS

          use Net::Frame::Layer::UDP qw(:consts);

          # Build a layer
          my $layer = Net::Frame::Layer::UDP->new(
             src      => getRandomHighPort(),
             dst      => 0,
             length   => 0,
             checksum => 0,
          );
          $layer->pack;

          print 'RAW: '.$layer->dump."\n";

          # Read a raw layer
          my $layer = Net::Frame::Layer::UDP->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 UDP layer.

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

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

ATTRIBUTES

       src
       dst Source and destination ports.

       length
           The length in bytes of the datagram, including layer 7 payload (that is, layer 4 +
           layer 7).

       checksum
           Checksum of the datagram.

       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.

       computeLengths
           Computes various lengths contained within this layer.

       computeChecksums ({ type => PROTO, src => IP, dst => IP })
           In order to compute checksums of TCP, you need to pass the protocol type (IPv4, IPv6),
           the source and destination IP addresses (IPv4 for IPv4, IPv6 for IPv6).

       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::UDP object)
           This method is mostly used internally. You pass a Net::Frame::Layer::UDP 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

       No constants here.

SEE ALSO

       Net::Frame::Layer

AUTHOR

       Patrice <GomoR> Auffret

COPYRIGHT AND LICENSE

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

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