ltm rule command DATAGRAM udp

iRule(1)		      BIG-IP TMSH Manual		      iRule(1)



DATAGRAM::udp
       Returns UDP payload information.

SYNOPSIS
       DATAGRAM::udp payload (LENGTH)?

       DATAGRAM::udp payload_length

DESCRIPTION
       This iRules command returns UDP payload information.  Note: throws an
       error if L4 protocol of the current connection is not UDP

       DATAGRAM::udp payload []

	    * Returns the content of the current UDP payload. If  is specified and more than 
	      bytes are available, only the first  bytes of collected data are returned.

       DATAGRAM::udp payload_length

	    * Returns the length, in bytes, of the current UDP payload.

RETURN VALUE
VALID DURING
       FLOW_INIT, CLIENT_DATA

EXAMPLES
	when FLOW_INIT {
	  if { [IP::protocol] == 17 } {
	     log local0. "UDP Flow: [IP::client_addr] [UDP::client_port] --> [IP::local_addr] [UDP::local_port]"
	     log local0. "UDP Payload Length = [DATAGRAM::udp payload_length] Payload: [DATAGRAM::udp payload 100]"
	   }
	}

HINTS
SEE ALSO
CHANGE LOG
       @BIGIP-12.0.0 --First introduced the command.



BIG-IP				  2017-01-31			      iRule(1)