NAME

Net::DNSServer::DBI - SQL backend for resolving DNS queries

SYNOPSIS

  #!/usr/bin/perl -w
  use strict;
  use Net::DNSServer;
  use Net::DNSServer::DBI;

  my $dbi_resolver = new Net::DNSServer::DBI {
    connect => [ dbi connect args ... ],
    default_ttl => "3600",
    default_serial => "2002040100",
    default_nameservers => [ qw(ns.isp.com) ],
  };

  run Net::DNSServer {
    priority => [ $dbi_resolver ],
  };

DESCRIPTION

This resolver translates a DNS query into an SQL query. The answer from the SQL server is translated back into a DNS response and sent to the DNS client.

This module requires an external database server to be running and the DBI / DBD::* API Interface to the SQL database server to be installed. The external database server may run on the same machine as the name server, (localhost), or it may run on a separate machine or database cluster for increased scalability and/or fault tolerance.

new

The new() method takes a hash ref of properties.

connect (required)

This is a hash ref of arguments that will be passed to DBI->connect() to initiate the connection to the database which must yield a valid database handle.

This field is required.

default_ttl (optional)

This is the $DEFAULT_TTL that will be used in case a zone template does not contain its own.

If none is supplied, it defaults to 86400.

default_serial (optional)

This is the serial number to be used for those in the "soa" table with NULL for serial.

If none is supplied, it defaults to today:

date +"%Y%m%d00"

default_nameservers (optional)

This is an array ref of name servers to be used for all entries that have %NS% in the "soa" table. The first element of this array is also considered the primary SOA server.

If none is supplied, the fully qualified domain of the hostname is used:

hostname --fqdn

along with its complement name server computed based on the hostname. i.e., "ns1.isp.com" will also add "ns2.isp.com" to this setting.

EXAMPLE

See demo/mysql/README packaged with this distribution for a working example using the MySQL database server as its SQL backend.

AUTHOR

Rob Brown, rob@roobik.com

SEE ALSO

DBI, Net::DNSServer, Net::DNSServer::Base,

COPYRIGHT

Copyright (c) 2002, Rob Brown. All rights reserved.

Net::DNSServer is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

$Id: DBI.pm,v 1.3 2002/04/29 10:50:31 rob Exp $