---
name: "Net::Frame::Layer::UDP"
section: "3pm"
platform: "linux"
package: "libnet-frame-perl"
version: "1.21-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Net::Frame::Layer::UDP"
---

# Net::Frame::Layer::UDP(3pm)

User Datagram Protocol layer object

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