summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorjvoisin2025-10-24 23:50:18 +0200
committerjvoisin2025-10-24 23:55:13 +0200
commit6ea4278a512bc9f1f816844222e65a4ea670db8e (patch)
tree8c645390d3ad5202e3a894f9f6779f4cb590b02e /doc
parenta167c4d23feb03e6c5b53f41724bbfcb813bf04b (diff)
feat(log): add the possibility to log to a filelog2file
Diffstat (limited to '')
-rw-r--r--doc/source/config.rst6
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
141This configuration variable allows to specify how logs should be written, 141This configuration variable allows to specify how logs should be written,
142either via ``php`` or ``syslog``. 142either 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
149The default value for ``sp.log_media`` is ``php``, to respect the `principle of 150The default value for ``sp.log_media`` is ``php``, to respect the `principle of
150least astonishment 151least 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
152it's `possible to modify php's logging system via php 153it'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
154heavily recommended to use the ``syslog`` option instead. 155heavily recommended to use the ``syslog`` option instead. The ``file:` option
156might be useful if you're using Snuffleupagus to fuzz or audit a codebase.
155 157
156log_max_len 158log_max_len
157^^^^^^^^^^^ 159^^^^^^^^^^^