Skip to content

Commit 11a98ac

Browse files
committed
Add logging, verbosity notes to README.
1 parent 916fec6 commit 11a98ac

File tree

1 file changed

+13
-0
lines changed

1 file changed

+13
-0
lines changed

README.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -578,6 +578,8 @@ in `/etc/sasl-xoauth2.conf`. Set them when setting the initial access token:
578578

579579
## Debugging
580580

581+
### Increasing Verbosity
582+
581583
By default, sasl-xoauth2 will write to syslog if authentication fails. To
582584
disable this, set `log_to_syslog_on_failure` to `no` in
583585
`/etc/sasl-xoauth2.conf`:
@@ -593,6 +595,17 @@ disable this, set `log_to_syslog_on_failure` to `no` in
593595
Conversely, to get more verbose logging when authentication fails, set
594596
`log_full_trace_on_failure` to `yes`.
595597

598+
To get *even more* logging, set `always_log_to_syslog` to `yes` to have
599+
sasl-xoauth2 immediately and unconditionally write logs to syslog .
600+
601+
### Postfix Logging
602+
603+
It can be useful (thanks [@kpedro88](https://github.com/kpedro88)!) to increase
604+
Postfix's logging level, following the instructions
605+
[here](https://www.postfix.org/DEBUG_README.html#verbose).
606+
607+
### SASL Mechanisms
608+
596609
If Postfix complains about not finding a SASL mechanism (along the lines of
597610
`warning: SASL authentication failure: No worthy mechs found`), it's possible
598611
that either `make install` or the pre-built package put libsasl-xoauth2.so in

0 commit comments

Comments
 (0)