~ntt-pf-lab/nova/monkey_patch_notification

<?xml version="1.0" encoding="utf-8"?><!DOCTYPE html PUBLIC '-//W3C//DTD XHTML 1.0 Transitional//EN' 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd'><html lang="en" xmlns="http://www.w3.org/1999/xhtml">

<head>

<title>Twisted Documentation: Creating and working with a names (DNS) server</title>

</head>

<h1 class="title">Creating and working with a names (DNS) server</h1>

<div class="toc"><ol><li><a href="#auto0">Creating a non-authoritative server</a></li><li><a href="#auto1">Creating an authoritative server</a></li></ol></div>

A Names server can be perform three basic operations:

<ul>

<li>act as a recursive server, forwarding queries to other servers</li>

<li>perform local caching of recursively discovered records</li>

<li>act as the authoritative server for a domain</li>

</ul>

<h2>Creating a non-authoritative server<a name="auto0"/></h2>

The first two of these are easy, and you can create a server that performs them

with the command <code class="shell">twistd -n dns --recursive --cache</code>.

You may wish to run this as root since it will try to bind to UDP port 53. Try

performing a lookup with it, <code class="shell">dig twistedmatrix.com

@127.0.0.1</code>.

<h2>Creating an authoritative server<a name="auto1"/></h2>

To act as the authority for a domain, two things are necessary: the address

of the machine on which the domain name server will run must be registered

as a nameserver for the domain; and the domain name server must be

configured to act as the authority. The first requirement is beyond the

scope of this howto and will not be covered.

To configure Names to act as the authority for

<code>example-domain.com</code>, we first create a

zone file for this domain.

<div class="py-listing"><pre> 1

zone = [

SOA(

# For whom we are the authority

'example-domain.com',

# This nameserver's name

mname = "ns1.example-domain.com",

# Mailbox of individual who handles this

rname = "root.example-domain.com",

# Unique serial identifying this SOA data

serial = 2003010601,

# Time interval before zone should be refreshed

refresh = "1H",

# Interval before failed refresh should be retried

retry = "1H",

100

101

# Upper limit on time interval before expiry

102

expire = "1H",

103

104

# Minimum TTL

105

minimum = "1H"

106

107

108

A('example-domain.com', '127.0.0.1'),

109

NS('example-domain.com', 'ns1.example-domain.com'),

110

111

CNAME('www.example-domain.com', 'example-domain.com'),

112

CNAME('ftp.example-domain.com', 'example-domain.com'),

113

114

MX('example-domain.com', 0, 'mail.example-domain.com'),

115

A('mail.example-domain.com', '123.0.16.43')

116

]

117

</pre><div class="caption">Zone file - <a href="listings/names/example-domain.com">listings/names/example-domain.com</a></div></div>

118

119

Next, run the command <code class="shell">twistd -n dns --pyzone

120

example-domain.com</code>. Now try querying the domain locally (again, with

121

dig): <code class="shell">dig -t any example-domain.com @127.0.0.1</code>.

122

123

124

Names can also read a traditional, BIND-syntax zone file. Specify these

125

with the <code>--bindzone</code> parameter. The $GENERATE and $INCLUDE

126

directives are not yet supported.

127

128

129

</div>

130

131

<a href="index.html">Index</a>

132

Version: 10.0.0

133

</body>

134

</html>

b'\\ No newline at end of file'

Older »