|
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 priviliges. Available commands are listed below; to use them, type /msg ChanServ command. For more information on a specific command, type /msg ChanServ HELP command.
REGISTER Register a channel IDENTIFY Identify yourself with your password SET Set channel options and information ACCESS Modify the list of privileged users LEVELS Redefine the meanings of access levels AKICK Maintain the AutoKick list DROP Cancel the registration of a channel SENDPASS Help retrive lost passwords
Other commands: BAN, CLEAR, CLIST, DEOP, DEVOICE, GETKEY, INFO, INVITE, KICK, LIST, LOGOUT, OP, TOPIC, UNBAN, VOICE, DEHALFOP, DEOWNER, DEPROTECT, HALFOP, OWNER, PROTECT 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. REGISTER Syntax: /msg ChanServ 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 others 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. IDENTIFY Syntax: /msg ChanServ 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. SET Syntax: /msg ChanServ SET option parameters
Allows the channel founder to set various channel options and other options. Available options:
FOUNDER Set the founder of a channel Syntax: /msg ChanServ SET channel Founder nick
Changes the founder of a channel. The new nickname must be a registered one.
SUCCESSOR Set the successor for a channel Syntax: /msg ChanServ 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 (15), the channel will be dropped instead, just as if no successor had been set. The new nickname must be a registered one.
PASSWORD Set the founder password Syntax: /msg ChanServ SET channel PASSWORD password
Sets the password used to identify as the founder of the channel
DESC Set the channel description Syntax: /msg ChanServ SET channel DESC description
Sets the description for the channel, which shows up with the LIST and INFO commands.
URL Associate a URL with the channel Syntax: /msg ChanServ SET channel URL [url]
Associates the given URL with the channel. This URL will be displayed whenever someone requests information on the with the INFO command. If no parameter is given, deletes any current URL for the channel.
EMAIL Associate an E-mail address with the channel Syntax: /msg ChanServ 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. If no parameter is given, deletes any current E-mail address for the channel.
ENTRYMSG Set a message to be sent to users when they enter the channel Syntax: /msg ChanServ SET channel ENTRYMSG [message]
Sets the message which will be sent via /notice to users when they enter the channel. If no parameter is given, causes no message to be sent upon entering the channel.
BANTYPE Set how Services make bans on the channel Syntax: /msg ChanServ SET channel BANTYPE bantype
Sets the ban type that will be used by services whenever they need to ban someone from your channel.
bantype is a number between 0 and 3 that means: 0: ban in the form *!user@host 1: ban in the form *!*user@host 2: ban in the form *!*@host 3: ban in the form *!*user@*.domain
MLOCK Lock channel modes on or off Syntax: /msg ChanServ SET channel MLOCK modes
Sets the mode-lock parameter for the channel. ChanServ allows you to define certain channel modes to be always on, off or free to be either on or off.
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. Note, however, that unlike the /MODE command, each use of SET MLOCK will remove all modes previously locked before setting the new!
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.
KEEPTOPIC Retain topic when channel is not in use Syntax: /msg ChanServ SET channel KEEPTOPIC {ON | OFF}
Enables or disables the topic retention option for a channel. 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.
OPNOTICE Send a notice when OP/DEOP commands are used Syntax: /msg ChanServ 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.
PEACE Regulate the use of critical commands Syntax: /msg ChanServ SET channel PEACE {ON | OFF}
Enables or disables the peace option for a channel. When peace is set, an user won't be able to kick, ban or remove a channel status of an user that has a level superior or equal to his via ChanServ commands.
PRIVATE Hide channel from LIST command Syntax: /msg ChanServ 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.
RESTRICTED Restrict access to the channel Syntax: /msg ChanServ 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.
SECURE Activate ChanServ security features Syntax: /msg ChanServ 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 access to the channel as controlled by the access list.
SECUREOPS Stricter control of chanop status Syntax: /msg ChanServ 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.
SECUREFOUNDER Stricter control of channel founder status Syntax: /msg ChanServ SET channel SECUREFOUNDER {ON | OFF}
Enables or disables the secure founder option for a channel. When secure founder is set, only the real founder will be able to drop the channel, change its password, its founder and its successor, and not those who are IDENTIFY'd with ChanServ.
SIGNKICK Sign kicks that are done with KICK command Syntax: /msg ChanServ SET channel SIGNKICK {ON | LEVEL | OFF}
Enables or disables signed kicks for a channel. When SIGNKICK is set, kicks issued with ChanServ KICK command 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. See /msg ChanServ HELP LEVELS for more information.
TOPICLOCK Topic can only be changed with TOPIC Syntax: /msg ChanServ 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 TOPIC command.
Type /msg ChanServ HELP option for more information on a particular option.
ACCESS Syntax: /msg ChanServ ACCESS channel ADD nick level, /msg ChanServ ACCESS channel DEL {nick | entry-num | list}, /msg ChanServ ACCESS channel LIST [mask | list], /msg ChanServ ACCESS channel CLEAR
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.
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 CLEAR command clears all entries of the access list.
LEVELS Syntax: /msg ChanServ LEVELS channel SET type level, /msg ChanServ LEVELS channel {DIS | DISABLE} type, /msg ChanServ LEVELS channel LIST, /msg ChanServ LEVELS channel RESET
The LEVELS command allows fine control over the meaning of the numeric access levels used for channels. 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: /msg ChanServ AKICK channel ADD [+expiry] {mask | nick} [reason], /msg ChanServ AKICK channel STICK mask, /msg ChanServ AKICK channel UNSTICK mask, /msg ChanServ AKICK channel DEL {mask| entry-num | list}, /msg ChanServ AKICK channel LIST [mask |list], /msg ChanServ VIEW [mask | list], /msg ChanServ AKICK channel ENFORCE, /msg ChanServ AKICK channel CLEAR
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. expiry is specified as an integer followed by one of w (weeks), d (days), h (hours), or m (minutes). Combinations (such as 1h30m) are allowed. To add an AutoKick which does not expire, leave that parameter out. If a reason is given with the command, that reason will be used when the user is kicked; if not, a default reason message is used.
The AKICK STICK command permanently bans the given mask on the channel. If someone tries to remove the ban, ChanServ will automatically set it again. You can stick usermasks only, not registered nicks.
The AKICK UNSTICK command cancels the effect of the AKICK STICK command, letting any operator on the channel remove the ban.
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. If a list of entry numbers is given, those entries are deleted. (See the example for LIST below.)
The AKICK LIST command displays the AutoKick 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: AKICK #channel LIST 2-5,7-9 Lists AutoKick entries numbered 2 through 5 and 7 through 9.
The AKICK VIEW command is a more verbose version of AKICK LIST command.
The AKICK ENFORCE command causes ChanServ to enforce the current AKICK list by removing those users who match an AKICK mask.
The AKICK CLEAR command clears all entries of the akick list.
DROP Syntax: /msg ChanServ DROP channel
Unregisters the named channel Only services admins can drop a channel for which they have not identified.
SENDPASS Syntax: /msg ChanServ SENDPASS channel
Send the password of the given channel to the e-mail address set in the founder's nickname record. This command is really useful to deal with lost passwords.
May be limited to IRC operators on certain networks.
This command is unavailable when encryption is enabled and it is impossible to generate a password through OpenSSL.
CLIST Syntax: /msg ChanServ CLIST [privilege]
Lists channels where you have the given privilege.
Usage examples: CLIST Lists all channels where you have privileges.
CLIST FOUNDER
Lists all channels where are the founder.
CLIST SUCCESSOR
Lists all channels where you are the successor.
CLIST 3
Lists all channels where you have access level 3 or more.
CLIST -1
Lists all channels where you have access level -1 or less.
PROTECT Syntax: /msg ChanServ PROTECT [#channel [nick]]
Protects a selected nick on a channel. If nick is not given, it will protect you. If channel and nick are not given, it will protect you on all channels you're on, provided you have the rights to.
By default, limited to the founder, or to those with level 10 and above on the channel for self protecting.
GETKEY Syntax: /msg ChanServ GETKEY channel
Returns the key of the given channel. This is a command mainly intended to be used by bots and/or scripts, so the output is in the following way:
KEY <channel> <key>
Key is "NO KEY" if no key is set.
CLEAR Syntax: /msg ChanServ CLEAR channel what
Tells ChanServ to clear certain settings on a channel. what can be any of the following:
MODES Resets all modes on the channel (i.e. clears modes i,k,l,m,n,p,s,t). BANS Clears all bans on the channel. OPS Removes channel-operator status (mode +o) from all channel operators. VOICES Removes "voice" status (mode +v) from anyone with that mode set. USERS Removes (kicks) all users from the channel.
By default, limited to those with founder access on the channel.
LIST Syntax: /msg ChanServ LIST [[pattern] [range] [NOLIMIT] [NOEXPIRE]]
Lists all registered channels. Channels with the PRIVATE option set will not be displayed. If pattern is given, only channels with a matching mask are displayed. The number of results shown at once is limited; you may specify a range to see results past this limit. For example:
LIST 51-100 Shows results 51 to 100.
LIST *help* 15-20 Shows results 15 to 20 whose name contains "help".
(Note: unlike numbered lists, it is not possible to use extended syntax such as 51-60,75-80).
If a pattern or range is given, specifying the NOLIMIT option shows an unlimited number of results.
LOGOUT Syntax: /msg ChanServ LOGOUT channel [nickname]
This command makes the selected nickname not identified anymore for the given channel.
If you are the founder of the channel, you can log out anybody, else you can only log out yourself.
|