Function: erc-ssl

erc-ssl is a function alias and interactive for erc-tls, defined in erc.el.gz.

Signature

(erc-ssl &key (SERVER (erc-compute-server)) (PORT (erc-compute-port 'ircs-u)) (NICK (erc-compute-nick)) (USER (erc-compute-user)) PASSWORD (FULL-NAME (erc-compute-full-name)) CLIENT-CERTIFICATE ID)

Documentation

ERC is a powerful, modular, and extensible IRC client.

This function is the main entry point for ERC over TLS.

It allows selecting connection parameters, and then starts ERC over TLS.

Non-interactively, it takes the keyword arguments
   (server (erc-compute-server))
   (port (erc-compute-port))
   (nick (erc-compute-nick))
   (user (erc-compute-user))
   password
   (full-name (erc-compute-full-name))
   client-certificate
   id

That is, if called with

   (erc-tls :server "irc.libera.chat" :full-name "J. Random Hacker")

then the server and full-name will be set to those values, whereas erc-compute-port and erc-compute-nick will be invoked for the values of their respective parameters.

CLIENT-CERTIFICATE, if non-nil, should either be a list where the first element is the certificate key file name, and the second element is the certificate file name itself, or t, which means that auth-source will be queried for the key and the certificate. Authenticating using a TLS client certificate is also referred to as "CertFP" (Certificate Fingerprint) authentication by various IRC networks.

Example usage:

    (erc-tls :server "irc.libera.chat" :port 6697
             :client-certificate
             '("/home/bandali/my-cert.key"
               "/home/bandali/my-cert.crt"))

When present, ID should be a symbol or a string to use for naming the server buffer and identifying the connection unequivocally. See Info node (erc) Network Identifier for details. Like USER and CLIENT-CERTIFICATE, this parameter cannot be specified interactively.

Key Bindings

Aliases

erc-ssl