summaryrefslogtreecommitdiff
path: root/docs/help/in/log.in
blob: fd9fc2cf7677d17f41a213efb4245aa4d0d8462b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42

@SYNTAX:log@

     -noopen: Create the entry to log list, but don't start logging
     -autoopen: Automatically open this log file at startup
     -targets: Log only in specified channels/nicks
     -window: Log the active window
     -rotate: Reopen the log file every hour, day, week or month.
              This makes only sense if you specify date/time formats
              to file name.
     <filename>: File name where to log, it is parsed with
                 strftime(), so %d=day, etc. see "man strftime" for
                 more info.
     <levels>: Defaults to ALL
     <id>: ID number of log.   

/SET log_create_mode <mode> - Specifies what file mode to use with
     the created log files. Default is 0644.

All of these are parsed with strftime():
/SET log_timestamp <text> - Specifies the time stamp format.
     Default is "%H:%M ".
/SET log_open_string <text> - Text written to log when it's opened
/SET log_close_string <text> - Text written to log when it's closed
/SET log_day_changed <text> - Text written to log when day changes

NOTE: Log files are locked after opened, so two Irssis can't
accidentally try to write to the same log file.

Examples:
        
/LOG OPEN -targets cras ~/irclogs/cras.log MSGS
     - Logs all messages from/to nick `cras'

/LOG OPEN -rotate day -targets #linux ~/irclogs/linux/linux-%Y-%m-%d
     - Logs all messages in channel #linux. Log is rotated daily, so
       logs in 1. May 2000 goes to file "linux-2000-05-01", when the
       day is changed, Irssi closes the log and starts logging to
       "linux-2000-05-02" etc.

See also: SET LOG, WINDOW LOG