lh | 9ed821d | 2023-04-07 01:36:19 -0700 | [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 | |
| 8 | INSERT |
| 9 | |
| 10 | config SYSLOGD |
| 11 | bool "syslogd" |
| 12 | default y |
| 13 | help |
| 14 | The syslogd utility is used to record logs of all the |
| 15 | significant events that occur on a system. Every |
| 16 | message that is logged records the date and time of the |
| 17 | event, and will generally also record the name of the |
| 18 | application that generated the message. When used in |
| 19 | conjunction with klogd, messages from the Linux kernel |
| 20 | can also be recorded. This is terribly useful, |
| 21 | especially for finding what happened when something goes |
| 22 | wrong. And something almost always will go wrong if |
| 23 | you wait long enough.... |
| 24 | |
| 25 | config FEATURE_ROTATE_LOGFILE |
| 26 | bool "Rotate message files" |
| 27 | default y |
| 28 | depends on SYSLOGD |
| 29 | help |
| 30 | This enables syslogd to rotate the message files |
| 31 | on his own. No need to use an external rotatescript. |
| 32 | |
| 33 | config FEATURE_REMOTE_LOG |
| 34 | bool "Remote Log support" |
| 35 | default y |
| 36 | depends on SYSLOGD |
| 37 | help |
| 38 | When you enable this feature, the syslogd utility can |
| 39 | be used to send system log messages to another system |
| 40 | connected via a network. This allows the remote |
| 41 | machine to log all the system messages, which can be |
| 42 | terribly useful for reducing the number of serial |
| 43 | cables you use. It can also be a very good security |
| 44 | measure to prevent system logs from being tampered with |
| 45 | by an intruder. |
| 46 | |
| 47 | config FEATURE_SYSLOGD_DUP |
| 48 | bool "Support -D (drop dups) option" |
| 49 | default y |
| 50 | depends on SYSLOGD |
| 51 | help |
| 52 | Option -D instructs syslogd to drop consecutive messages |
| 53 | which are totally the same. |
| 54 | |
| 55 | config FEATURE_SYSLOGD_CFG |
| 56 | bool "Support syslog.conf" |
| 57 | default y |
| 58 | depends on SYSLOGD |
| 59 | help |
| 60 | Supports restricted syslogd config. See docs/syslog.conf.txt |
| 61 | |
| 62 | config FEATURE_SYSLOGD_READ_BUFFER_SIZE |
| 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. |
| 71 | |
| 72 | config FEATURE_IPC_SYSLOG |
| 73 | bool "Circular Buffer support" |
| 74 | default y |
| 75 | depends on SYSLOGD |
| 76 | help |
| 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 |
| 80 | the oldest messages. This can be very useful for |
| 81 | systems with little or no permanent storage, since |
| 82 | otherwise system logs can eventually fill up your |
| 83 | entire filesystem, which may cause your system to |
| 84 | break badly. |
| 85 | |
| 86 | config FEATURE_IPC_SYSLOG_BUFFER_SIZE |
| 87 | int "Circular buffer size in Kbytes (minimum 4KB)" |
| 88 | default 16 |
| 89 | range 4 2147483647 |
| 90 | depends on FEATURE_IPC_SYSLOG |
| 91 | help |
| 92 | This option sets the size of the circular buffer |
| 93 | used to record system log messages. |
| 94 | |
| 95 | config LOGREAD |
| 96 | bool "logread" |
| 97 | default y |
| 98 | depends on FEATURE_IPC_SYSLOG |
| 99 | help |
| 100 | If you enabled Circular Buffer support, you almost |
| 101 | certainly want to enable this feature as well. This |
| 102 | utility will allow you to read the messages that are |
| 103 | stored in the syslogd circular buffer. |
| 104 | |
| 105 | config FEATURE_LOGREAD_REDUCED_LOCKING |
| 106 | bool "Double buffering" |
| 107 | default y |
| 108 | depends on LOGREAD |
| 109 | help |
| 110 | 'logread' ouput to slow serial terminals can have |
| 111 | side effects on syslog because of the semaphore. |
| 112 | This option make logread to double buffer copy |
| 113 | from circular buffer, minimizing semaphore |
| 114 | contention at some minor memory expense. |
| 115 | |
| 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 | |
| 129 | config KLOGD |
| 130 | bool "klogd" |
| 131 | default y |
| 132 | help |
| 133 | klogd is a utility which intercepts and logs all |
| 134 | messages from the Linux kernel and sends the messages |
| 135 | out to the 'syslogd' utility so they can be logged. If |
| 136 | you wish to record the messages produced by the kernel, |
| 137 | you should enable this option. |
| 138 | |
| 139 | comment "klogd should not be used together with syslog to kernel printk buffer" |
| 140 | depends on KLOGD && FEATURE_KMSG_SYSLOG |
| 141 | |
| 142 | config FEATURE_KLOGD_KLOGCTL |
| 143 | bool "Use the klogctl() interface" |
| 144 | default y |
| 145 | depends on KLOGD |
| 146 | select PLATFORM_LINUX |
| 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 | |
| 159 | config LOGGER |
| 160 | bool "logger" |
| 161 | default y |
| 162 | select FEATURE_SYSLOG |
| 163 | help |
| 164 | The logger utility allows you to send arbitrary text |
| 165 | messages to the system log (i.e. the 'syslogd' utility) so |
| 166 | they can be logged. This is generally used to help locate |
| 167 | problems that occur within programs and scripts. |
| 168 | |
| 169 | endmenu |