View source for Ban

{{articles}}
{{faq|Channel bans do not have a certain expiry time.  Operators have to remove the bans themselves, at their own discretion.}}

A '''ban''' prevents a user from joining a specific channel or server.

== Overview ==
''To remove a ban, see [[Unban]].''

Banning in channels are done most commonly with the channel mode +b.  

The IRC command for banning is: 

    /mode #chan +b {{hm}}.  

To make this easier, the Mibbit client has a default [[alias]] of /ban {{hm}}.  

To view the banlist, use the command /mode #chan +b or just /ban<space><enter> (if you are in the channel). 
A list of banned users is shown in the form of:
     ''<nowiki>[</nowiki>cancel ban button<nowiki>]</nowiki> <nowiki>[</nowiki>{{hm}}<nowiki>]</nowiki> <nowiki>[</nowiki>operator who banned<nowiki>]</nowiki> <nowiki>[</nowiki>time of ban<nowiki>]</nowiki>''

If there are ops that are new to IRC, they may accidentally ban the entire channel by banning *!*@*.  To easily recover from this, users can make sure certain [[hostmask]]s for unable to be banned with the channel mode +e.  To use, find out what the hostname of the person is, and use the command /mode #chan +e *!*@hostname.  Mode +e is 'exception', and if a [[hostmask]] matches one on the exception list, the user cannot be banned.

You must be a channel operator, half-operator, super-operator (or admin as called on the Mibbit client and [[UnrealIRCd]]), owner, or founder to set these modes.  The [[chanserv]] modes for these are +h, +o, +s, and +q.

=== Ban Types ===

Some servers allow for special types of bans.  This subsection entails what they are, and how to use them on those servers.

==== Quiet Ban ====

This ban type makes it so that any users with a specific [[hostmask]] cannot send messages, but can receive them in the channel they are banned.  They can also join and part at will.  To issue a quiet ban on [[UnrealIRCd]], use the following format:

     /mode #chan +b ~q:{{hm}}

==== Nickchange Ban ====

This ban type makes it so that any users with a specific [[hostmask]] cannot change their nick while in the channel, but can still talk.  They can join and part at will.  To issue a nickchange ban on [[UnrealIRCd]], use the following format:

    /mode #chan +b ~n:{{hm}}

==== In Other Channel Ban ====

Do you not like those in one channel also being in your channel.  On [[UnrealIRCd]], you can prevent that using a special type of ban.  To use it, use the following format:

    /mode #chan +b ~c:#badchan

Users can prefix power modes before (+, %, @, &, and ~ for voice, halfop, op, admin, and owner respectively) it for it to work on those of that power or higher.  If one wishes to ban those that have less than a certain mode on a certain channel, they can use the following format:

  /mode #chat +eb ~c:<prefix>#chan  ~c:#chan

==== Realname Ban ====

A realname bans on real name and underscores (_) are treated also as spaces ( ).  For [[UnrealIRCd]], the format is:

    /mode #chan +b ~r:<realname>


~x: bans can also be combined, e.g.,

    /mode # +b ~q:~c:#OtherChan

===Set a Ban with ChanServ===

{{notice|This section is convoluted.  If you can make it not so convoluted, feel free to.  To all other users, it is suggest not to read this.}}

You may wish to set a ban using ChanServ. Depending on the SIGNKICK settings of your channel this might mask which op set the ban (explained further below.)
To set the ban type: /cs ban #channel nick reason
If nick is not given, it will ban you. If channel and nick are not given, it will ban you on all channels you're on, provided you have the rights to. By default, limited to AOPs or those with level 5 access and above on the channel.

SIGNKICK Enables or disables signed kicks for a channel. When SIGNKICK is set, kicks issued with the ChanServ KICK or BAN commands will have the nick that used the command in their reason. If you use LEVEL, those who have a level that is superior or equal to the SIGNKICK level on the channel won't have their kicks signed. The command to set SIGNKICK is: /msg chanserv set #channel signkick {ON | LEVEL | OFF}

== Server Bans ==
An [[IRCop]] with enough privileges may ban users on servers.  The following types of server bans are as follows.  Command formats are not given for these bans, as these types of bans are server dependent, and can be found in respective documentations.

=== K-line ===
The K-line is a local server ban (specific to a single server, not the entire IRC network) that bans the offensive user's hostname.

=== G-line ===
The G-line (Global K-line) works exactly as the K-line, but is global. G-lines can expire, but in some cases they are permanent.

=== Z-line ===
On IRCds such as UnrealIRCd, the Z-line is a "powerful" ban, it is performed on IP address instead of the hostmask, making sure that users from that IP address will not join. Z-lines could expire, but in some cases it is permanent.

=== GZ-line ===
Some IRCds support the GZ-line (Global Z-line). It is exactly as the Z-line itself, but it's global, and network-wide.  UnrealIRCd has GZ-line support.
The GZ-line is an effective way of blocking static IP users, and keeping them out.

=== D-line ===
On other IRCds, such as Charybdis, a D-line replaces a Z-line.  It is called a D-line because it "denies" the IP address from connecting.  Charybdis does not have support for a Z-line or a GZ-line.  By using its "cluster" configuration feature, D-lines can be synchronized between servers, providing a type of 'GZ-line'.  This enables for very nice big network support since the administrator of one server may want to allow certain servers they trust to synchronize D-lines and K-lines, but not allow others.

== See also ==
* [http://archive.is/eWVU1] - archieved Toxin article on bans.
* [[Unban]]

[[Category:IRC]][[Category:Commands]][[Category:Unreal]][[Category:Mode]][[Category:Ban]]