ListenPortFileName (module scope)

Path of the file to which imdiag writes its chosen TCP listen port number, set at module load time.

This parameter applies to imdiag: Diagnostic instrumentation.

Name:

ListenPortFileName

Scope:

module

Type:

string (file path)

Default:

none

Required?:

no (but recommended for testbench use)

Introduced:

8.x

Description

When set at module scope, ListenPortFileName specifies the file that imdiag will create and populate with its chosen listen port number after the TCP listener is ready. The testbench reads this file to discover the port without needing a fixed port number.

This is the module-scope version of the parameter. The same name can also be set at input scope via input(type="imdiag" listenPortFileName=...).

Module usage

module(load="imdiag" listenPortFileName="/tmp/imdiag.port")

YAML usage

testbench_modules:
  - load: "../plugins/imdiag/.libs/imdiag"
    listenportfilename: "/tmp/imdiag.port"

See also

See also imdiag: Diagnostic instrumentation and ListenPortFileName.

---

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.