The following is a command reference for NickServ, an IRC Network Service - see NetworkServices
Contents
REGISTER
Syntax:
REGISTER password [E-mail]
Registers your nickname in the NickServ database. Once your nickname is registered, you can use the SET and ACCESS commands to configure your nickname'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 nickname later. (Note that case matters! FIDO, Fido, and fido are all different passwords!)
You must include a Kent (i.e. yourlogin@kent.ac.uk) e-mail address when registering your nickname.
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. For security please DO NOT use your Kent Computing Account password, or any other important password - IRC is NOT encrypted.
IDENTIFY
Syntax:
IDENTIFY password
Tells NickServ that you are really the owner of this nickname. 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.
AUTH
Syntax:
AUTH code
Authenticates registration or change of E-mail for a nickname. To ensure that your E-mail address is correct, NickServ will send an message containing an authentication code to the E-mail address given when you register your nickname or change your E-mail address with the SET EMAIL command. This command allows you to confirm that you have received the message and continue using your nickname normally. Replace code in the command with the nine-digit authentication code given in the E-mail message.
SENDAUTH
Syntax:
SENDAUTH
Sends you a copy of the authentication code for your nickname after a REGISTER or SET EMAIL. If you accidentally delete or otherwise lose the message with the authentication code, you can use this command to have an extra copy sent to you.
To prevent abuse, this command may only be used once every 24 hours.
SETAUTH
Syntax:
SETAUTH nickname
Sets a new authentication code for the given nickname. The nickname's owner will have to use the AUTH command for the nickname before being allowed to identify again. If the nickname is currently in use, a notice will be sent to the user of the nickname and they will no longer be treated as identified for the nickname.
GETAUTH
Syntax:
GETAUTH nickname
Retrieves the authentication code associated with nickname, if one exists.
CLEARAUTH
Syntax:
CLEARAUTH nickname
Clears any authentication code associated with nickname, allowing the nickname to be used normally.
DROP
Syntax:
DROP password
De-registers (drops) your nickname from the NickServ database. A nickname that has been dropped is free for anyone to re-register.
To prevent accidental use of this command, you must enter your password in order to drop your nickname.
ACCESS
Syntax:
ACCESS ADD mask
ACCESS DEL mask
ACCESS LIST
Modifies or displays the access list for your nickname. This is the list of user@host addresses which will be automatically recognized by NickServ as allowed to use the nickname. If you connect to IRC with an address on this list, you will not be affected by the nick's SET KILL setting, and if the SET SECURE option is disabled, you will be able to receive auto-op and other privileges in channels without using the IDENTIFY command.
The mask given to the ADD and DELcommands may contain wildcards (* or ?).
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.
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
INFO
Set text to be displayed with the INFO command
KILL
Turn kill protection on or off
SECURE
Turn nickname security on or off
PRIVATE
Prevent your nickname from appearing in a /msg NickServ LIST
HIDE
Hide certain pieces of nickname information
TIMEZONE
Set the time zone to use for displaying times
MAINNICK
Set the nickname shown in channel access lists
In order to use this command, you must first identify with your password (/msg NickServ HELP IDENTIFY for more information).
For more information about each setting, type /msg NickServ HELP SET <TOPIC>
For example:
/msg NickServ HELP SET SECURE
UNSET
Syntax:
UNSET {URL | INFO}
Allows you to clear the URL (URL) or information text (INFO) associated with your nickname.
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 nickname.
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, causing the IRC servers to disconnect the other user. This fake user will remain online for one minute (by default, changeable with the NSReleaseTimeout option in modules.conf) to ensure that the other user does not immediately reconnect; after that time, you can reclaim your nick. Alternatively, use the RELEASE command to get the nick back sooner.
In order to use the RECOVER command for a nickname, you must supply the correct password for the nickname, or you must already have identified to a nick linked to the given nick.
- =
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. Holds last for one minute; this command gets rid of them sooner. In order to use the RELEASE command for a nickname, you must supply the correct password for the nickname, or you must already have identified to a nick linked to the given nick.
GHOST
Syntax:
GHOST nickname [password]
Terminates a "ghost" IRC session using your nickname. 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 nickname, you must supply the correct password for the nickname, or you must already have identified to a nick linked to the given nick.
INFO
Syntax:
INFO nickname [ALL]
Displays information about the given nickname, such as the nickname's owner, last seen address and time, and options. If you are identified for the nick you're getting information for and ALL is specified, you will be shown all the information, regardless of whether it's hidden or not.
If the nickname's E-mail address has not yet been confirmed with the AUTH command, it will not be shown to anyone except the nickname owner regardless of the nickname's SET HIDE EMAIL setting.
LISTCHANS
Syntax:
LISTCHANS
Lists the names and the total number of channels you have registered under your nickname.
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
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.