The following is a command reference for ChanServ, a KentIRC provided Network Service.
Contents
REGISTER
Syntax:
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 (/msg ChanServ HELP ACCESS) for information on giving a subset of these privileges to other channel users.
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.
NOTICE: Passwords should not be easily guessable. For example, using your real name as a password is a bad idea. Short passwords are vulnerable to trial-and-error searches, so you should choose a password at least 5 characters long. For security please DO NOT use your Kent Computing Account password, or any other important password - IRC is NOT encrypted.
IDENTIFY
Syntax:
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.
DROP
Syntax:
DROP channel
Unregisters the named channel. Can only be used by channel founder, who must use the IDENTIFY command first.
SET
Syntax:
SET channel option parameters
Allows the channel founder to set various channel options and other information. The founder must use the IDENTIFY command before using SET.
Available options:
FOUNDER
Set the founder of a channel
SUCCESSOR
Set the successor for a channel
PASSWORD
Set the founder password
DESC
Set the channel description
URL
Associate a URL with the channel
EMAIL
Associate an E-mail address with the channel
ENTRYMSG
Set a message to be sent to users when they enter the channel
KEEPTOPIC
Retain topic when channel is not in use
TOPICLOCK
Topic can only be changed with TOPIC
MLOCK
Lock channel modes on or off
PRIVATE
Hide channel from LIST command
RESTRICTED
Restrict access to the channel
SECURE
Activate ChanServ security features
SECUREOPS
Stricter control of chanop status
LEAVEOPS
Do not de-op users on channel entry
OPNOTICE
Send a notice when OP/VOICE commands are used
ENFORCE
Enforce auto-op, auto-voice status
UNSET
Syntax:
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.
ACCESS
Syntax:
ACCESS channel ADD nickname level
ACCESS channel DEL {nickname | entry-num | list}
ACCESS channel LIST [mask | list]
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. If a list of entry numbers is given, those entries are deleted. (See the example for LIST below.)
The ACCESS LIST command displays the access 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; for example:
ACCESS #channel LIST 2-5,7-9
Lists access entries numbered 2 through 5 and 7 through 9.
The ACCESS COUNT command returns the number of entries there are on the access list.
LEVELS
Syntax:
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.)
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.
AKICK
Syntax:
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 nickname!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 level 100 (SOP) access and above on the channel.
INFO
Syntax:
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.
OP
Syntax:
OP #channel [nickname]
Ops a selected nickname on a channel. If nickname is not given, ops you. By default, limited to users with level 50 (AOP) access and above on the channel.
DEOP
Syntax:
DEOP #channel [nickname]
Deops a selected nickname on a channel. If nickname is not given, deops you. By default, limited to users with level 50 (AOP) access and above on the channel.
VOICE
Syntax:
VOICE #channel [nickname]
Voices a selected nickname on a channel. If nickname is not given, voices you. By default, limited to users with level 30 (VOP) access and above on the channel.
DEVOICE
Syntax:
DEVOICE #channel [nickname]
Devoices a selected nickname on a channel. If nickname is not given, devoices you. By default, limited to users with level 30 (VOP) access and above on the channel.
INVITE
<pre Syntax:
- INVITE channel
}}}
Tells ChanServ to invite you into the given channel. By default, limited to users with level 50 (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.
UNBAN
Syntax:
UNBAN channel
Tells ChanServ to remove all bans preventing you from entering the given channel. By default, limited to users with level 50 (AOP) access and above on the channel.
KICK
Syntax:
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 level 50 (AOP) access and above on the channel.
TOPIC
Syntax:
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 level 50 (AOP) access and above on the channel.
CLEAR
Syntax:
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 (only available if the IRC server supports ban exceptions).
INVITES
Clears all invite masks on the channel (only available if the IRC server supports invite masks).
OPS
Removes channel-operator status (mode +o) from all users.
HALFOPS
Removes halfop status (mode +h) from all users (only available if the IRC server supports halfops).
VOICES
Removes "voice" status (mode +v) from all users.
USERS
Removes (kicks) all users from the channel.
By default, limited to users with level 100 (SOP) access and above on the channel.
STATUS
Syntax:
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 level 100 (SOP) access and above on the channel.