ohmyzsh/plugins/fail2ban/README.md

fail2ban-client

Description

Zsh completion for the fail2ban-client command.
This plugin provides:

• Completion for subcommands (start, restart, reload, stop, unban, status, set, get, add, etc.)
• Dynamic completion of active jails
• Contextual completion of options for set and get (e.g., bantime, maxretry, ignoreip, etc.)
• Automatic handling of sudo if required

Installation

To use it, add fail2ban to the plugins array in your zshrc file:

plugins=(... fail2ban)

Usage

Type fail2ban-client <TAB> to trigger completion.
Examples:

fail2ban-client set <TAB>            # suggests jails  
fail2ban-client set sshd <TAB>       # suggests possible actions  
fail2ban-client get sshd <TAB>       # suggests available properties  
fail2ban-client status <TAB>         # suggests jails or the 'extended' option  

Compatibility

• Zsh version 5.x or higher
• Works with or without root access (uses sudo if needed)
• Designed to be used as a plugin in Oh My Zsh