website/content/docs/nickserv.md

52 lines
2.9 KiB
Markdown

# NickServ
Nickname services — register your nickname/account, log in, and manage account settings. Message it
with `/msg NickServ <command>`.
| Command | Syntax | Description |
| --- | --- | --- |
| REGISTER | `REGISTER <password> [email]` | Register your current nick as an account |
| IDENTIFY | `IDENTIFY [account] <password>` | Log in (alias `ID`) |
| LOGIN | `LOGIN <nick> <password>` | Log in and move onto that nick, freeing any session holding it |
| VOUCH | `VOUCH <nick>` | Confirm a pending member on an invite-only network |
| LOGOUT | `LOGOUT` | Log out to a guest nick (alias `LOGOFF`) |
| INFO | `INFO [account]` | Show account info (email shown only to the owner) |
| ALIST | `ALIST` | List channels you hold access on |
| SET | `SET <option> [value]` | Change account settings (see below) |
| GROUP | `GROUP <account> <password>` | Link your current nick to an account as an alias |
| GLIST | `GLIST` | List the nicks grouped to your account |
| UNGROUP | `UNGROUP [nick]` | Remove a grouped nick |
| GHOST | `GHOST <nick> [password]` | Rename off a session using a nick you own |
| RECOVER | `RECOVER <nick> [password]` | Free a nick you own and put yourself back onto it |
| RESETPASS | `RESETPASS <account>` then `RESETPASS <account> <code> <newpassword>` | Reset your password by email code |
| CONFIRM | `CONFIRM <code>` | Confirm the email on a newly registered account |
| DROP | `DROP <password>` | Delete your account and release founded channels |
| CERT | `CERT ADD\|DEL [password] <fingerprint>` · `CERT LIST [password]` | Manage TLS cert fingerprints for SASL EXTERNAL |
| AJOIN | `AJOIN ADD\|DEL <#channel>` · `AJOIN LIST` | Channels auto-joined when you identify |
| UPDATE | `UPDATE` | Re-apply auto-joins and vhost, re-check for memos |
## SET options
`SET <option> [value]`:
| Option | Sets |
| --- | --- |
| `PASSWORD <new>` | Account password |
| `EMAIL <address>` | Contact email |
| `PUBKEY [key]` | A NIST P-256 public key for `ECDSA-NIST256P-CHALLENGE` SASL (no value clears it) |
| `GREET [message]` | Your greet (shown by a channel bot on join) |
| `AVATAR` / `BIO` / `PRONOUNS` / `TIMEZONE` / `URL [value]` | Public profile fields (published as IRCv3 metadata) |
| `AUTOOP {ON\|OFF}` | Auto-op where you have channel access |
| `KILL {ON\|OFF}` | Nick protection |
| `HIDE STATUS {ON\|OFF}` | Hide your last-seen / online status |
## Operator commands
| Command | Syntax | Description |
| --- | --- | --- |
| SASET | `SASET <account> PASSWORD\|EMAIL\|GREET <value>` | Change another account's settings |
| SAREGISTER | `SAREGISTER <account> <password> [email]` | Create an account directly, active immediately |
| LIST | `LIST <pattern>` | List accounts matching a glob (auspex) |
| GETEMAIL | `GETEMAIL <email>` | List accounts by email (auspex) |
| SUSPEND / UNSUSPEND | `SUSPEND <account> [reason]` · `UNSUSPEND <account>` | Block / unblock an account from logging in |
| NOEXPIRE | `NOEXPIRE <account> {ON\|OFF}` | Pin an account against inactivity expiry |