]> granicus.if.org Git - pdns/commitdiff
manpages
authorBert Hubert <bert.hubert@netherlabs.nl>
Fri, 13 Dec 2002 08:35:20 +0000 (08:35 +0000)
committerBert Hubert <bert.hubert@netherlabs.nl>
Fri, 13 Dec 2002 08:35:20 +0000 (08:35 +0000)
git-svn-id: svn://svn.powerdns.com/pdns/trunk/pdns@72 d19b8d6e-7fed-0310-83ef-9ca221ded41b

Makefile.am
configure.in
modules/odbcbackend/OBJECTFILES [new file with mode: 0644]
modules/odbcbackend/OBJECTLIBS [new file with mode: 0644]
pdns/docs/pdns_control.8 [new file with mode: 0644]
pdns/docs/pdns_server.8 [new file with mode: 0644]
pdns/docs/zone2sql.8 [new file with mode: 0644]

index 1b713758dd5746236236123281c0d2f7a35d49fd..26646a45d45f45fddcd2467ac641abb3c7dd0cb0 100644 (file)
@@ -1,6 +1,8 @@
 SUBDIRS=modules pdns
 EXTRA_DIST=TODO WARNING README HACKING INSTALL ChangeLog debian pdns.spec
 
+man8_MANS=pdns/docs/pdns_control.8 pdns/docs/pdns_server.8 pdns/docs/zone2sql.8 
+
 install-exec-local: 
        -@chmod +x pdns/pdns
        @echo "***********************************************************"
index d6351b57e25c8fb648b6239925f066283710416c..dc1ad0a1b73e440ebb181c109b002b04d3c25be0 100644 (file)
@@ -391,4 +391,4 @@ pdns/backends/Makefile pdns/backends/bind/Makefile pdns/pdns \
 modules/mysqlbackend/Makefile modules/pdnsbackend/Makefile \
 modules/pgmysqlbackend/Makefile modules/db2backend/Makefile \
 modules/pipebackend/Makefile modules/oraclebackend/Makefile \
-modules/xdbbackend/Makefile)
+modules/xdbbackend/Makefile modules/odbcbackend/Makefile )
diff --git a/modules/odbcbackend/OBJECTFILES b/modules/odbcbackend/OBJECTFILES
new file mode 100644 (file)
index 0000000..e69de29
diff --git a/modules/odbcbackend/OBJECTLIBS b/modules/odbcbackend/OBJECTLIBS
new file mode 100644 (file)
index 0000000..e69de29
diff --git a/pdns/docs/pdns_control.8 b/pdns/docs/pdns_control.8
new file mode 100644 (file)
index 0000000..981642d
--- /dev/null
@@ -0,0 +1,47 @@
+.TH PDNS_CONTROL 8 "December 2002" "PowerDNS"
+.SH NAME
+pdns_control \- Control the pDNS nameserver
+.SH SYNOPSIS
+.B pdns_control command
+.SH DESCRIPTION
+\fBpdns_control\fR is used to send commands to a running pDNS nameserver.
+.SH COMMANDS
+.TP
+.B ccounts
+Show the content of the cache
+.TP
+.B cycle
+Restart the nameserver so it reloads its configuration.
+.TP
+.B list
+????
+.TP
+.B purge \fI[<record>]\fR
+Purge entries from the packet cache. If the record name ends with a
+dollar ($) all entries that end with that name are removed. If no record is
+specified the entire cache is purged.
+.TP
+.B quit
+Tell a running \fBpdns_server\fR to to quit.
+.TP
+.B set \fI<variable> <value>\fR
+Set the configuration parameter \fI<variable>\fR to \fI<value>\fR. Currently
+only the \fIquery\-logging\fR can be set.
+.TP
+.B show \fI<variable>\fR
+Print the value of a specific configuration variable.
+.TP
+.B status
+Show usage statistics.
+.TP
+.B uptime
+Show the uptime of the running server.
+.TP
+.B version
+Print the version of the running pdns daemon.
+.SH FILES
+.TP
+.I <socket>
+Control socket used to communicate with \fBpdns_server\fR.
+.SH SEE ALSO
+.BR pdns_server (8)
diff --git a/pdns/docs/pdns_server.8 b/pdns/docs/pdns_server.8
new file mode 100644 (file)
index 0000000..3e6395d
--- /dev/null
@@ -0,0 +1,30 @@
+.TH PDNS_SERVER 8 "December 2002" "PowerDNS"
+.SH NAME
+pdns_control \- The PowerDNS nameserver
+.SH SYNOPSIS
+.B pdns_server [options]
+.SH DESCRIPTION
+\fB
+.SH OPTIONS
+.TP
+.B \-\-daemon=\fIyes|no\fR
+Indicate if the server should run in the background as a real daemon,
+or in the foregroun.
+.TP
+.B \-\-guardion=\fIyes|no\fR
+Run \fBpdns_server\fR inside a guardian. This guardian monitors the performance
+of the inner \fBpdns_server\fR instance. It is also this guardian that
+\fBpdns_control\fR talks to.
+.TP
+.B \-\-control\-console
+Run the server in a special monitor mode. This enables detailed logging
+and exposes the raw control socket.
+.TP
+.B \-\-loglevel=\fI<level>\fR
+Set the logging level.
+.SH FILES
+.TP
+.I <socket>
+Control socket used to communicate with \fBpdns_server\fR.
+.SH SEE ALSO
+.BR pdns_control (8)
diff --git a/pdns/docs/zone2sql.8 b/pdns/docs/zone2sql.8
new file mode 100644 (file)
index 0000000..9c32bc4
--- /dev/null
@@ -0,0 +1,81 @@
+.TH ZONE2SQL 8 "December 2002" "PowerDNS"
+.SH NAME
+zone2sql \- Convert ISC Bind zones to SQL
+.SH SYNOPSIS
+.B zone2sql [OPTIONS]
+.SH DESCRIPTION
+\fBZone2sql\fR parses Bind \fInamed.conf\fR files and zonefiles and outputs SQL
+on standard out, which can then be fed to your database.
+.PP
+\fBzone2sql\fR understands the Bind master file extension '$GENERATE' and will
+also honour '$ORIGIN' and '$TTL'.
+.PP
+For backends supporting slave operation (currently only the PostgreSQL
+backend), there is also an option to keep slave zones as slaves, and not
+convert them to native operation.
+.PP
+By default, zone2sql outputs code suitable for the mysqlbackend, but it can
+also generate SQL for the Generic PostgreSQL and Oracle backends.
+.SH OPTIONS
+Input options:
+.TP
+.B \-\-named-conf=\fI<filename>\fR
+Read \fI<filename>\fR to get the bind configuration
+.TP
+.B \-\-zone=\fI<zone\-file>\fR
+Parse only this zone file. Conflicts with \fB\-\-named-conf\fR parameter.
+.TP
+.B \-\-zone-name=\fI<name>\fR
+When parsing a single zone without $ORIGIN statement, set this as the zone
+name. 
+.PP
+Output options:
+.TP
+.B \-\-bare
+Output in a bare format, suitable for further parsing. The output is formatted
+as follows:
+.RS
+.nf
+domain_id<TAB>'qname'<TAB>'qtype'<TAB>'content'<TAB>prio<TAB>ttl
+.fi
+.RE
+.TP
+.B \-\-gmysql
+Output in format suitable for the default configuration of the Generic MySQL
+backend. 
+.TP
+.B \-\-gpgsql
+Output in format suitable for the default configuration of the Generic
+PostgreSQL backend.
+.TP
+.B \-\-mysql
+Output in format suitable for the default configuration of the MySQL backend
+(the default output format).
+.TP
+.B \-\-oracle
+Output in format suitable for the default configuration of the Generic Oracle
+backend. 
+.TP
+.B \-\-startid=\fI<id>\fR
+Use \fI<id>\fR as the forst domain_id generated (defaults to 0).
+.TP
+.B \-\-transactions
+For Oracle and PostgreSQL output, wrap each domain in a transaction for higher
+speed and integrity. 
+.PP
+Other options:
+.TP
+.B \-\-slave
+Maintain slave status of zones listed in named.conf as being slaves. The
+default behaviour is to convert all zones to native operation. 
+.TP
+.B \-\-on\-error\-resume\-next
+Ignore missing files during parsing. Dangerous.
+.TP
+.B \-\-help
+List all options
+.TP
+.B \-\-verbose
+Be verbose during conversion. 
+.SH SEE ALSO
+.BR pdns_server (8)