content/kb/using/extbans.md

   1 Title: Extbans
   2 ---
   3
   4 Bans, quiets and invite and ban exemptions conventionally accept the format
   5 `nick!user@host`. On freenode another syntax, known as "extban", is accepted.
   6 These entries have the general format `$X` or `$X:data`. Optionally, they can
   7 be negated with a ~: `$~T`.
   8
   9
  10 # Available extban types
  11 | Type (name) | Description |
  12 | ----------- | ----------- |
  13 | $a<br>(account name) | Match users identified to the account specified in the parameter. Accepts wildcards; an empty $a matches any logged-in user. |
  14 | $j<br>(cannot join other channel) | Takes an exact channel name (no wildcards or globbing) as its parameter and matches any user who is banned from that channel. Due to caching by the server, a change to the target channel's ban list may not immediately affect a user's ability to send to the channel using $j. |
  15 | $r<br>(ircname) | Matches on a client's ircname, or gecos. The parameter accepts wildcards. For example: `/mode #channel +b $r:Foo*` will ban any user whose gecos begins with "Foo". |
  16 | $x<br>(full match) | Takes a parameter that is matched against a client's full nick!username@host#gecos. The parameter accepts wildcards. For example, `/mode #channel +b $x:*#Foo*` will ban any user whose gecos begins with Foo, or whose gecos contains "#Foo". |
  17 | $z<br>(connected securely) | Accepts no parameters. Matches users who are connected via SSL/TLS. |