# SysSock.Use

Enables listening on the system log socket or the path set by SysSock.Name.

This parameter applies to imuxsock: Unix Socket Input Module.

Name:

  SysSock.Use

Scope:

  module

Type:

  boolean

Default:

  module=on

Required?:

  no

Introduced:

  at least 7.0.0, possibly earlier

## Description

Listen on the default local log socket (`/dev/log`) or, if provided, use the log socket value assigned to the `SysSock.Name` parameter instead of the default. This is most useful if you run multiple instances of rsyslogd where only one shall handle the system log socket. Unless disabled by the `SysSock.Unlink` setting, this socket is created upon rsyslog startup and deleted upon shutdown, according to traditional syslogd behavior.

The behavior of this parameter is different for systemd systems. For those systems, `SysSock.Use` still needs to be enabled, but the value of `SysSock.Name` is ignored and the socket provided by systemd is used instead. If this parameter is not enabled, then imuxsock will only be of use if a custom input is configured.

See the Coexistence with systemd section for details.

## Module usage

    module(load="imuxsock" sysSock.use="off")

### Legacy names (for reference)

Historic names/directives for compatibility. Do not use in new configs. .. _imuxsock.parameter.legacy.omitlocallogging:

- $OmitLocalLogging — maps to SysSock.Use (status: legacy)

## 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–2025 Rainer Gerhards and others. Licensed under the Apache License 2.0.