~ubuntu-branches/ubuntu/maverick/bind9/maverick

\fBdig\fR [ \fB@server\fR ] [ \fB-b \fIaddress\fB\fR ] [ \fB-c \fIclass\fB\fR ] [ \fB-f \fIfilename\fB\fR ] [ \fB-k \fIfilename\fB\fR ] [ \fB-p \fIport#\fB\fR ] [ \fB-t \fItype\fB\fR ] [ \fB-x \fIaddr\fB\fR ] [ \fB-y \fIname:key\fB\fR ] [ \fBname\fR ] [ \fBtype\fR ] [ \fBclass\fR ] [ \fBqueryopt\fR\fI...\fR ]

\fBdig\fR [ \fB@server\fR ] [ \fB-b \fIaddress\fB\fR ] [ \fB-c \fIclass\fB\fR ] [ \fB-f \fIfilename\fB\fR ] [ \fB-k \fIfilename\fB\fR ] [ \fB-p \fIport#\fB\fR ] [ \fB-t \fItype\fB\fR ] [ \fB-x \fIaddr\fB\fR ] [ \fB-y \fIname:key\fB\fR ] [ \fB-4\fR ] [ \fB-6\fR ] [ \fBname\fR ] [ \fBtype\fR ] [ \fBclass\fR ] [ \fBqueryopt\fR\fI...\fR ]

.sp

\fBdig\fR [ \fB-h\fR ]

.sp

When no command line arguments or options are given, will perform an

NS query for "." (the root).

.PP

It is possible to set per user defaults for \fBdig\fR via

It is possible to set per-user defaults for \fBdig\fR via

\fI${HOME}/.digrc\fR. This file is read and any options in it

are applied before the command line arguments.

.SH "SIMPLE USAGE"

.PP

The \fB-b\fR option sets the source IP address of the query

to \fIaddress\fR. This must be a valid address on

one of the host's network interfaces.

one of the host's network interfaces or "0.0.0.0" or "::". An optional port

may be specified by appending "#<port>"

.PP

The default query class (IN for internet) is overridden by the

\fB-c\fR option. \fIclass\fR is any valid

107

108

to test a name server that has been configured to listen for queries

108

109

on a non-standard port number.

109

110

.PP

111

The \fB-4\fR option forces \fBdig\fR to only

112

use IPv4 query transport. The \fB-6\fR option forces

113

\fBdig\fR to only use IPv6 query transport.

114

.PP

110

115

The \fB-t\fR option sets the query type to

111

116

\fItype\fR. It can be any valid query type which is

112

117

supported in BIND9. The default query type "A", unless the

127

132

automatically performs a lookup for a name like

128

133

11.12.13.10.in-addr.arpa and sets the query type and

129

134

class to PTR and IN respectively. By default, IPv6 addresses are

130

looked up using the IP6.ARPA domain and binary labels as defined in

131

RFC2874. To use the older RFC1886 method using the IP6.INT domain and

132

"nibble" labels, specify the \fB-n\fR (nibble) option.

135

looked up using nibble format under the IP6.ARPA domain.

136

To use the older RFC1886 method using the IP6.INT domain

137

specify the \fB-i\fR option. Bit string labels (RFC2874)

138

are now experimental and are not attempted.

133

139

.PP

134

140

To sign the DNS queries sent by \fBdig\fR and their

135

141

responses using transaction signatures (TSIG), specify a TSIG key file

191

197

Deprecated, treated as a synonym for \fI+[no]search\fR

192

198

.TP

193

199

\fB+[no]aaonly\fR

194

This option does nothing. It is provided for compatibility with old

195

versions of \fBdig\fR where it set an unimplemented

196

resolver flag.

200

Sets the "aa" flag in the query.

201

.TP

202

\fB+[no]aaflag\fR

203

A synonym for \fI+[no]aaonly\fR.

197

204

.TP

198

205

\fB+[no]adflag\fR

199

206

Set [do not set] the AD (authentic data) bit in the query. The AD bit

205

212

Set [do not set] the CD (checking disabled) bit in the query. This

206

213

requests the server to not perform DNSSEC validation of responses.

207

214

.TP

215

\fB+[no]cl\fR

216

Display [do not display] the CLASS when printing the record.

217

.TP

218

\fB+[no]ttlid\fR

219

Display [do not display] the TTL when printing the record.

220

.TP

208

221

\fB+[no]recurse\fR

209

222

Toggle the setting of the RD (recursion desired) bit in the query.

210

223

This bit is set by default, which means \fBdig\fR

280

293

in a query timeout of 1 second being applied.

281

294

.TP

282

295

\fB+tries=T\fR

283

Sets the number of times to retry UDP queries to server to

296

Sets the number of times to try UDP queries to server to

284

297

\fIT\fR instead of the default, 3. If

285

298

\fIT\fR is less than or equal to zero, the number of

286

retries is silently rounded up to 1.

299

tries is silently rounded up to 1.

300

.TP

301

\fB+retry=T\fR

302

Sets the number of times to retry UDP queries to server to

303

\fIT\fR instead of the default, 2. Unlike

304

\fI+tries\fR, this does not include the initial

305

query.

287

306

.TP

288

307

\fB+ndots=D\fR

289

308

Set the number of dots that have to appear in

319

338

\fB+[no]dnssec\fR

320

339

Requests DNSSEC records be sent by setting the DNSSEC OK bit (DO)

321

340

in the OPT record in the additional section of the query.

341

.TP

342

\fB+[no]sigchase\fR

343

Chase DNSSEC signature chains. Requires dig be compiled with

344

-DDIG_SIGCHASE.

345

.TP

346

\fB+trusted-key=####\fR

347

Specify a trusted key to be used with \fB+sigchase\fR.

348

Requires dig be compiled with -DDIG_SIGCHASE.

349

.TP

350

\fB+[no]topdown\fR

351

When chasing DNSSEC signature chains perform a top down validation.

352

Requires dig be compiled with -DDIG_SIGCHASE.

322

353

.SH "MULTIPLE QUERIES"

323

354

.PP

324

355

The BIND 9 implementation of \fBdig \fR supports

Older »