mmb / vmod_dgram

Varnish VMOD to send data over UDP from VCL.

vmod_dgram

Varnish 4.0 Dgram Module

Author:	Matthew M. Boedicker
Author:	Maksim Naumov
Date:	2015-08-05
Version:	0.2
Manual section:	3

SYNOPSIS

import dgram;

sub vcl_deliver {

dgram.send(req.request + " " + req.http.host + req.url, "127.0.0.1", 12345);

}

DESCRIPTION

Varnish module to send arbitrary data over UDP from VCL.

The original use case is a hit counter that will send the URL served for every request to a simple UDP server for further processing.

FUNCTIONS

dgram

Prototype

send(STRING S, STRING HOST, INT PORT)

Return value

VOID

Description

Sends S as UDP to HOST:PORT.

Example

dgram.send("Hello world", "127.0.0.1", 12345);

INSTALLATION

If you received this package without a pre-generated configure script, you must have the GNU Autotools installed, and can then run the 'autogen.sh' script. If you received this package with a configure script, skip to the second command-line under Usage to configure.

Usage:

# Generate configure script
./autogen.sh

# Execute configure script
./configure [PKG_CONFIG=PATH]

Make targets:

• make - builds the vmod
• make install - installs your vmod
• make check - runs the unit tests in src/tests/*.vtc

HISTORY

COPYRIGHT

• Copyright (c) 2013 Matthew M. Boedicker
• Copyright (c) 2015 Maksim Naumov