| 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 | }}} |