TCP Settings#

💡 Tip: You can change these settings directly in the bgscan application instead of editing the TOML file manually.
Navigate to Settings → TCP Settings in the main menu to configure these options interactively using the TUI inspector.

Configuration file: settings/tcp_settings.toml

This file controls the TCP port scan configuration, including the target port, timeout, number of workers, retry attempts, and output prefix.

Port#

port = 80

The target TCP port to probe on each IP address. The scanner attempts to establish a TCP connection to this port. Common examples: 80 (HTTP), 443 (HTTPS), 22 (SSH).

Recommended values: Common ports for the service you are scanning.

Timeout#

timeout = 3000

Maximum duration (in milliseconds) to wait for a TCP connection to be established. Targets failing to respond within this window are considered unreachable.

Recommended values:

1000-3000 for local networks
5000-10000 for unreliable or distant networks

Workers#

workers = 200

The number of concurrent workers performing TCP connection attempts. Higher values increase scan speed at the cost of greater CPU and network utilization.

Recommended values:

50-100 for limited resources
200-500 for typical use
500-1000 for high-performance scanning

Prefix Output#

prefix_output = "tcp_"

The filename prefix applied to all output files generated by this module. Useful for distinguishing results when running multiple scans simultaneously.

Retries#

tries = 1

The maximum number of retry attempts per target to mitigate connection failures. Higher values improve reliability but increase total scan duration.

Recommended values:

0 for no retries (fastest)
1-3 for most networks
4-10 for unreliable networks