diff options
Diffstat (limited to 'net-dns/maradns/files/maradns-2.0.06-duende-man.patch')
| -rw-r--r-- | net-dns/maradns/files/maradns-2.0.06-duende-man.patch | 109 |
1 files changed, 109 insertions, 0 deletions
diff --git a/net-dns/maradns/files/maradns-2.0.06-duende-man.patch b/net-dns/maradns/files/maradns-2.0.06-duende-man.patch new file mode 100644 index 000000000000..8e9283bc0802 --- /dev/null +++ b/net-dns/maradns/files/maradns-2.0.06-duende-man.patch @@ -0,0 +1,109 @@ +Author: Nicholas Bamber <nicholas@periapt.co.uk> +Subject: Duende man page + We have made various changes to the duende executable and these need to + be reflected in the Debian man page. +Forwarded: yes +Last-Update: 2011-07-18 +--- a/doc/en/man/duende.8 ++++ b/doc/en/man/duende.8 +@@ -29,11 +29,12 @@ + makes a given child process a daemon. The standard output + and standard error + of the child process is logged via syslog() with a priority of +-LOG_INFO. ++LOG_ALERT. + .SH "USAGE" + .PP + .B "duende" +-child_process [ all subsequent arguments passed on to child ] ++.RB [ options ] ++child_process [ arguments passed onto child ] + .SH "DETAILS" + .PP + When +@@ -76,48 +77,52 @@ + duende uses a setuid() call to change the user ID of the logging + process + to the user with ID 66. ++.SH "OPTIONS" ++.PP ++Most of the above behaviour can be configured by command line arguments. ++.TP 4 ++.BI -c | --chroot " directory" ++The log helper process will change its directory and root to this location. ++This defaults to ++.B /etc/maradns/logger "." ++.TP 4 ++.BI -i | --ident " string" ++The log helper process will use this string to identify the process when ++sending messages to syslog. ++This defaults to ++.B log-help "." ++.TP 4 ++.BI -p | --pid " filename" ++If this argument is present, the duende parent process will store its pid in ++this file. ++.TP 4 ++.BI -u | --uid " integer" ++The log helper process will drop its user id to this. This value defaults to ++66. ++.TP 4 ++.BI -g | --gid " integer" ++The log helper process will drop its group id to this. This value defaults to ++66. ++.TP 4 ++.BI -r | --restart_on " integer" ++The log helper process will restart the child process if it exists with this ++status code. This defaults to 8. + .SH "LOGGING" + .PP + .B "duende" + uses the syslog() facility to log the standard output of the + program that it invokes. The name of the program (in other words, the +-"ident" given to openlog()) is the full path of the first argument +-given +-to +-.BR "duende" "." ++"ident" given to openlog()) defaults to ++.BR "log-helper" ++but can be overridden with the ++.RB "--ident" ++argument. + All messages created by the child process are sent +-to syslog() with a priority of LOG_INFO and a "facility" +-of LOG_DAEMON (daemon.info in /etc/syslog.conf); since daemon.info +-messages are not logged by default in FreeBSD, on FreeBSD systems +-messages generated by the child process are logged with a priority of +-LOG_ALERT and a "facility" of LOG_DAEMON (daemon.alert in +-/etc/syslog.conf). ++to syslog() with a priority of LOG_ALERT and a "facility" ++of LOG_DAEMON (daemon.info in /etc/syslog.conf). + Should duende itself encounter an error, it will send + messages to syslog() with a priority of LOG_ALERT. + .PP +-For example, suppose one invokes duende thusly: +- +-.nf +- duende /usr/local/sbin/maradns +-.fi +- +-If invoked thusly, duende will log all messages with the "ident" +-(program +-name) of "/usr/local/sbin/maradns". If this is not desired, invoke +-duende +-with something like: +- +-.nf +- export PATH=$PATH:/usr/local/sbin +- duende maradns +-.fi +- +-This will log messages with a (more sensible) "ident" of maradns. +-.PP +-Note: If a non-POSIX Bourne shell (such as csh, es, rc, or fish) is +-used to +-invoke MaraDNS, the above syntax needs to be changed. +-.PP + Also, the directory /etc/maradns/logger, while used by duende, is not + used + to store any log messages. That is unless, for some reason, one |