-
Notifications
You must be signed in to change notification settings - Fork 0
Available Commands
Below is a list of account management related commands.
Following the draft Account Registration IRCv3 specification, you can register an account using /REGISTER with the following syntax:
/REGISTER <account name> <email address> <password>
Example:
/REGISTER Valware valerie@valware.co.uk FantasticPasswordWhichDefinitelyNobodyWillEverGuessLmao
For logging in, you have two options.
You may either:
- use
SASLas is standard in clients (recommended). Most clients support SASL authentication and web-based IRC implementations use the "password" input field with SASL. - use
/IDENTIFYto login to your current nick. The syntax is as follows:
/IDENTIFY <account> <password>
Example:
/IDENTIFY Bob FantasticPasswordWhichDefinitelyNobodyWillEverGuessLmao
You can logout easily just by using the /LOGOUT command.
/AJOIN: This is your own personal list of channels which you will be automatically joined to when you connect if you logged in, but will also be triggered if you login after you connected. Note: You must actually be in the channel you want to add to your auto-join list.
You can type the command in either upper or lower-case, but the examples below use upper-case for the purposes of this example:
/AJOIN <add|del|list> [<chan>]
Examples:
/AJOIN add #PossumsOnly
/AJOIN del #BadPeopleChannel
/AJOIN list
Certificate fingerprints are a standard method of authentication using SASL EXTERNAL. The /CERTFP command lets you manage your Certficiate Fingerprint list. Here's the syntax and a few examples.
Note: You can only add certificate fingerprints you are currently wearing.
/CERTFP <add|del|list> [<certfp>]
Examples:
/CERTFP add
/CERTFP del 6d4fca1c036123cacd74331c5a724db926e3a94da17481ef6582d4b83cc50931
/CERTFP list
If you are not happy to be registered on a network, you can drop your account. This means unregister your account, or otherwise consider yourself deleted off their user database.
The command is easy, it's just /DROP. The server will ask you to confirm that you really want to drop your account by asking you to type /DROP again but with a code. The syntax is like this:
/DROP <code>
Example:
/DROP 39847
Sometimes if your login didn't work but you connected anyway, you'll be prompted for your password. This gives you a certain amount of time to /IDENTIFY before changing your username to a "guest" username. When this happens, there is a lock put on your account name to protect it from being used. If, for whatever reason, you didn't happen to make it in that time-frame, you'll have to login as usual with SASL and then you can use the /RELEASE command to release the hold on your account name. The syntax is as follows:
/RELEASE <account>
Example:
/RELEASE Valware
You can change your password using the /SETPASSWORD command. The syntax is like this:
/SETPASSWORD FantasticPasswordThatNobodyWillEverGuess
Paired with usermode +A, you can use /SETLANG in order to choose a language to which you want your incoming private messages translated.
/SETLANG <language code>
Examples:
/SETLANG en-gb
/SETLANG zh
/SETLANG es
When getting private messages from someone else, you will also receive a second message with the translated text. The other user does not see their own translated message.
To do: Make proper client-integratable IRCv3 style functionality using a CAP.
Below is a list of channel management related commands.
/CREGISTER will let you register a channel, which sets mode the 'registered mode (+r)' on the channel and 'owner status (+q)' on you and the syntax is as follows:
/CREGISTER <channel name>
Example:
/CREGISTER #mychannel
There a few commands which server operators/admins will be able to use. Each command requires an operclass privilege so you can tailor your IRCops permissions accordingly.
TODO: document /sadrop, /salogout