SrtPcapCaptureInputSettings interface

Settings for an SRT pcap live-capture input node.

Experimental: passive SRT probe from a live packet capture. The node captures off a host interface (a tcpdump -U -w - port) and replays the SRT sessions it observes as if they had been sent to an SRT listener: one connection per session, the same connection callbacks and health events as NorskInput.srt() in listener mode. Unlike NorskInput.srtPcap() there is no capture-file / playbackRate: a live wire is not paced. Requires the capture to be reachable on the interface (e.g. network=host and the SRT flow mirrored to a host NIC). see: NorskInput.srtPcapCapture()

Signature:

export interface SrtPcapCaptureInputSettings extends InputSettings<SrtPcapCaptureInputNode>, StreamStatisticsMixin

Extends: InputSettings<SrtPcapCaptureInputNode>, StreamStatisticsMixin

Events

Property Type Description

onConnection?

( streamId: string, index: number, remoteHost: string) ⇒ SrtConnectionResult

(Optional) Called for each SRT session observed in the capture, as SrtCommonInputSettings.onConnection. remoteHost is the sender’s ip:port.

onConnectionHealth?

(health: SrtConnectionHealth) ⇒ void

(Optional) Called periodically with per-connection health, as SrtInputSettings.onConnectionHealth.

onConnectionStatusChange?

( status: SrtInputStatus, sourceName: string | undefined, index: number, health?: InputHealthStatus) ⇒ void

(Optional) Called when a connection’s status has changed (e.g. when a session of the capture has ended)

Properties

Property Type Description

bpfFilter?

string

(Optional) Optional tcpdump BPF filter expression. Empty / unset = no filter.

captureBufferKb?

number

(Optional) Optional tcpdump capture buffer size in KiB (the -B size). Unset = default.

debugDumpSource?

string

(Optional) When specified dump the raw source input for debug purposes to the given directory

healthSampling?

HealthSamplingSettings

(Optional) Per-connection health sampling, as SrtInputSettings.healthSampling. On by default. A session’s final statistics are reported for three health intervals after its end, before the connection is reported as disconnected.

healthThresholds?

HealthThresholdsSettings | "recommended"

(Optional) Opt-in thresholds for degraded / recovered, as SrtInputSettings.healthThresholds.

interface

string

The capture interface name (e.g. "eth0"). As a no-privilege test affordance a value of the form "file:<path>" makes the engine read the capture from that classic pcap file (tcpdump -r <path>) instead of capturing live.

onSourceTimeStateChange?

(sourceTimeState: SourceTimeState) ⇒ void

(Optional) Called when either a VITC timecode is detected, or having previously detected a timestamp it stops being present

onTsContext?

(context: SrtTsContext) ⇒ void

(Optional)

onTsTable?

(table: SrtTsTable) ⇒ void

(Optional) Callback to be invoked on receiving a TS PSI/SI table/section

programFilter?

number

(Optional) Optionally filter a single program from MPTS at decode time

statsPollIntervalMs?

number

(Optional) Interval in milliseconds at which to sample the per-connection SRT statistics. When unspecified a default is used.

timeDomain?

TimeDomain

(Optional) Optional time-domain configuration, as SrtCommonInputSettings.timeDomain.