systemd/units/syslog.socket

#  SPDX-License-Identifier: LGPL-2.1-or-later
#
#  This file is part of systemd.
#
#  systemd is free software; you can redistribute it and/or modify it
#  under the terms of the GNU Lesser General Public License as published by
#  the Free Software Foundation; either version 2.1 of the License, or
#  (at your option) any later version.

[Unit]
Description=Syslog Socket
Documentation=man:systemd.special(7)
Documentation=https://systemd.io/SYSLOG
DefaultDependencies=no
Before=sockets.target

# Don't allow logging until the very end
Conflicts=shutdown.target
Before=shutdown.target

# Don't try to activate syslog.service if sysinit.target has failed.
Conflicts=emergency.service
Before=emergency.service

[Socket]
ListenDatagram=/run/systemd/journal/syslog
SocketMode=0666
PassCredentials=yes
PassSecurity=yes
ReceiveBuffer=8M

# The default syslog implementation should make syslog.service a
# symlink to itself, so that this socket activates the right actual
# syslog service.
#
# Examples:
#
# /etc/systemd/system/syslog.service -> /lib/systemd/system/rsyslog.service
# /etc/systemd/system/syslog.service -> /lib/systemd/system/syslog-ng.service
#
# Best way to achieve that is by adding this to your unit file
# (i.e. to rsyslog.service or syslog-ng.service):
#
# [Install]
# Alias=syslog.service
#
# See https://systemd.io/SYSLOG for details.
license: LGPL-2.1+ -> LGPL-2.1-or-later 2020-11-09 12:23:58 +08:00			`# SPDX-License-Identifier: LGPL-2.1-or-later`
Add SPDX license headers to unit files 2017-11-19 00:35:03 +08:00			`#`
syslog: enable kmsg bridge by default and enable syslogging for early boot services 2010-10-20 23:48:01 +08:00			`# This file is part of systemd.`
			`#`
			`# systemd is free software; you can redistribute it and/or modify it`
relicense to LGPLv2.1 (with exceptions) We finally got the OK from all contributors with non-trivial commits to relicense systemd from GPL2+ to LGPL2.1+. Some udev bits continue to be GPL2+ for now, but we are looking into relicensing them too, to allow free copy/paste of all code within systemd. The bits that used to be MIT continue to be MIT. The big benefit of the relicensing is that closed source code may now link against libsystemd-login.so and friends. 2012-04-12 06:20:58 +08:00			`# under the terms of the GNU Lesser General Public License as published by`
			`# the Free Software Foundation; either version 2.1 of the License, or`
syslog: enable kmsg bridge by default and enable syslogging for early boot services 2010-10-20 23:48:01 +08:00			`# (at your option) any later version.`

			`[Unit]`
			`Description=Syslog Socket`
units: introduce new Documentation= field and make use of it everywhere This should help making the boot process a bit easier to explore and understand for the administrator. The simple idea is that "systemctl status" now shows a link to documentation alongside the other status and decriptionary information of a service. This patch adds the necessary fields to all our shipped units if we have proper documentation for them. 2012-05-21 21:12:18 +08:00			`Documentation=man:systemd.special(7)`
various: update links to more wiki pages 2024-05-28 20:37:23 +08:00			`Documentation=https://systemd.io/SYSLOG`
syslog: enable kmsg bridge by default and enable syslogging for early boot services 2010-10-20 23:48:01 +08:00			`DefaultDependencies=no`
units: express Conflict in syslog.socket instead of emergency.service Note this commit only changes how the code is expressed; it does not change the existence of any dependency. The `Conflicts=` was added in 3136ec90, "Stop syslog.socket when entering emergency mode". The discussion in the issue #266 raised concerns that this might be needed for other units, but failed to point out why syslog.socket is special. The reason is that syslog.socket has DefaultDepedencies=no, so it does not get Requires=sysinit.target like other socket units do. But syslog.service does require sysinit.target, among other things. We don't have many socket, path, or timer units with DefaultDependencies=no, and I don't think any of the triggered services have such additional hard dependencies as syslog.service does. It is much less confusing if we keep this `Conflicts=` in the same file as the `DefaultDependencies=no` which made it necessary. 2017-09-30 00:20:31 +08:00			`Before=sockets.target`
units: add reference to wiki so syslog.socket 2012-07-03 19:31:09 +08:00
			`# Don't allow logging until the very end`
units: make sure syslog socket goes away early during shutdown 2012-01-12 11:34:50 +08:00			`Conflicts=shutdown.target`
units: express Conflict in syslog.socket instead of emergency.service Note this commit only changes how the code is expressed; it does not change the existence of any dependency. The `Conflicts=` was added in 3136ec90, "Stop syslog.socket when entering emergency mode". The discussion in the issue #266 raised concerns that this might be needed for other units, but failed to point out why syslog.socket is special. The reason is that syslog.socket has DefaultDepedencies=no, so it does not get Requires=sysinit.target like other socket units do. But syslog.service does require sysinit.target, among other things. We don't have many socket, path, or timer units with DefaultDependencies=no, and I don't think any of the triggered services have such additional hard dependencies as syslog.service does. It is much less confusing if we keep this `Conflicts=` in the same file as the `DefaultDependencies=no` which made it necessary. 2017-09-30 00:20:31 +08:00			`Before=shutdown.target`

			`# Don't try to activate syslog.service if sysinit.target has failed.`
			`Conflicts=emergency.service`
units: add missing ordering deps for Conflicts= of emergency.service 1. If we exited emergency mode immediately, we don't want to have an irreversible stop job still running for syslog.socket. I _suspect_ that can't happen, but let's not waste effort working out exactly why it's impossible and not just very improbable. 2. Similarly, it seems undesirable to have rescue.service and emergency.service both running with an open FD of /dev/console, for however short a period. 2017-09-25 18:45:03 +08:00			`Before=emergency.service`
syslog: enable kmsg bridge by default and enable syslogging for early boot services 2010-10-20 23:48:01 +08:00
			`[Socket]`
journal: move sockets into their own subdir 2012-01-06 03:24:16 +08:00			`ListenDatagram=/run/systemd/journal/syslog`
syslog: enable kmsg bridge by default and enable syslogging for early boot services 2010-10-20 23:48:01 +08:00			`SocketMode=0666`
socket: rename the PassCred= option to PassCredentials=, since we don't want to needlessly abbreviate options unless they are very well established 2011-12-31 08:07:49 +08:00			`PassCredentials=yes`
socket: add option for SO_PASSEC https://bugzilla.redhat.com/show_bug.cgi?id=798760 (Note that this work is not complete yet, as the kernel seems to send us useless data with SCM_SECURITY enabled) 2012-03-13 07:00:27 +08:00			`PassSecurity=yes`
log: increase socket buffers for logging by default 2012-01-28 01:57:37 +08:00			`ReceiveBuffer=8M`
syslog: enable kmsg bridge by default and enable syslogging for early boot services 2010-10-20 23:48:01 +08:00
kmsg-syslogd: remove kmsg-syslogd, since it's entirely obsoleted and replaced by journald 2012-01-06 10:11:17 +08:00			`# The default syslog implementation should make syslog.service a`
			`# symlink to itself, so that this socket activates the right actual`
			`# syslog service.`
			`#`
			`# Examples:`
			`#`
			`# /etc/systemd/system/syslog.service -> /lib/systemd/system/rsyslog.service`
			`# /etc/systemd/system/syslog.service -> /lib/systemd/system/syslog-ng.service`
			`#`
			`# Best way to achieve that is by adding this to your unit file`
			`# (i.e. to rsyslog.service or syslog-ng.service):`
			`#`
			`# [Install]`
			`# Alias=syslog.service`
units: add reference to wiki so syslog.socket 2012-07-03 19:31:09 +08:00			`#`
various: update links to more wiki pages 2024-05-28 20:37:23 +08:00			`# See https://systemd.io/SYSLOG for details.`