ltm rule command TCP release

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



TCP::release
       Release data gathered by TCP::collect to the upper layer.

SYNOPSIS
       TCP::release (LENGTH)?

DESCRIPTION
       Causes TCP to release and flush collected data, and allow other
       protocol layers to resume processing the connection.

       Returns the number of bytes actually released. If specified, up to
       length bytes are released; the return value will tell you how many
       bytes actually were.

       Syntax

       TCP::release []

	    * Causes TCP to release and flush collected data, and allow other
	      protocol layers to resume processing the connection. Returns the
	      number of bytes actually released. If specified, up to length bytes
	      are released; the return value will tell you how many bytes
	      actually were.

RETURN VALUE
       The number of bytes released.

VALID DURING
       CLIENT_ACCEPTED, CLIENT_CLOSED, CLIENT_DATA, SERVER_CLOSED,
       SERVER_CONNECTED, SERVER_DATA, SIP_REQUEST, SIP_REQUEST_SEND,
       SIP_RESPONSE, STREAM_MATCHED

EXAMPLES
	when CLIENT_ACCEPTED {
	  TCP::collect 15
	}
	when CLIENT_DATA {
	  if { [TCP::payload 15] contains "XYZ" } {
	     pool xyz_servers
	  } else {
	     pool web_servers
	 }
	 # HTTP_REQUEST will not fire until we release the collected TCP data
	 TCP::release
	}

HINTS
SEE ALSO
       TCP::collect TCP::notify

CHANGE LOG
       @BIGIP-9.0.0 --First introduced the command.



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