summaryrefslogtreecommitdiff
path: root/doc/ref/web.texi
diff options
context:
space:
mode:
authorChristopher Allan Webber <cwebber@dustycloud.org>2015-09-17 15:14:54 -0500
committerChristopher Allan Webber <cwebber@dustycloud.org>2016-11-07 12:05:30 -0600
commit8f1db9f2681e3859e4292563b96fecac200d1c08 (patch)
tree991ee8716158831a290fbfbd4560ced6371ca66a /doc/ref/web.texi
parentf8de9808ed6e8c16f20ba5abd803ecb437138a54 (diff)
downloadguile-8f1db9f2681e3859e4292563b96fecac200d1c08.tar.gz
web: Add https support through gnutls.
Since importing gnutls directly would result in a dependency cycle, we load gnutls lazily. This uses code originally written for Guix by Ludovic Courtès. * module/web/client.scm: (%http-receive-buffer-size) (gnutls-module, ensure-gnutls, gnutls-ref, tls-wrap): New variables. (open-socket-for-uri): Wrap in tls when uri scheme is https. * doc/ref/web.texi (open-socket-for-uri): Document gnutls usage.
Diffstat (limited to 'doc/ref/web.texi')
-rw-r--r--doc/ref/web.texi6
1 files changed, 5 insertions, 1 deletions
diff --git a/doc/ref/web.texi b/doc/ref/web.texi
index becdc28db..8ddb2073a 100644
--- a/doc/ref/web.texi
+++ b/doc/ref/web.texi
@@ -1422,7 +1422,11 @@ the lower-level HTTP, request, and response modules.
@end example
@deffn {Scheme Procedure} open-socket-for-uri uri
-Return an open input/output port for a connection to URI.
+Return an open input/output port for a connection to URI. Guile
+dynamically loads gnutls for https support.
+@xref{Guile Preparations,
+how to install the GnuTLS bindings for Guile,, gnutls-guile,
+GnuTLS-Guile}, for more information.
@end deffn
@deffn {Scheme Procedure} http-get uri arg...