CHANSERV COMMANDS
This is an html version of the Chanserv Help notices for IrCQNet, Unreal ircd, version 3.1.4. It has been slightly edited for better readability.
 
ChanServ allows you to register and control various aspects of channels. ChanServ can often prevent malicious users from "taking over" channels by limiting who is allowed channel operator privileges.
 
Available commands are listed below; to use them, type /msg ChanServ command. For more information on a specific command, type /msg ChanServ HELP command.
 
ACCESS Maintain the overall channel access list
AKICK Maintain the AutoKick list
AOP Maintain the AutoOp list
CLEAR Clears modes, bans, users
DEHALFOP Remote dehalfop
DEOP Remote deop
DEPROTECT Removes +a from a user
DEVOICE Remote devoice
DROP Cancel the registration of a channel
HALFOP Remote halfoping
HOP Maintain the AutoKick list
IDENTIFY Identify channels with your password
INFO Show channel options and information
INVITE Invites you to a channel
LEVELS Maintain the level list
LIST Lists channels
OP Remote oping
PROTECT Gives +a to a user
REGISTER Register a channel
SET  Set channel options and information 
SOP  Maintain the SuperOp list  
UNBAN  Removes bans  
UNSET  Unsets selected settings  
VOICE  Remote voicing  
VOP  Maintain the AutoVoice list  
 
Note that any channel which is not used for 14 days (i.e. which no user on the channel's access list enters for that period of time) will be automatically dropped.
 
 
ACCESS
Syntax: ACCESS channel ADD nick level
  ACCESS channel DEL {nick | 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 nick not on the access list has a user level of 0.
  Note that the access list may also be manipulated with the SOP, AOP, and VOP commands, which correspond to levels of 10, 5, and 3 respectively.
  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 nick 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.
 
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 nick or usermask 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 nick or 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 simply shows more details.
  The AKICK ENFORCE command causes ChanServ to enforce the current AKICK list by removing those users who match an AKICK mask.
  The AKICK COUNT command returns how many entries there are on the AutoKick list.
 
AOP
Syntax: AOP channel ADD nick
  AOP channel DEL nick
  AOP channel LIST [mask | list]
  AOP channel COUNT
  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.
  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; for example:
  AOP #channel LIST 2-5,7-9 Lists AOP list entries numbered 2 through 5 and 7 through 9
  The AOP COUNT command returns the number of entries there are on the AOP list.
 
CLEAR
Syntax: CLEAR channel what
  Tells ChanServ to clear certain settings on a channel. what can be any of the following:
 
BANS Clears all bans on the channel.
EXCEPTIONS Clears all exceptions on the channel.
HALFOPS Removes halfop status (mode +h) from all users.
MODES Clears all modes on the channel except those set in the channel's mode lock.
OPS Removes channel-operator status (mode +o) from all users.
USERS Removes (kicks) all users from the channel.
VOICES Removes "voice" status (mode +v) from all users.
  By default, your access level on the channel must be at least 10 to use this command.
 
DEHALFOP
Syntax: DEHALFOP #channel nick
  Removes halfop access from a selected nick on a channel. By default, limited to those with level 4 access and above on the channel.
 
DEOP
Syntax: DEOP #channel nick
  Deops a selected nick on a channel. By default, limited to those with level 5 access and above on the channel.
 
DEPROTECT
Syntax: DEPROTECT #channel nick
  Removes channel protection (mode +a) from a selected nick on a channel. By default, limited to those with level 10 access and above on the channel.
 
DEVOICE
Syntax: DEVOICE #channel nick
  Devoices a selected nick on a channel. By default, limited to those with level 3 access and above on the channel.
 
DROP
Syntax: DROP channel
  Unregisters the named channel. Can only be used by channel founder, who must use the IDENTIFY command first.
 
HALFOP
Syntax: HALFOP #channel nick
  Gives halfop access to a selected nick on a channel. By default, limited to those with level 4 access and above on the channel.
 
HOP
Syntax: HOP channel ADD nick
  HOP channel DEL nick
  HOP channel LIST [mask | list]
  HOP channel COUNT
  Maintains the HalfOp (HOP) list for a channel. Users with HOP status are automatically halfopped (set mode +h) when they join the channel.
  An HOP can modify the VOP list; SOPs and AOPs can modify the HOP list.
  The HOP LIST command displays the HOP 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: HOP #channel LIST 2-5,7-9
Lists HOP list entries numbered 2 through 5 and 7 through 9.
  The HOP COUNT command returns the number of entries there are on the HOP list.
 
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.
 
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.
 
INVITE
Syntax: INVITE channel
  Tells ChanServ to invite you into the given channel. By default, only works if your access level on that channel is at least 5.
 
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 tothe channel founder.)
  Caution: This command is for advanced users only! Changing level settings with this command may cause the SOP, AOP, and VOP 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 (seeHELP ACCESS LEVELS).
  The following is a list of the features and functions whose levels can be set:
 
ACC-LIST Allowed to view the access list
ACC-CHANGE Allowed to modify the access list
AKICK Allowed to use AKICK command
AUTODEOP Channel operator/halfop status disallowed
AUTOHALFOP Automatic halfop (+h) status
AUTOOP Automatic channel operator status
AUTOPROTECT Automatic channel protect (+a) status
AUTOVOICE Automatic mode +v
CLEAR Allowed to use CLEAR command
HALFOP Allowed to use HALFOP/DEHALFOP commands
INVITE Allowed to use INVITE command
MEMO Allowed to list/read channel memos
NOJOIN Not allowed to join channel if RESTRICTED
OP-DEOP Allowed to use OP/DEOP commands
PROTECT Allowed to use PROTECT/DEPROTECT commands
SET Allowed to use SET command (not FOUNDER/PASSWORD)
UNBAN Allowed to use UNBAN command
VOICE Allowed to use VOICE/DEVOICE commands
  Note that the levels for AUTODEOP and NOJOIN are maximum levels, while all others are minimum levels.
 
LIST
Syntax: LIST pattern
  Lists all registered channels matching the given pattern. (Channels with the PRIVATE option set are not listed.)
 
OP
Syntax: OP #channel nick
  Ops a selected nick on a channel. By default, limited to those with level 5 access and above on the channel.
 
PROTECT
Syntax: PROTECT #channel nick
  Gives channel protection (mode +a) to a selected nick on a channel. By default, limited to those with level 10 access and above on the channel.
 
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 your nickname. If you haven't, /msg NickServ HELP for information on how to do so.
 
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:
 
DESC Set the channel description
EMAIL Associate an E-mail address with the channel
ENFORCE Enforce auto-op, auto-voice status
ENTRYMSG Set a message to be sent to users when they enter the channel 
FOUNDER Set the founder of a channel
KEEPTOPIC Retain topic when channel is not in use
LEAVEOPS Do not de-op users on channel entry
MLOCK Lock channel modes on or off
OPNOTICE Send a notice when OP/DEOP commands are used
PASSWORD Set the founder password
PRIVATE Hide channel from LIST command
RESTRICTED Restrict access to the channel
SECURE Activate ChanServ security features
SECUREOPS Stricter control of chanop status
SUCCESSOR Set the successor for a channel
TOPIC Change the topic on the channel
TOPICLOCK Topic can only be changed with SET TOPIC
URL Associate a URL with the channel
  Type /msg ChanServ HELP option for more information on a particular option.
Syntax: SET channel DESC description
  Sets the description for the channel, which shows up with the LIST and INFO commands.
Syntax: SET channel EMAIL address
  Associates the given E-mail address with the channel. This address will be displayed whenever someone requests information on the channel with the INFO command.
Syntax: SET channel ENFORCE {ON | OFF}
  Enables or disables the enforce option for a channel. When enforce is set, ChanServ will enforce the auto-op and auto-voice levels for all users. For example, if a user with auto-op privileges is deopped, ChanServ will automatically op the user again, and ChanServ will also not allow the DEOP command to be used on that user.
Syntax: SET channel ENTRYMSG message
  Sets the message which will be sent via /notice to users when they enter the channel.
Syntax: SET channel FOUNDER nick
  Changes the founder of a channel. The new nickname must be a registered one.
Syntax: SET channel KEEPTOPIC {ON | OFF}
  Enables or disables the topic retention option for achannel. When topic retention is set, the topic for the channel will be remembered by ChanServ even after the last user leaves the channel, and will be restored the next time the channel is created.
Syntax: SET channel LEAVEOPS {ON | OFF}
  Enables or disables the leave ops option for a channel. When leave ops is set, ChanServ will leave server ops (+o for the first person in the channel) in place even if the user would not normally get auto-opped. The SECUREOPS option and AUTODEOP access level will still be enforced.
  Notice: This can allow users to "steal" ops during a netsplit.
Syntax: SET channel MLOCK modes
  Sets the mode-lock parameter for the channel. ChanServ allows you to define certain channel modes to be always on (or off). The modes that can be locked are i, k, l, m, n, p, s, and t; each of these modes can be locked on, locked off, or not locked. The modes parameter is constructed exactly the same way as a /MODE command; that is, modes followed by a + are locked on, and modes followed by a - are locked off.
  Warning: If you set a mode-locked key, as in the second example below, you should also set the RESTRICTED option for the channel (see HELP SET RESTRICTED), or anyone entering the channel when it is empty will be able to see the key!
  Examples:
  SET #channel MLOCK +nt-iklps Forces modes n and t on, and modes i, k, l, p, and s off. Mode m is left free to be either on or off.
  SET #channel MLOCK +knst-ilmp my-key Forces modes k, n, s, and t on, and modes i, l, m, and p off. Also forces the channel key to be "my-key".
  SET #channel MLOCK + Removes the mode lock; all channel modes are free to be either on or off.
Syntax: SET channel OPNOTICE {ON | OFF}
  Enables or disables the op-notice option for a channel. When op-notice is set, ChanServ will send a notice to the channel whenever the OP or DEOP commands are used for a user in the channel.
Syntax: SET channel PASSWORD password
  Sets the password used to identify as the founder of thechannel.
Syntax: SET channel PRIVATE {ON | OFF}
  Enables or disables the private option for a channel. When private is set, a /msg ChanServ LIST will not include the channel in any lists.
Syntax: SET channel RESTRICTED {ON | OFF}
  Enables or disables the restricted access option for a channel. When restricted access is set, users who would normally be disallowed from having channel operator privileges (users with negative access levels and, if secure ops is set, users not on the access list) will instead be kicked and banned from the channel.
Syntax: SET channel SECURE {ON | OFF}
  Enables or disables ChanServ's security features for a channel. When SECURE is set, only users who have registered their nicknames with NickServ and IDENTIFY'd with their password will be given privileges on the channel as controlled by the access list.
Syntax: SET channel SECUREOPS {ON | OFF}
  Enables or disables the secure ops option for a channel. When secure ops is set, users who are not on the userlist will not be allowed chanop status.
Syntax: SET channel SUCCESSOR nick
  Changes the successor of a channel. If the founder's nickname expires or is dropped while the channel is still registered, the successor will become the new founder of the channel. However, if the successor already has too many channels registered (500), the channel will be dropped instead, just as if no successor had been set. The new nickname must be a registered one.
Syntax: SET channel TOPIC topic
  Causes ChanServ to set the channel topic to the one specified. This command is most useful in conjunction with SET TOPICLOCK.
Syntax: SET channel TOPICLOCK {ON | OFF}
  Enables or disables the topic lock option for a channel. When topic lock is set, ChanServ will not allow the channel topic to be changed except via the SET TOPIC command.
Syntax: SET channel URL url
  Associates the given URL with the channel. This URL will be displayed whenever someone requests information on the channel with the INFO command.
 
SOP
Syntax: SOP channel ADD nick
  SOP channel DEL nick
  SOP channel LIST [mask | list]
  SOP channel COUNT
  Maintains the SuperOp (SOP) list for a channel. Users with SOP status are automatically opped (set mode +o) and protected (mode +a) 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; for example:
  SOP #channel LIST 2-5,7-9 Lists SOP list entries numbered 2 through 5 and 7 through 9.
  The SOP COUNT command returns the number of entries there are on the SOP list.
 
UNBAN
Syntax: UNBAN channel
  Tells ChanServ to remove all bans preventing you from entering the given channel. By default, only works if your access level on that channel is at least 5.
 
UNSET
Syntax: UNSET channel {SUCCESSOR | URL | EMAIL | ENTRYMSG}
  Clears the given setting for a channel.
 
VOICE
Syntax: VOICE #channel nick
  Voices a selected nick on a channel. By default, limited to those with level 3 access and above on the channel.
 
VOP
Syntax: VOP channel ADD nick
  VOP channel DEL nick
  VOP channel LIST [mask | list]
  VOP channel COUNT
  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; for example:
  VOP #channel LIST 2-5,7-9 Lists VOP list entries numbered 2 through 5 and 7 through 9.
  The VOP COUNT command returns the number of entries there are on the VOP list.
 
© 2000-2004
All rights reserved.