File: erc-services.el.html
As of ERC 5.6, this library's main module, services, mainly
concerns itself with authenticating to legacy IRC servers. If your
server supports SASL or CERTFP, please use one of those instead.
See (info "(erc) client-certificate") and (info "(erc) SASL") for
details. Note that this library also contains the local module
services-regain as well as standalone utility functions.
There are two ways to go about identifying yourself automatically to NickServ with this module. The more secure way is to listen for identify requests from the user NickServ. Another way is to identify yourself to NickServ directly after a successful connection and every time you change your nickname. This method is rather insecure, though, because no checks are made to test if NickServ is the real NickServ for a given network or server.
As a default, ERC has the data for the official nickname services on the networks Austnet, BrasNET, Dalnet, freenode, GalaxyNet, GRnet, Libera.Chat, and Slashnet. You can add more by using M-x customize-variable RET erc-nickserv-alist.
Usage:
Customize the option erc-modules to include services.
Add your nickname and NickServ password to erc-nickserv-passwords.
Using the Libera.Chat network as an example:
(setq erc-nickserv-passwords
'((Libera.Chat (("nickname" . "password")))))
The default automatic identification mode is autodetection of NickServ
identify requests. Set the variable erc-nickserv-identify-mode(var)/erc-nickserv-identify-mode(fun) if
you'd like to change this behavior.
If you'd rather not identify yourself automatically but would like access
to the functions contained in this file, just load this file without
enabling erc-services-mode(var)/erc-services-mode(fun).
Defined variables (13)
erc-auth-source-services-function | Function to retrieve NickServ password from auth-source. |
erc-nickserv-alist | Alist of NickServer details, sorted by network. |
erc-nickserv-identified-hook | Run this hook when NickServ acknowledged successful identification. |
erc-nickserv-identify-mode | The mode which is used when identifying to Nickserv. |
erc-nickserv-passwords | Passwords used when identifying to NickServ automatically. |
erc-prompt-for-nickserv-password | Ask for the password when identifying to NickServ. |
erc-services-mode | Non-nil if Erc-Services mode is enabled. |
erc-services-mode-hook | Hook run after entering or leaving ‘erc-services-mode’. |
erc-services-regain-alist | Alist mapping networks to nickname-regaining functions. |
erc-services-regain-mode | Non-nil if Erc-Services-Regain mode is enabled. |
erc-services-regain-mode-hook | Hook run after entering or leaving ‘erc-services-regain-mode’. |
erc-services-regain-timeout-seconds | Seconds after which to run callbacks if necessary. |
erc-use-auth-source-for-nickserv-password | Query auth-source for a password when identifying to NickServ. |