1 /* GnuTLS glue for GNU Emacs.
2 Copyright (C) 2010-2012 Free Software Foundation, Inc.
4 This file is part of GNU Emacs.
6 GNU Emacs is free software: you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation, either version 3 of the License, or
9 (at your option) any later version.
11 GNU Emacs is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
27 #include <gnutls/gnutls.h>
35 emacs_gnutls_handle_error (gnutls_session_t
, int err
);
37 static Lisp_Object Qgnutls_dll
;
38 static Lisp_Object Qgnutls_code
;
39 static Lisp_Object Qgnutls_anon
, Qgnutls_x509pki
;
40 static Lisp_Object Qgnutls_e_interrupted
, Qgnutls_e_again
,
41 Qgnutls_e_invalid_session
, Qgnutls_e_not_ready_for_handshake
;
42 static int gnutls_global_initialized
;
44 /* The following are for the property list of `gnutls-boot'. */
45 static Lisp_Object QCgnutls_bootprop_priority
;
46 static Lisp_Object QCgnutls_bootprop_trustfiles
;
47 static Lisp_Object QCgnutls_bootprop_keylist
;
48 static Lisp_Object QCgnutls_bootprop_crlfiles
;
49 static Lisp_Object QCgnutls_bootprop_callbacks
;
50 static Lisp_Object QCgnutls_bootprop_loglevel
;
51 static Lisp_Object QCgnutls_bootprop_hostname
;
52 static Lisp_Object QCgnutls_bootprop_min_prime_bits
;
53 static Lisp_Object QCgnutls_bootprop_verify_flags
;
54 static Lisp_Object QCgnutls_bootprop_verify_hostname_error
;
56 /* Callback keys for `gnutls-boot'. Unused currently. */
57 static Lisp_Object QCgnutls_bootprop_callbacks_verify
;
59 static void gnutls_log_function (int, const char *);
60 static void gnutls_log_function2 (int, const char*, const char*);
65 /* Macro for defining functions that will be loaded from the GnuTLS DLL. */
66 #define DEF_GNUTLS_FN(rettype,func,args) static rettype (FAR CDECL *fn_##func)args
68 /* Macro for loading GnuTLS functions from the library. */
69 #define LOAD_GNUTLS_FN(lib,func) { \
70 fn_##func = (void *) GetProcAddress (lib, #func); \
71 if (!fn_##func) return 0; \
74 DEF_GNUTLS_FN (gnutls_alert_description_t
, gnutls_alert_get
,
76 DEF_GNUTLS_FN (const char *, gnutls_alert_get_name
,
77 (gnutls_alert_description_t
));
78 DEF_GNUTLS_FN (int, gnutls_alert_send_appropriate
, (gnutls_session_t
, int));
79 DEF_GNUTLS_FN (int, gnutls_anon_allocate_client_credentials
,
80 (gnutls_anon_client_credentials_t
*));
81 DEF_GNUTLS_FN (void, gnutls_anon_free_client_credentials
,
82 (gnutls_anon_client_credentials_t
));
83 DEF_GNUTLS_FN (int, gnutls_bye
, (gnutls_session_t
, gnutls_close_request_t
));
84 DEF_GNUTLS_FN (int, gnutls_certificate_allocate_credentials
,
85 (gnutls_certificate_credentials_t
*));
86 DEF_GNUTLS_FN (void, gnutls_certificate_free_credentials
,
87 (gnutls_certificate_credentials_t
));
88 DEF_GNUTLS_FN (const gnutls_datum_t
*, gnutls_certificate_get_peers
,
89 (gnutls_session_t
, unsigned int *));
90 DEF_GNUTLS_FN (void, gnutls_certificate_set_verify_flags
,
91 (gnutls_certificate_credentials_t
, unsigned int));
92 DEF_GNUTLS_FN (int, gnutls_certificate_set_x509_crl_file
,
93 (gnutls_certificate_credentials_t
, const char *,
94 gnutls_x509_crt_fmt_t
));
95 DEF_GNUTLS_FN (int, gnutls_certificate_set_x509_key_file
,
96 (gnutls_certificate_credentials_t
, const char *, const char *,
97 gnutls_x509_crt_fmt_t
));
98 DEF_GNUTLS_FN (int, gnutls_certificate_set_x509_trust_file
,
99 (gnutls_certificate_credentials_t
, const char *,
100 gnutls_x509_crt_fmt_t
));
101 DEF_GNUTLS_FN (gnutls_certificate_type_t
, gnutls_certificate_type_get
,
103 DEF_GNUTLS_FN (int, gnutls_certificate_verify_peers2
,
104 (gnutls_session_t
, unsigned int *));
105 DEF_GNUTLS_FN (int, gnutls_credentials_set
,
106 (gnutls_session_t
, gnutls_credentials_type_t
, void *));
107 DEF_GNUTLS_FN (void, gnutls_deinit
, (gnutls_session_t
));
108 DEF_GNUTLS_FN (void, gnutls_dh_set_prime_bits
,
109 (gnutls_session_t
, unsigned int));
110 DEF_GNUTLS_FN (int, gnutls_error_is_fatal
, (int));
111 DEF_GNUTLS_FN (int, gnutls_global_init
, (void));
112 DEF_GNUTLS_FN (void, gnutls_global_set_log_function
, (gnutls_log_func
));
113 DEF_GNUTLS_FN (void, gnutls_global_set_log_level
, (int));
114 DEF_GNUTLS_FN (void, gnutls_global_set_mem_functions
,
115 (gnutls_alloc_function
, gnutls_alloc_function
,
116 gnutls_is_secure_function
, gnutls_realloc_function
,
117 gnutls_free_function
));
118 DEF_GNUTLS_FN (int, gnutls_handshake
, (gnutls_session_t
));
119 DEF_GNUTLS_FN (int, gnutls_init
, (gnutls_session_t
*, gnutls_connection_end_t
));
120 DEF_GNUTLS_FN (int, gnutls_priority_set_direct
,
121 (gnutls_session_t
, const char *, const char **));
122 DEF_GNUTLS_FN (size_t, gnutls_record_check_pending
, (gnutls_session_t
));
123 DEF_GNUTLS_FN (ssize_t
, gnutls_record_recv
, (gnutls_session_t
, void *, size_t));
124 DEF_GNUTLS_FN (ssize_t
, gnutls_record_send
,
125 (gnutls_session_t
, const void *, size_t));
126 DEF_GNUTLS_FN (const char *, gnutls_strerror
, (int));
127 DEF_GNUTLS_FN (void, gnutls_transport_set_errno
, (gnutls_session_t
, int));
128 DEF_GNUTLS_FN (const char *, gnutls_check_version
, (const char *));
129 DEF_GNUTLS_FN (void, gnutls_transport_set_lowat
, (gnutls_session_t
, int));
130 DEF_GNUTLS_FN (void, gnutls_transport_set_ptr2
,
131 (gnutls_session_t
, gnutls_transport_ptr_t
,
132 gnutls_transport_ptr_t
));
133 DEF_GNUTLS_FN (void, gnutls_transport_set_pull_function
,
134 (gnutls_session_t
, gnutls_pull_func
));
135 DEF_GNUTLS_FN (void, gnutls_transport_set_push_function
,
136 (gnutls_session_t
, gnutls_push_func
));
137 DEF_GNUTLS_FN (int, gnutls_x509_crt_check_hostname
,
138 (gnutls_x509_crt_t
, const char *));
139 DEF_GNUTLS_FN (void, gnutls_x509_crt_deinit
, (gnutls_x509_crt_t
));
140 DEF_GNUTLS_FN (int, gnutls_x509_crt_import
,
141 (gnutls_x509_crt_t
, const gnutls_datum_t
*,
142 gnutls_x509_crt_fmt_t
));
143 DEF_GNUTLS_FN (int, gnutls_x509_crt_init
, (gnutls_x509_crt_t
*));
146 init_gnutls_functions (Lisp_Object libraries
)
149 int max_log_level
= 1;
151 if (!(library
= w32_delayed_load (libraries
, Qgnutls_dll
)))
153 GNUTLS_LOG (1, max_log_level
, "GnuTLS library not found");
157 LOAD_GNUTLS_FN (library
, gnutls_alert_get
);
158 LOAD_GNUTLS_FN (library
, gnutls_alert_get_name
);
159 LOAD_GNUTLS_FN (library
, gnutls_alert_send_appropriate
);
160 LOAD_GNUTLS_FN (library
, gnutls_anon_allocate_client_credentials
);
161 LOAD_GNUTLS_FN (library
, gnutls_anon_free_client_credentials
);
162 LOAD_GNUTLS_FN (library
, gnutls_bye
);
163 LOAD_GNUTLS_FN (library
, gnutls_certificate_allocate_credentials
);
164 LOAD_GNUTLS_FN (library
, gnutls_certificate_free_credentials
);
165 LOAD_GNUTLS_FN (library
, gnutls_certificate_get_peers
);
166 LOAD_GNUTLS_FN (library
, gnutls_certificate_set_verify_flags
);
167 LOAD_GNUTLS_FN (library
, gnutls_certificate_set_x509_crl_file
);
168 LOAD_GNUTLS_FN (library
, gnutls_certificate_set_x509_key_file
);
169 LOAD_GNUTLS_FN (library
, gnutls_certificate_set_x509_trust_file
);
170 LOAD_GNUTLS_FN (library
, gnutls_certificate_type_get
);
171 LOAD_GNUTLS_FN (library
, gnutls_certificate_verify_peers2
);
172 LOAD_GNUTLS_FN (library
, gnutls_credentials_set
);
173 LOAD_GNUTLS_FN (library
, gnutls_deinit
);
174 LOAD_GNUTLS_FN (library
, gnutls_dh_set_prime_bits
);
175 LOAD_GNUTLS_FN (library
, gnutls_error_is_fatal
);
176 LOAD_GNUTLS_FN (library
, gnutls_global_init
);
177 LOAD_GNUTLS_FN (library
, gnutls_global_set_log_function
);
178 LOAD_GNUTLS_FN (library
, gnutls_global_set_log_level
);
179 LOAD_GNUTLS_FN (library
, gnutls_global_set_mem_functions
);
180 LOAD_GNUTLS_FN (library
, gnutls_handshake
);
181 LOAD_GNUTLS_FN (library
, gnutls_init
);
182 LOAD_GNUTLS_FN (library
, gnutls_priority_set_direct
);
183 LOAD_GNUTLS_FN (library
, gnutls_record_check_pending
);
184 LOAD_GNUTLS_FN (library
, gnutls_record_recv
);
185 LOAD_GNUTLS_FN (library
, gnutls_record_send
);
186 LOAD_GNUTLS_FN (library
, gnutls_strerror
);
187 LOAD_GNUTLS_FN (library
, gnutls_transport_set_errno
);
188 LOAD_GNUTLS_FN (library
, gnutls_check_version
);
189 /* We don't need to call gnutls_transport_set_lowat in GnuTLS 2.11.1
190 and later, and the function was removed entirely in 3.0.0. */
191 if (!fn_gnutls_check_version ("2.11.1"))
192 LOAD_GNUTLS_FN (library
, gnutls_transport_set_lowat
);
193 LOAD_GNUTLS_FN (library
, gnutls_transport_set_ptr2
);
194 LOAD_GNUTLS_FN (library
, gnutls_transport_set_pull_function
);
195 LOAD_GNUTLS_FN (library
, gnutls_transport_set_push_function
);
196 LOAD_GNUTLS_FN (library
, gnutls_x509_crt_check_hostname
);
197 LOAD_GNUTLS_FN (library
, gnutls_x509_crt_deinit
);
198 LOAD_GNUTLS_FN (library
, gnutls_x509_crt_import
);
199 LOAD_GNUTLS_FN (library
, gnutls_x509_crt_init
);
201 max_log_level
= global_gnutls_log_level
;
204 Lisp_Object name
= CAR_SAFE (Fget (Qgnutls_dll
, QCloaded_from
));
205 GNUTLS_LOG2 (1, max_log_level
, "GnuTLS library loaded:",
206 STRINGP (name
) ? (const char *) SDATA (name
) : "unknown");
212 #else /* !WINDOWSNT */
214 #define fn_gnutls_alert_get gnutls_alert_get
215 #define fn_gnutls_alert_get_name gnutls_alert_get_name
216 #define fn_gnutls_alert_send_appropriate gnutls_alert_send_appropriate
217 #define fn_gnutls_anon_allocate_client_credentials gnutls_anon_allocate_client_credentials
218 #define fn_gnutls_anon_free_client_credentials gnutls_anon_free_client_credentials
219 #define fn_gnutls_bye gnutls_bye
220 #define fn_gnutls_certificate_allocate_credentials gnutls_certificate_allocate_credentials
221 #define fn_gnutls_certificate_free_credentials gnutls_certificate_free_credentials
222 #define fn_gnutls_certificate_get_peers gnutls_certificate_get_peers
223 #define fn_gnutls_certificate_set_verify_flags gnutls_certificate_set_verify_flags
224 #define fn_gnutls_certificate_set_x509_crl_file gnutls_certificate_set_x509_crl_file
225 #define fn_gnutls_certificate_set_x509_key_file gnutls_certificate_set_x509_key_file
226 #define fn_gnutls_certificate_set_x509_trust_file gnutls_certificate_set_x509_trust_file
227 #define fn_gnutls_certificate_type_get gnutls_certificate_type_get
228 #define fn_gnutls_certificate_verify_peers2 gnutls_certificate_verify_peers2
229 #define fn_gnutls_credentials_set gnutls_credentials_set
230 #define fn_gnutls_deinit gnutls_deinit
231 #define fn_gnutls_dh_set_prime_bits gnutls_dh_set_prime_bits
232 #define fn_gnutls_error_is_fatal gnutls_error_is_fatal
233 #define fn_gnutls_global_init gnutls_global_init
234 #define fn_gnutls_global_set_log_function gnutls_global_set_log_function
235 #define fn_gnutls_global_set_log_level gnutls_global_set_log_level
236 #define fn_gnutls_global_set_mem_functions gnutls_global_set_mem_functions
237 #define fn_gnutls_handshake gnutls_handshake
238 #define fn_gnutls_init gnutls_init
239 #define fn_gnutls_priority_set_direct gnutls_priority_set_direct
240 #define fn_gnutls_record_check_pending gnutls_record_check_pending
241 #define fn_gnutls_record_recv gnutls_record_recv
242 #define fn_gnutls_record_send gnutls_record_send
243 #define fn_gnutls_strerror gnutls_strerror
244 #define fn_gnutls_transport_set_errno gnutls_transport_set_errno
245 #define fn_gnutls_transport_set_ptr2 gnutls_transport_set_ptr2
246 #define fn_gnutls_x509_crt_check_hostname gnutls_x509_crt_check_hostname
247 #define fn_gnutls_x509_crt_deinit gnutls_x509_crt_deinit
248 #define fn_gnutls_x509_crt_import gnutls_x509_crt_import
249 #define fn_gnutls_x509_crt_init gnutls_x509_crt_init
251 #endif /* !WINDOWSNT */
254 /* Function to log a simple message. */
256 gnutls_log_function (int level
, const char* string
)
258 message ("gnutls.c: [%d] %s", level
, string
);
261 /* Function to log a message and a string. */
263 gnutls_log_function2 (int level
, const char* string
, const char* extra
)
265 message ("gnutls.c: [%d] %s %s", level
, string
, extra
);
268 /* Function to log a message and an integer. */
270 gnutls_log_function2i (int level
, const char* string
, int extra
)
272 message ("gnutls.c: [%d] %s %d", level
, string
, extra
);
276 emacs_gnutls_handshake (struct Lisp_Process
*proc
)
278 gnutls_session_t state
= proc
->gnutls_state
;
281 if (proc
->gnutls_initstage
< GNUTLS_STAGE_HANDSHAKE_CANDO
)
284 if (proc
->gnutls_initstage
< GNUTLS_STAGE_TRANSPORT_POINTERS_SET
)
287 /* On W32 we cannot transfer socket handles between different runtime
288 libraries, so we tell GnuTLS to use our special push/pull
290 fn_gnutls_transport_set_ptr2 (state
,
291 (gnutls_transport_ptr_t
) proc
,
292 (gnutls_transport_ptr_t
) proc
);
293 fn_gnutls_transport_set_push_function (state
, &emacs_gnutls_push
);
294 fn_gnutls_transport_set_pull_function (state
, &emacs_gnutls_pull
);
296 /* For non blocking sockets or other custom made pull/push
297 functions the gnutls_transport_set_lowat must be called, with
298 a zero low water mark value. (GnuTLS 2.10.4 documentation)
300 (Note: this is probably not strictly necessary as the lowat
301 value is only used when no custom pull/push functions are
303 /* According to GnuTLS NEWS file, lowat level has been set to
304 zero by default in version 2.11.1, and the function
305 gnutls_transport_set_lowat was removed from the library in
307 if (!fn_gnutls_check_version ("2.11.1"))
308 fn_gnutls_transport_set_lowat (state
, 0);
310 /* This is how GnuTLS takes sockets: as file descriptors passed
311 in. For an Emacs process socket, infd and outfd are the
312 same but we use this two-argument version for clarity. */
313 fn_gnutls_transport_set_ptr2 (state
,
314 (gnutls_transport_ptr_t
) (long) proc
->infd
,
315 (gnutls_transport_ptr_t
) (long) proc
->outfd
);
318 proc
->gnutls_initstage
= GNUTLS_STAGE_TRANSPORT_POINTERS_SET
;
323 ret
= fn_gnutls_handshake (state
);
324 emacs_gnutls_handle_error (state
, ret
);
326 while (ret
< 0 && fn_gnutls_error_is_fatal (ret
) == 0);
328 proc
->gnutls_initstage
= GNUTLS_STAGE_HANDSHAKE_TRIED
;
330 if (ret
== GNUTLS_E_SUCCESS
)
332 /* Here we're finally done. */
333 proc
->gnutls_initstage
= GNUTLS_STAGE_READY
;
337 fn_gnutls_alert_send_appropriate (state
, ret
);
343 emacs_gnutls_record_check_pending (gnutls_session_t state
)
345 return fn_gnutls_record_check_pending (state
);
349 emacs_gnutls_transport_set_errno (gnutls_session_t state
, int err
)
351 fn_gnutls_transport_set_errno (state
, err
);
355 emacs_gnutls_write (struct Lisp_Process
*proc
, const char *buf
, ptrdiff_t nbyte
)
358 ptrdiff_t bytes_written
;
359 gnutls_session_t state
= proc
->gnutls_state
;
361 if (proc
->gnutls_initstage
!= GNUTLS_STAGE_READY
)
376 rtnval
= fn_gnutls_record_send (state
, buf
, nbyte
);
380 if (rtnval
== GNUTLS_E_INTERRUPTED
)
384 /* If we get GNUTLS_E_AGAIN, then set errno
385 appropriately so that send_process retries the
386 correct way instead of erroring out. */
387 if (rtnval
== GNUTLS_E_AGAIN
)
402 bytes_written
+= rtnval
;
405 emacs_gnutls_handle_error (state
, rtnval
);
406 return (bytes_written
);
410 emacs_gnutls_read (struct Lisp_Process
*proc
, char *buf
, ptrdiff_t nbyte
)
413 gnutls_session_t state
= proc
->gnutls_state
;
415 int log_level
= proc
->gnutls_log_level
;
417 if (proc
->gnutls_initstage
!= GNUTLS_STAGE_READY
)
419 /* If the handshake count is under the limit, try the handshake
420 again and increment the handshake count. This count is kept
421 per process (connection), not globally. */
422 if (proc
->gnutls_handshakes_tried
< GNUTLS_EMACS_HANDSHAKES_LIMIT
)
424 proc
->gnutls_handshakes_tried
++;
425 emacs_gnutls_handshake (proc
);
426 GNUTLS_LOG2i (5, log_level
, "Retried handshake",
427 proc
->gnutls_handshakes_tried
);
431 GNUTLS_LOG (2, log_level
, "Giving up on handshake; resetting retries");
432 proc
->gnutls_handshakes_tried
= 0;
435 rtnval
= fn_gnutls_record_recv (state
, buf
, nbyte
);
438 else if (rtnval
== GNUTLS_E_UNEXPECTED_PACKET_LENGTH
)
439 /* The peer closed the connection. */
441 else if (emacs_gnutls_handle_error (state
, rtnval
) == 0)
442 /* non-fatal error */
445 /* a fatal error occurred */
450 /* report a GnuTLS error to the user.
451 Returns zero if the error code was successfully handled. */
453 emacs_gnutls_handle_error (gnutls_session_t session
, int err
)
455 int max_log_level
= 0;
460 /* TODO: use a Lisp_Object generated by gnutls_make_error? */
464 max_log_level
= global_gnutls_log_level
;
466 /* TODO: use gnutls-error-fatalp and gnutls-error-string. */
468 str
= fn_gnutls_strerror (err
);
472 if (fn_gnutls_error_is_fatal (err
))
475 GNUTLS_LOG2 (0, max_log_level
, "fatal error:", str
);
480 GNUTLS_LOG2 (1, max_log_level
, "non-fatal error:", str
);
481 /* TODO: EAGAIN AKA Qgnutls_e_again should be level 2. */
484 if (err
== GNUTLS_E_WARNING_ALERT_RECEIVED
485 || err
== GNUTLS_E_FATAL_ALERT_RECEIVED
)
487 int alert
= fn_gnutls_alert_get (session
);
488 int level
= (err
== GNUTLS_E_FATAL_ALERT_RECEIVED
) ? 0 : 1;
489 str
= fn_gnutls_alert_get_name (alert
);
493 GNUTLS_LOG2 (level
, max_log_level
, "Received alert: ", str
);
498 /* convert an integer error to a Lisp_Object; it will be either a
499 known symbol like `gnutls_e_interrupted' and `gnutls_e_again' or
500 simply the integer value of the error. GNUTLS_E_SUCCESS is mapped
503 gnutls_make_error (int err
)
507 case GNUTLS_E_SUCCESS
:
510 return Qgnutls_e_again
;
511 case GNUTLS_E_INTERRUPTED
:
512 return Qgnutls_e_interrupted
;
513 case GNUTLS_E_INVALID_SESSION
:
514 return Qgnutls_e_invalid_session
;
517 return make_number (err
);
521 emacs_gnutls_deinit (Lisp_Object proc
)
525 CHECK_PROCESS (proc
);
527 if (XPROCESS (proc
)->gnutls_p
== 0)
530 log_level
= XPROCESS (proc
)->gnutls_log_level
;
532 if (XPROCESS (proc
)->gnutls_x509_cred
)
534 GNUTLS_LOG (2, log_level
, "Deallocating x509 credentials");
535 fn_gnutls_certificate_free_credentials (XPROCESS (proc
)->gnutls_x509_cred
);
536 XPROCESS (proc
)->gnutls_x509_cred
= NULL
;
539 if (XPROCESS (proc
)->gnutls_anon_cred
)
541 GNUTLS_LOG (2, log_level
, "Deallocating anon credentials");
542 fn_gnutls_anon_free_client_credentials (XPROCESS (proc
)->gnutls_anon_cred
);
543 XPROCESS (proc
)->gnutls_anon_cred
= NULL
;
546 if (XPROCESS (proc
)->gnutls_state
)
548 fn_gnutls_deinit (XPROCESS (proc
)->gnutls_state
);
549 XPROCESS (proc
)->gnutls_state
= NULL
;
550 if (GNUTLS_INITSTAGE (proc
) >= GNUTLS_STAGE_INIT
)
551 GNUTLS_INITSTAGE (proc
) = GNUTLS_STAGE_INIT
- 1;
554 XPROCESS (proc
)->gnutls_p
= 0;
558 DEFUN ("gnutls-get-initstage", Fgnutls_get_initstage
, Sgnutls_get_initstage
, 1, 1, 0,
559 doc
: /* Return the GnuTLS init stage of process PROC.
560 See also `gnutls-boot'. */)
563 CHECK_PROCESS (proc
);
565 return make_number (GNUTLS_INITSTAGE (proc
));
568 DEFUN ("gnutls-errorp", Fgnutls_errorp
, Sgnutls_errorp
, 1, 1, 0,
569 doc
: /* Return t if ERROR indicates a GnuTLS problem.
570 ERROR is an integer or a symbol with an integer `gnutls-code' property.
571 usage: (gnutls-errorp ERROR) */)
574 if (EQ (err
, Qt
)) return Qnil
;
579 DEFUN ("gnutls-error-fatalp", Fgnutls_error_fatalp
, Sgnutls_error_fatalp
, 1, 1, 0,
580 doc
: /* Check if ERROR is fatal.
581 ERROR is an integer or a symbol with an integer `gnutls-code' property.
582 usage: (gnutls-error-fatalp ERROR) */)
587 if (EQ (err
, Qt
)) return Qnil
;
591 code
= Fget (err
, Qgnutls_code
);
598 error ("Symbol has no numeric gnutls-code property");
602 if (! TYPE_RANGED_INTEGERP (int, err
))
603 error ("Not an error symbol or code");
605 if (0 == fn_gnutls_error_is_fatal (XINT (err
)))
611 DEFUN ("gnutls-error-string", Fgnutls_error_string
, Sgnutls_error_string
, 1, 1, 0,
612 doc
: /* Return a description of ERROR.
613 ERROR is an integer or a symbol with an integer `gnutls-code' property.
614 usage: (gnutls-error-string ERROR) */)
619 if (EQ (err
, Qt
)) return build_string ("Not an error");
623 code
= Fget (err
, Qgnutls_code
);
630 return build_string ("Symbol has no numeric gnutls-code property");
634 if (! TYPE_RANGED_INTEGERP (int, err
))
635 return build_string ("Not an error symbol or code");
637 return build_string (fn_gnutls_strerror (XINT (err
)));
640 DEFUN ("gnutls-deinit", Fgnutls_deinit
, Sgnutls_deinit
, 1, 1, 0,
641 doc
: /* Deallocate GnuTLS resources associated with process PROC.
642 See also `gnutls-init'. */)
645 return emacs_gnutls_deinit (proc
);
648 DEFUN ("gnutls-available-p", Fgnutls_available_p
, Sgnutls_available_p
, 0, 0, 0,
649 doc
: /* Return t if GnuTLS is available in this instance of Emacs. */)
653 Lisp_Object found
= Fassq (Qgnutls_dll
, Vlibrary_cache
);
659 status
= init_gnutls_functions (Vdynamic_library_alist
) ? Qt
: Qnil
;
660 Vlibrary_cache
= Fcons (Fcons (Qgnutls_dll
, status
), Vlibrary_cache
);
669 /* Initializes global GnuTLS state to defaults.
670 Call `gnutls-global-deinit' when GnuTLS usage is no longer needed.
671 Returns zero on success. */
673 emacs_gnutls_global_init (void)
675 int ret
= GNUTLS_E_SUCCESS
;
677 if (!gnutls_global_initialized
)
679 fn_gnutls_global_set_mem_functions (xmalloc
, xmalloc
, NULL
,
681 ret
= fn_gnutls_global_init ();
683 gnutls_global_initialized
= 1;
685 return gnutls_make_error (ret
);
689 /* Deinitializes global GnuTLS state.
690 See also `gnutls-global-init'. */
692 emacs_gnutls_global_deinit (void)
694 if (gnutls_global_initialized
)
695 gnutls_global_deinit ();
697 gnutls_global_initialized
= 0;
699 return gnutls_make_error (GNUTLS_E_SUCCESS
);
703 DEFUN ("gnutls-boot", Fgnutls_boot
, Sgnutls_boot
, 3, 3, 0,
704 doc
: /* Initialize GnuTLS client for process PROC with TYPE+PROPLIST.
705 Currently only client mode is supported. Return a success/failure
706 value you can check with `gnutls-errorp'.
708 TYPE is a symbol, either `gnutls-anon' or `gnutls-x509pki'.
709 PROPLIST is a property list with the following keys:
711 :hostname is a string naming the remote host.
713 :priority is a GnuTLS priority string, defaults to "NORMAL".
715 :trustfiles is a list of PEM-encoded trust files for `gnutls-x509pki'.
717 :crlfiles is a list of PEM-encoded CRL lists for `gnutls-x509pki'.
719 :keylist is an alist of PEM-encoded key files and PEM-encoded
720 certificates for `gnutls-x509pki'.
722 :callbacks is an alist of callback functions, see below.
724 :loglevel is the debug level requested from GnuTLS, try 4.
726 :verify-flags is a bitset as per GnuTLS'
727 gnutls_certificate_set_verify_flags.
729 :verify-hostname-error, if non-nil, makes a hostname mismatch an
730 error. Otherwise it will be just a warning.
732 :min-prime-bits is the minimum accepted number of bits the client will
733 accept in Diffie-Hellman key exchange.
735 The debug level will be set for this process AND globally for GnuTLS.
736 So if you set it higher or lower at any point, it affects global
739 Note that the priority is set on the client. The server does not use
740 the protocols's priority except for disabling protocols that were not
743 Processes must be initialized with this function before other GnuTLS
744 functions are used. This function allocates resources which can only
745 be deallocated by calling `gnutls-deinit' or by calling it again.
747 The callbacks alist can have a `verify' key, associated with a
748 verification function (UNUSED).
750 Each authentication type may need additional information in order to
751 work. For X.509 PKI (`gnutls-x509pki'), you probably need at least
752 one trustfile (usually a CA bundle). */)
753 (Lisp_Object proc
, Lisp_Object type
, Lisp_Object proplist
)
755 int ret
= GNUTLS_E_SUCCESS
;
756 int max_log_level
= 0;
758 gnutls_session_t state
;
759 gnutls_certificate_credentials_t x509_cred
= NULL
;
760 gnutls_anon_client_credentials_t anon_cred
= NULL
;
761 Lisp_Object global_init
;
762 char const *priority_string_ptr
= "NORMAL"; /* default priority string. */
763 unsigned int peer_verification
;
766 /* Placeholders for the property list elements. */
767 Lisp_Object priority_string
;
768 Lisp_Object trustfiles
;
769 Lisp_Object crlfiles
;
771 /* Lisp_Object callbacks; */
772 Lisp_Object loglevel
;
773 Lisp_Object hostname
;
774 /* Lisp_Object verify_error; */
775 Lisp_Object verify_hostname_error
;
776 Lisp_Object prime_bits
;
778 CHECK_PROCESS (proc
);
780 CHECK_LIST (proplist
);
782 if (NILP (Fgnutls_available_p ()))
784 error ("GnuTLS not available");
785 return gnutls_make_error (GNUTLS_EMACS_ERROR_NOT_LOADED
);
788 if (!EQ (type
, Qgnutls_x509pki
) && !EQ (type
, Qgnutls_anon
))
790 error ("Invalid GnuTLS credential type");
791 return gnutls_make_error (GNUTLS_EMACS_ERROR_INVALID_TYPE
);
794 hostname
= Fplist_get (proplist
, QCgnutls_bootprop_hostname
);
795 priority_string
= Fplist_get (proplist
, QCgnutls_bootprop_priority
);
796 trustfiles
= Fplist_get (proplist
, QCgnutls_bootprop_trustfiles
);
797 keylist
= Fplist_get (proplist
, QCgnutls_bootprop_keylist
);
798 crlfiles
= Fplist_get (proplist
, QCgnutls_bootprop_crlfiles
);
799 loglevel
= Fplist_get (proplist
, QCgnutls_bootprop_loglevel
);
800 verify_hostname_error
= Fplist_get (proplist
, QCgnutls_bootprop_verify_hostname_error
);
801 prime_bits
= Fplist_get (proplist
, QCgnutls_bootprop_min_prime_bits
);
803 if (!STRINGP (hostname
))
804 error ("gnutls-boot: invalid :hostname parameter");
805 c_hostname
= SSDATA (hostname
);
807 state
= XPROCESS (proc
)->gnutls_state
;
808 XPROCESS (proc
)->gnutls_p
= 1;
810 if (TYPE_RANGED_INTEGERP (int, loglevel
))
812 fn_gnutls_global_set_log_function (gnutls_log_function
);
813 fn_gnutls_global_set_log_level (XINT (loglevel
));
814 max_log_level
= XINT (loglevel
);
815 XPROCESS (proc
)->gnutls_log_level
= max_log_level
;
818 /* always initialize globals. */
819 global_init
= emacs_gnutls_global_init ();
820 if (! NILP (Fgnutls_errorp (global_init
)))
823 /* Before allocating new credentials, deallocate any credentials
824 that PROC might already have. */
825 emacs_gnutls_deinit (proc
);
827 /* Mark PROC as a GnuTLS process. */
828 XPROCESS (proc
)->gnutls_p
= 1;
829 XPROCESS (proc
)->gnutls_state
= NULL
;
830 XPROCESS (proc
)->gnutls_x509_cred
= NULL
;
831 XPROCESS (proc
)->gnutls_anon_cred
= NULL
;
832 XPROCESS (proc
)->gnutls_cred_type
= type
;
833 GNUTLS_INITSTAGE (proc
) = GNUTLS_STAGE_EMPTY
;
835 GNUTLS_LOG (1, max_log_level
, "allocating credentials");
836 if (EQ (type
, Qgnutls_x509pki
))
838 Lisp_Object verify_flags
;
839 unsigned int gnutls_verify_flags
= GNUTLS_VERIFY_ALLOW_X509_V1_CA_CRT
;
841 GNUTLS_LOG (2, max_log_level
, "allocating x509 credentials");
842 fn_gnutls_certificate_allocate_credentials (&x509_cred
);
843 XPROCESS (proc
)->gnutls_x509_cred
= x509_cred
;
845 verify_flags
= Fplist_get (proplist
, QCgnutls_bootprop_verify_flags
);
846 if (NUMBERP (verify_flags
))
848 gnutls_verify_flags
= XINT (verify_flags
);
849 GNUTLS_LOG (2, max_log_level
, "setting verification flags");
851 else if (NILP (verify_flags
))
852 GNUTLS_LOG (2, max_log_level
, "using default verification flags");
854 GNUTLS_LOG (2, max_log_level
, "ignoring invalid verify-flags");
856 fn_gnutls_certificate_set_verify_flags (x509_cred
, gnutls_verify_flags
);
858 else /* Qgnutls_anon: */
860 GNUTLS_LOG (2, max_log_level
, "allocating anon credentials");
861 fn_gnutls_anon_allocate_client_credentials (&anon_cred
);
862 XPROCESS (proc
)->gnutls_anon_cred
= anon_cred
;
865 GNUTLS_INITSTAGE (proc
) = GNUTLS_STAGE_CRED_ALLOC
;
867 if (EQ (type
, Qgnutls_x509pki
))
869 /* TODO: GNUTLS_X509_FMT_DER is also an option. */
870 int file_format
= GNUTLS_X509_FMT_PEM
;
873 for (tail
= trustfiles
; !NILP (tail
); tail
= Fcdr (tail
))
875 Lisp_Object trustfile
= Fcar (tail
);
876 if (STRINGP (trustfile
))
878 GNUTLS_LOG2 (1, max_log_level
, "setting the trustfile: ",
880 ret
= fn_gnutls_certificate_set_x509_trust_file
885 if (ret
< GNUTLS_E_SUCCESS
)
886 return gnutls_make_error (ret
);
890 emacs_gnutls_deinit (proc
);
891 error ("Invalid trustfile");
895 for (tail
= crlfiles
; !NILP (tail
); tail
= Fcdr (tail
))
897 Lisp_Object crlfile
= Fcar (tail
);
898 if (STRINGP (crlfile
))
900 GNUTLS_LOG2 (1, max_log_level
, "setting the CRL file: ",
902 ret
= fn_gnutls_certificate_set_x509_crl_file
903 (x509_cred
, SSDATA (crlfile
), file_format
);
905 if (ret
< GNUTLS_E_SUCCESS
)
906 return gnutls_make_error (ret
);
910 emacs_gnutls_deinit (proc
);
911 error ("Invalid CRL file");
915 for (tail
= keylist
; !NILP (tail
); tail
= Fcdr (tail
))
917 Lisp_Object keyfile
= Fcar (Fcar (tail
));
918 Lisp_Object certfile
= Fcar (Fcdr (tail
));
919 if (STRINGP (keyfile
) && STRINGP (certfile
))
921 GNUTLS_LOG2 (1, max_log_level
, "setting the client key file: ",
923 GNUTLS_LOG2 (1, max_log_level
, "setting the client cert file: ",
925 ret
= fn_gnutls_certificate_set_x509_key_file
926 (x509_cred
, SSDATA (certfile
), SSDATA (keyfile
), file_format
);
928 if (ret
< GNUTLS_E_SUCCESS
)
929 return gnutls_make_error (ret
);
933 emacs_gnutls_deinit (proc
);
934 error (STRINGP (keyfile
) ? "Invalid client cert file"
935 : "Invalid client key file");
940 GNUTLS_INITSTAGE (proc
) = GNUTLS_STAGE_FILES
;
941 GNUTLS_LOG (1, max_log_level
, "gnutls callbacks");
942 GNUTLS_INITSTAGE (proc
) = GNUTLS_STAGE_CALLBACKS
;
944 /* Call gnutls_init here: */
946 GNUTLS_LOG (1, max_log_level
, "gnutls_init");
947 ret
= fn_gnutls_init (&state
, GNUTLS_CLIENT
);
948 XPROCESS (proc
)->gnutls_state
= state
;
949 if (ret
< GNUTLS_E_SUCCESS
)
950 return gnutls_make_error (ret
);
951 GNUTLS_INITSTAGE (proc
) = GNUTLS_STAGE_INIT
;
953 if (STRINGP (priority_string
))
955 priority_string_ptr
= SSDATA (priority_string
);
956 GNUTLS_LOG2 (1, max_log_level
, "got non-default priority string:",
957 priority_string_ptr
);
961 GNUTLS_LOG2 (1, max_log_level
, "using default priority string:",
962 priority_string_ptr
);
965 GNUTLS_LOG (1, max_log_level
, "setting the priority string");
966 ret
= fn_gnutls_priority_set_direct (state
,
969 if (ret
< GNUTLS_E_SUCCESS
)
970 return gnutls_make_error (ret
);
972 GNUTLS_INITSTAGE (proc
) = GNUTLS_STAGE_PRIORITY
;
974 if (INTEGERP (prime_bits
))
975 fn_gnutls_dh_set_prime_bits (state
, XUINT (prime_bits
));
977 ret
= EQ (type
, Qgnutls_x509pki
)
978 ? fn_gnutls_credentials_set (state
, GNUTLS_CRD_CERTIFICATE
, x509_cred
)
979 : fn_gnutls_credentials_set (state
, GNUTLS_CRD_ANON
, anon_cred
);
980 if (ret
< GNUTLS_E_SUCCESS
)
981 return gnutls_make_error (ret
);
983 GNUTLS_INITSTAGE (proc
) = GNUTLS_STAGE_CRED_SET
;
984 ret
= emacs_gnutls_handshake (XPROCESS (proc
));
985 if (ret
< GNUTLS_E_SUCCESS
)
986 return gnutls_make_error (ret
);
988 /* Now verify the peer, following
989 http://www.gnu.org/software/gnutls/manual/html_node/Verifying-peer_0027s-certificate.html.
990 The peer should present at least one certificate in the chain; do a
991 check of the certificate's hostname with
992 gnutls_x509_crt_check_hostname() against :hostname. */
994 ret
= fn_gnutls_certificate_verify_peers2 (state
, &peer_verification
);
995 if (ret
< GNUTLS_E_SUCCESS
)
996 return gnutls_make_error (ret
);
998 if (XINT (loglevel
) > 0 && peer_verification
& GNUTLS_CERT_INVALID
)
999 message ("%s certificate could not be verified.", c_hostname
);
1001 if (peer_verification
& GNUTLS_CERT_REVOKED
)
1002 GNUTLS_LOG2 (1, max_log_level
, "certificate was revoked (CRL):",
1005 if (peer_verification
& GNUTLS_CERT_SIGNER_NOT_FOUND
)
1006 GNUTLS_LOG2 (1, max_log_level
, "certificate signer was not found:",
1009 if (peer_verification
& GNUTLS_CERT_SIGNER_NOT_CA
)
1010 GNUTLS_LOG2 (1, max_log_level
, "certificate signer is not a CA:",
1013 if (peer_verification
& GNUTLS_CERT_INSECURE_ALGORITHM
)
1014 GNUTLS_LOG2 (1, max_log_level
,
1015 "certificate was signed with an insecure algorithm:",
1018 if (peer_verification
& GNUTLS_CERT_NOT_ACTIVATED
)
1019 GNUTLS_LOG2 (1, max_log_level
, "certificate is not yet activated:",
1022 if (peer_verification
& GNUTLS_CERT_EXPIRED
)
1023 GNUTLS_LOG2 (1, max_log_level
, "certificate has expired:",
1026 if (peer_verification
!= 0)
1028 if (NILP (verify_hostname_error
))
1029 GNUTLS_LOG2 (1, max_log_level
, "certificate validation failed:",
1033 emacs_gnutls_deinit (proc
);
1034 error ("Certificate validation failed %s, verification code %d",
1035 c_hostname
, peer_verification
);
1039 /* Up to here the process is the same for X.509 certificates and
1040 OpenPGP keys. From now on X.509 certificates are assumed. This
1041 can be easily extended to work with openpgp keys as well. */
1042 if (fn_gnutls_certificate_type_get (state
) == GNUTLS_CRT_X509
)
1044 gnutls_x509_crt_t gnutls_verify_cert
;
1045 const gnutls_datum_t
*gnutls_verify_cert_list
;
1046 unsigned int gnutls_verify_cert_list_size
;
1048 ret
= fn_gnutls_x509_crt_init (&gnutls_verify_cert
);
1049 if (ret
< GNUTLS_E_SUCCESS
)
1050 return gnutls_make_error (ret
);
1052 gnutls_verify_cert_list
=
1053 fn_gnutls_certificate_get_peers (state
, &gnutls_verify_cert_list_size
);
1055 if (gnutls_verify_cert_list
== NULL
)
1057 fn_gnutls_x509_crt_deinit (gnutls_verify_cert
);
1058 emacs_gnutls_deinit (proc
);
1059 error ("No x509 certificate was found\n");
1062 /* We only check the first certificate in the given chain. */
1063 ret
= fn_gnutls_x509_crt_import (gnutls_verify_cert
,
1064 &gnutls_verify_cert_list
[0],
1065 GNUTLS_X509_FMT_DER
);
1067 if (ret
< GNUTLS_E_SUCCESS
)
1069 fn_gnutls_x509_crt_deinit (gnutls_verify_cert
);
1070 return gnutls_make_error (ret
);
1073 if (!fn_gnutls_x509_crt_check_hostname (gnutls_verify_cert
, c_hostname
))
1075 if (NILP (verify_hostname_error
))
1076 GNUTLS_LOG2 (1, max_log_level
, "x509 certificate does not match:",
1080 fn_gnutls_x509_crt_deinit (gnutls_verify_cert
);
1081 emacs_gnutls_deinit (proc
);
1082 error ("The x509 certificate does not match \"%s\"", c_hostname
);
1085 fn_gnutls_x509_crt_deinit (gnutls_verify_cert
);
1088 return gnutls_make_error (ret
);
1091 DEFUN ("gnutls-bye", Fgnutls_bye
,
1092 Sgnutls_bye
, 2, 2, 0,
1093 doc
: /* Terminate current GnuTLS connection for process PROC.
1094 The connection should have been initiated using `gnutls-handshake'.
1096 If CONT is not nil the TLS connection gets terminated and further
1097 receives and sends will be disallowed. If the return value is zero you
1098 may continue using the connection. If CONT is nil, GnuTLS actually
1099 sends an alert containing a close request and waits for the peer to
1100 reply with the same message. In order to reuse the connection you
1101 should wait for an EOF from the peer.
1103 This function may also return `gnutls-e-again', or
1104 `gnutls-e-interrupted'. */)
1105 (Lisp_Object proc
, Lisp_Object cont
)
1107 gnutls_session_t state
;
1110 CHECK_PROCESS (proc
);
1112 state
= XPROCESS (proc
)->gnutls_state
;
1114 ret
= fn_gnutls_bye (state
,
1115 NILP (cont
) ? GNUTLS_SHUT_RDWR
: GNUTLS_SHUT_WR
);
1117 return gnutls_make_error (ret
);
1121 syms_of_gnutls (void)
1123 gnutls_global_initialized
= 0;
1125 DEFSYM (Qgnutls_dll
, "gnutls");
1126 DEFSYM (Qgnutls_code
, "gnutls-code");
1127 DEFSYM (Qgnutls_anon
, "gnutls-anon");
1128 DEFSYM (Qgnutls_x509pki
, "gnutls-x509pki");
1129 DEFSYM (QCgnutls_bootprop_hostname
, ":hostname");
1130 DEFSYM (QCgnutls_bootprop_priority
, ":priority");
1131 DEFSYM (QCgnutls_bootprop_trustfiles
, ":trustfiles");
1132 DEFSYM (QCgnutls_bootprop_keylist
, ":keylist");
1133 DEFSYM (QCgnutls_bootprop_crlfiles
, ":crlfiles");
1134 DEFSYM (QCgnutls_bootprop_callbacks
, ":callbacks");
1135 DEFSYM (QCgnutls_bootprop_callbacks_verify
, "verify");
1136 DEFSYM (QCgnutls_bootprop_min_prime_bits
, ":min-prime-bits");
1137 DEFSYM (QCgnutls_bootprop_loglevel
, ":loglevel");
1138 DEFSYM (QCgnutls_bootprop_verify_flags
, ":verify-flags");
1139 DEFSYM (QCgnutls_bootprop_verify_hostname_error
, ":verify-hostname-error");
1141 DEFSYM (Qgnutls_e_interrupted
, "gnutls-e-interrupted");
1142 Fput (Qgnutls_e_interrupted
, Qgnutls_code
,
1143 make_number (GNUTLS_E_INTERRUPTED
));
1145 DEFSYM (Qgnutls_e_again
, "gnutls-e-again");
1146 Fput (Qgnutls_e_again
, Qgnutls_code
,
1147 make_number (GNUTLS_E_AGAIN
));
1149 DEFSYM (Qgnutls_e_invalid_session
, "gnutls-e-invalid-session");
1150 Fput (Qgnutls_e_invalid_session
, Qgnutls_code
,
1151 make_number (GNUTLS_E_INVALID_SESSION
));
1153 DEFSYM (Qgnutls_e_not_ready_for_handshake
, "gnutls-e-not-ready-for-handshake");
1154 Fput (Qgnutls_e_not_ready_for_handshake
, Qgnutls_code
,
1155 make_number (GNUTLS_E_APPLICATION_ERROR_MIN
));
1157 defsubr (&Sgnutls_get_initstage
);
1158 defsubr (&Sgnutls_errorp
);
1159 defsubr (&Sgnutls_error_fatalp
);
1160 defsubr (&Sgnutls_error_string
);
1161 defsubr (&Sgnutls_boot
);
1162 defsubr (&Sgnutls_deinit
);
1163 defsubr (&Sgnutls_bye
);
1164 defsubr (&Sgnutls_available_p
);
1166 DEFVAR_INT ("gnutls-log-level", global_gnutls_log_level
,
1167 doc
: /* Logging level used by the GnuTLS functions.
1168 Set this larger than 0 to get debug output in the *Messages* buffer.
1169 1 is for important messages, 2 is for debug data, and higher numbers
1170 are as per the GnuTLS logging conventions. */);
1171 global_gnutls_log_level
= 0;
1174 #endif /* HAVE_GNUTLS */