UserServ

CERT

CERT maintains a list of CertFP fingerprints that will allow UserServ to recognize you and authenticate you automatically.

You cannot add the same fingerprint to multiple accounts.

Syntax: CERT LIST
Syntax: CERT ADD [fingerprint]
Syntax: CERT DEL <fingerprint>

Operators with user:auspex privilege can also view another user's fingerprint list.

Syntax: CERT LIST <account>

Examples:
/msg UserServ CERT LIST
/msg UserServ CERT ADD f3a1aad46ca88e180c25c9c7021a4b3a
/msg UserServ CERT DEL f3a1aad46ca88e180c25c9c7021a4b3a

DROP

Using this command removes your account from services' database. You will lose all your channel access and memos. If an account is dropped, anyone else can re-register it. You need to log in to services before doing this.

When dropping and re-registering an account during a netsplit, users on the other side of the split may later be recognized as the new account.

Syntax: DROP <account> <password>

Examples:
/msg UserServ DROP foo bar

FREEZE

FREEZE allows operators to "freeze" an abusive user's account. Users cannot log into a frozen account. Thus, users cannot obtain the access associated with the account.

FREEZE information will be displayed in INFO output.

Syntax: FREEZE <account> ON|OFF <reason>

Examples:
/msg UserServ FREEZE pfish ON Persistent spammer
/msg UserServ FREEZE alambert OFF

FVERIFY

FVERIFY allows administrators to confirm a change associated with an account registration without having the verification email.

Syntax: FVERIFY <operation> <nickname>

Example:
/msg UserServ FVERIFY REGISTER jenny
/msg UserServ FVERIFY EMAILCHG Aeriana

HOLD

HOLD prevents an account and all channels registered to it from expiring.

Syntax: HOLD <account> ON|OFF

Examples:
/msg UserServ HOLD jilles ON

INFO

INFO displays account information such as registration time, flags, and other details.

You can query the account a user is logged in as by specifying an equals sign followed by their nick. This '=' convention works with most commands.

Syntax: INFO <account>
Syntax: INFO =<online user>

Examples:
/msg UserServ INFO w00t Shows information about the account w00t.
/msg UserServ INFO =w00tie[home] Shows information about the account the user w00tie[home] is logged in as.

LIST

LIST shows accounts that match a given pattern. Wildcards are allowed.

If user@host is also given, only accounts whose last seen host matches it are shown.

Syntax: LIST <pattern>
Syntax: LIST <pattern>!<user@host>

Examples:
/msg UserServ LIST james*
/msg UserServ LIST *a?ambert*
/msg UserServ LIST *!*@*.de

LISTCHANS

LISTCHANS shows the channels that you have access to, including those that you own.

AKICKs and host-based access are not shown.

Syntax: LISTCHANS

Operators with user:auspex privilege can also check another user's access.

Syntax: LISTCHANS <account>

Example:
/msg UserServ LISTCHANS

LISTMAIL

LISTMAIL shows accounts registered to a given e-mail address. Wildcards are allowed.

Syntax: LISTMAIL <email>

Examples:
/msg UserServ LISTMAIL patrick@example.com
/msg UserServ LISTMAIL *@cam.ac.uk

LISTVHOST

LISTVHOST shows accounts which have a vHost set on them. If a pattern is given, only accounts with vHosts matching the pattern are shown.

Syntax: LISTVHOST [pattern]

Examples:
/msg UserServ LISTVHOST
/msg UserServ LISTVHOST *staff*

LOGIN

LOGIN identifies you with services so that you can perform general maintenance and commands that require you to be logged in.

Syntax: LOGIN <account> <password>

Example:
/msg UserServ LOGIN smith sesame

LOGOUT

LOGOUT logs you out of the account that you are currently logged into.

Syntax: LOGOUT

Example:
/msg UserServ LOGOUT

MARK

MARK allows operators to attach a note to an account. For example, an operator could mark the account of a spammer so that others know the user has previously been warned.

MARK information will be displayed in INFO output.

Syntax: MARK <account> ON|OFF <reason>

Examples:
/msg UserServ MARK game_boy ON Persistent spammer
/msg UserServ MARK nenolod OFF

REGISTER

This will register an account with UserServ. This allows you to get access to channels more easily and use memos (if enabled). The password is a case-sensitive password that you make up. Please write down or memorize your password! You will need it later to change settings.

You have to to confirm the email address. To do this, follow the instructions in the message sent to the email address.

Syntax: REGISTER <account> <password> <email-address>

Examples:
/msg UserServ REGISTER foo sesame foo@bar.com

RESETPASS

RESETPASS sets a random password for the specified account.

Syntax: RESETPASS <account>

Examples:
/msg UserServ RESETPASS pfish

RETURN

RETURN resets the specified account password, sends it to the email address specified and changes account's email address to this address. Any current sessions logged in to the account are logged out.

Syntax: RETURN <account> <e-mail>

Examples:
/msg UserServ RETURN jdoe john@example.com

SENDPASS

SENDPASS emails the password for the specified account to the corresponding email address. SENDPASS emails a key to the email address corresponding to the specified account that can be used to set a new password using SETPASS.

Syntax: SENDPASS <account>

If the account is marked, you can override this using the FORCE keyword.

Syntax: SENDPASS <account> FORCE

If a key has been emailed but not yet used, you can clear it using the CLEAR keyword.

Syntax: SENDPASS <account> CLEAR

Examples:
/msg UserServ SENDPASS foo

SENDPASS

SENDPASS emails a key to the email address corresponding to the specified account that can be used to set a new password using SETPASS.

Syntax: SENDPASS <account>

If a key has been emailed but not yet used, you can clear it using the CLEAR keyword.

Syntax: SENDPASS <account> CLEAR

Examples:
/msg UserServ SENDPASS foo

SET EMAIL

SET EMAIL changes the e-mail address associated with an account. The e-mail address is used for password retrieval.

You may be required to confirm the new e-mail address. To confirm the address, follow the instructions in the message sent to the new address.

Syntax: SET EMAIL <new address>

Example:
/msg UserServ SET EMAIL dan@example.com

SET EMAILMEMOS

This will forward memos sent to your account to the email address listed on your registration.

Syntax: SET EMAILMEMOS [ON|OFF]

Example:
/msg UserServ SET EMAILMEMOS ON

SET HIDEMAIL

SET HIDEMAIL prevents an account's e-mail address from being shown to other users.

Syntax: SET HIDEMAIL ON|OFF

Example:
/msg UserServ SET HIDEMAIL ON

SET NEVEROP

SET NEVEROP prevents others from adding you to channel access lists.

Syntax: SET NEVEROP ON|OFF

Example:
/msg UserServ SET NEVEROP on

SET NOOP

SET NOOP prevents services from automatically opping you in channels you have access in. You can choose to op/voice yourself by using the UserServ OP and VOICE commands.

Syntax: SET NOOP ON|OFF

Example:
/msg UserServ SET NOOP ON

SET PASSWORD

SET PASSWORD changes the password of an account.

Syntax: SET PASSWORD <new password>

Example:
/msg UserServ SET PASSWORD swordfish

SET PRIVATE

SET PRIVATE hides various information about your account from other users.

SET PRIVATE ON automatically enables HIDEMAIL too.

Syntax: SET PRIVATE ON|OFF

Example:
/msg UserServ SET PRIVATE ON

SET PRIVMSG

SET PRIVMSG causes Services to use private messages when talking to the user authenticated on this account.

Syntax: SET PRIVMSG ON|OFF

Example:
/msg UserServ SET PRIVMSG ON

SET PROPERTY

SET PROPERTY manipulates metadata associated with an account.

To delete a metadata entry, specify the name and leave the value blank.

Syntax: SET PROPERTY <name> [value]

Example:
/msg UserServ SET PROPERTY URL http://www.example.com/~jay/
/msg UserServ SET PROPERTY SIGN Pisces
/msg UserServ SET PROPERTY ICQ

SETPASS

SETPASS allows you to set a new password using a key emailed to you. The key is valid for one time only, and also becomes invalid if you identify with your old password.

To set a new password if you know the current password, use SET PASSWORD instead of SETPASS.

Syntax: SETPASS <account> <key> <password>

STATUS

STATUS returns information about your current state. It will show information about your account, IRC operator, and SRA status.

Syntax: STATUS

Example:
/msg UserServ STATUS

TAXONOMY

The taxonomy command lists metadata information associated with registered users.

Examples:
/msg UserServ TAXONOMY foo

VACATION

VACATION extends the expiration time for your account (but not your channels) to three times the usual value. You can only do this if your account is registered long enough.

Vacation mode is disabled automatically the next time you log in to UserServ.

Syntax: VACATION

Examples:
/msg UserServ VACATION

VERIFY

VERIFY confirms a change associated with your account registration.

Syntax: VERIFY <operation> <account> <key>

Example:
/msg UserServ VERIFY REGISTER jenny 161803399
/msg UserServ VERIFY EMAILCHG Aeriana 271828183

VHOST

VHOST allows operators to set a virtual host (also known as a spoof or cloak) on an account. This vHost will be set on the user immediately and each time they log in.

Syntax: VHOST <account> ON <vHost>
Syntax: VHOST <account> OFF

If the account is marked, you can override this using the FORCE keyword.

Syntax: VHOST <account> ON <vHost> FORCE
Syntax: VHOST <account> OFF FORCE

Examples:
/msg UserServ VHOST spb ON may.explode.on.impact
/msg UserServ VHOST nenolod OFF