diff options
| author | Martin Schwenke <martin@meltin.net> | 2014-10-18 14:39:30 +1100 |
|---|---|---|
| committer | Amitay Isaacs <amitay@samba.org> | 2014-10-28 05:42:04 +0100 |
| commit | a6e770ec287b78ec2d2c85a6d0c22a67bd03a4d6 (patch) | |
| tree | 9d9dfb73434ff15db6d6bba1cd08b53036bac6d2 /ctdb/doc | |
| parent | 1d1cd04cb9b8e66e0303c362669db2c6c47fccae (diff) | |
| download | samba-a6e770ec287b78ec2d2c85a6d0c22a67bd03a4d6.tar.gz samba-a6e770ec287b78ec2d2c85a6d0c22a67bd03a4d6.tar.xz samba-a6e770ec287b78ec2d2c85a6d0c22a67bd03a4d6.zip | |
ctdb-logging: Add non-blocking Unix domain logging to syslog backend
Format messages as per RFC3164.
Signed-off-by: Martin Schwenke <martin@meltin.net>
Reviewed-by: Amitay Isaacs <amitay@gmail.com>
Diffstat (limited to 'ctdb/doc')
| -rw-r--r-- | ctdb/doc/ctdbd.1.xml | 31 | ||||
| -rw-r--r-- | ctdb/doc/ctdbd.conf.5.xml | 28 |
2 files changed, 53 insertions, 6 deletions
diff --git a/ctdb/doc/ctdbd.1.xml b/ctdb/doc/ctdbd.1.xml index e700bf293e..fdf03d1e3a 100644 --- a/ctdb/doc/ctdbd.1.xml +++ b/ctdb/doc/ctdbd.1.xml @@ -150,11 +150,36 @@ </listitem> </varlistentry> <varlistentry> - <term>syslog</term> - <listitem> + <term>syslog<optional>:<parameter>METHOD</parameter></optional></term> + <listitem> + <para> + CTDB will log to syslog. By default this will use + the syslog(3) API. + </para> + <para> + Under heavy loads syslog(3) can block if the syslog + daemon processes messages too slowly. This can + cause CTDB to block when logging. + </para> <para> - CTDB will log to syslog + If METHOD is specified then it specifies an + extension that causes logging to be done in a + non-blocking mode. Note that <emphasis>this may + cause messages to be dropped</emphasis>. METHOD + must be one of: </para> + <variablelist> + <varlistentry> + <term>nonblocking</term> + <listitem> + <para> + CTDB will log to syslog via + <filename>/dev/log</filename> in non-blocking + mode. + </para> + </listitem> + </varlistentry> + </variablelist> </listitem> </varlistentry> </variablelist> diff --git a/ctdb/doc/ctdbd.conf.5.xml b/ctdb/doc/ctdbd.conf.5.xml index 898688dc12..95f37021d3 100644 --- a/ctdb/doc/ctdbd.conf.5.xml +++ b/ctdb/doc/ctdbd.conf.5.xml @@ -242,11 +242,33 @@ </listitem> </varlistentry> <varlistentry> - <term>syslog</term> - <listitem> + <term>syslog<optional>:<parameter>METHOD</parameter></optional></term> + <listitem> + <para> + CTDB will log to syslog. By default this will use + the syslog(3) API. + </para> <para> - CTDB will log to syslog + If METHOD is specified then it specifies an + extension that causes logging to be done in a + non-blocking fashion. This can be useful under + heavy loads that might cause the syslog daemon to + dequeue messages too slowly, which would otherwise + cause CTDB to block when logging. METHOD must be + one of: </para> + <variablelist> + <varlistentry> + <term>nonblocking</term> + <listitem> + <para> + CTDB will log to syslog via + <filename>/dev/log</filename> in non-blocking + mode. + </para> + </listitem> + </varlistentry> + </variablelist> </listitem> </varlistentry> </variablelist> |