ServerStreamDriverPermittedPeer

Accepts permitted peer identifiers for compatibility, but the plain TCP driver used by imdiag does not enforce them.

This parameter applies to imdiag: Diagnostic instrumentation.

Name:

ServerStreamDriverPermittedPeer

Scope:

input

Type:

array

Default:

input=none

Required?:

no

Introduced:

at least 5.x, possibly earlier

Description

Defines the set of remote peers that may connect when the chosen network stream driver supports authentication. imdiag always uses the plain TCP (ptcp) stream driver, which offers no peer verification. As a result, the configured identities are accepted but ignored. The parameter is kept for forward compatibility with the generic TCP listener framework should imdiag gain authenticated stream support in the future.

Configure this parameter before ServerRun if you need to preserve configuration compatibility. When multiple peers are listed, provide an array of identity strings even though the ptcp driver ignores them.

Input usage

module(load="imdiag")
input(type="imdiag"
      listenPortFileName="/var/run/rsyslog/imdiag.port"
      serverStreamDriverPermittedPeer=["diag.example.com","127.0.0.1"]
      serverRun="19998")

Legacy names (for reference)

Historic names/directives for compatibility. Do not use in new configs.

  • $IMDiagServerStreamDriverPermittedPeer — maps to ServerStreamDriverPermittedPeer (status: legacy)

See also

See also imdiag: Diagnostic instrumentation.


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.