diff options
| author | jvoisin | 2025-10-24 23:50:18 +0200 |
|---|---|---|
| committer | jvoisin | 2025-10-24 23:55:13 +0200 |
| commit | 6ea4278a512bc9f1f816844222e65a4ea670db8e (patch) | |
| tree | 8c645390d3ad5202e3a894f9f6779f4cb590b02e /doc/source/config.rst | |
| parent | a167c4d23feb03e6c5b53f41724bbfcb813bf04b (diff) | |
feat(log): add the possibility to log to a filelog2file
Diffstat (limited to 'doc/source/config.rst')
| -rw-r--r-- | doc/source/config.rst | 6 |
1 files changed, 4 insertions, 2 deletions
diff --git a/doc/source/config.rst b/doc/source/config.rst index 64d3591..2053c2f 100644 --- a/doc/source/config.rst +++ b/doc/source/config.rst | |||
| @@ -139,19 +139,21 @@ log_media | |||
| 139 | ^^^^^^^^^ | 139 | ^^^^^^^^^ |
| 140 | 140 | ||
| 141 | This configuration variable allows to specify how logs should be written, | 141 | This configuration variable allows to specify how logs should be written, |
| 142 | either via ``php`` or ``syslog``. | 142 | either via ``php``, ``syslog``, or `file:`. |
| 143 | 143 | ||
| 144 | :: | 144 | :: |
| 145 | 145 | ||
| 146 | sp.log_media("php"); | 146 | sp.log_media("php"); |
| 147 | sp.log_media("syslog"); | 147 | sp.log_media("syslog"); |
| 148 | sp.log_media("file:/var/log/snuffleupagus.log"); | ||
| 148 | 149 | ||
| 149 | The default value for ``sp.log_media`` is ``php``, to respect the `principle of | 150 | The default value for ``sp.log_media`` is ``php``, to respect the `principle of |
| 150 | least astonishment | 151 | least astonishment |
| 151 | <https://en.wikipedia.org/wiki/Principle_of_least_astonishment>`__. But since | 152 | <https://en.wikipedia.org/wiki/Principle_of_least_astonishment>`__. But since |
| 152 | it's `possible to modify php's logging system via php | 153 | it's `possible to modify php's logging system via php |
| 153 | <https://www.php.net/manual/en/errorfunc.configuration.php>`__, it's | 154 | <https://www.php.net/manual/en/errorfunc.configuration.php>`__, it's |
| 154 | heavily recommended to use the ``syslog`` option instead. | 155 | heavily recommended to use the ``syslog`` option instead. The ``file:` option |
| 156 | might be useful if you're using Snuffleupagus to fuzz or audit a codebase. | ||
| 155 | 157 | ||
| 156 | log_max_len | 158 | log_max_len |
| 157 | ^^^^^^^^^^^ | 159 | ^^^^^^^^^^^ |
