networkNamespace¶
This is the name of the network namespace.
This parameter applies to omuxsock: Unix sockets Output Module.
- Name:
networkNamespace
- Scope:
module, action
- Type:
string
- Default:
module=none, action=none
- Required?:
no
- Introduced:
v8.2512
Description¶
Sets a name for the networknamespace property. If no network namespace is set, the local (startup) network namespace is used by default. The namespace must be created (and interfaces appropriately configured) prior to starting rsyslogd. rsyslogd must be explicitly built with namespace support, otherwise an error will occur when the namespace is subsequently used against an input stream. The underlying operating system must also support the setns() system call, otherwise the input instance will be unable to bind within the given namespace.
Note
The network namespace should exist as a named file under /var/run/netns/. In particular, the namespace must be created prior to starting rsyslogd. Rsyslogd must be explicitly built with namespace support, otherwise an error will occur when the namespace is subsequently used by an output action. The underlying operating system must also support the setns() system call, otherwise the output action will be unable to operate within the given namespace.
Module usage¶
If networkNamespace is set at the module level, then it becomes the default networkNamespace setting for all omuxsock actions.
module(load="omuxsock" networkNamespace="management")
Action usage¶
An empty string (
"") can be used at the action level to override a module levelnetworkNamespacesetting and explicitly use the startup network namespace for that action.
action(type="omuxsock" socketName="/tmp/example" networkNamespace="routing")
action(type="omuxsock" socketName="rsyslogd.msg.handler" networkNamespace="")
See also¶
See also omuxsock: Unix sockets Output Module.
Support: rsyslog Assistant | GitHub Discussions | GitHub Issues: rsyslog source project
Contributing: Source & docs: rsyslog source project
© 2008–2025 Rainer Gerhards and others. Licensed under the Apache License 2.0.