Unlink¶
Controls whether the socket is unlinked on open and close.
This parameter applies to imuxsock: Unix Socket Input Module.
- Name:
Unlink
- Scope:
input
- Type:
boolean
- Default:
input=on
- Required?:
no
- Introduced:
7.3.9
Description¶
If turned on (default), the socket is unlinked and re-created when opened and also unlinked when finally closed. Set it to off if you handle socket creation yourself.
Only an existing socket or symbolic link at the socket path is removed. If the path names any other kind of file, such as a regular file, rsyslog leaves it in place, logs an error, and does not create that socket.
Unlink="off" is for sockets whose lifecycle is managed outside rsyslog.
If rsyslog should create the socket path, leave Unlink at its default
on value. In particular, CreatePath="on" cannot be combined with
Unlink="off": rsyslog would be asked to create the socket path but then
forbidden from replacing or removing it on restart.
Note
Note that handling socket creation oneself has the advantage that a limited amount of messages may be queued by the OS if rsyslog is not running.
Added in version 7.3.9.
Input usage¶
input(type="imuxsock" unlink="off")
See also¶
See also imuxsock: Unix Socket Input Module.
Support: rsyslog Assistant | GitHub Discussions | GitHub Issues: rsyslog source project
Contributing: Source & docs: rsyslog source project
© 2008–2026 Rainer Gerhards and others. Licensed under the Apache License 2.0.