summaryrefslogtreecommitdiff
path: root/usr.sbin/nsd/nsd-checkconf.8.in
blob: ef7ff02c18ed30d1ed150865a637d1dba71afff9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
.TH "nsd\-checkconf" "8" "Nov  1, 2012" "NLnet Labs" "nsd 3.2.14"
.\" Copyright (c) 2001\-2011, NLnet Labs. All rights reserved.
.\" See LICENSE for the license.
.SH "NAME"
.LP
.B nsd\-checkconf
\- NSD configuration file checker.
.SH "SYNOPSIS"
.LP
.B nsd\-checkconf
.RB [ \-v ]
.RB [ \-h ]
.RB [ \-o
.IR option ]
.RB [ \-z
.IR zonename ]
.RB [ \-s
.IR keyname ]
.I configfile
.SH "DESCRIPTION"
.LP
.B nsd\-checkconf
reads a configuration file. It prints parse errors to standard 
error, and performs additional checks on the contents. The 
configfile format is described in nsd.conf(5).
.P
The utility of this program is to check a config file for errors 
before using it in nsd(8) or nsd\-zonec(8). This program can also be used 
for shell scripts to access the nsd config file, using the \-o and 
\-z options.
.P
.SH "OPTIONS"
.TP
.B \-v
After reading print the options to standard output in configfile 
format. Without this option, only success or parse errors are 
reported.
.TP
.B \-h
Print usage help information and exit.
.TP
.B \-o\fI option
Return only this option from the config file. This option can
to be used in conjunction with the 
.B \-z
option.
The special value 
.I zones
prints out a list of configured zones.
.P
.RS
This option is primarily used by 
.B nsdc 
to parse the config file from the shell. If the
.B \-z
option is given, but the 
.B \-o 
option is not given, nothing is printed. 
.RE
.TP
.B \-s\fI keyname
Prints the key secret (base64 blob) configured for this key in the 
config file. Used to help shell scripts parse the config file.
.TP
.B \-z\fI zonename
Return the option specified with 
.B \-o
for zone 'zonename'.
.P
.RS
If this option is not given, the server section of the config file
is used.  This option is primarily used by 
.B nsdc 
to parse the config file from the shell.
.RE
.P
.RS
The \-o, \-s and \-z option print configfile options to standard output. 
.RE
.SH "FILES"
.TP
@nsdconfigfile@
default
.B NSD
configuration file
.SH "SEE ALSO"
.LP
nsd(8), nsdc(8), nsd.conf(5), nsd\-notify(8), nsd\-patch(8), 
nsd-xfer(8), nsd\-zonec(8)
.SH "AUTHORS"
.LP
.B NSD
was written by NLnet Labs and RIPE NCC joint team. Please see
CREDITS file in the distribution for further details.