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 | |
Janne Kiviluoto | c897dfe | 2010-03-31 15:58:58 +0200 | [diff] [blame] | 55 | config FEATURE_SYSLOGD_READ_BUFFER_SIZE |
Denys Vlasenko | 345e093 | 2010-03-31 16:03:56 +0200 | [diff] [blame] | 56 | int "Read buffer size in bytes" |
| 57 | default 256 |
| 58 | range 256 20000 |
| 59 | depends on SYSLOGD |
| 60 | help |
| 61 | This option sets the size of the syslog read buffer. |
| 62 | Actual memory usage increases around five times the |
| 63 | change done here. |
Janne Kiviluoto | c897dfe | 2010-03-31 15:58:58 +0200 | [diff] [blame] | 64 | |
Denis Vlasenko | 7d219aa | 2006-10-05 10:17:08 +0000 | [diff] [blame] | 65 | config FEATURE_IPC_SYSLOG |
Rob Landley | 2ec922e | 2006-04-13 23:22:16 +0000 | [diff] [blame] | 66 | bool "Circular Buffer support" |
Denys Vlasenko | 2f32bf8 | 2010-06-06 04:14:28 +0200 | [diff] [blame] | 67 | default y |
Denis Vlasenko | 7d219aa | 2006-10-05 10:17:08 +0000 | [diff] [blame] | 68 | depends on SYSLOGD |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 69 | help |
Eric Andersen | 08f4a4c | 2003-02-28 07:20:55 +0000 | [diff] [blame] | 70 | When you enable this feature, the syslogd utility will |
| 71 | use a circular buffer to record system log messages. |
| 72 | When the buffer is filled it will continue to overwrite |
Bernhard Reutner-Fischer | 3e8669f | 2008-07-22 18:27:53 +0000 | [diff] [blame] | 73 | the oldest messages. This can be very useful for |
Eric Andersen | 88c916b | 2003-10-22 09:58:56 +0000 | [diff] [blame] | 74 | systems with little or no permanent storage, since |
Eric Andersen | 08f4a4c | 2003-02-28 07:20:55 +0000 | [diff] [blame] | 75 | otherwise system logs can eventually fill up your |
| 76 | entire filesystem, which may cause your system to |
| 77 | break badly. |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 78 | |
Denis Vlasenko | 7d219aa | 2006-10-05 10:17:08 +0000 | [diff] [blame] | 79 | config FEATURE_IPC_SYSLOG_BUFFER_SIZE |
Denis Vlasenko | 4ee7cd4 | 2008-03-17 09:13:22 +0000 | [diff] [blame] | 80 | int "Circular buffer size in Kbytes (minimum 4KB)" |
Eric Andersen | d4a5e25 | 2003-12-19 11:32:14 +0000 | [diff] [blame] | 81 | default 16 |
Bernhard Reutner-Fischer | bb4b9f1 | 2007-06-07 13:22:56 +0000 | [diff] [blame] | 82 | range 4 2147483647 |
Denis Vlasenko | 7d219aa | 2006-10-05 10:17:08 +0000 | [diff] [blame] | 83 | depends on FEATURE_IPC_SYSLOG |
Eric Andersen | d4a5e25 | 2003-12-19 11:32:14 +0000 | [diff] [blame] | 84 | help |
| 85 | This option sets the size of the circular buffer |
| 86 | used to record system log messages. |
| 87 | |
Denis Vlasenko | 7d219aa | 2006-10-05 10:17:08 +0000 | [diff] [blame] | 88 | config LOGREAD |
Rob Landley | 2ec922e | 2006-04-13 23:22:16 +0000 | [diff] [blame] | 89 | bool "logread" |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 90 | default y |
Denis Vlasenko | 7d219aa | 2006-10-05 10:17:08 +0000 | [diff] [blame] | 91 | depends on FEATURE_IPC_SYSLOG |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 92 | help |
Eric Andersen | 08f4a4c | 2003-02-28 07:20:55 +0000 | [diff] [blame] | 93 | If you enabled Circular Buffer support, you almost |
Bernhard Reutner-Fischer | 3e8669f | 2008-07-22 18:27:53 +0000 | [diff] [blame] | 94 | certainly want to enable this feature as well. This |
Eric Andersen | 08f4a4c | 2003-02-28 07:20:55 +0000 | [diff] [blame] | 95 | utility will allow you to read the messages that are |
| 96 | stored in the syslogd circular buffer. |
| 97 | |
Denis Vlasenko | 7d219aa | 2006-10-05 10:17:08 +0000 | [diff] [blame] | 98 | config FEATURE_LOGREAD_REDUCED_LOCKING |
Denis Vlasenko | 4ee7cd4 | 2008-03-17 09:13:22 +0000 | [diff] [blame] | 99 | bool "Double buffering" |
Denys Vlasenko | 2f32bf8 | 2010-06-06 04:14:28 +0200 | [diff] [blame] | 100 | default y |
Denis Vlasenko | 7d219aa | 2006-10-05 10:17:08 +0000 | [diff] [blame] | 101 | depends on LOGREAD |
Eric Andersen | d4a5e25 | 2003-12-19 11:32:14 +0000 | [diff] [blame] | 102 | help |
Eric Andersen | c7bda1c | 2004-03-15 08:29:22 +0000 | [diff] [blame] | 103 | 'logread' ouput to slow serial terminals can have |
Eric Andersen | d4a5e25 | 2003-12-19 11:32:14 +0000 | [diff] [blame] | 104 | side effects on syslog because of the semaphore. |
Eric Andersen | c7bda1c | 2004-03-15 08:29:22 +0000 | [diff] [blame] | 105 | This option make logread to double buffer copy |
| 106 | from circular buffer, minimizing semaphore |
Eric Andersen | d4a5e25 | 2003-12-19 11:32:14 +0000 | [diff] [blame] | 107 | contention at some minor memory expense. |
| 108 | |
Denis Vlasenko | 7d219aa | 2006-10-05 10:17:08 +0000 | [diff] [blame] | 109 | config KLOGD |
Eric Andersen | 08f4a4c | 2003-02-28 07:20:55 +0000 | [diff] [blame] | 110 | bool "klogd" |
Denys Vlasenko | 2f32bf8 | 2010-06-06 04:14:28 +0200 | [diff] [blame] | 111 | default y |
Eric Andersen | 08f4a4c | 2003-02-28 07:20:55 +0000 | [diff] [blame] | 112 | help |
Eric Andersen | 88c916b | 2003-10-22 09:58:56 +0000 | [diff] [blame] | 113 | klogd is a utility which intercepts and logs all |
Eric Andersen | 08f4a4c | 2003-02-28 07:20:55 +0000 | [diff] [blame] | 114 | messages from the Linux kernel and sends the messages |
Bernhard Reutner-Fischer | 3e8669f | 2008-07-22 18:27:53 +0000 | [diff] [blame] | 115 | out to the 'syslogd' utility so they can be logged. If |
Eric Andersen | 08f4a4c | 2003-02-28 07:20:55 +0000 | [diff] [blame] | 116 | you wish to record the messages produced by the kernel, |
| 117 | you should enable this option. |
| 118 | |
Jeremie Koenig | 63c2e7e | 2010-08-01 03:01:44 +0200 | [diff] [blame] | 119 | config FEATURE_KLOGD_KLOGCTL |
| 120 | bool "Use the klogctl() interface" |
| 121 | default y |
Denys Vlasenko | e3b1a1f | 2011-02-26 22:24:08 +0100 | [diff] [blame^] | 122 | depends on KLOGD |
| 123 | select PLATFORM_LINUX |
Jeremie Koenig | 63c2e7e | 2010-08-01 03:01:44 +0200 | [diff] [blame] | 124 | help |
| 125 | The klogd applet supports two interfaces for reading |
| 126 | kernel messages. Linux provides the klogctl() interface |
| 127 | which allows reading messages from the kernel ring buffer |
| 128 | independently from the file system. |
| 129 | |
| 130 | If you answer 'N' here, klogd will use the more portable |
| 131 | approach of reading them from /proc or a device node. |
| 132 | However, this method requires the file to be available. |
| 133 | |
| 134 | If in doubt, say 'Y'. |
| 135 | |
Denis Vlasenko | 7d219aa | 2006-10-05 10:17:08 +0000 | [diff] [blame] | 136 | config LOGGER |
Eric Andersen | 08f4a4c | 2003-02-28 07:20:55 +0000 | [diff] [blame] | 137 | bool "logger" |
Denys Vlasenko | 2f32bf8 | 2010-06-06 04:14:28 +0200 | [diff] [blame] | 138 | default y |
Denis Vlasenko | 7d219aa | 2006-10-05 10:17:08 +0000 | [diff] [blame] | 139 | select FEATURE_SYSLOG |
Eric Andersen | 08f4a4c | 2003-02-28 07:20:55 +0000 | [diff] [blame] | 140 | help |
Eric Andersen | 480f153 | 2003-07-26 08:20:46 +0000 | [diff] [blame] | 141 | The logger utility allows you to send arbitrary text |
| 142 | messages to the system log (i.e. the 'syslogd' utility) so |
Bernhard Reutner-Fischer | 3e8669f | 2008-07-22 18:27:53 +0000 | [diff] [blame] | 143 | they can be logged. This is generally used to help locate |
Eric Andersen | 480f153 | 2003-07-26 08:20:46 +0000 | [diff] [blame] | 144 | problems that occur within programs and scripts. |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 145 | |
| 146 | endmenu |