| | 1 | [[libtorrentMirror]] |
| | 2 | |
| | 3 | {{{ |
| | 4 | Logging |
| | 5 | ======= |
| | 6 | |
| | 7 | Opening log files |
| | 8 | ----------------- |
| | 9 | |
| | 10 | # log.open_file = "log name", "file path" |
| | 11 | |
| | 12 | log.open_file = "rtorrent.log", (cat,/tmp/rtorrent.log.,(system.pid)) |
| | 13 | |
| | 14 | A newly opened log file is not connected to any logging events. |
| | 15 | |
| | 16 | Some control over formatting will be provided at a later date. |
| | 17 | |
| | 18 | Adding outputs to events |
| | 19 | ------------------------ |
| | 20 | |
| | 21 | # log.add_output = "logging event", "log name" |
| | 22 | |
| | 23 | log.add_output = "info", "rtorrent.log" |
| | 24 | |
| | 25 | log.add_output = "dht_debug", "tracker.log" |
| | 26 | log.add_output = "tracker_debug", "tracker.log" |
| | 27 | |
| | 28 | Each log handle can be added to multiple different logging events. |
| | 29 | |
| | 30 | Logging events |
| | 31 | -------------- |
| | 32 | |
| | 33 | "critical" |
| | 34 | "error" |
| | 35 | "warn" |
| | 36 | "notice" |
| | 37 | "info" |
| | 38 | "debug" |
| | 39 | |
| | 40 | The above events receive logging events from all the sub-groups |
| | 41 | displayed below, and each event also reciving events from the event |
| | 42 | above in importance. |
| | 43 | |
| | 44 | Thus some high-volume sub-group events such as “tracker_debug” are not |
| | 45 | part of “debug” and every “warn” event will receive events from “error”, |
| | 46 | “critical”. |
| | 47 | |
| | 48 | "connection_*" |
| | 49 | "dht_*" |
| | 50 | "peer_*" |
| | 51 | "rpc_*" |
| | 52 | "storage_*" |
| | 53 | "thread_*" |
| | 54 | "tracker_*" |
| | 55 | "torrent_*" |
| | 56 | |
| | 57 | All sub-groups have events from “critical” to “debug” defined. |
| | 58 | }}} |