2022-04-25 19:34:35 +02:00

83 lines
3.4 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

:::{important} You are reading the help for Irssi 1.0. **The current release version is Neırssi 1.3.**
:::
# log
<!-- comment
Please submit changes to
- https://github.com/ailin-nemui/irssi/blob/master/docs/help/in/log.in
- https://github.com/ailin-nemui/irssi/blob/master/src/fe-common/core/fe-log.c
endcomment -->
## Syntax ##
<div class="irssisyntax highlight"><pre style="\-\-cmdlen:8ch"><code><span class="synB">LOG</span> <span class="synB">OPEN</span> <span class="syn10">[<span class="syn">-noopen</span>]</span> <span class="syn10">[<span class="syn">-autoopen</span>]</span> <span class="syn10">[<span class="syn">-window</span>]</span> <span class="syn10">[<span class="syn">-</span><span class="syn09">&lt;server tag></span>]</span> <span class="syn10">[<span class="syn">-targets</span> <span class="syn09">&lt;targets></span>]</span> <span class="syn10">[<span class="syn">-colors</span>]</span> <span class="synB05">&lt;fname></span> <span class="syn10">[<span class="syn09">&lt;levels></span>]</span></code></pre></div>
<div class="irssisyntax highlight"><pre style="\-\-cmdlen:9ch"><code><span class="synB">LOG</span> <span class="synB">CLOSE</span> <span class="synB05">&lt;id></span>|<span class="synB05">&lt;file></span></code></pre></div>
<div class="irssisyntax highlight"><pre style="\-\-cmdlen:9ch"><code><span class="synB">LOG</span> <span class="synB">START</span> <span class="synB05">&lt;id></span>|<span class="synB05">&lt;file></span></code></pre></div>
<div class="irssisyntax highlight"><pre style="\-\-cmdlen:8ch"><code><span class="synB">LOG</span> <span class="synB">STOP</span> <span class="synB05">&lt;id></span>|<span class="synB05">&lt;file></span></code></pre></div>
## Parameters ##
| | |
| --- | --- |
| `OPEN`: | Opens a log file. |
| `CLOSE`: | Closes a log file. |
| `START`: | Starts logging a log entry. |
| `STOP`: | Stops logging a log entry. |
| | |
| --- | --- |
| `-noopen`: | Saves the entry in the configuration, but doesn't actually start logging. |
| `-autoopen`: | Automatically opens the log at startup. |
| `-window`: | Displays the output to the active window, or the window specified in the targets parameter. |
| `-<server tag>`: | The server tag the targets must be on. |
| `-targets`: | Logs the specified nicknames or channels. |
| `-colors`: | Also log the color codes of the messages. |
The filename of the log and the levels to match; if no argument is given,
the list of open logs will be displayed.
## Description ##
Opens a log file and stores the messages of the given targets into it; the
log files will be locked so multiple clients cannot log to the same file.
You may use any of the date formats to create a log rotation; we strongly
recommend you to enable autolog if you are interested in keeping logs.
## Examples ##
/LOG OPEN -targets mike ~/irclogs/mike.log MSGS
/LOG OPEN -targets #irssi-freenode ~/irclogs/freenode/irssi-%Y-%m-%d
/LOG CLOSE ~/irclogs/freenode/irssi-%Y-%m-%d
/LOG STOP ~/irclogs/freenode/irssi-%Y-%m-%d
/LOG START ~/irclogs/freenode/irssi-%Y-%m-%d
/SET autolog ON
## References ##
[https://github.com/irssi/irssi/blob/master/docs/formats.txt](https://github.com/irssi/irssi/blob/master/docs/formats.txt)
## See also ##
[SET](/documentation/help/1.0/set), [LOG](/documentation/help/1.0/log), [WINDOW](/documentation/help/1.0/window), [LOG](/documentation/help/1.0/log)