This command is used for managing the akick list for a given channel. If a user matching a mask on the akick list appears in the channel, then ChanServ will automatically ban that person and remove them from the channel. This can be useful for banning certain nick names or host masks from appearing in your channel. Even if the ban is undone later, if the akick is still on the list, the person will still be banned and removed by services upon joining.
This command has 6 sub commands which can be used which will be described in further detail below.
This adds an entry to the akick list. This can be a nickname (usually a registered nickname) or a host mask. This command takes 1 or 2 arguments, the nick name or host mask to ban, and an optional ban reason which will be shown to the user upon being removed from the channel. If unset, then a default "User has been banned from the channel" will be used instead. If a nickname is specified instead of a host mask, than anyone identified to the account will be banned.
To add the account owned by nick1 for the reason "You are banned" from #channel, you can run this command:
/msg ChanServ akick #channel add nick1 You are banned
This removes an akick entry or number of entries from the list. This command takes 1 argument, either a nickname, host mask, entry number, group of entry numbers, or range of entry numbers on the list. If removing entry numbers, you should use the list sub command described below to find out which numbers you want to delete first. To delete entries 1, 6, 7, 8, and 11 from #channel, you would use the following command:
/msg ChanServ akick #channel del 1,6-8,11
This command lists access entries on your channel's akick list. This command accepts 1 optional argument, a mask, nick, entry number, or range of entry numbers to list. If this argument is not specified, then the entire list is shown. To run this command to see the entire akick list for #channel, use this command:
/msg ChanServ akick #channel list
This command is identical to the above command, but provides more information, such as who added an akick and when it was last applied to a user. Usage is identical except the word view is used instead of list.
This command enforces the akick list, removing anyone from the channel who may be on the list. It is rare that you would ever need to use this command. It may be useful after a netsplit, particularly one that affects services, or a server desync. This command accepts no arguments. To enforce the akick list on #channel, run the following command:
/msg ChanServ akick #channel enforce
This command may be considered dangerous, and so its use is usually restricted to channel founders. This completely removes the akick list from a channel. Once you run this command, there is no way to undo its effects, so you should think carefully about whether or not this is something you want to do. To completely clear out the akick list on #channel, you can run the following command:
/msg ChanServ akick #channel clear