hush/sysklogd/Config.in

#
# For a description of the syntax of this configuration file,
# see scripts/kbuild/config-language.txt.
#

menu "System Logging Utilities"

config SYSLOGD
	bool "syslogd"
	default n
	help
	  The syslogd utility is used to record logs of all the
	  significant events that occur on a system.  Every
	  message that is logged records the date and time of the
	  event, and will generally also record the name of the
	  application that generated the message.  When used in
	  conjunction with klogd, messages from the Linux kernel
	  can also be recorded.  This is terribly useful,
	  especially for finding what happened when something goes
	  wrong.  And something almost always will go wrong if
	  you wait long enough....

config FEATURE_ROTATE_LOGFILE
	bool "Rotate message files"
	default n
	depends on SYSLOGD
	help
	  This enables syslogd to rotate the message files
	  on his own. No need to use an external rotatescript.

config FEATURE_REMOTE_LOG
	bool "Remote Log support"
	default n
	depends on SYSLOGD
	help
	  When you enable this feature, the syslogd utility can
	  be used to send system log messages to another system
	  connected via a network.  This allows the remote
	  machine to log all the system messages, which can be
	  terribly useful for reducing the number of serial
	  cables you use.  It can also be a very good security
	  measure to prevent system logs from being tampered with
	  by an intruder.

config FEATURE_IPC_SYSLOG
	bool "Circular Buffer support"
	default n
	depends on SYSLOGD
	help
	  When you enable this feature, the syslogd utility will
	  use a circular buffer to record system log messages.
	  When the buffer is filled it will continue to overwrite
	  the oldest messages.  This can be very useful for
	  systems with little or no permanent storage, since
	  otherwise system logs can eventually fill up your
	  entire filesystem, which may cause your system to
	  break badly.

config FEATURE_IPC_SYSLOG_BUFFER_SIZE
	int "    Circular buffer size in Kbytes (minimum 4KB)"
	default 16
	range 4 2147483647
	depends on FEATURE_IPC_SYSLOG
	help
	  This option sets the size of the circular buffer
	  used to record system log messages.

config LOGREAD
	bool "logread"
	default y
	depends on FEATURE_IPC_SYSLOG
	help
	  If you enabled Circular Buffer support, you almost
	  certainly want to enable this feature as well.  This
	  utility will allow you to read the messages that are
	  stored in the syslogd circular buffer.

config FEATURE_LOGREAD_REDUCED_LOCKING
	bool "logread double buffering"
	default n
	depends on LOGREAD
	help
	  'logread' ouput to slow serial terminals can have
	  side effects on syslog because of the semaphore.
	  This option make logread to double buffer copy
	  from circular buffer, minimizing semaphore
	  contention at some minor memory expense.

config KLOGD
	bool "klogd"
	default n
	help
	  klogd is a utility which intercepts and logs all
	  messages from the Linux kernel and sends the messages
	  out to the 'syslogd' utility so they can be logged.  If
	  you wish to record the messages produced by the kernel,
	  you should enable this option.

config LOGGER
	bool "logger"
	default n
	select FEATURE_SYSLOG
	help
	    The logger utility allows you to send arbitrary text
	    messages to the system log (i.e. the 'syslogd' utility) so
	    they can be logged.  This is generally used to help locate
	    problems that occur within programs and scripts.

endmenu
Yet another major rework of the BusyBox config system, using the considerably modified Kbuild system I put into uClibc. With this, there should be no more need to modify Rules.mak since I've moved all the interesting options into the config system. I think I've got everything updated, but you never know, I may have made some mistakes, so watch closely. -Erik 2002-12-05 08:41:41 +00:00			`#`
			`# For a description of the syntax of this configuration file,`
			`# see scripts/kbuild/config-language.txt.`
			`#`

			`menu "System Logging Utilities"`

build system overhaul 2006-10-05 10:17:08 +00:00			`config SYSLOGD`
Yet another major rework of the BusyBox config system, using the considerably modified Kbuild system I put into uClibc. With this, there should be no more need to modify Rules.mak since I've moved all the interesting options into the config system. I think I've got everything updated, but you never know, I may have made some mistakes, so watch closely. -Erik 2002-12-05 08:41:41 +00:00			`bool "syslogd"`
			`default n`
			`help`
Add all the syslogd help text 2003-02-28 07:20:55 +00:00			`The syslogd utility is used to record logs of all the`
			`significant events that occur on a system. Every`
			`message that is logged records the date and time of the`
			`event, and will generally also record the name of the`
			`application that generated the message. When used in`
			`conjunction with klogd, messages from the Linux kernel`
			`can also be recorded. This is terribly useful,`
Andreas Mohr writes: the busybox menuconfig triggered my "inacceptable number of spelling mistakes" upper level, so I decided to make a patch ;-) I also improved some wording to describe some things in a better way. Many thanks for an incredible piece of software! Andreas Mohr, random OSS developer 2003-10-22 09:58:56 +00:00			`especially for finding what happened when something goes`
Add all the syslogd help text 2003-02-28 07:20:55 +00:00			`wrong. And something almost always will go wrong if`
			`you wait long enough....`
Yet another major rework of the BusyBox config system, using the considerably modified Kbuild system I put into uClibc. With this, there should be no more need to modify Rules.mak since I've moved all the interesting options into the config system. I think I've got everything updated, but you never know, I may have made some mistakes, so watch closely. -Erik 2002-12-05 08:41:41 +00:00
build system overhaul 2006-10-05 10:17:08 +00:00			`config FEATURE_ROTATE_LOGFILE`
Patch from Robert P Day: let menuconfig indent stuff for us, we don't have to do it in Config.in. 2006-04-13 23:22:16 +00:00			`bool "Rotate message files"`
Arnd Ben Otto writes: Hi Eric I have written a small patch for the Busybox syslogd. With this patch one can limit the size of the messagfile. As soon as the limit is reached the syslogd can rotate or purge the messagefile(s) on his own. There is no necessity to use an external rotatescript. Even if logread does something similar, its very handy to have some messagefile after your box crash. I wrote this patch initial vor BB 0.6x where no cron daemon was avail. Now I adapted it for the new Version and i hope it is still useful. At least I still use it :-) bye Arnd 2003-10-09 09:43:18 +00:00			`default n`
build system overhaul 2006-10-05 10:17:08 +00:00			`depends on SYSLOGD`
Arnd Ben Otto writes: Hi Eric I have written a small patch for the Busybox syslogd. With this patch one can limit the size of the messagfile. As soon as the limit is reached the syslogd can rotate or purge the messagefile(s) on his own. There is no necessity to use an external rotatescript. Even if logread does something similar, its very handy to have some messagefile after your box crash. I wrote this patch initial vor BB 0.6x where no cron daemon was avail. Now I adapted it for the new Version and i hope it is still useful. At least I still use it :-) bye Arnd 2003-10-09 09:43:18 +00:00			`help`
			`This enables syslogd to rotate the message files`
			`on his own. No need to use an external rotatescript.`

build system overhaul 2006-10-05 10:17:08 +00:00			`config FEATURE_REMOTE_LOG`
Patch from Robert P Day: let menuconfig indent stuff for us, we don't have to do it in Config.in. 2006-04-13 23:22:16 +00:00			`bool "Remote Log support"`
Yet another major rework of the BusyBox config system, using the considerably modified Kbuild system I put into uClibc. With this, there should be no more need to modify Rules.mak since I've moved all the interesting options into the config system. I think I've got everything updated, but you never know, I may have made some mistakes, so watch closely. -Erik 2002-12-05 08:41:41 +00:00			`default n`
build system overhaul 2006-10-05 10:17:08 +00:00			`depends on SYSLOGD`
Yet another major rework of the BusyBox config system, using the considerably modified Kbuild system I put into uClibc. With this, there should be no more need to modify Rules.mak since I've moved all the interesting options into the config system. I think I've got everything updated, but you never know, I may have made some mistakes, so watch closely. -Erik 2002-12-05 08:41:41 +00:00			`help`
Add all the syslogd help text 2003-02-28 07:20:55 +00:00			`When you enable this feature, the syslogd utility can`
			`be used to send system log messages to another system`
			`connected via a network. This allows the remote`
			`machine to log all the system messages, which can be`
			`terribly useful for reducing the number of serial`
			`cables you use. It can also be a very good security`
			`measure to prevent system logs from being tampered with`
			`by an intruder.`
Yet another major rework of the BusyBox config system, using the considerably modified Kbuild system I put into uClibc. With this, there should be no more need to modify Rules.mak since I've moved all the interesting options into the config system. I think I've got everything updated, but you never know, I may have made some mistakes, so watch closely. -Erik 2002-12-05 08:41:41 +00:00
build system overhaul 2006-10-05 10:17:08 +00:00			`config FEATURE_IPC_SYSLOG`
Patch from Robert P Day: let menuconfig indent stuff for us, we don't have to do it in Config.in. 2006-04-13 23:22:16 +00:00			`bool "Circular Buffer support"`
Yet another major rework of the BusyBox config system, using the considerably modified Kbuild system I put into uClibc. With this, there should be no more need to modify Rules.mak since I've moved all the interesting options into the config system. I think I've got everything updated, but you never know, I may have made some mistakes, so watch closely. -Erik 2002-12-05 08:41:41 +00:00			`default n`
build system overhaul 2006-10-05 10:17:08 +00:00			`depends on SYSLOGD`
Yet another major rework of the BusyBox config system, using the considerably modified Kbuild system I put into uClibc. With this, there should be no more need to modify Rules.mak since I've moved all the interesting options into the config system. I think I've got everything updated, but you never know, I may have made some mistakes, so watch closely. -Erik 2002-12-05 08:41:41 +00:00			`help`
Add all the syslogd help text 2003-02-28 07:20:55 +00:00			`When you enable this feature, the syslogd utility will`
			`use a circular buffer to record system log messages.`
			`When the buffer is filled it will continue to overwrite`
Andreas Mohr writes: the busybox menuconfig triggered my "inacceptable number of spelling mistakes" upper level, so I decided to make a patch ;-) I also improved some wording to describe some things in a better way. Many thanks for an incredible piece of software! Andreas Mohr, random OSS developer 2003-10-22 09:58:56 +00:00			`the oldest messages. This can be very useful for`
			`systems with little or no permanent storage, since`
Add all the syslogd help text 2003-02-28 07:20:55 +00:00			`otherwise system logs can eventually fill up your`
			`entire filesystem, which may cause your system to`
			`break badly.`
Yet another major rework of the BusyBox config system, using the considerably modified Kbuild system I put into uClibc. With this, there should be no more need to modify Rules.mak since I've moved all the interesting options into the config system. I think I've got everything updated, but you never know, I may have made some mistakes, so watch closely. -Erik 2002-12-05 08:41:41 +00:00
build system overhaul 2006-10-05 10:17:08 +00:00			`config FEATURE_IPC_SYSLOG_BUFFER_SIZE`
Patch from Fillod Stephane: You will find in the attached file "syslog.patch" a patch which adds config options to set at compile time the size of the circular buffer, and some documentation update. 2003-12-19 11:32:14 +00:00			`int " Circular buffer size in Kbytes (minimum 4KB)"`
			`default 16`
- add a config-time range check for IPC_SYSLOG_BUFFER_SIZE The upper-bound doesn't look like it is working since it accepts LONG_MAX as input. I suspect that this is an lxdialog feature or something like that ;) 2007-06-07 13:22:56 +00:00			`range 4 2147483647`
build system overhaul 2006-10-05 10:17:08 +00:00			`depends on FEATURE_IPC_SYSLOG`
Patch from Fillod Stephane: You will find in the attached file "syslog.patch" a patch which adds config options to set at compile time the size of the circular buffer, and some documentation update. 2003-12-19 11:32:14 +00:00			`help`
			`This option sets the size of the circular buffer`
			`used to record system log messages.`

build system overhaul 2006-10-05 10:17:08 +00:00			`config LOGREAD`
Patch from Robert P Day: let menuconfig indent stuff for us, we don't have to do it in Config.in. 2006-04-13 23:22:16 +00:00			`bool "logread"`
Yet another major rework of the BusyBox config system, using the considerably modified Kbuild system I put into uClibc. With this, there should be no more need to modify Rules.mak since I've moved all the interesting options into the config system. I think I've got everything updated, but you never know, I may have made some mistakes, so watch closely. -Erik 2002-12-05 08:41:41 +00:00			`default y`
build system overhaul 2006-10-05 10:17:08 +00:00			`depends on FEATURE_IPC_SYSLOG`
Yet another major rework of the BusyBox config system, using the considerably modified Kbuild system I put into uClibc. With this, there should be no more need to modify Rules.mak since I've moved all the interesting options into the config system. I think I've got everything updated, but you never know, I may have made some mistakes, so watch closely. -Erik 2002-12-05 08:41:41 +00:00			`help`
Add all the syslogd help text 2003-02-28 07:20:55 +00:00			`If you enabled Circular Buffer support, you almost`
			`certainly want to enable this feature as well. This`
			`utility will allow you to read the messages that are`
			`stored in the syslogd circular buffer.`

build system overhaul 2006-10-05 10:17:08 +00:00			`config FEATURE_LOGREAD_REDUCED_LOCKING`
Patch from Robert P Day: let menuconfig indent stuff for us, we don't have to do it in Config.in. 2006-04-13 23:22:16 +00:00			`bool "logread double buffering"`
Patch from Fillod Stephane: You will find in the attached file "syslog.patch" a patch which adds config options to set at compile time the size of the circular buffer, and some documentation update. 2003-12-19 11:32:14 +00:00			`default n`
build system overhaul 2006-10-05 10:17:08 +00:00			`depends on LOGREAD`
Patch from Fillod Stephane: You will find in the attached file "syslog.patch" a patch which adds config options to set at compile time the size of the circular buffer, and some documentation update. 2003-12-19 11:32:14 +00:00			`help`
Remove trailing whitespace. Update copyright to include 2004. 2004-03-15 08:29:22 +00:00			`'logread' ouput to slow serial terminals can have`
Patch from Fillod Stephane: You will find in the attached file "syslog.patch" a patch which adds config options to set at compile time the size of the circular buffer, and some documentation update. 2003-12-19 11:32:14 +00:00			`side effects on syslog because of the semaphore.`
Remove trailing whitespace. Update copyright to include 2004. 2004-03-15 08:29:22 +00:00			`This option make logread to double buffer copy`
			`from circular buffer, minimizing semaphore`
Patch from Fillod Stephane: You will find in the attached file "syslog.patch" a patch which adds config options to set at compile time the size of the circular buffer, and some documentation update. 2003-12-19 11:32:14 +00:00			`contention at some minor memory expense.`

build system overhaul 2006-10-05 10:17:08 +00:00			`config KLOGD`
Add all the syslogd help text 2003-02-28 07:20:55 +00:00			`bool "klogd"`
			`default n`
			`help`
Andreas Mohr writes: the busybox menuconfig triggered my "inacceptable number of spelling mistakes" upper level, so I decided to make a patch ;-) I also improved some wording to describe some things in a better way. Many thanks for an incredible piece of software! Andreas Mohr, random OSS developer 2003-10-22 09:58:56 +00:00			`klogd is a utility which intercepts and logs all`
Add all the syslogd help text 2003-02-28 07:20:55 +00:00			`messages from the Linux kernel and sends the messages`
			`out to the 'syslogd' utility so they can be logged. If`
			`you wish to record the messages produced by the kernel,`
			`you should enable this option.`

build system overhaul 2006-10-05 10:17:08 +00:00			`config LOGGER`
Add all the syslogd help text 2003-02-28 07:20:55 +00:00			`bool "logger"`
			`default n`
build system overhaul 2006-10-05 10:17:08 +00:00			`select FEATURE_SYSLOG`
Add all the syslogd help text 2003-02-28 07:20:55 +00:00			`help`
The logger utility does not really depend on CONFIG_SYSLOGD, since it can also be used with other syslog daemons -Erik 2003-07-26 08:20:46 +00:00			`The logger utility allows you to send arbitrary text`
			`messages to the system log (i.e. the 'syslogd' utility) so`
			`they can be logged. This is generally used to help locate`
			`problems that occur within programs and scripts.`
Yet another major rework of the BusyBox config system, using the considerably modified Kbuild system I put into uClibc. With this, there should be no more need to modify Rules.mak since I've moved all the interesting options into the config system. I think I've got everything updated, but you never know, I may have made some mistakes, so watch closely. -Erik 2002-12-05 08:41:41 +00:00
			`endmenu`