REGISTER Registering a channel
Syntax:
/msg Chanserv REGISTER #<channel> <password> <description>
Explanation: Registers a channel with ChanServ.
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 he/she enters the channel.
See the ACCESS command (/msg ChanServ HELP ACCESS) for information on giving
other users channel op's and co-founder access.
NOTICE: In order to register a channel, you must first register your nickname.
See the NickServ Help Section Below.
IDENTIFY Identify yourself with your password
Syntax:
/msg Chanserv IDENTIFY #<channel> <password>
Explanation: 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 Set channel options and information
Syntax:
/msg Chanserv SET #<channel> <option> <parameters>
Explanation: 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
Syntax:
/msg Chanserv SET #<channel> FOUNDER <nick>
Changes the founder of a channel. The new nickname must be a
registered one.
PASSWORD Set the founder password
Syntax:
/msg Chanserv SET #<channel> PASSWORD
Changes the password of a channel. You must be the founder to do this.
URL Set the channel homepage URL
Syntax:
/msg Chanserv SET #<channel> URL <description>
Sets the homepage URL for the channel, which shows up with the INFO
command.
DESC Set the channel description/greeting
Syntax:
/msg Chanserv SET #<channel> DESC <description>
Sets the description for the channel, which shows up with the LIST
and INFO command. To use the description as a greeting message to
each person who joins the channel, use:
SET #<channel> GREET ON|OFF
GREET Set channel greeting on or off
Syntax:
/msg Chanserv SET #<channel> GREET {ON or OFF}
Enables or disables ChanServ greeting new users when they join the
channel. To set the greeting message, use:
SET #<channel> DESC <description>
TOPIC Change the topic on a channel
Syntax:
/msg Chanserv SET #<channel> TOPIC <topic>
Causes ChanServ to set the channel topic to the one specified.
This command is most useful in conjunction with SET LOCKTOPIC.
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 (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:
/msg Chanserv 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.
/msg Chanserv 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".
/msg Chanserv 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 or 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 used.
TOPICLOCK Topic can only be changed with SET TOPIC
Syntax:
/msg Chanserv SET #<channel> TOPICLOCK {ON or 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.
PRIVATE Hide channel from ChanServ lists
Syntax:
/msg Chanserv SET #<channel> PRIVATE {ON or 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.
SECUREOPS Stricter control of chanop status
Syntax:
/msg Chanserv SET #<channel> SECUREOPS {ON or 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.
RESTRICTED Restricts access to channel
Syntax:
/msg Chanserv SET #<channel> RESTRICTED {ON or 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 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.
Note that the access list may only contain registered nicknames if
SECURE is set.
ACCESS Modify the list of privileged users
Explanation: 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.
Syntax:
/msg Chanserv ACCESS #<channel> ADD <mask> <level>
Adds the given nickname or usermask to the access list with the given user
level; if the nick or mask is already present on the list, its access level
is changed to the level specified in the command.
Syntax:
/msg Chanserv ACCESS #<channel> DEL {<mask> or <entry-num>}
Removes the given nick or mask from the access list.
Syntax:
/msg Chanserv ACCESS #<channel> LIST [mask]
Displays the access list; if a mask is given, only those entries matching the
mask are displayed.
Note: By default, any nick not on the access list has a user level of 0.
User access levels:
There are currently five distinct access levels available:
- Founder
Full access to ChanServ functions; automatic opping upon entering channel.
Note that only one person may have founder status (it cannot be given using
the ACCESS command).
- 10
Access to AKICK command; automatic opping.
- 5
Automatic opping.
- 0
No special privileges; can be opped by other ops (unless secure-ops is set)
- <0
May not be opped.
In addition, any user with access level greater than zero can add other users
to the access list, as long as the new entries are for levels less than the
user's own. So, for example, a level 10 user can add level 5 users, and
either a level 10 or a level 5 user can add negative-level users. Founders
can add users at any level they want.
AKICK Maintain the AutoKick list
Explanation: 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.
Syntax:
/msg Chanserv AKICK <channel> ADD <mask> [reason]
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".
Syntax:
/msg Chanserv AKICK <channel> DEL <mask>
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.
Syntax:
/msg Chanserv AKICK <channel> LIST [mask]
Displays the AutoKick list, or optionally only those AutoKick entries which
match the given mask.
DROP Cancel the registration of a channel
Syntax:
/msg Chanserv DROP #<channel>
Explanation: Unregisters the named channel. Can only be used by channel
founder, who must use the IDENTIFY command first.
CLEAR Reclaim channel if its taken over
Syntax:
/msg Chanserv CLEAR #<channel> <command>
Explanation: Tells ChanServ to clear certain settings on a channel.
These commands 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.
Your access level on the channel must be at least 10 to use this command.
UNBAN Remove all bans preventing you from entering your channel.
Syntax:
/msg Chanserv UNBAN #<channel>
Explanation: Tells ChanServ to remove all bans preventing you from entering the given
channel.
Only works if your access level on that channel is greater than zero.
LEVELS Allows founders to re assign access level values.
Explanation: 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.)
Syntax:
/msg Chanserv LEVELS #<channel> SET <type> <level>
Allows the access level for a function or group of functions to be changed.
Syntax:
/msg Chanserv LEVELS #<channel> {DIS or DISABLE} <type>
(or DIS for short) disables an automatic feature or disallows access to a
function by anyone other than the channel founder.
Syntax: /msg Chanserv LEVELS #<channel> LIST
Shows the current levels for each function or group of functions.
Syntax: /msg Chanserv LEVELS #<channel> RESET
Resets the levels to the default levels of a newly-created channel
(see ACCESS LEVELS).
The following feature/function names are understood. Note that the levels
for AUTODEOP and NOJOIN are maximum levels while all others are minimum levels.
AUTOOP: Automatic channel operator status
AUTOVOICE: Automatic mode +v
AUTODEOP: Channel operator status disallowed
NOJOIN: Not allowed to join channel if RESTRICTED
INVITE: Allowed to use INVITE command
AKICK: Allowed to use AKICK command
SET: Allowed to use SET command (not FOUNDER/PASSWORD)
CLEAR: Allowed to use CLEAR command
UNBAN: Allowed to use UNBAN command
OPDEOP: Allowed to use OP/DEOP commands
ACCESS: Allowed to use ACCESS command
INFO
Syntax:
/msg Chanserv INFO #<channel>
Explanation: Lists information about the named registered channel, including
its founder, time of registration, last time used, description, and mode lock,
if any.
LIST
Syntax:
/msg Chanserv LIST <mask>
Explanation: Lists all registered channels matching the given mask. (Channels
with the PRIVATE option set are not listed, of course.)
INVITE
Syntax:
/msg Chanserv INVITE #<channel>
Explanation: Tells ChanServ to invite you into the given channel. Only works
if your access level on that channel is greater than zero.
OP/DEOP
Syntax:
/msg Chanserv OP #<channel> <nick>
Explanation: Ops a selected nick on a channel. Limited to those with level
five access and above on said channel.
Syntax:
/msg Chanserv DEOP #<channel> <nick>
Explanation: Deops a selected nick on a channel. Limited to those with level
five access and above on said channel.
Note: Any channel which is not used for two weeks (i.e. which no user on the
channel's access list enters for that period of time) will be automatically
dropped.
|
NickServ allows you to "register" a nickname and prevent others from using
them. If the nick is not used for 30 days, the registration will expire.
The following commands allow for registration and maintenance of nicknames;
to use them, type /msg NickServ <command>.
REGISTER Register a nickname
Syntax:
/msg Nickserv REGISTER <password>
Registers your nickname in the NickServ database. Once your nick is
registered, you can use the SET and ACCESS commands to configure your nick's
settings as you like them. Make sure you remember the password you use when
registering - you'll need it to make changes to your nick later.
(Note that case matters! FIDO, Fido, and fido are all different passwords!)
Guidelines on choosing passwords:
Passwords should not be easily guessable. For example, using your real name
as a password is a bad idea. Using your nickname as a password is a much
worse idea ;) and, in fact, NickServ will not allow it. Also, short passwords
are vulnerable to trial-and-error searches, so you should choose a password at
least 5 characters long. Finally, the space character cannot be used in
passwords.
IDENTIFY Identify yourself with your password
Syntax:
/msg Nickserv IDENTIFY password
Tells NickServ that you are really the owner of this nick. Many commands
require you to authenticate yourself with this command before you use them.
The password should be the same one you sent with the REGISTER command.
ACCESS Modify the list of authorized addresses
Explanation: Modifies or displays the access list for your nick. This is the
list of addresses which will be automatically recognized by NickServ as allowed
to use the nick. If you want to use the nick from a different address, you
need to send an IDENTIFY command to make NickServ recognize you.
Syntax:
/msg Nickserv ACCESS ADD [mask]
Adds your current hostname to you access list.
Example:
/msg Nickserv ACCESS ADD achurch@*.dragonfire.net
Allows access to user achurch from any machine in the dragonfire.net domain.
Syntax:
/msg Nickserv ACCESS DEL mask
Example:
/msg Nickserv ACCESS DEL achurch@*.dragonfire.net
Reverses the previous command.
Syntax:
/msg Nickserv ACCESS LIST
Displays the current access list.
SET Set options, including kill protection
Syntax:
/msg Nickserv SET option parameters
Sets various nickname options. The option can be one of:
KILL Turn kill protection on or off
Syntax:
/msg Nickserv SET KILL
Turns the automatic protection option for your nick on or off.
With kill protection on, if another user tries to use your nick they
will be given one minute to change to another nick. After which their
nick will be forcibly changed by NickServ.
SECURE Turn nickname security on or off
Syntax:
/msg Nickserv SET SECURE {ON|OFF}
Turns NickServ's security features on or off for your nick.
With SECURE set, you must enter your password before you will be
recognized as the owner of the nick, regardless of whether your
address is on the access list. However, if you are on the access
list, NickServ will not auto-kill you regardless of the setting of
the KILL option.
PASSWORD Set your nickname password
Syntax:
SET PASSWORD new-password
Changes the password used to identify you as the nick's owner.
In order to use these commands, you must first identify with your password.
DROP Cancel the registration of a nickname
Syntax:
/msg Nickserv DROP [nickname]
Drops your nickname from the NickServ database. A nick that has been dropped
is free for anyone to re-register.
In order to use this command, you must first identify with your password.
RECOVER Kill another user who has taken your nick
Syntax:
/msg Nickserv RECOVER nickname [password]
Allows you to recover your nickname if someone else has taken it; this does
the same thing that NickServ does automatically if someone steals a
kill-protected nick.
When you give this command, NickServ will bring a fake user online with the
same nickname as the user you're trying to recover your nick from.
This causes the IRC servers to disconnect the other user. NickServ's fake
user will remain online for one minute to ensure that the other user does not
immediately reconnect; after that minute, you can reclaim your nick.
Alternatively, use the RELEASE command to get the nick back sooner.
NOTE: In order to use the RECOVER command for a nick, your current address as
shown in /WHOIS must be on that nick's access list, or you must supply the
correct password for the nickname.
RELEASE Regain custody of your nick after RECOVER
Syntax:
/msg Nickserv RELEASE nickname
Instructs NickServ to remove any hold on your nickname caused by automatic
kill protection or use of the RECOVER command. By default, such holds last
for one minute; this command gets rid of them sooner.
In order to use the RELEASE command for a nick, your current address as shown
in /WHOIS must be on that nick's access list, or you must supply the correct
password for the nickname.
GHOST
Syntax:
/msg Nickserv GHOST nickname
Terminates a "ghost" IRC session using your nick. A "ghost" session is one
which is not actually connected, but which the IRC server believes is still
online for one reason or another. Typically, this happens if your computer
crashes or your Internet or modem connection goes down while you're on IRC.
In order to use the GHOST command for a nick, your current address as shown
in /WHOIS must be on that nick's access list, or you must supply the correct
password for the nickname.
INFO
Syntax:
/msg Nickserv INFO nickname
Displays information about the given nickname, such as the nick's owner, last
seen address and time, and nick options.
LIST
Syntax:
/msg Nickserv LIST <hostmask>
Lists all registered nicknames which match the given pattern, in
nick!user@host format.
Examples:
/msg Nickserv LIST *!joeuser@foo.com
Lists all nicks owned by joeuser@foo.com.
/msg Nickserv LIST *Bot*!*
Lists all registered nicks with Bot in their names (case insensitive).
/msg Nickserv LIST *!*@*.bar.org
Lists all nicks owned by users in the bar.org domain.
STATUS
Syntax:
/msg Nickserv STATUS
Returns whether the user using the given nickname is recognized as the owner
of the nickname.
The response has this format:
nickname status-code
where nickname is the nickname sent with the command, and status-code is one
of the following:
0 - no such user online or nickname not registered
1 - user not recognized as nickname's owner
2 - user recognized as owner via access list only
3 - user recognized as owner via password identification
Up to sixteen nicknames may be sent with each command; the rest will be
ignored. No error message is generated if no nickname is given.
NOTICE: This service is intended to provide a way for IRC users to ensure
their identity is not compromised. It is NOT intended to facilitate "stealing"
of nicknames or other malicious actions. Abuse of NickServ will result in, at
minimum, loss of the abused nickname(s).
|
