Skip to main content

cidrdb – CIDRDB

Last updated March 2020

The cidrdb module exposes scripting functions that check the IP of incoming transactions against CIDR blocks defined within a database, a blacklist for example. For more information on CIDR blocks, see

The cidrdb module can query the data source layer or an RBLDNSD-format data file. When using the data source layer, the cidrdb module requires a previous ds_core instantiation with the uri pointing to the database that contains the table from which the CIDR blocks are drawn. For more information, see “ds_core - Datasource Query Core”.


This module is loaded automatically as required and does not need to be explicitly included.

Datasource Scope

When using the data source layer as the source for the CIDR data, ensure that you have disabled the limit on the number of rows returned in a data source query by setting max_rows to -1 as shown in the following:

Datasource "csv" {
    uri = "csv:"
    max_rows = -1

Lua Functions

This module makes the following Lua functions available:

Console Commands

The cidrdb module can be controlled through the ec_console. The following commands are available:

cidrdb reload

The reload action will trigger an immediate reload of the specified list.

cidrdb list

List configured CIDR databases. This command outputs:

cidr_name [refresh in secs seconds]

To list configured CIDR databases in XML format use xml cidrdb list . This command outputs the cidr_name, the refresh interval, and the number of seconds until the next refresh.

Was this page helpful?