Function: erc-services-regain-mode

erc-services-regain-mode is an interactive and byte-compiled function defined in erc-services.el.gz.

Signature

(erc-services-regain-mode &optional ARG)

Documentation

Toggle ERC services-regain mode locally.

If called interactively, enable erc-services-regain-mode(var)/erc-services-regain-mode(fun) if ARG is positive, and disable it otherwise. If called from Lisp, enable the mode if ARG is omitted or nil.

Reacquire a nickname from your past self or some interloper. This module only concerns itself with initial nick rejections that occur during connection registration in response to an opening "NICK" command. More specifically, the following conditions must be met for ERC to activate this mechanism and consider its main option, erc-services-regain-alist:

  - the server must reject the opening "NICK" request
  - ERC must request a temporary nickname
  - the user must successfully authenticate

In practical terms, this means that this module, which is still somewhat experimental, is likely only useful in conjunction with SASL authentication or CertFP rather than the traditional approach provided by the services module it shares a library with (see Info node (erc) SASL for more).

This local module's minor mode is only active in server buffers.

Key Bindings

Source Code

;; Defined in /usr/src/emacs/lisp/erc/erc-services.el.gz
;;;###autoload(put 'services-regain 'erc--feature 'erc-services)
(define-erc-module services-regain nil
  "Reacquire a nickname from your past self or some interloper.
This module only concerns itself with initial nick rejections
that occur during connection registration in response to an
opening \"NICK\" command.  More specifically, the following
conditions must be met for ERC to activate this mechanism and
consider its main option, `erc-services-regain-alist':

  - the server must reject the opening \"NICK\" request
  - ERC must request a temporary nickname
  - the user must successfully authenticate

In practical terms, this means that this module, which is still
somewhat experimental, is likely only useful in conjunction with
SASL authentication or CertFP rather than the traditional approach
provided by the `services' module it shares a library with (see Info
node `(erc) SASL' for more).

This local module's minor mode is only active in server buffers."
  ((when erc--target (erc-services-regain-mode -1))) nil localp)