Skip to Content
Browse documentation

bfdctl — Command Reference

Inspect brute-force detection reports and manage IP blacklists/whitelists.

Inspect brute-force detection reports and manage IP blacklists/whitelists.

Requirements

Run as root on the Eenos server. A configured BFD installation and the intended IP address. Use one operation; the dispatcher otherwise selects the first matching branch.

Usage

The following example uses the operation described below; replace example identities and paths before use:

/usr/local/eenos/scripts/bfdctl --reportshow

Arguments and options

Argument / optionUsage and meaning
-l, --reportshowFlag. Show last 100 BFD reports
-la, --reportallFlag. Show all BFD reports
-bs, --blacklistshowFlag. Show Blacklisted IPs
-ws, --whitelistshowFlag. Show Whitelisted IPs
-bValue: IP. Blacklist an IP address
-wValue: IP. Whitelist an IP address
-rValue: IP. Remove an IP from Blacklist
-rwValue: IP. Remove an IP from Whitelist

-h, --help displays this parser's help. The installed version remains authoritative for available options.

Operational effects

Report/list actions read BFD data; -b/-w/-r/-rw change blacklist or whitelist state. Incorrect changes can block legitimate access or bypass intended protection.

Verify the result

Check the resulting list and the intended access/protection behavior.

Check operation output and the relevant service/application state. Several legacy wrappers exit successfully after logging a handler failure, so a zero shell exit status alone is not proof of completion.

Back to Administration & Internal Tools · All command-line tools