emacs-gnutls: Help For Developers
3 Help For Developers
*********************
The GnuTLS library is detected automatically at compile time. You
should see that it’s enabled in the ‘configure’ output. If not, follow
the standard procedure for finding out why a system library is not
picked up by the Emacs compilation. On the W32 (Windows) platform,
installing the DLLs with a recent build should be enough.
Just use ‘open-protocol-stream’ or ‘open-network-stream’ (the two are
equivalent, the first one being an alias to the second). You should not
have to use the ‘gnutls.el’ functions directly. But you can test them
with ‘open-gnutls-stream’.
-- Function: open-gnutls-stream name buffer host service
This function creates a buffer connected to a specific HOST and
SERVICE (port number or service name). The parameters and their
syntax are the same as those given to ‘open-network-stream’ (
Network Connections (elisp)Network.). The connection process is
called NAME (made unique if necessary). This function returns the
connection process.
;; open a HTTPS connection
(open-gnutls-stream "tls" "tls-buffer" "yourserver.com" "https")
;; open a IMAPS connection
(open-gnutls-stream "tls" "tls-buffer" "imap.gmail.com" "imaps")
The function ‘gnutls-negotiate’ is not generally useful and it may
change as needed, so please see ‘gnutls.el’ for the details.
-- Function: gnutls-negotiate spec
Please see ‘gnutls.el’ for the SPEC details and for usage, but do
not rely on this function’s interface if possible.