From: Bert Hubert Date: Fri, 13 Dec 2002 08:35:20 +0000 (+0000) Subject: manpages X-Git-Tag: pdns-2.9.2~3 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=ca249bf7e7f278bea8b0f26afef8da65caa7609a;p=pdns manpages git-svn-id: svn://svn.powerdns.com/pdns/trunk/pdns@72 d19b8d6e-7fed-0310-83ef-9ca221ded41b --- diff --git a/Makefile.am b/Makefile.am index 1b713758d..26646a45d 100644 --- a/Makefile.am +++ b/Makefile.am @@ -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 "***********************************************************" diff --git a/configure.in b/configure.in index d6351b57e..dc1ad0a1b 100644 --- a/configure.in +++ b/configure.in @@ -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 index 000000000..e69de29bb diff --git a/modules/odbcbackend/OBJECTLIBS b/modules/odbcbackend/OBJECTLIBS new file mode 100644 index 000000000..e69de29bb diff --git a/pdns/docs/pdns_control.8 b/pdns/docs/pdns_control.8 new file mode 100644 index 000000000..981642dba --- /dev/null +++ b/pdns/docs/pdns_control.8 @@ -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[]\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 \fR +Set the configuration parameter \fI\fR to \fI\fR. Currently +only the \fIquery\-logging\fR can be set. +.TP +.B show \fI\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 +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 index 000000000..3e6395d43 --- /dev/null +++ b/pdns/docs/pdns_server.8 @@ -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\fR +Set the logging level. +.SH FILES +.TP +.I +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 index 000000000..9c32bc4bd --- /dev/null +++ b/pdns/docs/zone2sql.8 @@ -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\fR +Read \fI\fR to get the bind configuration +.TP +.B \-\-zone=\fI\fR +Parse only this zone file. Conflicts with \fB\-\-named-conf\fR parameter. +.TP +.B \-\-zone-name=\fI\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'qname''qtype''content'priottl +.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\fR +Use \fI\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)