From: Tara Sawyer <tara@anne.cat>
To: 34937@debbugs.gnu.org
Cc: Tara Sawyer <tara@anne.cat>
Subject: bug#34937: [PATCH] update user docs for emacs-gnutls; tofu and program vs built-in
Date: Thu, 21 Mar 2019 09:26:20 -0700 [thread overview]
Message-ID: <20190321162620.85383-1-tara@anne.cat> (raw)
---
doc/misc/emacs-gnutls.texi | 18 ++++++++++++++++++
1 file changed, 18 insertions(+)
diff --git a/doc/misc/emacs-gnutls.texi b/doc/misc/emacs-gnutls.texi
index add79d12e4..e79174d784 100644
--- a/doc/misc/emacs-gnutls.texi
+++ b/doc/misc/emacs-gnutls.texi
@@ -93,6 +93,24 @@ There's one way to find out if GnuTLS is available, by calling
@url{http://sourceforge.net/projects/ezwinports/files/} thanks to Eli
Zaretskii) in the same directory as Emacs, you should be OK.
+To debug GnuTLS problems, first check the messages buffer, and then
+check the function below @code{gnutls-log-level}
+
+If GnuTLS is not available as a built-in (@code{gnutls-available-p}
+returns an empty list (), emacs will call out to the @code{gnutls-cli}
+program to perform TLS connections. If you need to modify
+the command it calls you can do this with the variable
+@code{tls-program}.
+For example, if you want to pin a certificate and use Trust On First
+Use(TOFU), then something like this:
+ @code{(add-to-list 'tls-program "gnutls-cli --tofu --x509cafile %t -p
+ %p %h ")}
+ will probably serve you well.
+
+
+
+@section Functions and Variables
+
@defun gnutls-available-p
This function returns non-@code{nil} if GnuTLS is available in this
instance of Emacs, @code{nil} otherwise. If GnuTLS is available, the
--
2.21.0
next reply other threads:[~2019-03-21 16:26 UTC|newest]
Thread overview: 6+ messages / expand[flat|nested] mbox.gz Atom feed top
2019-03-21 16:26 Tara Sawyer [this message]
2019-04-17 0:23 ` bug#34937: [PATCH] update user docs for emacs-gnutls; tofu and program vs built-in Noam Postavsky
2019-04-17 11:06 ` Noam Postavsky
2019-04-17 11:47 ` Noam Postavsky
2019-04-17 20:22 ` Tara Anne
2019-04-17 22:32 ` Noam Postavsky
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.gnu.org/software/emacs/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20190321162620.85383-1-tara@anne.cat \
--to=tara@anne.cat \
--cc=34937@debbugs.gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).