Sending UDP commands to Transformer

Transformer includes a command-line tool that enables you to send administration commands to Transformer.

For information on the commands supported by Tranformer’s UDP interface, see UDP commands.

Enabling Transformer’s UDP socket

Transformer’s UDP socket is disabled by default. To enable it, follow the steps below:

  1. Set the port number for Transformer’s UDP socket:

    udp-port       10002
  2. [Optional] Bind Transformer’s UDP socket to a single network interface:

  3. Restart Transformer:

    ./dfw start Transformer

For more information on the configuration items udp-interface and udp-port, see UDP configuration.

Sending a UDP message to Transformer

Use the udpsend utility, included with Transformer, to send UDP messages to Transformer.


Issues a UDP command to Transformer.

The udpsend utility is located in the Transformer’s bin directory.

Syntax: udpsend [-s <server-ip>] [-p <server-port>] <message>

Parameter Type Default Description




[optional] The IP address of the machine to which the UDP message is to be sent. This must be an IP address, not a host name, and must match the IP address specified for Transformer’s optional configuration item udp-interface (if specified).




[optional] Port on which the Transformer listens for UDP messages. This must be the port number specified in the udp-port option in Transformer’s transformer.conf file.



Message to send. This can include spaces. Any quotation marks in the message must be escaped to prevent the shell’s interpreter from stripping them.

Example: udpsend -s -p 10002 memory_write

For more information on the syntax of individual UDP messages, see UDP commands.

See also: