[irc/freenode/web-7.0.git] / content / kb / using / extbans.md

Title: Extbans
---

Bans, quiets and invite and ban exemptions conventionally accept the format
`nick!user@host`. On freenode another syntax, known as "extban", is accepted.
These entries have the general format `$X` or `$X:data`. Optionally, they can
be negated with a ~: `$~T`.


# Available extban types
| Type (name) | Description |
| ----------- | ----------- |
| $a<br>(account name) | Match users identified to the account specified in the parameter. Accepts wildcards; an empty $a matches any logged-in user. |
| $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. |
| $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". |
| $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". |
| $z<br>(connected securely) | Accepts no parameters. Matches users who are connected via SSL/TLS. |
Commit	Line	Data
cc0201e3 CFL	1	Title: Extbans
cc0201e3 CFL	2	---
cc0201e3	3
c97f2197 EK	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`.
cc0201e3	8
cc0201e3	9
c97f2197	10	# Available extban types
cc0201e3 CFL	11	\| Type (name) \| Description \|
cc0201e3 CFL	12	\| ----------- \| ----------- \|
c97f2197 EK	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. \|