Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 1 | # |
| 2 | # For a description of the syntax of this configuration file, |
| 3 | # see scripts/kbuild/config-language.txt. |
| 4 | # |
| 5 | |
| 6 | menu "System Logging Utilities" |
| 7 | |
Denys Vlasenko | d70e0e9 | 2010-06-08 12:15:11 +0200 | [diff] [blame] | 8 | INSERT |
| 9 | |
Denis Vlasenko | 7d219aa | 2006-10-05 10:17:08 +0000 | [diff] [blame] | 10 | config SYSLOGD |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 11 | bool "syslogd" |
Denys Vlasenko | 2f32bf8 | 2010-06-06 04:14:28 +0200 | [diff] [blame] | 12 | default y |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 13 | help |
Eric Andersen | 08f4a4c | 2003-02-28 07:20:55 +0000 | [diff] [blame] | 14 | The syslogd utility is used to record logs of all the |
Bernhard Reutner-Fischer | 3e8669f | 2008-07-22 18:27:53 +0000 | [diff] [blame] | 15 | significant events that occur on a system. Every |
Eric Andersen | 08f4a4c | 2003-02-28 07:20:55 +0000 | [diff] [blame] | 16 | message that is logged records the date and time of the |
| 17 | event, and will generally also record the name of the |
Bernhard Reutner-Fischer | 3e8669f | 2008-07-22 18:27:53 +0000 | [diff] [blame] | 18 | application that generated the message. When used in |
Eric Andersen | 08f4a4c | 2003-02-28 07:20:55 +0000 | [diff] [blame] | 19 | conjunction with klogd, messages from the Linux kernel |
Bernhard Reutner-Fischer | 3e8669f | 2008-07-22 18:27:53 +0000 | [diff] [blame] | 20 | can also be recorded. This is terribly useful, |
Eric Andersen | 88c916b | 2003-10-22 09:58:56 +0000 | [diff] [blame] | 21 | especially for finding what happened when something goes |
Bernhard Reutner-Fischer | 3e8669f | 2008-07-22 18:27:53 +0000 | [diff] [blame] | 22 | wrong. And something almost always will go wrong if |
Eric Andersen | 08f4a4c | 2003-02-28 07:20:55 +0000 | [diff] [blame] | 23 | you wait long enough.... |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 24 | |
Denis Vlasenko | 7d219aa | 2006-10-05 10:17:08 +0000 | [diff] [blame] | 25 | config FEATURE_ROTATE_LOGFILE |
Rob Landley | 2ec922e | 2006-04-13 23:22:16 +0000 | [diff] [blame] | 26 | bool "Rotate message files" |
Denys Vlasenko | 2f32bf8 | 2010-06-06 04:14:28 +0200 | [diff] [blame] | 27 | default y |
Denis Vlasenko | 7d219aa | 2006-10-05 10:17:08 +0000 | [diff] [blame] | 28 | depends on SYSLOGD |
Eric Andersen | 29c77f7 | 2003-10-09 09:43:18 +0000 | [diff] [blame] | 29 | help |
| 30 | This enables syslogd to rotate the message files |
| 31 | on his own. No need to use an external rotatescript. |
| 32 | |
Denis Vlasenko | 7d219aa | 2006-10-05 10:17:08 +0000 | [diff] [blame] | 33 | config FEATURE_REMOTE_LOG |
Rob Landley | 2ec922e | 2006-04-13 23:22:16 +0000 | [diff] [blame] | 34 | bool "Remote Log support" |
Denys Vlasenko | 2f32bf8 | 2010-06-06 04:14:28 +0200 | [diff] [blame] | 35 | default y |
Denis Vlasenko | 7d219aa | 2006-10-05 10:17:08 +0000 | [diff] [blame] | 36 | depends on SYSLOGD |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 37 | help |
Eric Andersen | 08f4a4c | 2003-02-28 07:20:55 +0000 | [diff] [blame] | 38 | When you enable this feature, the syslogd utility can |
| 39 | be used to send system log messages to another system |
Bernhard Reutner-Fischer | 3e8669f | 2008-07-22 18:27:53 +0000 | [diff] [blame] | 40 | connected via a network. This allows the remote |
Eric Andersen | 08f4a4c | 2003-02-28 07:20:55 +0000 | [diff] [blame] | 41 | machine to log all the system messages, which can be |
| 42 | terribly useful for reducing the number of serial |
Bernhard Reutner-Fischer | 3e8669f | 2008-07-22 18:27:53 +0000 | [diff] [blame] | 43 | cables you use. It can also be a very good security |
Eric Andersen | 08f4a4c | 2003-02-28 07:20:55 +0000 | [diff] [blame] | 44 | measure to prevent system logs from being tampered with |
| 45 | by an intruder. |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 46 | |
Denis Vlasenko | be048f2 | 2008-02-26 20:13:52 +0000 | [diff] [blame] | 47 | config FEATURE_SYSLOGD_DUP |
| 48 | bool "Support -D (drop dups) option" |
Denys Vlasenko | 2f32bf8 | 2010-06-06 04:14:28 +0200 | [diff] [blame] | 49 | default y |
Denis Vlasenko | be048f2 | 2008-02-26 20:13:52 +0000 | [diff] [blame] | 50 | depends on SYSLOGD |
| 51 | help |
| 52 | Option -D instructs syslogd to drop consecutive messages |
| 53 | which are totally the same. |
| 54 | |
Sergey Naumov | 73ef15c | 2011-04-10 07:34:27 +0200 | [diff] [blame] | 55 | config FEATURE_SYSLOGD_CFG |
| 56 | bool "Support syslog.conf" |
| 57 | default y |
| 58 | depends on SYSLOGD |
| 59 | help |
Denys Vlasenko | 0288b27 | 2011-04-16 20:15:14 +0200 | [diff] [blame] | 60 | Supports restricted syslogd config. See docs/syslog.conf.txt |
Sergey Naumov | 73ef15c | 2011-04-10 07:34:27 +0200 | [diff] [blame] | 61 | |
Janne Kiviluoto | c897dfe | 2010-03-31 15:58:58 +0200 | [diff] [blame] | 62 | config FEATURE_SYSLOGD_READ_BUFFER_SIZE |
Denys Vlasenko | 345e093 | 2010-03-31 16:03:56 +0200 | [diff] [blame] | 63 | int "Read buffer size in bytes" |
| 64 | default 256 |
| 65 | range 256 20000 |
| 66 | depends on SYSLOGD |
| 67 | help |
| 68 | This option sets the size of the syslog read buffer. |
| 69 | Actual memory usage increases around five times the |
| 70 | change done here. |
Janne Kiviluoto | c897dfe | 2010-03-31 15:58:58 +0200 | [diff] [blame] | 71 | |
Denis Vlasenko | 7d219aa | 2006-10-05 10:17:08 +0000 | [diff] [blame] | 72 | config FEATURE_IPC_SYSLOG |
Rob Landley | 2ec922e | 2006-04-13 23:22:16 +0000 | [diff] [blame] | 73 | bool "Circular Buffer support" |
Denys Vlasenko | 2f32bf8 | 2010-06-06 04:14:28 +0200 | [diff] [blame] | 74 | default y |
Denis Vlasenko | 7d219aa | 2006-10-05 10:17:08 +0000 | [diff] [blame] | 75 | depends on SYSLOGD |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 76 | help |
Eric Andersen | 08f4a4c | 2003-02-28 07:20:55 +0000 | [diff] [blame] | 77 | When you enable this feature, the syslogd utility will |
| 78 | use a circular buffer to record system log messages. |
| 79 | When the buffer is filled it will continue to overwrite |
Bernhard Reutner-Fischer | 3e8669f | 2008-07-22 18:27:53 +0000 | [diff] [blame] | 80 | the oldest messages. This can be very useful for |
Eric Andersen | 88c916b | 2003-10-22 09:58:56 +0000 | [diff] [blame] | 81 | systems with little or no permanent storage, since |
Eric Andersen | 08f4a4c | 2003-02-28 07:20:55 +0000 | [diff] [blame] | 82 | otherwise system logs can eventually fill up your |
| 83 | entire filesystem, which may cause your system to |
| 84 | break badly. |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 85 | |
Denis Vlasenko | 7d219aa | 2006-10-05 10:17:08 +0000 | [diff] [blame] | 86 | config FEATURE_IPC_SYSLOG_BUFFER_SIZE |
Denis Vlasenko | 4ee7cd4 | 2008-03-17 09:13:22 +0000 | [diff] [blame] | 87 | int "Circular buffer size in Kbytes (minimum 4KB)" |
Eric Andersen | d4a5e25 | 2003-12-19 11:32:14 +0000 | [diff] [blame] | 88 | default 16 |
Bernhard Reutner-Fischer | bb4b9f1 | 2007-06-07 13:22:56 +0000 | [diff] [blame] | 89 | range 4 2147483647 |
Denis Vlasenko | 7d219aa | 2006-10-05 10:17:08 +0000 | [diff] [blame] | 90 | depends on FEATURE_IPC_SYSLOG |
Eric Andersen | d4a5e25 | 2003-12-19 11:32:14 +0000 | [diff] [blame] | 91 | help |
| 92 | This option sets the size of the circular buffer |
| 93 | used to record system log messages. |
| 94 | |
Denis Vlasenko | 7d219aa | 2006-10-05 10:17:08 +0000 | [diff] [blame] | 95 | config LOGREAD |
Rob Landley | 2ec922e | 2006-04-13 23:22:16 +0000 | [diff] [blame] | 96 | bool "logread" |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 97 | default y |
Denis Vlasenko | 7d219aa | 2006-10-05 10:17:08 +0000 | [diff] [blame] | 98 | depends on FEATURE_IPC_SYSLOG |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 99 | help |
Eric Andersen | 08f4a4c | 2003-02-28 07:20:55 +0000 | [diff] [blame] | 100 | If you enabled Circular Buffer support, you almost |
Bernhard Reutner-Fischer | 3e8669f | 2008-07-22 18:27:53 +0000 | [diff] [blame] | 101 | certainly want to enable this feature as well. This |
Eric Andersen | 08f4a4c | 2003-02-28 07:20:55 +0000 | [diff] [blame] | 102 | utility will allow you to read the messages that are |
| 103 | stored in the syslogd circular buffer. |
| 104 | |
Denis Vlasenko | 7d219aa | 2006-10-05 10:17:08 +0000 | [diff] [blame] | 105 | config FEATURE_LOGREAD_REDUCED_LOCKING |
Denis Vlasenko | 4ee7cd4 | 2008-03-17 09:13:22 +0000 | [diff] [blame] | 106 | bool "Double buffering" |
Denys Vlasenko | 2f32bf8 | 2010-06-06 04:14:28 +0200 | [diff] [blame] | 107 | default y |
Denis Vlasenko | 7d219aa | 2006-10-05 10:17:08 +0000 | [diff] [blame] | 108 | depends on LOGREAD |
Eric Andersen | d4a5e25 | 2003-12-19 11:32:14 +0000 | [diff] [blame] | 109 | help |
Eric Andersen | c7bda1c | 2004-03-15 08:29:22 +0000 | [diff] [blame] | 110 | 'logread' ouput to slow serial terminals can have |
Eric Andersen | d4a5e25 | 2003-12-19 11:32:14 +0000 | [diff] [blame] | 111 | side effects on syslog because of the semaphore. |
Eric Andersen | c7bda1c | 2004-03-15 08:29:22 +0000 | [diff] [blame] | 112 | This option make logread to double buffer copy |
| 113 | from circular buffer, minimizing semaphore |
Eric Andersen | d4a5e25 | 2003-12-19 11:32:14 +0000 | [diff] [blame] | 114 | contention at some minor memory expense. |
| 115 | |
Peter Korsgaard | cd776cf | 2013-01-06 00:07:19 +0100 | [diff] [blame] | 116 | config FEATURE_KMSG_SYSLOG |
| 117 | bool "Linux kernel printk buffer support" |
| 118 | default y |
| 119 | depends on SYSLOGD |
| 120 | select PLATFORM_LINUX |
| 121 | help |
| 122 | When you enable this feature, the syslogd utility will |
| 123 | write system log message to the Linux kernel's printk buffer. |
| 124 | This can be used as a smaller alternative to the syslogd IPC |
| 125 | support, as klogd and logread aren't needed. |
| 126 | |
| 127 | NOTICE: Syslog facilities in log entries needs kernel 3.5+. |
| 128 | |
Denis Vlasenko | 7d219aa | 2006-10-05 10:17:08 +0000 | [diff] [blame] | 129 | config KLOGD |
Eric Andersen | 08f4a4c | 2003-02-28 07:20:55 +0000 | [diff] [blame] | 130 | bool "klogd" |
Denys Vlasenko | 2f32bf8 | 2010-06-06 04:14:28 +0200 | [diff] [blame] | 131 | default y |
Eric Andersen | 08f4a4c | 2003-02-28 07:20:55 +0000 | [diff] [blame] | 132 | help |
Eric Andersen | 88c916b | 2003-10-22 09:58:56 +0000 | [diff] [blame] | 133 | klogd is a utility which intercepts and logs all |
Eric Andersen | 08f4a4c | 2003-02-28 07:20:55 +0000 | [diff] [blame] | 134 | messages from the Linux kernel and sends the messages |
Bernhard Reutner-Fischer | 3e8669f | 2008-07-22 18:27:53 +0000 | [diff] [blame] | 135 | out to the 'syslogd' utility so they can be logged. If |
Eric Andersen | 08f4a4c | 2003-02-28 07:20:55 +0000 | [diff] [blame] | 136 | you wish to record the messages produced by the kernel, |
| 137 | you should enable this option. |
| 138 | |
Peter Korsgaard | cd776cf | 2013-01-06 00:07:19 +0100 | [diff] [blame] | 139 | comment "klogd should not be used together with syslog to kernel printk buffer" |
| 140 | depends on KLOGD && FEATURE_KMSG_SYSLOG |
| 141 | |
Jeremie Koenig | 63c2e7e | 2010-08-01 03:01:44 +0200 | [diff] [blame] | 142 | config FEATURE_KLOGD_KLOGCTL |
| 143 | bool "Use the klogctl() interface" |
| 144 | default y |
Denys Vlasenko | e3b1a1f | 2011-02-26 22:24:08 +0100 | [diff] [blame] | 145 | depends on KLOGD |
| 146 | select PLATFORM_LINUX |
Jeremie Koenig | 63c2e7e | 2010-08-01 03:01:44 +0200 | [diff] [blame] | 147 | help |
| 148 | The klogd applet supports two interfaces for reading |
| 149 | kernel messages. Linux provides the klogctl() interface |
| 150 | which allows reading messages from the kernel ring buffer |
| 151 | independently from the file system. |
| 152 | |
| 153 | If you answer 'N' here, klogd will use the more portable |
| 154 | approach of reading them from /proc or a device node. |
| 155 | However, this method requires the file to be available. |
| 156 | |
| 157 | If in doubt, say 'Y'. |
| 158 | |
Denis Vlasenko | 7d219aa | 2006-10-05 10:17:08 +0000 | [diff] [blame] | 159 | config LOGGER |
Eric Andersen | 08f4a4c | 2003-02-28 07:20:55 +0000 | [diff] [blame] | 160 | bool "logger" |
Denys Vlasenko | 2f32bf8 | 2010-06-06 04:14:28 +0200 | [diff] [blame] | 161 | default y |
Denis Vlasenko | 7d219aa | 2006-10-05 10:17:08 +0000 | [diff] [blame] | 162 | select FEATURE_SYSLOG |
Eric Andersen | 08f4a4c | 2003-02-28 07:20:55 +0000 | [diff] [blame] | 163 | help |
Eric Andersen | 480f153 | 2003-07-26 08:20:46 +0000 | [diff] [blame] | 164 | The logger utility allows you to send arbitrary text |
| 165 | messages to the system log (i.e. the 'syslogd' utility) so |
Bernhard Reutner-Fischer | 3e8669f | 2008-07-22 18:27:53 +0000 | [diff] [blame] | 166 | they can be logged. This is generally used to help locate |
Eric Andersen | 480f153 | 2003-07-26 08:20:46 +0000 | [diff] [blame] | 167 | problems that occur within programs and scripts. |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 168 | |
| 169 | endmenu |