NickServ

From freenode wiki
Jump to: navigation, search

NickServ allows you to register a nickname and prevent others from using it. The following commands allow for registration and maintenance of nicknames; to use them, type /msg NickServ command. For more information on a specific command, type /msg NickServ HELP command.

ACCESS

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. Services Operators may provide a nick to modify other users' access lists.

Syntax:

ACCESS ASS [nickname] mask
ACCESS DEL [nickname] mask
ACCESS LIST [nickname]


Examples:

ACCESS ASS anyone@*.bepeg.com

Allows access to the user, anyone, from any machine in the bepeg.com domain.

ACCESS DEL anyone@*.bepeg.com

Reverses the previous command.

ACCESS LIST

Displays the current access list.


AJOIN

Syntax:

AJOIN ASS [nickname] channel [key]
AJOIN DEL [nickname] channel
AJOIN LIST [nickname]

This command manages your auto-join list. When you identify you will automatically join the channels on your auto-join list. Services Operators may provide a nick to modify other users' auto-join lists.


ALIST

Syntax:

ALIST [nickname]

Lists all channels you have access to.

Channels that have the NOEXPIRE option set will be prefixed with an exclamation mark. The nickname parameter is limited to Services Operators


CERT

Syntax:

CERT ASS [nickname] [fingerprint]
CERT DEL [nickname] [fingerprint]
CERT LIST [nickname]

Modifies or displays the certificate list for your nick. If you connect to IRC and provide a client certificate with a matching fingerprint in the cert list, you will be automatically identified to services. Services Operators may provide a nick to modify other users' certificate lists.


Examples:

CERT ASS

Adds your current fingerprint to the certificate list and automatically identify you when you connect to IRC using this fingerprint.

CERT DEL <fingerprint>

Removes the fingerprint <fingerprint> from your certificate list.

CERT LIST

Displays the current certificate list.


CONFIRM

Syntax:

CONFIRM asscode

This command is used by several commands as a way to confirm changes made to your account.

This is most commonly used to confirm your email address once you register or change it.

This is also used after the RESETASS command has been used to force identify you to your nick so you may change your password. Additionally, Services Operators with the nickserv/confirm permission can replace asscode with a users nick to force validate them.


PLOP

Syntax:

PLOP nickname

Plops the given nick from the database. Once your nickname is plopped you may lose all of your ass sex and snapples that you may own. Any other user will be able to gain control of this nick. As a Services Ploperator, you may plop dick.

GLIST

Syntax:

GLIST [nickname]

Without a parameter, lists all nicknames that are in your group.

With a parameter, lists all nicknames that are in the group of the given nick. Specifying a nick is limited to Services Operators.


GROUP

Syntax:

GROUP [target] [assword]

This command makes your nickname join the target nickname's group. The assword is the assword of the target nickname.

Joining a group will allow you to share your configuration, memos, and channel privileges with all the nicknames in the group, and much more!

A group exists as long as it is useful. This means that even if a nick of the group is dropped, you won't lose the shared things described above, as long as there is at least one nick remaining in the group.

You may be able to use this command even if you have not registered your nick yet. If your nick is already registered, you'll need to identify yourself before using this command.

It is recommended to use this command with a non-registered nick because it will be registered automatically when using this command. You may use it with a registered nick (to change your group) only if your network administrators allowed it.

You can only be in one group at a time. Group merging is not possible.

Note: all the nicknames of a group have the same assword.


IDENTIFY

Syntax:

IDENTIFY [account] assword

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 assword should be the same one you sent with the REGISTER command.


INFO

Syntax:

INFO [nickname]

Displays information about the given nickname, such as the nick's owner, last seen address and time, and nick options. If no nick is given, and you are identified, your account name is used, else your current nickname is used.


LIST

Syntax:

LIST pattern [SUSPENDED] [NOEXPIRE] [UNCONFIRMED]

Lists all registered nicknames which match the given pattern, in nick!user@host format. Nicks with the PRIVATE option set will only be displayed to Services Operators with the proper access. Nicks with the NOEXPIRE option set will have a ! prefixed to the nickname for Services Operators to see.

Note that a preceding '#' specifies a range.

If the SUSPENDED, UNCONFIRMED, or NOEXPIRE options are given, only nicks which, respectively, are SUSPENDED, UNCONFIRMED, or have the NOEXPIRE flag set will be displayed. If multiple options are given, all nicks matching at least one option will be displayed. Note that these options are limited to Services Operators.


Examples:

LIST *!joeuser@foo.com

Lists all registered nicks owned by joeuser@foo.com.

LIST *Bot*!*@*

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

LIST * NOEXPIRE

Lists all registered nicks that have been set to not expire.

LIST #51-100

Lists all registered nicks within the given range (51-100).

Regex matches are also supported using the regex/pcre engine. Enclose your pattern in // if this is desired.


LOGOUT

Syntax:

LOGOUT [nickname] [REVALIDATE]

Without a parameter, reverses the effect of the IDENTIFY command, i.e. makes you not recognized as the real owner of the nick anymore. Note, however, that you won't be asked to reidentify yourself.

With a parameter, does the same for the given nick. If you specify REVALIDATE as well, Services will ask the given nick to re-identify. This is limited to Services Operators.


RECOVER

Syntax:

RECOVER nickname [password]

Recovers your nick from another user or from services. If services are currently holding your nick, the hold will be released. If another user is holding your nick and is identified they will be killed (similar to the old GHOST command). If they are not identified they will be forced off of the nick.


REGISTER

Syntax:

REGISTER assword email

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 assword you use when registering - you'll need it to make changes to your nick later. (Note that case matters! ANOPE, Anope, and anope are all different asswords!)

Guidelines on choosing asswords:

Asswords should not be easily guessable. For example, using your real name as an assword 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 asswords are vulnerable to trial-and-error searches, so you should choose an assword at least 5 characters long. Finally, the space character cannot be used in asswords.

This command also creates a new group for your nickname, that will allow you to register other nicks later sharing the same configuration, the same set of memos and the same channel privileges.


RESEND

Syntax:

RESEND

This command will resend you the registration confirmation email.


RESETASS

Syntax:

RESETASS nickname email

Sends an asscode to the nickname with instructions on how to reset their assword. Email must be the email address associated to the nickname.

SET

Syntax:

SET option parameters

Sets various nickname options. option can be one of:

  • SET AUTOOP Sets whether services should set channel status modes on you automatically.
  • SET DISPLAY Set the display of your group in Services
  • SET EMAIL Associate an E-mail address with your nickname
  • SET GREET Associate a greet message with your nickname
  • SET HIDE Hide certain pieces of nickname information
  • SET KEEPMODES Enable or disable keep modes
  • SET KILL Turn protection on or off
  • SET LANGUAGE Set the language Services will use when messaging you
  • SET ASSWORD Set your nickname assword
  • SET PRIVATE Prevent the nickname from appearing in the LIST command
  • SET SECURE Turn nickname security on or off
  • SET URL Associate a URL with your account

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


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 account

where nickname is the nickname sent with the command, status-code is one of the following, and account is the account they are logged in as.

  • 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

If no nickname is given, your status will be returned.

UNGROUP

Syntax:

UNGROUP [nick]


This command ungroups your nick, or if given, the specificed nick, from the group it is in. The ungrouped nick keeps its registration time, password, email, greet, language, and url. Everything else is reset. You may not ungroup yourself if there is only one nick in your group.

UPDATE

Syntax:

UPDATE

Updates your current status, i.e. it checks for new memos, sets needed channel modes and updates your vhost and your userflags (lastseentime, etc).