The EsperNet IRC Network

IRC Services - Guide to ChanServ

About ChanServ

ChanServ allows you to register your channels. It provides a convenient interface to manage your channels, including access lists, mode enforcement, topic restoration, and if necessary, help to manage troublesome users. You can think of ChanServ as NickServ for your channels.

Channels unused for 14 days are automatically dropped, so be sure to use your channels!

For a list of commands from ChanServ, type:

/MSG ChanServ HELP COMMANDS

The following commands can be used with ChanServ:

Command	Description
REGISTER	Register a channel.
IDENTIFY	Identify yourself with your password.
DROP	Cancel the registration of a channel.
SET	Set channel options and information.
UNSET	Clear channel information.
INFO	Show channel options and information.
ACCESS	Maintain the overall channel access list.
LEVELS	Fine-tune channel privilege levels.
SOP	Maintain the SuperOp list.
AOP	Maintain the AutoOp list.
VOP	Maintain the AutoVoice list.
NOP	Maintain the NeverOp list.
OP	Give a user chanop status (+o).
DEOP	Remove chanop status (+o).
VOICE	Give a user voice status (+v).
DEVOICE	Remove voice status (+v).
INVITE	Invite yourself to a channel.
UNBAN	Unban yourself from a channel.
KICK	Kick a user from a channel.
TOPIC	Change a channel's topic.
CLEAR	Clear channel modes or mass-kick users.
STATUS	Return a user's access level on a channel.
AKICK	Maintain the AutoKick list.
These commands are available to Services Administrators:
GETPASS	Retrieve the founder password for a channel (only if encryption is disabled).
FORBID	Prevent a channel from being registered/used.
SUSPEND	Prevent a registered channel from being used.
UNSUSPEND	Cancel a channel suspension.
LIST	List registered channels.
Services admins can also use the following commands on any channel without needing to identify for that channel: ACCESS LIST, AKICK LIST, STATUS.

ChanServ Command Details

REGISTER

REGISTER channel password description

Registers a channel in the ChanServ database. In order to use this command, you must first be a channel operator on the channel you're trying to register. The password is used with the IDENTIFY command to allow you to make changes to the channel settings at a later time. The last parameter, which must be included, is a general description of the channel's purpose.

When you register a channel, you are recorded as the "founder" of the channel. The channel founder is allowed to change all of the channel settings for the channel; ChanServ will also automatically give the founder channel-operator privileges when s/he enters the channel. See the ACCESS command ( NOTICE: In order to register a channel, you must have first registered and identified for your nickname. If you haven't, /msg NickServ HELP for information on how to do so.

Example:

/msg ChanServ REGISTER #dragonweyr AGoodPassword Esper's Official Help Channel

IDENTIFY

IDENTIFY channel password

Authenticates you to ChanServ as the founder of the given channel. Many commands require you to use this command before using them. The password should be the same one you sent with the REGISTER command.

Example:

/msg ChanServ IDENTIFY #dragonweyr AGoodPassword

DROP

DROP channel

Unregisters the named channel. Only Services admins can drop a channel for which they have not identified.

Example:

/msg ChanServ DROP #dragonweyr

UNSET

UNSET channel {SUCCESSOR | URL | EMAIL | ENTRYMSG}

Clears the given setting for a channel. As with the SET command, Services admins can clear settings for any channel without identifying for the channel.

Example:

/msg ChanServ UNSET #dragonweyr URL

INFO

INFO channel [ALL]

Lists information about the named registered channel, including its founder, time of registration, last time used, description, and mode lock, if any. If you are identified as the founder of the channel you're getting information for and ALL is specified, the entry message and successor will also be displayed.

Services admins can use the ALL parameter with any channel.

Example:

/msg ChanServ INFO #dragonweyr ALL

ACCESS

ACCESS channel ADD nickname level
ACCESS channel DEL nickname
ACCESS channel LIST [+start] [mask]
ACCESS channel LISTLEVEL [+start] level
ACCESS channel COUNT

Maintains the access list for a channel. The access list specifies which users are allowed chanop status or access to ChanServ commands on the channel. Different user levels allow for access to different subsets of privileges; /msg ChanServ HELP ACCESS LEVELS for more specific information. Any nickname not on the access list has a user level of 0.

The ACCESS ADD command adds the given nickname to the access list with the given user level; if the nick is already present on the list, its access level is changed to the level specified in the command. The level specified must be less than that of the user giving the command, and if the nick is already on the access list, the current access level of that nick must be less than the access level of the user giving the command.

The ACCESS DEL command removes the given nickname from the access list. Users can only remove nicknames with an access level lower than their own.

The ACCESS LIST command displays the access list. If a wildcard mask is given, only those entries matching the mask are displayed. If the start parameter is given, it specifies how many matches to skip before displaying results (for example, +50 would cause the first 50 matches to be skipped).

The ACCESS LISTLEVEL command is similar to ACCESS LIST, but displays only entries with the given access level. The level can be specified as a range: LISTLEVEL 50-100, for example, lists all users with access levels between 50 and 100 inclusive.

The ACCESS COUNT command returns the number of entries there are on the access list.

Note that the access list may also be manipulated with the SOP, AOP, VOP, and NOP commands, which correspond to levels of 100, 50, 30, and -1 respectively.

Example:

/msg ChanServ ACCESS #channel LIST 2-5,7-9

LEVELS

LEVELS channel SET type level
LEVELS channel {DIS | DISABLE} type
LEVELS channel LIST
LEVELS channel RESET

The LEVELS command allows fine control over the meaning of the numeric access levels used by the ACCESS command. With this command, you can define the access level required for most of ChanServ's functions. (The SET FOUNDER and SET PASSWORD commands, as well as this command, are always restricted to the channel founder.)

Caution: This command is for advanced users only! Changing level settings with this command may cause the SOP, AOP, VOP, and NOP commands to stop working correctly.

LEVELS SET allows the access level for a function or group of functions to be changed. LEVELS DISABLE (or DIS for short) disables an automatic feature or disallows access to a function by anyone other than the channel founder. LEVELS LIST shows the current levels for each function or group of functions. LEVELS RESET resets the levels to the default levels of a newly-created channel (see HELP ACCESS LEVELS).

For a list of the features and functions whose levels can be set, see HELP LEVELS DESC.

Example:

/msg ChanServ LEVELS #channel LIST 2-5,7-9

SOP

SOP channel ADD nickname
SOP channel DEL nickname
SOP channel LIST [mask | list]
SOP channel COUNT

Lists SOP list entries numbered 2 through 5 and 7 through 9.

Maintains the SuperOp (SOP) list for a channel. Users with SOP status are automatically opped (set mode +o) when they join the channel.

An SOP can modify the AOP and VOP lists. Only a channel's founder can modify the SOP list.

The SOP LIST command displays the SOP list. If a wildcard mask is given, only those entries matching the mask are displayed. If a list of entry numbers is given, only those entries are shown.

The SOP COUNT command returns the number of entries there are on the SOP list.

Example:

/msg ChanServ SOP #channel LIST 2-5,7-9

AOP

AOP channel ADD nickname
AOP channel DEL nickname
AOP channel LIST [mask | list]
AOP channel COUNT

Lists AOP list entries numbered 2 through 5 and 7 through 9.

Maintains the AutoOp (AOP) list for a channel. Users with AOP status are automatically opped (set mode +o) when they join the channel.

An AOP can modify the VOP list; SOPs can modify the AOP list.

The AOP LIST command displays the AOP list. If a wildcard mask is given, only those entries matching the mask are displayed. If a list of entry numbers is given, only those entries are shown.

The AOP COUNT command returns the number of entries there are on the AOP list.

Example:

/msg ChanServ AOP #channel LIST 2-5,7-9

VOP

VOP channel ADD nickname
VOP channel DEL nickname
VOP channel LIST [mask | list]
VOP channel COUNT

Lists VOP list entries numbered 2 through 5 and 7 through 9.

Maintains the VoiceOp (VOP) list for a channel. Users with VOP status are automatically voiced (set mode +v) when they join the channel.

The VOP LIST command displays the VOP list. If a wildcard mask is given, only those entries matching the mask are displayed. If a list of entry numbers is given, only those entries are shown.

The VOP COUNT command returns the number of entries there are on the VOP list.

Example:

/msg ChanServ VOP #channel LIST 2-5,7-9

NOP

NOP channel ADD nickname
NOP channel DEL nickname
NOP channel LIST [+start] [mask]
NOP channel COUNT

Maintains the NeverOp (NOP) list for a channel. Users with NOP status are not permitted to be given channel operator (mode +o) status, and ChanServ will remove mode +o from such users whenever it is given to them.

The ADD, DEL, LIST, and COUNT subcommands function the same way as for the AOP command.

OP

OP channel [nickname]

Ops a selected nickname on a channel. If nickname is not given, ops you. By default, limited to users with AOP access and above on the channel.

Example:

/msg ChanServ OP #dragonweyr Ketju

DEOP

DEOP channel [nickname]

Deops a selected nickname on a channel. If nickname is not given, deops you. By default, limited to users with AOP access and above on the channel.

Example:

/msg ChanServ DEOP #dragonweyr Ketju

VOICE

VOICE channel [nickname]

Voices a selected nickname on a channel. If nickname is not given, voices you. By default, limited to users with VOP access and above on the channel.

Example:

/msg ChanServ VOICE #dragonweyr Ketju

DEVOICE

DEVOICE channel [nickname]

Devoices a selected nickname on a channel. If nickname is not given, devoices you. By default, limited to users with VOP access and above on the channel.

Example:

/msg ChanServ DEVOICE #dragonweyr Ketju

INVITE

INVITE channel

Tells ChanServ to invite you into the given channel. By default, limited to users with AOP access and above on the channel.

Note: If you get a message saying that the channel is not in use, it means that the channel is empty, and you can join it freely without needing to use this command.

Example:

/msg ChanServ INVITE #dragonweyr

UNBAN

UNBAN channel

Tells ChanServ to remove all bans preventing you from entering the given channel. By default, limited to users with AOP access and above on the channel.

Example:

/msg ChanServ UNBAN

KICK

KICK channel nickname [reason]

Tells ChanServ to kick the given nickname from the given channel. The message included in the kick will show who used the KICK command, as well as the reason given with the command, if any. By default, limited to users with AOP access and above on the channel.

Example:

/msg ChanServ KICK #dragonweyr Ketju Causing trouble

TOPIC

TOPIC channel topic

Causes ChanServ to set the channel topic to the one specified. This command is most useful in conjunction with SET TOPICLOCK. By default, limited to users with AOP access and above on the channel.

Example:

/msg ChanServ TOPIC #dragonweyr Welcome to Esper's Official Help Channel

CLEAR

CLEAR channel what

Tells ChanServ to clear certain settings on a channel. what can be any of the following:

MODES Clears all modes on the channel except those set in the channel's mode lock.

BANS Clears all bans on the channel.

EXCEPTIONS Clears all exceptions on the channel.

INVITES Clears all invite masks on the channel.

OPS Removes channel-operator status (mode +o) from all users.

VOICES Removes "voice" status (mode +v) from all users.

USERS Removes (kicks) all users from the channel.

By default, limited to users with SOP access and above on the channel.

Example:

/msg ChanServ CLEAR #dragonweyr BANS

STATUS

STATUS channel nickname

Returns the current access level of the given nickname on the given channel. The reply is of the form:

STATUS channel nickname access-level

If an error occurs, the reply will be in the form:

STATUS channel nickname ERROR error-message

By default, limited to users with SOP access and above on the channel.

Example:

/msg ChanServ STATUS #dragonweyr Ketju

AKICK

AKICK channel ADD mask [reason]
AKICK channel DEL mask
AKICK channel LIST [mask | list]
AKICK channel VIEW [mask | list]
AKICK channel ENFORCE
AKICK channel COUNT

Maintains the autokick list for a channel. If a user on the autokick list attempts to join the channel, ChanServ will ban that user from the channel, then kick the user.

The AKICK ADD command adds the given user@host or nick!user@host mask to the autokick list. If a reason is given with the command, that reason will be used when the user is kicked; if not, the default reason is "You have been banned from the channel".

The AKICK DEL command removes the given mask from the autokick list. It does not, however, remove any bans placed by an autokick; those must be removed manually.

The AKICK LIST command displays the autokick list, or optionally only those autokick entries which match the given mask. AKICK VIEW is similar, but shows more details.

The AKICK ENFORCE command causes ChanServ to enforce the current autokick list by removing those users who match an autokick mask.

The AKICK COUNT command returns how many entries there are on the autokick list.

By default, limited to users with SOP access and above on the channel.

Example:

/msg ChanServ AKICK COUNT #dragonweyr

GETPASS

GETPASS channel

Returns the password for the given channel. Note that whenever this command is used, a message including the person who issued the command and the channel it was used on will be logged and sent out as a WALLOPS/GLOBOPS.

If encryption is in use, this command may not be available depending on the type of encryption used.

Limited to Services admins.

Example:

/msg ChanServ GETPASS #dragonweyr

FORBID

FORBID channel

Disallows anyone from registering or using the given channel. May be cancelled by dropping the channel.

Limited to Services admins.

Example:

/msg ChanServ FORBID #dragonweyr

SUSPEND

SUSPEND [+expiry] channel reason

Prevents a channel from being used or identified for by anyone. The channel can be unsuspended with the UNSUSPEND command, which will allow it to be used as before. The expiry parameter is interpreted in the same manner as for the AKILL command.

Limited to Services admins.

Example:

/msg ChanServ SUSPEND +30d #dragonweyr Causing trouble

UNSUSPEND

UNSUSPEND channel

Allows users to use and identify for a previously suspended channel.

Limited to Services admins.

Example:

/msg ChanServ UNSUSPEND #dragonweyr

Copyright © 1996-2010, The EsperNet IRC Network. All rights reserved.