CVS log for src/usr.sbin/syslogd/syslogd.8

Up to [cvs.NetBSD.org] / src / usr.sbin / syslogd

Request diff between arbitrary revisions

Keyword substitution: kv
Default branch: MAIN

syslogd.8 & syslogd.c: add -k option

Provide a means of disabling the translation of (remote) messages
received with facility kern to facility user. Feature equivalent to
what FreeBSD added years ago, though the code is slightly different
(a bit easier to follow expressively). Patches from RVP, provided in
PR lib/57172 (with very minor tweaks by me).

syslogd: make -d accept an optional argument

Make it possible to specify the debug message categories with an
optional numeric argument.  You'll have to read the fine source to
find out what they are.  The number can be specified as the usual
decimal, hex (0x), or octal (0) literal with an optional ~negation.

Since syslogd uses getopt(3), not getopt_long(3), do a bit of
gymnastics so that both -d42 and -d 42 are accepted (I'm not inventing
long names for all the existing options just to support an optional
argument to -d).

-d without an argument still uses the old D_DEFAULT selection just in
case someone really relies on that.  You can disable all debug
messages with -d0 but still get syslogd not daemonized.

Sync with HEAD

Sync with HEAD, resolve a couple of conflicts

Sort options.

syslogd: allow the reporting of buffer overflows to be disabled.

This generally isn't a good thing, nothing should be discard silently.
However, for systems that don't want big syslogd buffers or are too slow
to log effectively this reporting can now be disabled.

syslogd: allow the receiving buffer size to be set.

This allows the admin to try and avoid buffer overflow when a log of
logging appears in bursts.

Remove workaround for ancient HTML generation code.

resync with head

sync with head

sync with (a bit old) head

fix thinko

Resync to 2012-11-19 00:00:00 UTC

Remove trailing whitespace.

Note enchancements that appeared in NetBSD 6.0.

sync with head

Remove unnecessary Bk/Ek pairs from SYNOPSIS.
No effective change except where I used the opportunity to sort options
and/or option descriptions.

add aliases for the protocol format

reinstate a sentence partly removed in v1.43 regarding the default
facility/priority for local kernel messages

draft-ietf-syslog-protocol-23 -> RFC 5424

Apply patch (requested by bouyer in ticket #1990):
Fix typo: LOT_NOTICE -> LOG_NOTICE.

Apply patch (requested by bouyer in ticket #1990):
Fix typo: LOT_NOTICE -> LOG_NOTICE.

Apply patch (requested by bouyer in ticket #1990):
Fix typo: LOT_NOTICE -> LOG_NOTICE.

Apply patch (requested by bouyer in ticket #1272):
Fix typo: LOT_NOTICE -> LOG_NOTICE.

Apply patch (requested by bouyer in ticket #1272):
Fix typo: LOT_NOTICE -> LOG_NOTICE.

Apply patch (requested by bouyer in ticket #392):
Fix typo: LOT_NOTICE -> LOG_NOTICE.

Bump date for previous.

note some options' optarg in DESCRIPTION as well.

make -o option consistent with others.

Remove trailing whitespace.

Import syslogd SoC project by Martin Schuette:
	- new syslog protocol api syslogp(3) that supports structured data
	  and draft-rfc timestamps
	- reliable tcp connections with queueing
	- encrypted connections

PR/14563: Brian A. Seklecki: syslogd binds udp sockets on all interfaces
Add -b option to pass a bind address.

Add -T to SYNOPSIS.

Fix typo.

PR 32579: Add a -T flag to syslogd, which causes it to use local time for
messages received from the network. Useful for collecting logs from
devices which do not have correct time.

Add it to usage.

Document it, also document that syslogd adds a timestamp with the local
time if it does not recognize the original timestamp field. Bump date.

Approved by wrstuden@.

Add reference to RFC 3164. From Pavel Cahyna in PR 32578.

Fix typo, and make HTML-save.

Merge the thorpej-syslogd-hack-branch down to the trunk.  Enhancements
include:

- Extend the syntax of syslog.conf to allow selections of log destinations
  by comma-separated lists of program name (including kernel-generated
  messages) and originating host name.
- Ability to pipe selected messages through arbitrary filter commands.
- Ability to specify priority comparison operations.
- Improvements to domain name handling.
- Conversion to use kqueue for communication and signal events, eliminating
  all unsafe signal handlers.
- Allow spaces as well as tabs in syslog.conf.
- Log kernel printfs at LOG_NOTICE instad of LOG_CRIT.
- Ability to log facility/priority with a log message.
- Reliability improvements.

Add the ability to specify how the priority should be compared in
syslog.conf, e.g.:

*.<notice
*.=err
*.>=debug

Add a -U option that changes the default comparison from ">=" to "=".

Add a -v option that causes the facility and priority to be logged with
the message.  One -v logs it numerically, a second -v logs it by name.

From FreeBSD, with the exception of changing the unique priority option
to -U (we already have a -u).

Bump date for defaults documentation.

Document the default facility and priority that syslogd uses for
untagged messages.

Add -S to SYNOPSIS; sort descriptions; bump date for new -S flag.

Don't fsync() kernel messages by default -- enable it with the "-S" flag.
This avoids some seriously gratuitous disk hosage in various cases.

XXX It would probably be better to allow this to be specified in the config
file somehow.

Implement -r, which prevents syslogd from compressing multiple messages with
the same string into "last message repeated N times", and instead forces
syslogd to write out every message.

Based on '-c' in FreeBSD's syslogd, although a different option letter was
chosen because their syslogd requires '-c -c' to get this functionality,
and we don't have the support for logging to pipes which is what FreeBSD's
syslogd with a single '-c' is related to.

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22366, verified by myself.

setup -> set up.

New sentence, new line.

Add an explanation of the log format.  From PR#14290.

.Nm does not need a dummy argument ("") before punctuation or
for correct formatting of the SYNOPSIS any longer.

resolve 1.6 pullup ticket #23 from wiz
pulls up revisions 1.26, 1.27
Original commit messages:

> Grammar fixes and a markup fix.

and

> Sort options in man page, don't mention non-existing '-S' option,
> use some more markup and improve existing one.

Sort options in man page, don't mention non-existing '-S' option,
use some more markup and improve existing one.
Sync usage() with man page.

Grammar fixes and a markup fix.

Drop a .Pp, sort SEE ALSO.

Whitespace nits.

- No more lost error messages during syslogd startup, they now all appear on
stdout before syslogd becomes a daemon.
- Flags for setuid/setgid/chroot syslogd after initialization is completed
- Warning instead of silent ignoring for malformed lines (with spaces instead
of tags)
Approved by Christos

-DLIBWRAP will enable libwrap-based filtering on UDP socket messages.
PR 13348

new `-n' switch to avoid looking up hostnames.

Logical markup. Reported in bin/12816 by Tetsuya Isaki.

Pull up rev 1.19 from trunk: Xr newsyslog.

Xr newsyslog.

Pullup revs syslogd.8 1.15->1.18 and syslogd.c 1.34->1.38:

Make -s work as advertised.  (Not only not listen on udp/514, but don't
bind the socket, and don't create the socket if it is not needed for
forwarding actions).

Pullup approved by Jason Thorpe (thorpej@netbsd.org)

Remove caveat about behavior of `syslogd -s' when forwarding rules are
present -- this behavior has been fixed.

Back out and redo previous at Bill Sommerfeld's <sommerfeld@netbsd.org>
request:

	instead of the -S flag, fix the -s flag to not open a socket
	if there are no forwarding rules in /etc/syslog.conf

The behavior of syslogd when -s is specified and there are forwarding rules
should still be made cleaner.

1.) bring usage text up to date, and clarify description of `-s' option
    in man page and comments -- for some time it has no longer prevents
    an inet socket from being opened, just caused it to be ignored

2.) Fix this problem with `-s' -- syslogd always opens an inet socket, even if
    -s is specified and it has nowhere to send to.  This socket is then
    shutdown(), but there is no way to not have this socket open.

    Users setting up paranoid installations can now specify `-S' which
    prevents any non-unix-domain sockets from being opened, even if
    forwarding is specified in /etc/syslogd.conf.

    As per the previous fix, this is not made the default for `-s', as it
    also prevents syslogd from forwarding log messages.

3.) document the above in the man page and usage.

Justification:  in light of the possibility of future DoS attacks, or the
desire to set up a machine which is relatively uninformative in the face
of port scans, users may quite legitimately want to control what sockets
are open on their machine.  Telling such users that they cannot run
syslogd is non-ideal.

Pull up to last week's -current.

- Fix location of RCS Id string.
- It's now syslogd.pid, not syslog.pid.

s/acknowledgment/acknowledgement/

More and more .Os cleanups.  .Os is defined in the tmac.doc-common file,
so we shouldn't override it with versions in the manpages.  Many more to
come.

/var/run/log.

/dev/log moved to /var/run/syslog.socket.

Clean up SYNOPSIS formatting.

- allow -p /log/socket to appear more than once (and work as expected
  if given this).  this is extremely useful for chrooted daemons that
  still want to create log entries via a local mechanism.

- create a new -P option that takes a filename of log sockets (equiv.
  of calling syslogd which -p <each line of file>.  this is useful
  for the case of many chroot areas and keeping this information in
  one place rather than having to remember it all.

if no -p options are given, the default (_PATH_LOG) is used as normal.

Change occurrences of "UNIX" to .Ux or .At as appropriate.

minor .Nm cleanup

alternate -> alternative, per PR 2643

Fix PR/2371, a spelling error and missing -s from the description.

Added code to implement mode in which syslogd listens only to unix
domain socket (triggered by -s option) and documentation for
same. This closes pr 1761, although the code is slightly different.

Merge/sync with 4.4lite2. Fixed HISTORY line for syslog.conf.5. Note
that the claim in the HISTORY line for syslogd.8 that it appeared in
4.3BSD is probably bogus -- I remember it being a lot older.

imported from 44lite2

Add RCS indentifiers.

initial import of 386bsd-0.1 sources

Initial revision