X-Git-Url: https://git.librecmc.org/?a=blobdiff_plain;f=docs%2Flogging_and_backgrounding.txt;h=c76cd36532c2337081e052fcb3d63396238b0e12;hb=b0648b0e7874e8551df64708532346a049ab7f2c;hp=39f0158837c2b0b5ff6f7aab8f973fb1d21c5952;hpb=a19e64933c600b7f05232ad80bb5db85c115e42d;p=oweals%2Fbusybox.git diff --git a/docs/logging_and_backgrounding.txt b/docs/logging_and_backgrounding.txt index 39f015883..c76cd3653 100644 --- a/docs/logging_and_backgrounding.txt +++ b/docs/logging_and_backgrounding.txt @@ -21,24 +21,22 @@ To help with that, busybox applets should have options to override default behavior, whatever that is for a given applet. -Current sutiation is a bit of a mess: +Current situation is a bit of a mess: acpid - auto-backgrounds unless -d crond - auto-backgrounds unless -f, logs to syslog unless -d or -L. option -d logs to stderr, -L FILE logs to FILE devfsd - (obsolete) -dnsd - option -d makes it auto-background and log to syslog +dnsd - option -d makes it background and log to syslog fakeidentd - inetd service. Auto-backgrounds and logs to syslog if no -f and no -i and no -w (-i is "inetd service" flag, -w is "inetd-wait service" flag) -ftpd - inetd service. Logs to syslog always, with -v logs to strerr too -httpd - auto-backgrounds unless -f or -i - (-i is "inetd service" flag) +ftpd - inetd service. Logs to syslog with -S, with -v logs to strerr too +httpd - auto-backgrounds unless -f or -i (-i is "inetd service" flag) inetd - auto-backgrounds unless -f, logs to syslog unless -e klogd - auto-backgrounds unless -n syslogd - auto-backgrounds unless -n -telnetd - auto-backgrounds unless -f or -i - (-i is "inetd service" flag) +telnetd - auto-backgrounds unless -f or -i (-i is "inetd service" flag) udhcpc - auto-backgrounds unless -f after lease is obtained, option -b makes it background sooner (when lease attempt fails and retries start), @@ -47,10 +45,21 @@ udhcpc - auto-backgrounds unless -f after lease is obtained, udhcpd - auto-backgrounds and do not log to stderr unless -f, otherwise logs to stderr, but option -S makes it log *also* to syslog zcip - auto-backgrounds and logs *also* to syslog unless -f + behaviour can be overridden with experimental LOGGING env.var + (can be set to either "none" or "syslog") + +Total: 13 applets (+1 obsolete), + 4 log to syslog by default (crond fakeidentd inetd zcip), + 5 never log to syslog (acpid httpd telnetd klogd syslogd, last two + - for obviously correct reasons), + there are no daemons which always log to syslog, + 12 auto-background if not run as inetd services (all except dnsd. + Note that there is no "standard" dnsd AFAIKS). But see below + for daemons (tcpsvd etc) which don't auto-background. miscutils/crond.c: logmode = LOGMODE_SYSLOG; networking/dnsd.c: logmode = LOGMODE_SYSLOG; -networking/ftpd.c: logmode = LOGMODE_SYSLOG; +networking/ftpd.c: logmode = LOGMODE_NONE; networking/ftpd.c: logmode |= LOGMODE_SYSLOG; networking/inetd.c: logmode = LOGMODE_SYSLOG; networking/isrv_identd.c: logmode = LOGMODE_SYSLOG; @@ -63,7 +72,7 @@ networking/udhcp/dhcpd.c: logmode |= LOGMODE_SYSLOG; networking/zcip.c: logmode |= LOGMODE_SYSLOG; -These daemons seem to never auto-background/log to syslog: +These daemons never auto-background and never log to syslog: lpd - inetd service. Has nothing to log so far, though dhcprelay - standard behavior