From fcc6d4d55ff29545a4002bec0288750a32322207 Mon Sep 17 00:00:00 2001 From: Matt Simerson Date: Tue, 26 Mar 2013 23:37:08 -0700 Subject: [PATCH] moved FAQ to github wiki --- MANIFEST | 1 - README | 2 ++ docs/FAQ.pod | 47 ----------------------------------------------- 3 files changed, 2 insertions(+), 48 deletions(-) delete mode 100644 docs/FAQ.pod diff --git a/MANIFEST b/MANIFEST index 8c60bdf..4de05e0 100644 --- a/MANIFEST +++ b/MANIFEST @@ -25,7 +25,6 @@ docs/advanced.pod docs/authentication.pod docs/config.pod docs/development.pod -docs/FAQ.pod docs/hooks.pod docs/logging.pod docs/plugins.pod diff --git a/README b/README index 421e7d4..d394af5 100644 --- a/README +++ b/README @@ -12,6 +12,8 @@ web: mailinglist: qpsmtpd-subscribe@perl.org +FAQ: + https://github.com/qpsmtpd-dev/qpsmtpd-dev/wiki/faq =head1 DESCRIPTION diff --git a/docs/FAQ.pod b/docs/FAQ.pod deleted file mode 100644 index 68e8806..0000000 --- a/docs/FAQ.pod +++ /dev/null @@ -1,47 +0,0 @@ -# best read with perldoc: perldoc FAQ.pod - -=head1 FAQ - -=head2 Q: Do I need to enable a logging plugin? - -=head2 A: No. - -When zero logging plugins are configured, logs are directed to STDERR. This -is the 'default' logging and logs are piped to multilog and stored in -log/main/current. - -When more than zero logging plugins are enabled, builtin logging is disabled -and logs are sent to every logging plugin configured in config/plugins. - - -=head2 Q: How do I watch the logs? - -=head2 A: Here's a few examples: - -The default log files can be watched in real time lik this: - - tail -F ~smtpd/log/main/current - -To convert the tai timestamps to human readable date time: - - tail -F ~smtpd/log/main/current | tai64nlocal - -To exclude the dates entirely, use this command: - - tail -F ~smtpd/smtpd/log/main/current | cut -d' ' -f2-3 - - -=head2 Q: How do I get alerts when qpsmtpd has a problem? - -=head2 A: Send logs with levels below LOGERROR to syslog. - -This can be done by adding the following lines to config/plugins: - - logging/syslog loglevel LOGERROR - logging/warn LOGINFO - -The warn logging plugin replicates the builtin logging, directing log messages to STDERR. The syslog plugin directs errors to syslog where standard monitoring tools can pick them up and act on them. - -With these settings, errors will still get sent to STDERR as well. - -=cut