Ascends.Net Services

NickServ Command Reference

NickServ allows you to "register" a nickname and prevent others from using it. 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 /nickserv command. For more information on a specific command, type /nickserv HELP command.

REGISTER

Register a nickname

IDENTIFY

Identify yourself with your password

ACCESS

Modify the list of authorized addresses

LINK

Make your nick an alias for another

SET

Set options, including kill protection

DROP

Cancel the registration of a nickname

RECOVER

Kill another user who has taken your nick

RELEASE

Regain custody of your nick after RECOVER

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).

[Top]

REGISTER

Syntax:

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.

[Top]

IDENTIFY

Syntax:

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.

[Top]

DROP

Syntax:

DROP

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 (/nickserv HELP IDENTIFY for more information).

[Top]

ACCESS

Syntax:

ACCESS ADD mask
ACCESS DEL mask
ACCESS LIST

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.

Examples:

ACCESS ADD achurch@*.dragonfire.net

Allows access to user achurch from any machine in the dragonfire.net domain.

ACCESS DEL achurch@*.dragonfire.net

Reverses the previous command.

ACCESS LIST

Displays the current access list.

[Top]

LINK

Syntax:

LINK nick password

Links your nickname to another, effectively making the nick you are currently using an alias for the given nick. When you give this command, the access list for the nick you are using is deleted and replaced by that of the nick you are linking to; all memos for your current nick are added to the list of memos for the target nick (this may cause the nick to exceed its limit of memos, in which case you will need to delete some before you can receive more for either nick).

Once the link has been established, your nick will be transparently converted into the target nick everywhere in Services, except for the NickServ UNLINK and DROP commands. For example, you can use either nick to read the same set of memos (and memos sent to either nick will go into the same list). If you identify for one nick, you will automatically be identified for the other as well. If either nick is on a channel's access list, then both nicks will get the same access privileges.

In order to use this command, you must identify for your current nick (using the IDENTIFY command), and you must supply the password for the nick you wish to link to.

[Top]

UNLINK

Syntax:

UNLINK [nick pass]

Removes a link from your nick to another. When the link is removed, the nickname flags and access list of the previously linked nick are copied to your current nick and can then be independently changed. Memos are not copied; all memos will remain stored with the previously linked nick.

By giving a nickname and password as parameters, you can unlink a nick besides the one you are currently using.

[Top]

SET

Syntax:

SET option parameters

Sets various nickname options. option can be one of:

PASSWORD

Set your nickname password

LANGUAGE

Set the language Services will use when sending messages to you

URL

Associate a URL with your nickname

EMAIL

Associate an E-mail address with your nickname

KILL

Turn kill protection on or off

SECURE

Turn nickname security on or off

PRIVATE

Prevent your nickname from appearing in a /nickserv LIST

HIDE

Hide certain pieces of nickname information

Type /nickserv HELP SET option for more information on a specific option.

[Top]

SET PASSWORD

Syntax:

SET PASSWORD new-password

Changes the password used to identify you as the nick's owner.

[Top]

SET LANGUAGE

Syntax:

SET LANGUAGE number

Changes the language Services uses when sending messages to you (for example, when responding to a command you send). number should be chosen from the following list of supported languages:

[Top]

SET URL

Syntax:

SET URL url

Associates the given URL with your nickname. This URL will be displayed whenever someone requests information on your nick with the INFO command.

[Top]

SET EMAIL

Syntax:

SET EMAIL address

Associates the given E-mail address with your nickname. This address will be displayed whenever someone requests information on the channel with the INFO command.

[Top]

SET KILL

Syntax:

SET KILL {ON | QUICK | IMMED | OFF}

Turns the automatic kill protection option for your nick on or off. With kill protection on, if another user tries to take your nick, they will be given one minute to change to another nick, after which they will be forcibly removed from IRC by NickServ.

If you select QUICK, the user will be given only 20 seconds to change nicks instead of the usual 60. If you select IMMED, the user will be killed immediately without being warned first or given a chance to change their nick; please do not use this option unless necessary. Also, your network's administrators may have disabled this option.

[Top]

SET SECURE

Syntax:

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.

[Top]

SET PRIVATE

Syntax:

SET PRIVATE {ON | OFF}

Turns NickServ's privacy option on or off for your nick. With PRIVATE set, your nickname will not appear in nickname lists generated with NickServ's LIST command. (However, anyone who knows your nickname can still get information on it using the INFO command.)

[Top]

SET HIDE

Syntax:

SET HIDE {EMAIL | USERMASK | QUIT} {ON | OFF}

Allows you to prevent certain pieces of information from being displayed when someone does a NickServ INFO on your nick. You can hide your E-mail address (EMAIL), last seen user@host mask (USERMASK), and last quit message (QUIT). The second parameter specifies whether the information should be displayed (OFF) or hidden (ON).

[Top]

RECOVER

Syntax:

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 tries to use 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. This fake user will 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 (/nickserv HELP RELEASE) to get the nick back sooner.

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.

[Top]

RELEASE

Syntax:

RELEASE nickname [password]

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.

[Top]

GHOST

Syntax:

GHOST nickname [password]

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.

[Top]

INFO

Syntax:

INFO nickname

Displays information about the given nickname, such as the nick's owner, last seen address and time, and nick options.

[Top]

LIST

Syntax:

LIST pattern

Lists all registered nicknames which match the given pattern, in nick!user@host format. Nicks with the PRIVATE option set will not be displayed.

Examples:

LIST *!joeuser@foo.com

Lists all nicks owned by joeuser@foo.com.

LIST *Bot*!*@*

Lists all registered nicks with Bot in their names (case insensitive).

LIST *!*@*.bar.org

Lists all nicks owned by users in the bar.org domain.

[Top]

STATUS

Syntax:

STATUS nickname...

Returns whether the user using the given nickname is recognized as the owner of the nickname. The response has this format:

nickname status-code

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

ChanServ Command Reference

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 /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

CLEAR

[Top]

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, /nickserv HELP for information on how to do so.

[Top]

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.

[Top]

DROP

Syntax:

DROP channel

Unregisters the named channel. Can only be used by channel founder, who must use the IDENTIFY command first.

[Top]

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

TOPIC

Change the topic on the channel

KEEPTOPIC

Retain topic when channel is not in use

TOPICLOCK

Topic can only be changed with SET 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

Never de-op users except with DEOP command OPNOTICE Send a notice when OP/DEOP commands are used

[Top]

SET FOUNDER

Syntax:

SET channel FOUNDER nick

Changes the founder of a channel. The new nickname must be a registered one.

[Top]

SET SUCCESSOR

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 (0), the channel will be dropped instead, just as if no successor had been set. The new nickname must be a registered one.

[Top]

SET PASSWORD

Syntax:

SET channel PASSWORD password

Sets the password used to identify as the founder of the channel.

[Top]

SET URL

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. If no parameter is given, deletes any current URL for the channel.

[Top]

SET EMAIL

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. If no parameter is given, deletes any current E-mail address for the channel.

[Top]

SET ENTRYMSG

Syntax:

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.

[Top]

SET TOPIC

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.

[Top]

SET KEEPTOPIC

Syntax:

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.

[Top]

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.

[Top]

SET MLOCK

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.

[Top]

SET PRIVATE

Syntax:

SET channel PRIVATE {ON | OFF}

Enables or disables the private option for a channel. When private is set, a /chanserv LIST will not include the channel in any lists.

[Top]

SET RESTRICTED

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.

[Top]

SET SECURE

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 access to the channel as controlled by the access list.

[Top]

SET SECUREOPS

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.

[Top]

SET LEAVEOPS

Syntax:

SET channel LEAVEOPS {ON | OFF}

Enables or disables the leave ops option for a channel. When leave ops is set, ChanServ will never de-op a user in that channel except with the DEOP command.

[Top]

SET OPNOTICE

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.

[Top]

ACCESS

Syntax:

ACCESS channel ADD nick level
ACCESS channel DEL {nick | entry-num | list}
ACCESS channel LIST [mask | list]

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.

[Top]

ACCESS LEVELS

User access levels

By default, the following access levels are defined:

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.

3

Automatic voicing.

0

No special privileges; can be opped by other ops (unless secure-ops is set). <0 May not be opped.

[Top]

AKICK

Syntax:

AKICK channel ADD mask [reason]
AKICK channel DEL mask
AKICK channel LIST [mask]

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.

[Top]

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 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.

[Top]

INFO

Syntax:

INFO channel

Lists information about the named registered channel, including its founder, time of registration, last time used, description, and mode lock, if any.

[Top]

LIST

Syntax:

LIST pattern

Lists all registered channels matching the given pattern. (Channels with the PRIVATE option set are not listed.)

[Top]

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.

[Top]

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.

[Top]

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 greater than zero.

[Top]

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 greater than zero.

[Top]

CLEAR

Syntax:

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.

MemoServ Command Reference

MemoServ is a utility allowing IRC users to send short messages to other IRC users, whether they are online at the time or not, or to channels(*). Both the sender's nickname and the target nickname or channel must be registered in order to send a memo.

MemoServ's commands include:

SEND

Send a memo to a nick or channel

LIST

List your memos

READ

Read a memo or memos

DEL

Delete a memo or memos

SET

Set options related to memos

(*) By default, any user with at least level 10 access on a

channel can read that channel's memos. This can be changed with the NickServ LEVELS command.

[Top]

SEND

Syntax:

SEND {nick | channel} memo-text

Sends the named nick or channel a memo containing memo-text. When sending to a nickname, the recipient will receive a notice that he/she has a new memo. The target nickname/channel must be registered.

[Top]

LIST

Syntax:

LIST [channel] [list | NEW]

Lists any memos you currently have. With NEW, lists only new (unread) memos. Unread memos are marked with a "*" to the left of the memo number. You can also specify a list of numbers, as in the example below:

LIST 2-5,7-9 Lists memos numbered 2 through 5 and 7 through 9.

[Top]

READ

Syntax:

READ [channel] {num | list | LAST | NEW}

Sends you the text of the memos specified. If LAST is given, sends you the memo you most recently received. If NEW is given, sends you all of your new memos. Otherwise, sends you memo number num. You can also give a list of numbers, as in this example:

READ 2-5,7-9 Displays memos numbered 2 through 5 and 7 through 9.

[Top]

DEL

Syntax:

DEL [channel] {num | list | ALL}

Deletes the specified memo or memos. You can supply multiple memo numbers or ranges of numbers instead of a single number, as in the second example below.

If ALL is given, deletes all of your memos.

Examples:

DEL 1

Deletes your first memo.

DEL 2-5,7-9

Deletes memos numbered 2 through 5 and 7 through 9.

[Top]

SET

Syntax:

SET option parameters

Sets various memo options. option can be one of:

NOTIFY

Changes when you will be notified about new memos (only for nicknames)

LIMIT

Sets the maximum number of memos you can receive

[Top]

SET NOTIFY

Syntax:

SET NOTIFY {ON | LOGON | NEW | OFF}

Changes when you will be notified about new memos:

ON

You will be notified of memos when you log on, when you unset /AWAY, and when they are sent to you.

LOGON

You will only be notified of memos when you log on or when you unset /AWAY.

NEW

You will only be notified of memos when they are sent to you.

OFF

You will not receive any notification of memos.

[Top]

SET LIMIT

Syntax:

SET LIMIT [channel] limit

Sets the maximum number of memos you (or the given channel) are allowed to have. If you set this to 0, no one will be able to send any memos to you. However, you cannot set this any higher than 20.

[Top]

INFO

Syntax:

INFO [channel]

Displays information on the number of memos you have, how many of them are unread, and how many total memos you can receive. With a parameter, displays the same information for the given channel.