* bug#34937: [PATCH] update user docs for emacs-gnutls; tofu and program vs built-in
@ 2019-03-21 16:26 Tara Sawyer
2019-04-17 0:23 ` Noam Postavsky
2019-04-17 11:06 ` Noam Postavsky
0 siblings, 2 replies; 6+ messages in thread
From: Tara Sawyer @ 2019-03-21 16:26 UTC (permalink / raw)
To: 34937; +Cc: Tara Sawyer
---
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
^ permalink raw reply related [flat|nested] 6+ messages in thread
* bug#34937: [PATCH] update user docs for emacs-gnutls; tofu and program vs built-in
2019-03-21 16:26 bug#34937: [PATCH] update user docs for emacs-gnutls; tofu and program vs built-in Tara Sawyer
@ 2019-04-17 0:23 ` Noam Postavsky
2019-04-17 11:06 ` Noam Postavsky
1 sibling, 0 replies; 6+ messages in thread
From: Noam Postavsky @ 2019-04-17 0:23 UTC (permalink / raw)
To: Tara Sawyer; +Cc: 34937
Tara Sawyer <tara@anne.cat> writes:
> +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.
tls.el is getting obsoleted in Emacs 27 (see Bug#31457), so I don't
think we want to add documentation about it. Basically, you should only
be using it if you really know what you're doing already.
^ permalink raw reply [flat|nested] 6+ messages in thread
* bug#34937: [PATCH] update user docs for emacs-gnutls; tofu and program vs built-in
2019-03-21 16:26 bug#34937: [PATCH] update user docs for emacs-gnutls; tofu and program vs built-in Tara Sawyer
2019-04-17 0:23 ` Noam Postavsky
@ 2019-04-17 11:06 ` Noam Postavsky
2019-04-17 11:47 ` Noam Postavsky
1 sibling, 1 reply; 6+ messages in thread
From: Noam Postavsky @ 2019-04-17 11:06 UTC (permalink / raw)
To: 34937; +Cc: Tara Anne
[-- Attachment #1: Type: text/plain, Size: 82 bytes --]
[forwarding to list, please use "Reply All" to keep 34937@debbugs.gnu.org on Cc]
[-- Attachment #2: Type: message/rfc822, Size: 645 bytes --]
From: Tara Anne <tara@anne.cat>
To: Noam Postavsky <npostavs@gmail.com>
Subject: Re: bug#34937: [PATCH] update user docs for emacs-gnutls; tofu and program vs built-in
Date: Tue, 16 Apr 2019 19:06:25 -0700
Message-ID: <6B139D81-701E-40BF-A05B-FCD6C13CC09A@anne.cat>
Well I have no idea what I’m doing, and was forced to learn it.
But if it’s getting obsoleted, then I agree with you.
Thanks for responding!
^ permalink raw reply [flat|nested] 6+ messages in thread
* bug#34937: [PATCH] update user docs for emacs-gnutls; tofu and program vs built-in
2019-04-17 11:06 ` Noam Postavsky
@ 2019-04-17 11:47 ` Noam Postavsky
2019-04-17 20:22 ` Tara Anne
0 siblings, 1 reply; 6+ messages in thread
From: Noam Postavsky @ 2019-04-17 11:47 UTC (permalink / raw)
To: 34937; +Cc: Tara Anne
> From: Tara Anne <tara@anne.cat>
> Well I have no idea what I’m doing, and was forced to learn it.
Do you mean the builtin gnutls-based functions aren't working for you?
^ permalink raw reply [flat|nested] 6+ messages in thread
* bug#34937: [PATCH] update user docs for emacs-gnutls; tofu and program vs built-in
2019-04-17 11:47 ` Noam Postavsky
@ 2019-04-17 20:22 ` Tara Anne
2019-04-17 22:32 ` Noam Postavsky
0 siblings, 1 reply; 6+ messages in thread
From: Tara Anne @ 2019-04-17 20:22 UTC (permalink / raw)
To: Noam Postavsky; +Cc: 34937
They were not compiled in to my binary release of emacs. No idea why.
Rather than re-compile I opted to just call out,
Hence this patch.
On Apr 17, 2019, at 4:47 AM, Noam Postavsky <npostavs@gmail.com> wrote:
>> From: Tara Anne <tara@anne.cat>
>> Well I have no idea what I’m doing, and was forced to learn it.
>
> Do you mean the builtin gnutls-based functions aren't working for you?
>
^ permalink raw reply [flat|nested] 6+ messages in thread
* bug#34937: [PATCH] update user docs for emacs-gnutls; tofu and program vs built-in
2019-04-17 20:22 ` Tara Anne
@ 2019-04-17 22:32 ` Noam Postavsky
0 siblings, 0 replies; 6+ messages in thread
From: Noam Postavsky @ 2019-04-17 22:32 UTC (permalink / raw)
To: Tara Anne; +Cc: 34937
tags 34937 wontfix
close 34937
quit
Tara Anne <tara@anne.cat> writes:
> They were not compiled in to my binary release of emacs. No idea why.
> Rather than re-compile I opted to just call out,
Ah, well, you might want to look into getting gnutls working,
considering using the external binary can hit bugs like #15905
"url-copy-file sometimes silently downloads garbage or incomplete file"
Anyway, I'm closing this bug report as wontfix, for reasons mentioned
upthread.
^ permalink raw reply [flat|nested] 6+ messages in thread
end of thread, other threads:[~2019-04-17 22:32 UTC | newest]
Thread overview: 6+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2019-03-21 16:26 bug#34937: [PATCH] update user docs for emacs-gnutls; tofu and program vs built-in Tara Sawyer
2019-04-17 0:23 ` 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
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).