* admin/notes/bug-triage: Fix bug priorities. Explain colors in debbugs-gnu.
[emacs.git] / src / xselect.c
blob23b735ed89fc5aa8c279a36a69e3d3194a28d0ee
1 /* X Selection processing for Emacs.
2 Copyright (C) 1993-1997, 2000-2016 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/>. */
20 /* Rewritten by jwz */
22 #include <config.h>
23 #include <limits.h>
24 #include <stdio.h> /* termhooks.h needs this */
26 #ifdef HAVE_SYS_TYPES_H
27 #include <sys/types.h>
28 #endif
30 #include <unistd.h>
32 #include "lisp.h"
33 #include "xterm.h" /* for all of the X includes */
34 #include "frame.h" /* Need this to get the X window of selected_frame */
35 #include "blockinput.h"
36 #include "termhooks.h"
37 #include "keyboard.h"
39 #include <X11/Xproto.h>
41 struct prop_location;
42 struct selection_data;
44 static void x_decline_selection_request (struct selection_input_event *);
45 static bool x_convert_selection (Lisp_Object, Lisp_Object, Atom, bool,
46 struct x_display_info *);
47 static bool waiting_for_other_props_on_window (Display *, Window);
48 static struct prop_location *expect_property_change (Display *, Window,
49 Atom, int);
50 static void unexpect_property_change (struct prop_location *);
51 static void wait_for_property_change (struct prop_location *);
52 static Lisp_Object x_get_window_property_as_lisp_data (struct x_display_info *,
53 Window, Atom,
54 Lisp_Object, Atom);
55 static Lisp_Object selection_data_to_lisp_data (struct x_display_info *,
56 const unsigned char *,
57 ptrdiff_t, Atom, int);
58 static void lisp_data_to_selection_data (struct x_display_info *, Lisp_Object,
59 struct selection_data *);
61 /* Printing traces to stderr. */
63 #ifdef TRACE_SELECTION
64 #define TRACE0(fmt) \
65 fprintf (stderr, "%"pMd": " fmt "\n", (printmax_t) getpid ())
66 #define TRACE1(fmt, a0) \
67 fprintf (stderr, "%"pMd": " fmt "\n", (printmax_t) getpid (), a0)
68 #define TRACE2(fmt, a0, a1) \
69 fprintf (stderr, "%"pMd": " fmt "\n", (printmax_t) getpid (), a0, a1)
70 #define TRACE3(fmt, a0, a1, a2) \
71 fprintf (stderr, "%"pMd": " fmt "\n", (printmax_t) getpid (), a0, a1, a2)
72 #else
73 #define TRACE0(fmt) (void) 0
74 #define TRACE1(fmt, a0) (void) 0
75 #define TRACE2(fmt, a0, a1) (void) 0
76 #endif
78 /* Bytes needed to represent 'long' data. This is as per libX11; it
79 is not necessarily sizeof (long). */
80 #define X_LONG_SIZE 4
82 /* If this is a smaller number than the max-request-size of the display,
83 emacs will use INCR selection transfer when the selection is larger
84 than this. The max-request-size is usually around 64k, so if you want
85 emacs to use incremental selection transfers when the selection is
86 smaller than that, set this. I added this mostly for debugging the
87 incremental transfer stuff, but it might improve server performance.
89 This value cannot exceed INT_MAX / max (X_LONG_SIZE, sizeof (long))
90 because it is multiplied by X_LONG_SIZE and by sizeof (long) in
91 subscript calculations. Similarly for PTRDIFF_MAX - 1 or SIZE_MAX
92 - 1 in place of INT_MAX. */
93 #define MAX_SELECTION_QUANTUM \
94 ((int) min (0xFFFFFF, (min (INT_MAX, min (PTRDIFF_MAX, SIZE_MAX) - 1) \
95 / max (X_LONG_SIZE, sizeof (long)))))
97 static int
98 selection_quantum (Display *display)
100 long mrs = XMaxRequestSize (display);
101 return (mrs < MAX_SELECTION_QUANTUM / X_LONG_SIZE + 25
102 ? (mrs - 25) * X_LONG_SIZE
103 : MAX_SELECTION_QUANTUM);
106 #define LOCAL_SELECTION(selection_symbol,dpyinfo) \
107 assq_no_quit (selection_symbol, dpyinfo->terminal->Vselection_alist)
110 /* Define a queue to save up SELECTION_REQUEST_EVENT events for later
111 handling. */
113 struct selection_event_queue
115 struct selection_input_event event;
116 struct selection_event_queue *next;
119 static struct selection_event_queue *selection_queue;
121 /* Nonzero means queue up SELECTION_REQUEST_EVENT events. */
123 static int x_queue_selection_requests;
125 /* True if the input events are duplicates. */
127 static bool
128 selection_input_event_equal (struct selection_input_event *a,
129 struct selection_input_event *b)
131 return (a->kind == b->kind && a->dpyinfo == b->dpyinfo
132 && a->requestor == b->requestor && a->selection == b->selection
133 && a->target == b->target && a->property == b->property
134 && a->time == b->time);
137 /* Queue up an SELECTION_REQUEST_EVENT *EVENT, to be processed later. */
139 static void
140 x_queue_event (struct selection_input_event *event)
142 struct selection_event_queue *queue_tmp;
144 /* Don't queue repeated requests.
145 This only happens for large requests which uses the incremental protocol. */
146 for (queue_tmp = selection_queue; queue_tmp; queue_tmp = queue_tmp->next)
148 if (selection_input_event_equal (event, &queue_tmp->event))
150 TRACE1 ("DECLINE DUP SELECTION EVENT %p", queue_tmp);
151 x_decline_selection_request (event);
152 return;
156 queue_tmp = xmalloc (sizeof *queue_tmp);
157 TRACE1 ("QUEUE SELECTION EVENT %p", queue_tmp);
158 queue_tmp->event = *event;
159 queue_tmp->next = selection_queue;
160 selection_queue = queue_tmp;
163 /* Start queuing SELECTION_REQUEST_EVENT events. */
165 static void
166 x_start_queuing_selection_requests (void)
168 if (x_queue_selection_requests)
169 emacs_abort ();
171 x_queue_selection_requests++;
172 TRACE1 ("x_start_queuing_selection_requests %d", x_queue_selection_requests);
175 /* Stop queuing SELECTION_REQUEST_EVENT events. */
177 static void
178 x_stop_queuing_selection_requests (void)
180 TRACE1 ("x_stop_queuing_selection_requests %d", x_queue_selection_requests);
181 --x_queue_selection_requests;
183 /* Take all the queued events and put them back
184 so that they get processed afresh. */
186 while (selection_queue != NULL)
188 struct selection_event_queue *queue_tmp = selection_queue;
189 TRACE1 ("RESTORE SELECTION EVENT %p", queue_tmp);
190 kbd_buffer_unget_event (&queue_tmp->event);
191 selection_queue = queue_tmp->next;
192 xfree (queue_tmp);
197 /* This converts a Lisp symbol to a server Atom, avoiding a server
198 roundtrip whenever possible. */
200 static Atom
201 symbol_to_x_atom (struct x_display_info *dpyinfo, Lisp_Object sym)
203 Atom val;
204 if (NILP (sym)) return 0;
205 if (EQ (sym, QPRIMARY)) return XA_PRIMARY;
206 if (EQ (sym, QSECONDARY)) return XA_SECONDARY;
207 if (EQ (sym, QSTRING)) return XA_STRING;
208 if (EQ (sym, QINTEGER)) return XA_INTEGER;
209 if (EQ (sym, QATOM)) return XA_ATOM;
210 if (EQ (sym, QCLIPBOARD)) return dpyinfo->Xatom_CLIPBOARD;
211 if (EQ (sym, QTIMESTAMP)) return dpyinfo->Xatom_TIMESTAMP;
212 if (EQ (sym, QTEXT)) return dpyinfo->Xatom_TEXT;
213 if (EQ (sym, QCOMPOUND_TEXT)) return dpyinfo->Xatom_COMPOUND_TEXT;
214 if (EQ (sym, QUTF8_STRING)) return dpyinfo->Xatom_UTF8_STRING;
215 if (EQ (sym, QDELETE)) return dpyinfo->Xatom_DELETE;
216 if (EQ (sym, QMULTIPLE)) return dpyinfo->Xatom_MULTIPLE;
217 if (EQ (sym, QINCR)) return dpyinfo->Xatom_INCR;
218 if (EQ (sym, QEMACS_TMP)) return dpyinfo->Xatom_EMACS_TMP;
219 if (EQ (sym, QTARGETS)) return dpyinfo->Xatom_TARGETS;
220 if (EQ (sym, QNULL)) return dpyinfo->Xatom_NULL;
221 if (!SYMBOLP (sym)) emacs_abort ();
223 TRACE1 (" XInternAtom %s", SSDATA (SYMBOL_NAME (sym)));
224 block_input ();
225 val = XInternAtom (dpyinfo->display, SSDATA (SYMBOL_NAME (sym)), False);
226 unblock_input ();
227 return val;
231 /* This converts a server Atom to a Lisp symbol, avoiding server roundtrips
232 and calls to intern whenever possible. */
234 static Lisp_Object
235 x_atom_to_symbol (struct x_display_info *dpyinfo, Atom atom)
237 char *str;
238 Lisp_Object val;
240 if (! atom)
241 return Qnil;
243 switch (atom)
245 case XA_PRIMARY:
246 return QPRIMARY;
247 case XA_SECONDARY:
248 return QSECONDARY;
249 case XA_STRING:
250 return QSTRING;
251 case XA_INTEGER:
252 return QINTEGER;
253 case XA_ATOM:
254 return QATOM;
257 if (dpyinfo == NULL)
258 return Qnil;
259 if (atom == dpyinfo->Xatom_CLIPBOARD)
260 return QCLIPBOARD;
261 if (atom == dpyinfo->Xatom_TIMESTAMP)
262 return QTIMESTAMP;
263 if (atom == dpyinfo->Xatom_TEXT)
264 return QTEXT;
265 if (atom == dpyinfo->Xatom_COMPOUND_TEXT)
266 return QCOMPOUND_TEXT;
267 if (atom == dpyinfo->Xatom_UTF8_STRING)
268 return QUTF8_STRING;
269 if (atom == dpyinfo->Xatom_DELETE)
270 return QDELETE;
271 if (atom == dpyinfo->Xatom_MULTIPLE)
272 return QMULTIPLE;
273 if (atom == dpyinfo->Xatom_INCR)
274 return QINCR;
275 if (atom == dpyinfo->Xatom_EMACS_TMP)
276 return QEMACS_TMP;
277 if (atom == dpyinfo->Xatom_TARGETS)
278 return QTARGETS;
279 if (atom == dpyinfo->Xatom_NULL)
280 return QNULL;
282 block_input ();
283 str = XGetAtomName (dpyinfo->display, atom);
284 unblock_input ();
285 TRACE1 ("XGetAtomName --> %s", str);
286 if (! str) return Qnil;
287 val = intern (str);
288 block_input ();
289 /* This was allocated by Xlib, so use XFree. */
290 XFree (str);
291 unblock_input ();
292 return val;
295 /* Do protocol to assert ourself as a selection owner.
296 FRAME shall be the owner; it must be a valid X frame.
297 Update the Vselection_alist so that we can reply to later requests for
298 our selection. */
300 static void
301 x_own_selection (Lisp_Object selection_name, Lisp_Object selection_value,
302 Lisp_Object frame)
304 struct frame *f = XFRAME (frame);
305 Window selecting_window = FRAME_X_WINDOW (f);
306 struct x_display_info *dpyinfo = FRAME_DISPLAY_INFO (f);
307 Display *display = dpyinfo->display;
308 Time timestamp = dpyinfo->last_user_time;
309 Atom selection_atom = symbol_to_x_atom (dpyinfo, selection_name);
311 block_input ();
312 x_catch_errors (display);
313 XSetSelectionOwner (display, selection_atom, selecting_window, timestamp);
314 x_check_errors (display, "Can't set selection: %s");
315 x_uncatch_errors_after_check ();
316 unblock_input ();
318 /* Now update the local cache */
320 Lisp_Object selection_data;
321 Lisp_Object prev_value;
323 selection_data = list4 (selection_name, selection_value,
324 INTEGER_TO_CONS (timestamp), frame);
325 prev_value = LOCAL_SELECTION (selection_name, dpyinfo);
327 tset_selection_alist
328 (dpyinfo->terminal,
329 Fcons (selection_data, dpyinfo->terminal->Vselection_alist));
331 /* If we already owned the selection, remove the old selection
332 data. Don't use Fdelq as that may QUIT. */
333 if (!NILP (prev_value))
335 /* We know it's not the CAR, so it's easy. */
336 Lisp_Object rest = dpyinfo->terminal->Vselection_alist;
337 for (; CONSP (rest); rest = XCDR (rest))
338 if (EQ (prev_value, Fcar (XCDR (rest))))
340 XSETCDR (rest, XCDR (XCDR (rest)));
341 break;
347 /* Given a selection-name and desired type, look up our local copy of
348 the selection value and convert it to the type.
349 Return nil, a string, a vector, a symbol, an integer, or a cons
350 that CONS_TO_INTEGER could plausibly handle.
351 This function is used both for remote requests (LOCAL_REQUEST is zero)
352 and for local x-get-selection-internal (LOCAL_REQUEST is nonzero).
354 This calls random Lisp code, and may signal or gc. */
356 static Lisp_Object
357 x_get_local_selection (Lisp_Object selection_symbol, Lisp_Object target_type,
358 bool local_request, struct x_display_info *dpyinfo)
360 Lisp_Object local_value;
361 Lisp_Object handler_fn, value, check;
363 local_value = LOCAL_SELECTION (selection_symbol, dpyinfo);
365 if (NILP (local_value)) return Qnil;
367 /* TIMESTAMP is a special case. */
368 if (EQ (target_type, QTIMESTAMP))
370 handler_fn = Qnil;
371 value = XCAR (XCDR (XCDR (local_value)));
373 else
375 /* Don't allow a quit within the converter.
376 When the user types C-g, he would be surprised
377 if by luck it came during a converter. */
378 ptrdiff_t count = SPECPDL_INDEX ();
379 specbind (Qinhibit_quit, Qt);
381 CHECK_SYMBOL (target_type);
382 handler_fn = Fcdr (Fassq (target_type, Vselection_converter_alist));
384 if (!NILP (handler_fn))
385 value = call3 (handler_fn,
386 selection_symbol, (local_request ? Qnil : target_type),
387 XCAR (XCDR (local_value)));
388 else
389 value = Qnil;
390 unbind_to (count, Qnil);
393 /* Make sure this value is of a type that we could transmit
394 to another X client. */
396 check = value;
397 if (CONSP (value)
398 && SYMBOLP (XCAR (value)))
399 check = XCDR (value);
401 if (STRINGP (check)
402 || VECTORP (check)
403 || SYMBOLP (check)
404 || INTEGERP (check)
405 || NILP (value))
406 return value;
407 /* Check for a value that CONS_TO_INTEGER could handle. */
408 else if (CONSP (check)
409 && INTEGERP (XCAR (check))
410 && (INTEGERP (XCDR (check))
412 (CONSP (XCDR (check))
413 && INTEGERP (XCAR (XCDR (check)))
414 && NILP (XCDR (XCDR (check))))))
415 return value;
417 signal_error ("Invalid data returned by selection-conversion function",
418 list2 (handler_fn, value));
421 /* Subroutines of x_reply_selection_request. */
423 /* Send a SelectionNotify event to the requestor with property=None,
424 meaning we were unable to do what they wanted. */
426 static void
427 x_decline_selection_request (struct selection_input_event *event)
429 XEvent reply_base;
430 XSelectionEvent *reply = &(reply_base.xselection);
432 reply->type = SelectionNotify;
433 reply->display = SELECTION_EVENT_DISPLAY (event);
434 reply->requestor = SELECTION_EVENT_REQUESTOR (event);
435 reply->selection = SELECTION_EVENT_SELECTION (event);
436 reply->time = SELECTION_EVENT_TIME (event);
437 reply->target = SELECTION_EVENT_TARGET (event);
438 reply->property = None;
440 /* The reason for the error may be that the receiver has
441 died in the meantime. Handle that case. */
442 block_input ();
443 x_catch_errors (reply->display);
444 XSendEvent (reply->display, reply->requestor, False, 0, &reply_base);
445 XFlush (reply->display);
446 x_uncatch_errors ();
447 unblock_input ();
450 /* This is the selection request currently being processed.
451 It is set to zero when the request is fully processed. */
452 static struct selection_input_event *x_selection_current_request;
454 /* Display info in x_selection_request. */
456 static struct x_display_info *selection_request_dpyinfo;
458 /* Raw selection data, for sending to a requestor window. */
460 struct selection_data
462 unsigned char *data;
463 ptrdiff_t size;
464 int format;
465 Atom type;
466 bool nofree;
467 Atom property;
468 /* This can be set to non-NULL during x_reply_selection_request, if
469 the selection is waiting for an INCR transfer to complete. Don't
470 free these; that's done by unexpect_property_change. */
471 struct prop_location *wait_object;
472 struct selection_data *next;
475 /* Linked list of the above (in support of MULTIPLE targets). */
477 static struct selection_data *converted_selections;
479 /* "Data" to send a requestor for a failed MULTIPLE subtarget. */
480 static Atom conversion_fail_tag;
482 /* Used as an unwind-protect clause so that, if a selection-converter signals
483 an error, we tell the requestor that we were unable to do what they wanted
484 before we throw to top-level or go into the debugger or whatever. */
486 static void
487 x_selection_request_lisp_error (void)
489 struct selection_data *cs, *next;
491 for (cs = converted_selections; cs; cs = next)
493 next = cs->next;
494 if (! cs->nofree && cs->data)
495 xfree (cs->data);
496 xfree (cs);
498 converted_selections = NULL;
500 if (x_selection_current_request != 0
501 && selection_request_dpyinfo->display)
502 x_decline_selection_request (x_selection_current_request);
505 static void
506 x_catch_errors_unwind (void)
508 block_input ();
509 x_uncatch_errors ();
510 unblock_input ();
514 /* This stuff is so that INCR selections are reentrant (that is, so we can
515 be servicing multiple INCR selection requests simultaneously.) I haven't
516 actually tested that yet. */
518 /* Keep a list of the property changes that are awaited. */
520 struct prop_location
522 int identifier;
523 Display *display;
524 Window window;
525 Atom property;
526 int desired_state;
527 bool arrived;
528 struct prop_location *next;
531 static int prop_location_identifier;
533 static Lisp_Object property_change_reply;
535 static struct prop_location *property_change_reply_object;
537 static struct prop_location *property_change_wait_list;
539 static void
540 set_property_change_object (struct prop_location *location)
542 /* Input must be blocked so we don't get the event before we set these. */
543 if (! input_blocked_p ())
544 emacs_abort ();
545 XSETCAR (property_change_reply, Qnil);
546 property_change_reply_object = location;
550 /* Send the reply to a selection request event EVENT. */
552 #ifdef TRACE_SELECTION
553 static int x_reply_selection_request_cnt;
554 #endif /* TRACE_SELECTION */
556 static void
557 x_reply_selection_request (struct selection_input_event *event,
558 struct x_display_info *dpyinfo)
560 XEvent reply_base;
561 XSelectionEvent *reply = &(reply_base.xselection);
562 Display *display = SELECTION_EVENT_DISPLAY (event);
563 Window window = SELECTION_EVENT_REQUESTOR (event);
564 ptrdiff_t bytes_remaining;
565 int max_bytes = selection_quantum (display);
566 ptrdiff_t count = SPECPDL_INDEX ();
567 struct selection_data *cs;
569 reply->type = SelectionNotify;
570 reply->display = display;
571 reply->requestor = window;
572 reply->selection = SELECTION_EVENT_SELECTION (event);
573 reply->time = SELECTION_EVENT_TIME (event);
574 reply->target = SELECTION_EVENT_TARGET (event);
575 reply->property = SELECTION_EVENT_PROPERTY (event);
576 if (reply->property == None)
577 reply->property = reply->target;
579 block_input ();
580 /* The protected block contains wait_for_property_change, which can
581 run random lisp code (process handlers) or signal. Therefore, we
582 put the x_uncatch_errors call in an unwind. */
583 record_unwind_protect_void (x_catch_errors_unwind);
584 x_catch_errors (display);
586 /* Loop over converted selections, storing them in the requested
587 properties. If data is large, only store the first N bytes
588 (section 2.7.2 of ICCCM). Note that we store the data for a
589 MULTIPLE request in the opposite order; the ICCM says only that
590 the conversion itself must be done in the same order. */
591 for (cs = converted_selections; cs; cs = cs->next)
593 if (cs->property == None)
594 continue;
596 bytes_remaining = cs->size;
597 bytes_remaining *= cs->format >> 3;
598 if (bytes_remaining <= max_bytes)
600 /* Send all the data at once, with minimal handshaking. */
601 TRACE1 ("Sending all %"pD"d bytes", bytes_remaining);
602 XChangeProperty (display, window, cs->property,
603 cs->type, cs->format, PropModeReplace,
604 cs->data, cs->size);
606 else
608 /* Send an INCR tag to initiate incremental transfer. */
609 long value[1];
611 TRACE2 ("Start sending %"pD"d bytes incrementally (%s)",
612 bytes_remaining, XGetAtomName (display, cs->property));
613 cs->wait_object
614 = expect_property_change (display, window, cs->property,
615 PropertyDelete);
617 /* XChangeProperty expects an array of long even if long is
618 more than 32 bits. */
619 value[0] = min (bytes_remaining, X_LONG_MAX);
620 XChangeProperty (display, window, cs->property,
621 dpyinfo->Xatom_INCR, 32, PropModeReplace,
622 (unsigned char *) value, 1);
623 XSelectInput (display, window, PropertyChangeMask);
627 /* Now issue the SelectionNotify event. */
628 XSendEvent (display, window, False, 0, &reply_base);
629 XFlush (display);
631 #ifdef TRACE_SELECTION
633 char *sel = XGetAtomName (display, reply->selection);
634 char *tgt = XGetAtomName (display, reply->target);
635 TRACE3 ("Sent SelectionNotify: %s, target %s (%d)",
636 sel, tgt, ++x_reply_selection_request_cnt);
637 if (sel) XFree (sel);
638 if (tgt) XFree (tgt);
640 #endif /* TRACE_SELECTION */
642 /* Finish sending the rest of each of the INCR values. This should
643 be improved; there's a chance of deadlock if more than one
644 subtarget in a MULTIPLE selection requires an INCR transfer, and
645 the requestor and Emacs loop waiting on different transfers. */
646 for (cs = converted_selections; cs; cs = cs->next)
647 if (cs->wait_object)
649 int format_bytes = cs->format / 8;
650 bool had_errors_p = x_had_errors_p (display);
652 /* Must set this inside block_input (). unblock_input may read
653 events and setting property_change_reply in
654 wait_for_property_change is then too late. */
655 set_property_change_object (cs->wait_object);
656 unblock_input ();
658 bytes_remaining = cs->size;
659 bytes_remaining *= format_bytes;
661 /* Wait for the requestor to ack by deleting the property.
662 This can run Lisp code (process handlers) or signal. */
663 if (! had_errors_p)
665 TRACE1 ("Waiting for ACK (deletion of %s)",
666 XGetAtomName (display, cs->property));
667 wait_for_property_change (cs->wait_object);
669 else
670 unexpect_property_change (cs->wait_object);
672 while (bytes_remaining)
674 int i = ((bytes_remaining < max_bytes)
675 ? bytes_remaining
676 : max_bytes) / format_bytes;
677 block_input ();
679 cs->wait_object
680 = expect_property_change (display, window, cs->property,
681 PropertyDelete);
683 TRACE1 ("Sending increment of %d elements", i);
684 TRACE1 ("Set %s to increment data",
685 XGetAtomName (display, cs->property));
687 /* Append the next chunk of data to the property. */
688 XChangeProperty (display, window, cs->property,
689 cs->type, cs->format, PropModeAppend,
690 cs->data, i);
691 bytes_remaining -= i * format_bytes;
692 cs->data += i * ((cs->format == 32) ? sizeof (long)
693 : format_bytes);
694 XFlush (display);
695 had_errors_p = x_had_errors_p (display);
696 // See comment above about property_change_reply.
697 set_property_change_object (cs->wait_object);
698 unblock_input ();
700 if (had_errors_p) break;
702 /* Wait for the requestor to ack this chunk by deleting
703 the property. This can run Lisp code or signal. */
704 TRACE1 ("Waiting for increment ACK (deletion of %s)",
705 XGetAtomName (display, cs->property));
706 wait_for_property_change (cs->wait_object);
709 /* Now write a zero-length chunk to the property to tell the
710 requestor that we're done. */
711 block_input ();
712 if (! waiting_for_other_props_on_window (display, window))
713 XSelectInput (display, window, 0);
715 TRACE1 ("Set %s to a 0-length chunk to indicate EOF",
716 XGetAtomName (display, cs->property));
717 XChangeProperty (display, window, cs->property,
718 cs->type, cs->format, PropModeReplace,
719 cs->data, 0);
720 TRACE0 ("Done sending incrementally");
723 /* rms, 2003-01-03: I think I have fixed this bug. */
724 /* The window we're communicating with may have been deleted
725 in the meantime (that's a real situation from a bug report).
726 In this case, there may be events in the event queue still
727 referring to the deleted window, and we'll get a BadWindow error
728 in XTread_socket when processing the events. I don't have
729 an idea how to fix that. gerd, 2001-01-98. */
730 /* 2004-09-10: XSync and UNBLOCK so that possible protocol errors are
731 delivered before uncatch errors. */
732 XSync (display, False);
733 unblock_input ();
735 /* GTK queues events in addition to the queue in Xlib. So we
736 UNBLOCK to enter the event loop and get possible errors delivered,
737 and then BLOCK again because x_uncatch_errors requires it. */
738 block_input ();
739 /* This calls x_uncatch_errors. */
740 unbind_to (count, Qnil);
741 unblock_input ();
744 /* Handle a SelectionRequest event EVENT.
745 This is called from keyboard.c when such an event is found in the queue. */
747 static void
748 x_handle_selection_request (struct selection_input_event *event)
750 Time local_selection_time;
752 struct x_display_info *dpyinfo = SELECTION_EVENT_DPYINFO (event);
753 Atom selection = SELECTION_EVENT_SELECTION (event);
754 Lisp_Object selection_symbol = x_atom_to_symbol (dpyinfo, selection);
755 Atom target = SELECTION_EVENT_TARGET (event);
756 Lisp_Object target_symbol = x_atom_to_symbol (dpyinfo, target);
757 Atom property = SELECTION_EVENT_PROPERTY (event);
758 Lisp_Object local_selection_data;
759 bool success = false;
760 ptrdiff_t count = SPECPDL_INDEX ();
762 if (!dpyinfo) goto DONE;
764 local_selection_data = LOCAL_SELECTION (selection_symbol, dpyinfo);
766 /* Decline if we don't own any selections. */
767 if (NILP (local_selection_data)) goto DONE;
769 /* Decline requests issued prior to our acquiring the selection. */
770 CONS_TO_INTEGER (XCAR (XCDR (XCDR (local_selection_data))),
771 Time, local_selection_time);
772 if (SELECTION_EVENT_TIME (event) != CurrentTime
773 && local_selection_time > SELECTION_EVENT_TIME (event))
774 goto DONE;
776 x_selection_current_request = event;
777 selection_request_dpyinfo = dpyinfo;
778 record_unwind_protect_void (x_selection_request_lisp_error);
780 /* We might be able to handle nested x_handle_selection_requests,
781 but this is difficult to test, and seems unimportant. */
782 x_start_queuing_selection_requests ();
783 record_unwind_protect_void (x_stop_queuing_selection_requests);
785 TRACE2 ("x_handle_selection_request: selection=%s, target=%s",
786 SDATA (SYMBOL_NAME (selection_symbol)),
787 SDATA (SYMBOL_NAME (target_symbol)));
789 if (EQ (target_symbol, QMULTIPLE))
791 /* For MULTIPLE targets, the event property names a list of atom
792 pairs; the first atom names a target and the second names a
793 non-None property. */
794 Window requestor = SELECTION_EVENT_REQUESTOR (event);
795 Lisp_Object multprop;
796 ptrdiff_t j, nselections;
798 if (property == None) goto DONE;
799 multprop
800 = x_get_window_property_as_lisp_data (dpyinfo, requestor, property,
801 QMULTIPLE, selection);
803 if (!VECTORP (multprop) || ASIZE (multprop) % 2)
804 goto DONE;
806 nselections = ASIZE (multprop) / 2;
807 /* Perform conversions. This can signal. */
808 for (j = 0; j < nselections; j++)
810 Lisp_Object subtarget = AREF (multprop, 2*j);
811 Atom subproperty = symbol_to_x_atom (dpyinfo,
812 AREF (multprop, 2*j+1));
814 if (subproperty != None)
815 x_convert_selection (selection_symbol, subtarget,
816 subproperty, true, dpyinfo);
818 success = true;
820 else
822 if (property == None)
823 property = SELECTION_EVENT_TARGET (event);
824 success = x_convert_selection (selection_symbol,
825 target_symbol, property,
826 false, dpyinfo);
829 DONE:
831 if (success)
832 x_reply_selection_request (event, dpyinfo);
833 else
834 x_decline_selection_request (event);
835 x_selection_current_request = 0;
837 /* Run the `x-sent-selection-functions' abnormal hook. */
838 if (!NILP (Vx_sent_selection_functions)
839 && !EQ (Vx_sent_selection_functions, Qunbound))
840 CALLN (Frun_hook_with_args, Qx_sent_selection_functions,
841 selection_symbol, target_symbol, success ? Qt : Qnil);
843 unbind_to (count, Qnil);
846 /* Perform the requested selection conversion, and write the data to
847 the converted_selections linked list, where it can be accessed by
848 x_reply_selection_request. If FOR_MULTIPLE, write out
849 the data even if conversion fails, using conversion_fail_tag.
851 Return true iff successful. */
853 static bool
854 x_convert_selection (Lisp_Object selection_symbol,
855 Lisp_Object target_symbol, Atom property,
856 bool for_multiple, struct x_display_info *dpyinfo)
858 Lisp_Object lisp_selection;
859 struct selection_data *cs;
861 lisp_selection
862 = x_get_local_selection (selection_symbol, target_symbol,
863 false, dpyinfo);
865 /* A nil return value means we can't perform the conversion. */
866 if (NILP (lisp_selection)
867 || (CONSP (lisp_selection) && NILP (XCDR (lisp_selection))))
869 if (for_multiple)
871 cs = xmalloc (sizeof *cs);
872 cs->data = (unsigned char *) &conversion_fail_tag;
873 cs->size = 1;
874 cs->format = 32;
875 cs->type = XA_ATOM;
876 cs->nofree = true;
877 cs->property = property;
878 cs->wait_object = NULL;
879 cs->next = converted_selections;
880 converted_selections = cs;
883 return false;
886 /* Otherwise, record the converted selection to binary. */
887 cs = xmalloc (sizeof *cs);
888 cs->data = NULL;
889 cs->nofree = true;
890 cs->property = property;
891 cs->wait_object = NULL;
892 cs->next = converted_selections;
893 converted_selections = cs;
894 lisp_data_to_selection_data (dpyinfo, lisp_selection, cs);
895 return true;
898 /* Handle a SelectionClear event EVENT, which indicates that some
899 client cleared out our previously asserted selection.
900 This is called from keyboard.c when such an event is found in the queue. */
902 static void
903 x_handle_selection_clear (struct selection_input_event *event)
905 Atom selection = SELECTION_EVENT_SELECTION (event);
906 Time changed_owner_time = SELECTION_EVENT_TIME (event);
908 Lisp_Object selection_symbol, local_selection_data;
909 Time local_selection_time;
910 struct x_display_info *dpyinfo = SELECTION_EVENT_DPYINFO (event);
911 Lisp_Object Vselection_alist;
913 TRACE0 ("x_handle_selection_clear");
915 if (!dpyinfo) return;
917 selection_symbol = x_atom_to_symbol (dpyinfo, selection);
918 local_selection_data = LOCAL_SELECTION (selection_symbol, dpyinfo);
920 /* Well, we already believe that we don't own it, so that's just fine. */
921 if (NILP (local_selection_data)) return;
923 CONS_TO_INTEGER (XCAR (XCDR (XCDR (local_selection_data))),
924 Time, local_selection_time);
926 /* We have reasserted the selection since this SelectionClear was
927 generated, so we can disregard it. */
928 if (changed_owner_time != CurrentTime
929 && local_selection_time > changed_owner_time)
930 return;
932 /* Otherwise, really clear. Don't use Fdelq as that may QUIT;. */
933 Vselection_alist = dpyinfo->terminal->Vselection_alist;
934 if (EQ (local_selection_data, CAR (Vselection_alist)))
935 Vselection_alist = XCDR (Vselection_alist);
936 else
938 Lisp_Object rest;
939 for (rest = Vselection_alist; CONSP (rest); rest = XCDR (rest))
940 if (EQ (local_selection_data, CAR (XCDR (rest))))
942 XSETCDR (rest, XCDR (XCDR (rest)));
943 break;
946 tset_selection_alist (dpyinfo->terminal, Vselection_alist);
948 /* Run the `x-lost-selection-functions' abnormal hook. */
949 CALLN (Frun_hook_with_args, Qx_lost_selection_functions, selection_symbol);
951 redisplay_preserve_echo_area (20);
954 void
955 x_handle_selection_event (struct selection_input_event *event)
957 TRACE0 ("x_handle_selection_event");
958 if (event->kind != SELECTION_REQUEST_EVENT)
959 x_handle_selection_clear (event);
960 else if (x_queue_selection_requests)
961 x_queue_event (event);
962 else
963 x_handle_selection_request (event);
967 /* Clear all selections that were made from frame F.
968 We do this when about to delete a frame. */
970 void
971 x_clear_frame_selections (struct frame *f)
973 Lisp_Object frame;
974 Lisp_Object rest;
975 struct x_display_info *dpyinfo = FRAME_DISPLAY_INFO (f);
976 struct terminal *t = dpyinfo->terminal;
978 XSETFRAME (frame, f);
980 /* Delete elements from the beginning of Vselection_alist. */
981 while (CONSP (t->Vselection_alist)
982 && EQ (frame, XCAR (XCDR (XCDR (XCDR (XCAR (t->Vselection_alist)))))))
984 /* Run the `x-lost-selection-functions' abnormal hook. */
985 CALLN (Frun_hook_with_args, Qx_lost_selection_functions,
986 Fcar (Fcar (t->Vselection_alist)));
988 tset_selection_alist (t, XCDR (t->Vselection_alist));
991 /* Delete elements after the beginning of Vselection_alist. */
992 for (rest = t->Vselection_alist; CONSP (rest); rest = XCDR (rest))
993 if (CONSP (XCDR (rest))
994 && EQ (frame, XCAR (XCDR (XCDR (XCDR (XCAR (XCDR (rest))))))))
996 CALLN (Frun_hook_with_args, Qx_lost_selection_functions,
997 XCAR (XCAR (XCDR (rest))));
998 XSETCDR (rest, XCDR (XCDR (rest)));
999 break;
1003 /* True if any properties for DISPLAY and WINDOW
1004 are on the list of what we are waiting for. */
1006 static bool
1007 waiting_for_other_props_on_window (Display *display, Window window)
1009 for (struct prop_location *p = property_change_wait_list; p; p = p->next)
1010 if (p->display == display && p->window == window)
1011 return true;
1012 return false;
1015 /* Add an entry to the list of property changes we are waiting for.
1016 DISPLAY, WINDOW, PROPERTY, STATE describe what we will wait for.
1017 The return value is a number that uniquely identifies
1018 this awaited property change. */
1020 static struct prop_location *
1021 expect_property_change (Display *display, Window window,
1022 Atom property, int state)
1024 struct prop_location *pl = xmalloc (sizeof *pl);
1025 pl->identifier = ++prop_location_identifier;
1026 pl->display = display;
1027 pl->window = window;
1028 pl->property = property;
1029 pl->desired_state = state;
1030 pl->next = property_change_wait_list;
1031 pl->arrived = false;
1032 property_change_wait_list = pl;
1033 return pl;
1036 /* Delete an entry from the list of property changes we are waiting for.
1037 IDENTIFIER is the number that uniquely identifies the entry. */
1039 static void
1040 unexpect_property_change (struct prop_location *location)
1042 struct prop_location *prop, **pprev = &property_change_wait_list;
1044 for (prop = property_change_wait_list; prop; prop = *pprev)
1046 if (prop == location)
1048 *pprev = prop->next;
1049 xfree (prop);
1050 break;
1052 else
1053 pprev = &prop->next;
1057 /* Remove the property change expectation element for IDENTIFIER. */
1059 static void
1060 wait_for_property_change_unwind (void *loc)
1062 struct prop_location *location = loc;
1064 unexpect_property_change (location);
1065 if (location == property_change_reply_object)
1066 property_change_reply_object = 0;
1069 /* Actually wait for a property change.
1070 IDENTIFIER should be the value that expect_property_change returned. */
1072 static void
1073 wait_for_property_change (struct prop_location *location)
1075 ptrdiff_t count = SPECPDL_INDEX ();
1077 /* Make sure to do unexpect_property_change if we quit or err. */
1078 record_unwind_protect_ptr (wait_for_property_change_unwind, location);
1080 /* See comment in x_reply_selection_request about setting
1081 property_change_reply. Do not do it here. */
1083 /* If the event we are waiting for arrives beyond here, it will set
1084 property_change_reply, because property_change_reply_object says so. */
1085 if (! location->arrived)
1087 EMACS_INT timeout = max (0, x_selection_timeout);
1088 EMACS_INT secs = timeout / 1000;
1089 int nsecs = (timeout % 1000) * 1000000;
1090 TRACE2 (" Waiting %"pI"d secs, %d nsecs", secs, nsecs);
1091 wait_reading_process_output (secs, nsecs, 0, false,
1092 property_change_reply, NULL, 0);
1094 if (NILP (XCAR (property_change_reply)))
1096 TRACE0 (" Timed out");
1097 error ("Timed out waiting for property-notify event");
1101 unbind_to (count, Qnil);
1104 /* Called from XTread_socket in response to a PropertyNotify event. */
1106 void
1107 x_handle_property_notify (const XPropertyEvent *event)
1109 struct prop_location *rest;
1111 for (rest = property_change_wait_list; rest; rest = rest->next)
1113 if (!rest->arrived
1114 && rest->property == event->atom
1115 && rest->window == event->window
1116 && rest->display == event->display
1117 && rest->desired_state == event->state)
1119 TRACE2 ("Expected %s of property %s",
1120 (event->state == PropertyDelete ? "deletion" : "change"),
1121 XGetAtomName (event->display, event->atom));
1123 rest->arrived = true;
1125 /* If this is the one wait_for_property_change is waiting for,
1126 tell it to wake up. */
1127 if (rest == property_change_reply_object)
1128 XSETCAR (property_change_reply, Qt);
1130 return;
1137 /* Variables for communication with x_handle_selection_notify. */
1138 static Atom reading_which_selection;
1139 static Lisp_Object reading_selection_reply;
1140 static Window reading_selection_window;
1142 /* Do protocol to read selection-data from the server.
1143 Converts this to Lisp data and returns it.
1144 FRAME is the frame whose X window shall request the selection. */
1146 static Lisp_Object
1147 x_get_foreign_selection (Lisp_Object selection_symbol, Lisp_Object target_type,
1148 Lisp_Object time_stamp, Lisp_Object frame)
1150 struct frame *f = XFRAME (frame);
1151 struct x_display_info *dpyinfo = FRAME_DISPLAY_INFO (f);
1152 Display *display = dpyinfo->display;
1153 Window requestor_window = FRAME_X_WINDOW (f);
1154 Time requestor_time = dpyinfo->last_user_time;
1155 Atom target_property = dpyinfo->Xatom_EMACS_TMP;
1156 Atom selection_atom = symbol_to_x_atom (dpyinfo, selection_symbol);
1157 Atom type_atom = (CONSP (target_type)
1158 ? symbol_to_x_atom (dpyinfo, XCAR (target_type))
1159 : symbol_to_x_atom (dpyinfo, target_type));
1160 EMACS_INT timeout, secs;
1161 int nsecs;
1163 if (!FRAME_LIVE_P (f))
1164 return Qnil;
1166 if (! NILP (time_stamp))
1167 CONS_TO_INTEGER (time_stamp, Time, requestor_time);
1169 block_input ();
1170 TRACE2 ("Get selection %s, type %s",
1171 XGetAtomName (display, type_atom),
1172 XGetAtomName (display, target_property));
1174 x_catch_errors (display);
1175 XConvertSelection (display, selection_atom, type_atom, target_property,
1176 requestor_window, requestor_time);
1177 x_check_errors (display, "Can't convert selection: %s");
1178 x_uncatch_errors_after_check ();
1180 /* Prepare to block until the reply has been read. */
1181 reading_selection_window = requestor_window;
1182 reading_which_selection = selection_atom;
1183 XSETCAR (reading_selection_reply, Qnil);
1185 /* It should not be necessary to stop handling selection requests
1186 during this time. In fact, the SAVE_TARGETS mechanism requires
1187 us to handle a clipboard manager's requests before it returns
1188 SelectionNotify. */
1189 #if false
1190 x_start_queuing_selection_requests ();
1191 record_unwind_protect_void (x_stop_queuing_selection_requests);
1192 #endif
1194 unblock_input ();
1196 /* This allows quits. Also, don't wait forever. */
1197 timeout = max (0, x_selection_timeout);
1198 secs = timeout / 1000;
1199 nsecs = (timeout % 1000) * 1000000;
1200 TRACE1 (" Start waiting %"pI"d secs for SelectionNotify", secs);
1201 wait_reading_process_output (secs, nsecs, 0, false,
1202 reading_selection_reply, NULL, 0);
1203 TRACE1 (" Got event = %d", !NILP (XCAR (reading_selection_reply)));
1205 if (NILP (XCAR (reading_selection_reply)))
1206 error ("Timed out waiting for reply from selection owner");
1207 if (EQ (XCAR (reading_selection_reply), Qlambda))
1208 return Qnil;
1210 /* Otherwise, the selection is waiting for us on the requested property. */
1211 return
1212 x_get_window_property_as_lisp_data (dpyinfo, requestor_window,
1213 target_property, target_type,
1214 selection_atom);
1217 /* Subroutines of x_get_window_property_as_lisp_data */
1219 /* Use xfree, not XFree, to free the data obtained with this function. */
1221 static void
1222 x_get_window_property (Display *display, Window window, Atom property,
1223 unsigned char **data_ret, ptrdiff_t *bytes_ret,
1224 Atom *actual_type_ret, int *actual_format_ret,
1225 unsigned long *actual_size_ret)
1227 ptrdiff_t total_size;
1228 unsigned long bytes_remaining;
1229 ptrdiff_t offset = 0;
1230 unsigned char *data = 0;
1231 unsigned char *tmp_data = 0;
1232 int result;
1233 int buffer_size = selection_quantum (display);
1235 /* Wide enough to avoid overflow in expressions using it. */
1236 ptrdiff_t x_long_size = X_LONG_SIZE;
1238 /* Maximum value for TOTAL_SIZE. It cannot exceed PTRDIFF_MAX - 1
1239 and SIZE_MAX - 1, for an extra byte at the end. And it cannot
1240 exceed LONG_MAX * X_LONG_SIZE, for XGetWindowProperty. */
1241 ptrdiff_t total_size_max =
1242 ((min (PTRDIFF_MAX, SIZE_MAX) - 1) / x_long_size < LONG_MAX
1243 ? min (PTRDIFF_MAX, SIZE_MAX) - 1
1244 : LONG_MAX * x_long_size);
1246 block_input ();
1248 /* First probe the thing to find out how big it is. */
1249 result = XGetWindowProperty (display, window, property,
1250 0, 0, False, AnyPropertyType,
1251 actual_type_ret, actual_format_ret,
1252 actual_size_ret,
1253 &bytes_remaining, &tmp_data);
1254 if (result != Success)
1255 goto done;
1257 /* This was allocated by Xlib, so use XFree. */
1258 XFree (tmp_data);
1260 if (*actual_type_ret == None || *actual_format_ret == 0)
1261 goto done;
1263 if (total_size_max < bytes_remaining)
1264 goto size_overflow;
1265 total_size = bytes_remaining;
1266 data = xmalloc (total_size + 1);
1268 /* Now read, until we've gotten it all. */
1269 while (bytes_remaining)
1271 ptrdiff_t bytes_gotten;
1272 int bytes_per_item;
1273 result
1274 = XGetWindowProperty (display, window, property,
1275 offset / X_LONG_SIZE,
1276 buffer_size / X_LONG_SIZE,
1277 False,
1278 AnyPropertyType,
1279 actual_type_ret, actual_format_ret,
1280 actual_size_ret, &bytes_remaining, &tmp_data);
1282 /* If this doesn't return Success at this point, it means that
1283 some clod deleted the selection while we were in the midst of
1284 reading it. Deal with that, I guess.... */
1285 if (result != Success)
1286 break;
1288 bytes_per_item = *actual_format_ret >> 3;
1289 eassert (*actual_size_ret <= buffer_size / bytes_per_item);
1291 /* The man page for XGetWindowProperty says:
1292 "If the returned format is 32, the returned data is represented
1293 as a long array and should be cast to that type to obtain the
1294 elements."
1295 This applies even if long is more than 32 bits, the X library
1296 converts from 32 bit elements received from the X server to long
1297 and passes the long array to us. Thus, for that case memcpy can not
1298 be used. We convert to a 32 bit type here, because so much code
1299 assume on that.
1301 The bytes and offsets passed to XGetWindowProperty refers to the
1302 property and those are indeed in 32 bit quantities if format is 32. */
1304 bytes_gotten = *actual_size_ret;
1305 bytes_gotten *= bytes_per_item;
1307 TRACE2 ("Read %"pD"d bytes from property %s",
1308 bytes_gotten, XGetAtomName (display, property));
1310 if (total_size - offset < bytes_gotten)
1312 unsigned char *data1;
1313 ptrdiff_t remaining_lim = total_size_max - offset - bytes_gotten;
1314 if (remaining_lim < 0 || remaining_lim < bytes_remaining)
1315 goto size_overflow;
1316 total_size = offset + bytes_gotten + bytes_remaining;
1317 data1 = xrealloc (data, total_size + 1);
1318 data = data1;
1321 if (BITS_PER_LONG > 32 && *actual_format_ret == 32)
1323 unsigned long i;
1324 int *idata = (int *) (data + offset);
1325 long *ldata = (long *) tmp_data;
1327 for (i = 0; i < *actual_size_ret; ++i)
1328 idata[i] = ldata[i];
1330 else
1331 memcpy (data + offset, tmp_data, bytes_gotten);
1333 offset += bytes_gotten;
1335 /* This was allocated by Xlib, so use XFree. */
1336 XFree (tmp_data);
1339 XFlush (display);
1340 data[offset] = '\0';
1342 done:
1343 unblock_input ();
1344 *data_ret = data;
1345 *bytes_ret = offset;
1346 return;
1348 size_overflow:
1349 if (data)
1350 xfree (data);
1351 unblock_input ();
1352 memory_full (SIZE_MAX);
1355 /* Use xfree, not XFree, to free the data obtained with this function. */
1357 static void
1358 receive_incremental_selection (struct x_display_info *dpyinfo,
1359 Window window, Atom property,
1360 Lisp_Object target_type,
1361 unsigned int min_size_bytes,
1362 unsigned char **data_ret,
1363 ptrdiff_t *size_bytes_ret,
1364 Atom *type_ret, int *format_ret,
1365 unsigned long *size_ret)
1367 ptrdiff_t offset = 0;
1368 struct prop_location *wait_object;
1369 Display *display = dpyinfo->display;
1371 if (min (PTRDIFF_MAX, SIZE_MAX) < min_size_bytes)
1372 memory_full (SIZE_MAX);
1373 *data_ret = xmalloc (min_size_bytes);
1374 *size_bytes_ret = min_size_bytes;
1376 TRACE1 ("Read %u bytes incrementally", min_size_bytes);
1378 /* At this point, we have read an INCR property.
1379 Delete the property to ack it.
1380 (But first, prepare to receive the next event in this handshake.)
1382 Now, we must loop, waiting for the sending window to put a value on
1383 that property, then reading the property, then deleting it to ack.
1384 We are done when the sender places a property of length 0.
1386 block_input ();
1387 XSelectInput (display, window, STANDARD_EVENT_SET | PropertyChangeMask);
1388 TRACE1 (" Delete property %s",
1389 SDATA (SYMBOL_NAME (x_atom_to_symbol (dpyinfo, property))));
1390 XDeleteProperty (display, window, property);
1391 TRACE1 (" Expect new value of property %s",
1392 SDATA (SYMBOL_NAME (x_atom_to_symbol (dpyinfo, property))));
1393 wait_object = expect_property_change (display, window, property,
1394 PropertyNewValue);
1395 XFlush (display);
1396 // See comment in x_reply_selection_request about property_change_reply.
1397 set_property_change_object (wait_object);
1398 unblock_input ();
1400 while (true)
1402 unsigned char *tmp_data;
1403 ptrdiff_t tmp_size_bytes;
1405 TRACE0 (" Wait for property change");
1406 wait_for_property_change (wait_object);
1408 /* expect it again immediately, because x_get_window_property may
1409 .. no it won't, I don't get it.
1410 .. Ok, I get it now, the Xt code that implements INCR is broken. */
1411 TRACE0 (" Get property value");
1412 x_get_window_property (display, window, property,
1413 &tmp_data, &tmp_size_bytes,
1414 type_ret, format_ret, size_ret);
1416 TRACE1 (" Read increment of %"pD"d bytes", tmp_size_bytes);
1418 if (tmp_size_bytes == 0) /* we're done */
1420 TRACE0 ("Done reading incrementally");
1422 if (! waiting_for_other_props_on_window (display, window))
1423 XSelectInput (display, window, STANDARD_EVENT_SET);
1424 /* Use xfree, not XFree, because x_get_window_property
1425 calls xmalloc itself. */
1426 xfree (tmp_data);
1427 break;
1430 block_input ();
1431 TRACE1 (" ACK by deleting property %s",
1432 XGetAtomName (display, property));
1433 XDeleteProperty (display, window, property);
1434 wait_object = expect_property_change (display, window, property,
1435 PropertyNewValue);
1436 // See comment in x_reply_selection_request about property_change_reply.
1437 set_property_change_object (wait_object);
1438 XFlush (display);
1439 unblock_input ();
1441 if (*size_bytes_ret - offset < tmp_size_bytes)
1442 *data_ret = xpalloc (*data_ret, size_bytes_ret,
1443 tmp_size_bytes - (*size_bytes_ret - offset),
1444 -1, 1);
1446 memcpy ((*data_ret) + offset, tmp_data, tmp_size_bytes);
1447 offset += tmp_size_bytes;
1449 /* Use xfree, not XFree, because x_get_window_property
1450 calls xmalloc itself. */
1451 xfree (tmp_data);
1456 /* Fetch a value from property PROPERTY of X window WINDOW on display
1457 DISPLAY. TARGET_TYPE and SELECTION_ATOM are used in error message
1458 if this fails. */
1460 static Lisp_Object
1461 x_get_window_property_as_lisp_data (struct x_display_info *dpyinfo,
1462 Window window, Atom property,
1463 Lisp_Object target_type,
1464 Atom selection_atom)
1466 Atom actual_type;
1467 int actual_format;
1468 unsigned long actual_size;
1469 unsigned char *data = 0;
1470 ptrdiff_t bytes = 0;
1471 Lisp_Object val;
1472 Display *display = dpyinfo->display;
1474 TRACE0 ("Reading selection data");
1476 x_get_window_property (display, window, property, &data, &bytes,
1477 &actual_type, &actual_format, &actual_size);
1478 if (! data)
1480 block_input ();
1481 bool there_is_a_selection_owner
1482 = XGetSelectionOwner (display, selection_atom) != 0;
1483 unblock_input ();
1484 if (there_is_a_selection_owner)
1485 signal_error ("Selection owner couldn't convert",
1486 actual_type
1487 ? list2 (target_type,
1488 x_atom_to_symbol (dpyinfo, actual_type))
1489 : target_type);
1490 else
1491 signal_error ("No selection",
1492 x_atom_to_symbol (dpyinfo, selection_atom));
1495 if (actual_type == dpyinfo->Xatom_INCR)
1497 /* That wasn't really the data, just the beginning. */
1499 unsigned int min_size_bytes = * ((unsigned int *) data);
1500 block_input ();
1501 /* Use xfree, not XFree, because x_get_window_property
1502 calls xmalloc itself. */
1503 xfree (data);
1504 unblock_input ();
1505 receive_incremental_selection (dpyinfo, window, property, target_type,
1506 min_size_bytes, &data, &bytes,
1507 &actual_type, &actual_format,
1508 &actual_size);
1511 block_input ();
1512 TRACE1 (" Delete property %s", XGetAtomName (display, property));
1513 XDeleteProperty (display, window, property);
1514 XFlush (display);
1515 unblock_input ();
1517 /* It's been read. Now convert it to a lisp object in some semi-rational
1518 manner. */
1519 val = selection_data_to_lisp_data (dpyinfo, data, bytes,
1520 actual_type, actual_format);
1522 /* Use xfree, not XFree, because x_get_window_property
1523 calls xmalloc itself. */
1524 xfree (data);
1525 return val;
1528 /* These functions convert from the selection data read from the server into
1529 something that we can use from Lisp, and vice versa.
1531 Type: Format: Size: Lisp Type:
1532 ----- ------- ----- -----------
1533 * 8 * String
1534 ATOM 32 1 Symbol
1535 ATOM 32 > 1 Vector of Symbols
1536 * 16 1 Integer
1537 * 16 > 1 Vector of Integers
1538 * 32 1 if <=16 bits: Integer
1539 if > 16 bits: Cons of top16, bot16
1540 * 32 > 1 Vector of the above
1542 When converting a Lisp number to C, it is assumed to be of format 16 if
1543 it is an integer, and of format 32 if it is a cons of two integers.
1545 When converting a vector of numbers from Lisp to C, it is assumed to be
1546 of format 16 if every element in the vector is an integer, and is assumed
1547 to be of format 32 if any element is a cons of two integers.
1549 When converting an object to C, it may be of the form (SYMBOL . <data>)
1550 where SYMBOL is what we should claim that the type is. Format and
1551 representation are as above.
1553 Important: When format is 32, data should contain an array of int,
1554 not an array of long as the X library returns. This makes a difference
1555 when sizeof(long) != sizeof(int). */
1559 static Lisp_Object
1560 selection_data_to_lisp_data (struct x_display_info *dpyinfo,
1561 const unsigned char *data,
1562 ptrdiff_t size, Atom type, int format)
1564 if (type == dpyinfo->Xatom_NULL)
1565 return QNULL;
1567 /* Convert any 8-bit data to a string, for compactness. */
1568 else if (format == 8)
1570 Lisp_Object str, lispy_type;
1572 str = make_unibyte_string ((char *) data, size);
1573 /* Indicate that this string is from foreign selection by a text
1574 property `foreign-selection' so that the caller of
1575 x-get-selection-internal (usually x-get-selection) can know
1576 that the string must be decode. */
1577 if (type == dpyinfo->Xatom_COMPOUND_TEXT)
1578 lispy_type = QCOMPOUND_TEXT;
1579 else if (type == dpyinfo->Xatom_UTF8_STRING)
1580 lispy_type = QUTF8_STRING;
1581 else
1582 lispy_type = QSTRING;
1583 Fput_text_property (make_number (0), make_number (size),
1584 Qforeign_selection, lispy_type, str);
1585 return str;
1587 /* Convert a single atom to a Lisp_Symbol. Convert a set of atoms to
1588 a vector of symbols. */
1589 else if (type == XA_ATOM
1590 /* Treat ATOM_PAIR type similar to list of atoms. */
1591 || type == dpyinfo->Xatom_ATOM_PAIR)
1593 ptrdiff_t i;
1594 /* On a 64 bit machine sizeof(Atom) == sizeof(long) == 8.
1595 But the callers of these function has made sure the data for
1596 format == 32 is an array of int. Thus, use int instead
1597 of Atom. */
1598 int *idata = (int *) data;
1600 if (size == sizeof (int))
1601 return x_atom_to_symbol (dpyinfo, (Atom) idata[0]);
1602 else
1604 Lisp_Object v = make_uninit_vector (size / sizeof (int));
1606 for (i = 0; i < size / sizeof (int); i++)
1607 ASET (v, i, x_atom_to_symbol (dpyinfo, (Atom) idata[i]));
1608 return v;
1612 /* Convert a single 16-bit number or a small 32-bit number to a Lisp_Int.
1613 If the number is 32 bits and won't fit in a Lisp_Int,
1614 convert it to a cons of integers, 16 bits in each half.
1616 else if (format == 32 && size == sizeof (int))
1617 return INTEGER_TO_CONS (((int *) data) [0]);
1618 else if (format == 16 && size == sizeof (short))
1619 return make_number (((short *) data) [0]);
1621 /* Convert any other kind of data to a vector of numbers, represented
1622 as above (as an integer, or a cons of two 16 bit integers.)
1624 else if (format == 16)
1626 ptrdiff_t i;
1627 Lisp_Object v = make_uninit_vector (size / 2);
1629 for (i = 0; i < size / 2; i++)
1631 short j = ((short *) data) [i];
1632 ASET (v, i, make_number (j));
1634 return v;
1636 else
1638 ptrdiff_t i;
1639 Lisp_Object v = make_uninit_vector (size / X_LONG_SIZE);
1641 for (i = 0; i < size / X_LONG_SIZE; i++)
1643 int j = ((int *) data) [i];
1644 ASET (v, i, INTEGER_TO_CONS (j));
1646 return v;
1650 /* Convert OBJ to an X long value, and return it as unsigned long.
1651 OBJ should be an integer or a cons representing an integer.
1652 Treat values in the range X_LONG_MAX + 1 .. X_ULONG_MAX as X
1653 unsigned long values: in theory these values are supposed to be
1654 signed but in practice unsigned 32-bit data are communicated via X
1655 selections and we need to support that. */
1656 static unsigned long
1657 cons_to_x_long (Lisp_Object obj)
1659 if (X_ULONG_MAX <= INTMAX_MAX
1660 || XINT (INTEGERP (obj) ? obj : XCAR (obj)) < 0)
1661 return cons_to_signed (obj, X_LONG_MIN, min (X_ULONG_MAX, INTMAX_MAX));
1662 else
1663 return cons_to_unsigned (obj, X_ULONG_MAX);
1666 /* Use xfree, not XFree, to free the data obtained with this function. */
1668 static void
1669 lisp_data_to_selection_data (struct x_display_info *dpyinfo,
1670 Lisp_Object obj, struct selection_data *cs)
1672 Lisp_Object type = Qnil;
1674 eassert (cs != NULL);
1675 cs->nofree = false;
1677 if (CONSP (obj) && SYMBOLP (XCAR (obj)))
1679 type = XCAR (obj);
1680 obj = XCDR (obj);
1681 if (CONSP (obj) && NILP (XCDR (obj)))
1682 obj = XCAR (obj);
1685 if (EQ (obj, QNULL) || (EQ (type, QNULL)))
1686 { /* This is not the same as declining */
1687 cs->format = 32;
1688 cs->size = 0;
1689 cs->data = NULL;
1690 type = QNULL;
1692 else if (STRINGP (obj))
1694 if (SCHARS (obj) < SBYTES (obj))
1695 /* OBJ is a multibyte string containing a non-ASCII char. */
1696 signal_error ("Non-ASCII string must be encoded in advance", obj);
1697 if (NILP (type))
1698 type = QSTRING;
1699 cs->format = 8;
1700 cs->size = SBYTES (obj);
1701 cs->data = SDATA (obj);
1702 cs->nofree = true;
1704 else if (SYMBOLP (obj))
1706 void *data = xmalloc (sizeof (Atom) + 1);
1707 Atom *x_atom_ptr = data;
1708 cs->data = data;
1709 cs->format = 32;
1710 cs->size = 1;
1711 cs->data[sizeof (Atom)] = 0;
1712 *x_atom_ptr = symbol_to_x_atom (dpyinfo, obj);
1713 if (NILP (type)) type = QATOM;
1715 else if (RANGED_INTEGERP (X_SHRT_MIN, obj, X_SHRT_MAX))
1717 void *data = xmalloc (sizeof (short) + 1);
1718 short *short_ptr = data;
1719 cs->data = data;
1720 cs->format = 16;
1721 cs->size = 1;
1722 cs->data[sizeof (short)] = 0;
1723 *short_ptr = XINT (obj);
1724 if (NILP (type)) type = QINTEGER;
1726 else if (INTEGERP (obj)
1727 || (CONSP (obj) && INTEGERP (XCAR (obj))
1728 && (INTEGERP (XCDR (obj))
1729 || (CONSP (XCDR (obj))
1730 && INTEGERP (XCAR (XCDR (obj)))))))
1732 void *data = xmalloc (sizeof (unsigned long) + 1);
1733 unsigned long *x_long_ptr = data;
1734 cs->data = data;
1735 cs->format = 32;
1736 cs->size = 1;
1737 cs->data[sizeof (unsigned long)] = 0;
1738 *x_long_ptr = cons_to_x_long (obj);
1739 if (NILP (type)) type = QINTEGER;
1741 else if (VECTORP (obj))
1743 /* Lisp_Vectors may represent a set of ATOMs;
1744 a set of 16 or 32 bit INTEGERs;
1745 or a set of ATOM_PAIRs (represented as [[A1 A2] [A3 A4] ...]
1747 ptrdiff_t i;
1748 ptrdiff_t size = ASIZE (obj);
1750 if (SYMBOLP (AREF (obj, 0)))
1751 /* This vector is an ATOM set */
1753 void *data;
1754 Atom *x_atoms;
1755 if (NILP (type)) type = QATOM;
1756 for (i = 0; i < size; i++)
1757 if (!SYMBOLP (AREF (obj, i)))
1758 signal_error ("All elements of selection vector must have same type", obj);
1760 cs->data = data = xnmalloc (size, sizeof *x_atoms);
1761 x_atoms = data;
1762 cs->format = 32;
1763 cs->size = size;
1764 for (i = 0; i < size; i++)
1765 x_atoms[i] = symbol_to_x_atom (dpyinfo, AREF (obj, i));
1767 else
1768 /* This vector is an INTEGER set, or something like it */
1770 int format = 16;
1771 int data_size = sizeof (short);
1772 void *data;
1773 unsigned long *x_atoms;
1774 short *shorts;
1775 if (NILP (type)) type = QINTEGER;
1776 for (i = 0; i < size; i++)
1778 if (! RANGED_INTEGERP (X_SHRT_MIN, AREF (obj, i),
1779 X_SHRT_MAX))
1781 /* Use sizeof (long) even if it is more than 32 bits.
1782 See comment in x_get_window_property and
1783 x_fill_property_data. */
1784 data_size = sizeof (long);
1785 format = 32;
1786 break;
1789 cs->data = data = xnmalloc (size, data_size);
1790 x_atoms = data;
1791 shorts = data;
1792 cs->format = format;
1793 cs->size = size;
1794 for (i = 0; i < size; i++)
1796 if (format == 32)
1797 x_atoms[i] = cons_to_x_long (AREF (obj, i));
1798 else
1799 shorts[i] = XINT (AREF (obj, i));
1803 else
1804 signal_error (/* Qselection_error */ "Unrecognized selection data", obj);
1806 cs->type = symbol_to_x_atom (dpyinfo, type);
1809 static Lisp_Object
1810 clean_local_selection_data (Lisp_Object obj)
1812 if (CONSP (obj)
1813 && INTEGERP (XCAR (obj))
1814 && CONSP (XCDR (obj))
1815 && INTEGERP (XCAR (XCDR (obj)))
1816 && NILP (XCDR (XCDR (obj))))
1817 obj = Fcons (XCAR (obj), XCDR (obj));
1819 if (CONSP (obj)
1820 && INTEGERP (XCAR (obj))
1821 && INTEGERP (XCDR (obj)))
1823 if (XINT (XCAR (obj)) == 0)
1824 return XCDR (obj);
1825 if (XINT (XCAR (obj)) == -1)
1826 return make_number (- XINT (XCDR (obj)));
1828 if (VECTORP (obj))
1830 ptrdiff_t i;
1831 ptrdiff_t size = ASIZE (obj);
1832 Lisp_Object copy;
1833 if (size == 1)
1834 return clean_local_selection_data (AREF (obj, 0));
1835 copy = make_uninit_vector (size);
1836 for (i = 0; i < size; i++)
1837 ASET (copy, i, clean_local_selection_data (AREF (obj, i)));
1838 return copy;
1840 return obj;
1843 /* Called from XTread_socket to handle SelectionNotify events.
1844 If it's the selection we are waiting for, stop waiting
1845 by setting the car of reading_selection_reply to non-nil.
1846 We store t there if the reply is successful, lambda if not. */
1848 void
1849 x_handle_selection_notify (const XSelectionEvent *event)
1851 if (event->requestor != reading_selection_window)
1852 return;
1853 if (event->selection != reading_which_selection)
1854 return;
1856 TRACE0 ("Received SelectionNotify");
1857 XSETCAR (reading_selection_reply,
1858 (event->property != 0 ? Qt : Qlambda));
1862 /* From a Lisp_Object, return a suitable frame for selection
1863 operations. OBJECT may be a frame, a terminal object, or nil
1864 (which stands for the selected frame--or, if that is not an X
1865 frame, the first X display on the list). If no suitable frame can
1866 be found, return NULL. */
1868 static struct frame *
1869 frame_for_x_selection (Lisp_Object object)
1871 Lisp_Object tail, frame;
1872 struct frame *f;
1874 if (NILP (object))
1876 f = XFRAME (selected_frame);
1877 if (FRAME_X_P (f) && FRAME_LIVE_P (f))
1878 return f;
1880 FOR_EACH_FRAME (tail, frame)
1882 f = XFRAME (frame);
1883 if (FRAME_X_P (f) && FRAME_LIVE_P (f))
1884 return f;
1887 else if (TERMINALP (object))
1889 struct terminal *t = decode_live_terminal (object);
1891 if (t->type == output_x_window)
1892 FOR_EACH_FRAME (tail, frame)
1894 f = XFRAME (frame);
1895 if (FRAME_LIVE_P (f) && f->terminal == t)
1896 return f;
1899 else if (FRAMEP (object))
1901 f = XFRAME (object);
1902 if (FRAME_X_P (f) && FRAME_LIVE_P (f))
1903 return f;
1906 return NULL;
1910 DEFUN ("x-own-selection-internal", Fx_own_selection_internal,
1911 Sx_own_selection_internal, 2, 3, 0,
1912 doc: /* Assert an X selection of type SELECTION and value VALUE.
1913 SELECTION is a symbol, typically `PRIMARY', `SECONDARY', or `CLIPBOARD'.
1914 (Those are literal upper-case symbol names, since that's what X expects.)
1915 VALUE is typically a string, or a cons of two markers, but may be
1916 anything that the functions on `selection-converter-alist' know about.
1918 FRAME should be a frame that should own the selection. If omitted or
1919 nil, it defaults to the selected frame.
1921 On Nextstep, FRAME is unused. */)
1922 (Lisp_Object selection, Lisp_Object value, Lisp_Object frame)
1924 if (NILP (frame)) frame = selected_frame;
1925 if (!FRAME_LIVE_P (XFRAME (frame)) || !FRAME_X_P (XFRAME (frame)))
1926 error ("X selection unavailable for this frame");
1928 CHECK_SYMBOL (selection);
1929 if (NILP (value)) error ("VALUE may not be nil");
1930 x_own_selection (selection, value, frame);
1931 return value;
1935 /* Request the selection value from the owner. If we are the owner,
1936 simply return our selection value. If we are not the owner, this
1937 will block until all of the data has arrived. */
1939 DEFUN ("x-get-selection-internal", Fx_get_selection_internal,
1940 Sx_get_selection_internal, 2, 4, 0,
1941 doc: /* Return text selected from some X window.
1942 SELECTION-SYMBOL is typically `PRIMARY', `SECONDARY', or `CLIPBOARD'.
1943 (Those are literal upper-case symbol names, since that's what X expects.)
1944 TARGET-TYPE is the type of data desired, typically `STRING'.
1946 TIME-STAMP is the time to use in the XConvertSelection call for foreign
1947 selections. If omitted, defaults to the time for the last event.
1949 TERMINAL should be a terminal object or a frame specifying the X
1950 server to query. If omitted or nil, that stands for the selected
1951 frame's display, or the first available X display.
1953 On Nextstep, TIME-STAMP and TERMINAL are unused. */)
1954 (Lisp_Object selection_symbol, Lisp_Object target_type,
1955 Lisp_Object time_stamp, Lisp_Object terminal)
1957 Lisp_Object val = Qnil;
1958 struct frame *f = frame_for_x_selection (terminal);
1960 CHECK_SYMBOL (selection_symbol);
1961 CHECK_SYMBOL (target_type);
1962 if (EQ (target_type, QMULTIPLE))
1963 error ("Retrieving MULTIPLE selections is currently unimplemented");
1964 if (!f)
1965 error ("X selection unavailable for this frame");
1967 val = x_get_local_selection (selection_symbol, target_type, true,
1968 FRAME_DISPLAY_INFO (f));
1970 if (NILP (val) && FRAME_LIVE_P (f))
1972 Lisp_Object frame;
1973 XSETFRAME (frame, f);
1974 return x_get_foreign_selection (selection_symbol, target_type,
1975 time_stamp, frame);
1978 if (CONSP (val) && SYMBOLP (XCAR (val)))
1980 val = XCDR (val);
1981 if (CONSP (val) && NILP (XCDR (val)))
1982 val = XCAR (val);
1984 return clean_local_selection_data (val);
1987 DEFUN ("x-disown-selection-internal", Fx_disown_selection_internal,
1988 Sx_disown_selection_internal, 1, 3, 0,
1989 doc: /* If we own the selection SELECTION, disown it.
1990 Disowning it means there is no such selection.
1992 Sets the last-change time for the selection to TIME-OBJECT (by default
1993 the time of the last event).
1995 TERMINAL should be a terminal object or a frame specifying the X
1996 server to query. If omitted or nil, that stands for the selected
1997 frame's display, or the first available X display.
1999 On Nextstep, the TIME-OBJECT and TERMINAL arguments are unused.
2000 On MS-DOS, all this does is return non-nil if we own the selection. */)
2001 (Lisp_Object selection, Lisp_Object time_object, Lisp_Object terminal)
2003 Time timestamp;
2004 Atom selection_atom;
2005 struct selection_input_event event;
2006 struct frame *f = frame_for_x_selection (terminal);
2007 struct x_display_info *dpyinfo;
2009 if (!f)
2010 return Qnil;
2012 dpyinfo = FRAME_DISPLAY_INFO (f);
2013 CHECK_SYMBOL (selection);
2015 /* Don't disown the selection when we're not the owner. */
2016 if (NILP (LOCAL_SELECTION (selection, dpyinfo)))
2017 return Qnil;
2019 selection_atom = symbol_to_x_atom (dpyinfo, selection);
2021 block_input ();
2022 if (NILP (time_object))
2023 timestamp = dpyinfo->last_user_time;
2024 else
2025 CONS_TO_INTEGER (time_object, Time, timestamp);
2026 XSetSelectionOwner (dpyinfo->display, selection_atom, None, timestamp);
2027 unblock_input ();
2029 /* It doesn't seem to be guaranteed that a SelectionClear event will be
2030 generated for a window which owns the selection when that window sets
2031 the selection owner to None. The NCD server does, the MIT Sun4 server
2032 doesn't. So we synthesize one; this means we might get two, but
2033 that's ok, because the second one won't have any effect. */
2034 SELECTION_EVENT_DPYINFO (&event) = dpyinfo;
2035 SELECTION_EVENT_SELECTION (&event) = selection_atom;
2036 SELECTION_EVENT_TIME (&event) = timestamp;
2037 x_handle_selection_clear (&event);
2039 return Qt;
2042 DEFUN ("x-selection-owner-p", Fx_selection_owner_p, Sx_selection_owner_p,
2043 0, 2, 0,
2044 doc: /* Whether the current Emacs process owns the given X Selection.
2045 The arg should be the name of the selection in question, typically one of
2046 the symbols `PRIMARY', `SECONDARY', or `CLIPBOARD'.
2047 (Those are literal upper-case symbol names, since that's what X expects.)
2048 For convenience, the symbol nil is the same as `PRIMARY',
2049 and t is the same as `SECONDARY'.
2051 TERMINAL should be a terminal object or a frame specifying the X
2052 server to query. If omitted or nil, that stands for the selected
2053 frame's display, or the first available X display.
2055 On Nextstep, TERMINAL is unused. */)
2056 (Lisp_Object selection, Lisp_Object terminal)
2058 struct frame *f = frame_for_x_selection (terminal);
2060 CHECK_SYMBOL (selection);
2061 if (EQ (selection, Qnil)) selection = QPRIMARY;
2062 if (EQ (selection, Qt)) selection = QSECONDARY;
2064 if (f && !NILP (LOCAL_SELECTION (selection, FRAME_DISPLAY_INFO (f))))
2065 return Qt;
2066 else
2067 return Qnil;
2070 DEFUN ("x-selection-exists-p", Fx_selection_exists_p, Sx_selection_exists_p,
2071 0, 2, 0,
2072 doc: /* Whether there is an owner for the given X selection.
2073 SELECTION should be the name of the selection in question, typically
2074 one of the symbols `PRIMARY', `SECONDARY', `CLIPBOARD', or
2075 `CLIPBOARD_MANAGER' (X expects these literal upper-case names.) The
2076 symbol nil is the same as `PRIMARY', and t is the same as `SECONDARY'.
2078 TERMINAL should be a terminal object or a frame specifying the X
2079 server to query. If omitted or nil, that stands for the selected
2080 frame's display, or the first available X display.
2082 On Nextstep, TERMINAL is unused. */)
2083 (Lisp_Object selection, Lisp_Object terminal)
2085 Window owner;
2086 Atom atom;
2087 struct frame *f = frame_for_x_selection (terminal);
2088 struct x_display_info *dpyinfo;
2090 CHECK_SYMBOL (selection);
2091 if (EQ (selection, Qnil)) selection = QPRIMARY;
2092 if (EQ (selection, Qt)) selection = QSECONDARY;
2094 if (!f)
2095 return Qnil;
2097 dpyinfo = FRAME_DISPLAY_INFO (f);
2099 if (!NILP (LOCAL_SELECTION (selection, dpyinfo)))
2100 return Qt;
2102 atom = symbol_to_x_atom (dpyinfo, selection);
2103 if (atom == 0) return Qnil;
2104 block_input ();
2105 owner = XGetSelectionOwner (dpyinfo->display, atom);
2106 unblock_input ();
2107 return (owner ? Qt : Qnil);
2111 /* Send clipboard manager a SAVE_TARGETS request with a UTF8_STRING
2112 property (http://www.freedesktop.org/wiki/ClipboardManager). */
2114 static Lisp_Object
2115 x_clipboard_manager_save (Lisp_Object frame)
2117 struct frame *f = XFRAME (frame);
2118 struct x_display_info *dpyinfo = FRAME_DISPLAY_INFO (f);
2119 Atom data = dpyinfo->Xatom_UTF8_STRING;
2121 XChangeProperty (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2122 dpyinfo->Xatom_EMACS_TMP,
2123 dpyinfo->Xatom_ATOM, 32, PropModeReplace,
2124 (unsigned char *) &data, 1);
2125 x_get_foreign_selection (QCLIPBOARD_MANAGER, QSAVE_TARGETS,
2126 Qnil, frame);
2127 return Qt;
2130 /* Error handler for x_clipboard_manager_save_frame. */
2132 static Lisp_Object
2133 x_clipboard_manager_error_1 (Lisp_Object err)
2135 AUTO_STRING (format, "X clipboard manager error: %s\n\
2136 If the problem persists, set `%s' to nil.");
2137 AUTO_STRING (varname, "x-select-enable-clipboard-manager");
2138 CALLN (Fmessage, format, CAR (CDR (err)), varname);
2139 return Qnil;
2142 /* Error handler for x_clipboard_manager_save_all. */
2144 static Lisp_Object
2145 x_clipboard_manager_error_2 (Lisp_Object err)
2147 fprintf (stderr, "Error saving to X clipboard manager.\n\
2148 If the problem persists, set '%s' \
2149 to nil.\n", "x-select-enable-clipboard-manager");
2150 return Qnil;
2153 /* Called from delete_frame: save any clipboard owned by FRAME to the
2154 clipboard manager. Do nothing if FRAME does not own the clipboard,
2155 or if no clipboard manager is present. */
2157 void
2158 x_clipboard_manager_save_frame (Lisp_Object frame)
2160 struct frame *f;
2162 if (!NILP (Vx_select_enable_clipboard_manager)
2163 && FRAMEP (frame)
2164 && (f = XFRAME (frame), FRAME_X_P (f))
2165 && FRAME_LIVE_P (f))
2167 struct x_display_info *dpyinfo = FRAME_DISPLAY_INFO (f);
2168 Lisp_Object local_selection
2169 = LOCAL_SELECTION (QCLIPBOARD, dpyinfo);
2171 if (!NILP (local_selection)
2172 && EQ (frame, XCAR (XCDR (XCDR (XCDR (local_selection)))))
2173 && XGetSelectionOwner (dpyinfo->display,
2174 dpyinfo->Xatom_CLIPBOARD_MANAGER))
2175 internal_condition_case_1 (x_clipboard_manager_save, frame, Qt,
2176 x_clipboard_manager_error_1);
2180 /* Called from Fkill_emacs: save any clipboard owned by FRAME to the
2181 clipboard manager. Do nothing if FRAME does not own the clipboard,
2182 or if no clipboard manager is present. */
2184 void
2185 x_clipboard_manager_save_all (void)
2187 /* Loop through all X displays, saving owned clipboards. */
2188 struct x_display_info *dpyinfo;
2189 Lisp_Object local_selection, local_frame;
2191 if (NILP (Vx_select_enable_clipboard_manager))
2192 return;
2194 for (dpyinfo = x_display_list; dpyinfo; dpyinfo = dpyinfo->next)
2196 local_selection = LOCAL_SELECTION (QCLIPBOARD, dpyinfo);
2197 if (NILP (local_selection)
2198 || !XGetSelectionOwner (dpyinfo->display,
2199 dpyinfo->Xatom_CLIPBOARD_MANAGER))
2200 continue;
2202 local_frame = XCAR (XCDR (XCDR (XCDR (local_selection))));
2203 if (FRAME_LIVE_P (XFRAME (local_frame)))
2205 message ("Saving clipboard to X clipboard manager...");
2206 internal_condition_case_1 (x_clipboard_manager_save, local_frame,
2207 Qt, x_clipboard_manager_error_2);
2213 /***********************************************************************
2214 Drag and drop support
2215 ***********************************************************************/
2216 /* Check that lisp values are of correct type for x_fill_property_data.
2217 That is, number, string or a cons with two numbers (low and high 16
2218 bit parts of a 32 bit number). Return the number of items in DATA,
2219 or -1 if there is an error. */
2222 x_check_property_data (Lisp_Object data)
2224 Lisp_Object iter;
2225 int size = 0;
2227 for (iter = data; CONSP (iter); iter = XCDR (iter))
2229 Lisp_Object o = XCAR (iter);
2231 if (! NUMBERP (o) && ! STRINGP (o) && ! CONSP (o))
2232 return -1;
2233 else if (CONSP (o) &&
2234 (! NUMBERP (XCAR (o)) || ! NUMBERP (XCDR (o))))
2235 return -1;
2236 if (size == INT_MAX)
2237 return -1;
2238 size++;
2241 return size;
2244 /* Convert lisp values to a C array. Values may be a number, a string
2245 which is taken as an X atom name and converted to the atom value, or
2246 a cons containing the two 16 bit parts of a 32 bit number.
2248 DPY is the display use to look up X atoms.
2249 DATA is a Lisp list of values to be converted.
2250 RET is the C array that contains the converted values. It is assumed
2251 it is big enough to hold all values.
2252 FORMAT is 8, 16 or 32 and denotes char/short/long for each C value to
2253 be stored in RET. Note that long is used for 32 even if long is more
2254 than 32 bits (see man pages for XChangeProperty, XGetWindowProperty and
2255 XClientMessageEvent). */
2257 void
2258 x_fill_property_data (Display *dpy, Lisp_Object data, void *ret, int format)
2260 unsigned long val;
2261 unsigned long *d32 = (unsigned long *) ret;
2262 unsigned short *d16 = (unsigned short *) ret;
2263 unsigned char *d08 = (unsigned char *) ret;
2264 Lisp_Object iter;
2266 for (iter = data; CONSP (iter); iter = XCDR (iter))
2268 Lisp_Object o = XCAR (iter);
2270 if (NUMBERP (o) || CONSP (o))
2272 if (CONSP (o)
2273 && RANGED_INTEGERP (X_LONG_MIN >> 16, XCAR (o), X_LONG_MAX >> 16)
2274 && RANGED_INTEGERP (- (1 << 15), XCDR (o), -1))
2276 /* cons_to_x_long does not handle negative values for v2.
2277 For XDnd, v2 might be y of a window, and can be negative.
2278 The XDnd spec. is not explicit about negative values,
2279 but let's assume negative v2 is sent modulo 2**16. */
2280 unsigned long v1 = XINT (XCAR (o)) & 0xffff;
2281 unsigned long v2 = XINT (XCDR (o)) & 0xffff;
2282 val = (v1 << 16) | v2;
2284 else
2285 val = cons_to_x_long (o);
2287 else if (STRINGP (o))
2289 block_input ();
2290 val = XInternAtom (dpy, SSDATA (o), False);
2291 unblock_input ();
2293 else
2294 error ("Wrong type, must be string, number or cons");
2296 if (format == 8)
2298 if ((1 << 8) < val && val <= X_ULONG_MAX - (1 << 7))
2299 error ("Out of 'char' range");
2300 *d08++ = val;
2302 else if (format == 16)
2304 if ((1 << 16) < val && val <= X_ULONG_MAX - (1 << 15))
2305 error ("Out of 'short' range");
2306 *d16++ = val;
2308 else
2309 *d32++ = val;
2313 /* Convert an array of C values to a Lisp list.
2314 F is the frame to be used to look up X atoms if the TYPE is XA_ATOM.
2315 DATA is a C array of values to be converted.
2316 TYPE is the type of the data. Only XA_ATOM is special, it converts
2317 each number in DATA to its corresponding X atom as a symbol.
2318 FORMAT is 8, 16 or 32 and gives the size in bits for each C value to
2319 be stored in RET.
2320 SIZE is the number of elements in DATA.
2322 Important: When format is 32, data should contain an array of int,
2323 not an array of long as the X library returns. This makes a difference
2324 when sizeof(long) != sizeof(int).
2326 Also see comment for selection_data_to_lisp_data above. */
2328 Lisp_Object
2329 x_property_data_to_lisp (struct frame *f, const unsigned char *data,
2330 Atom type, int format, unsigned long size)
2332 ptrdiff_t format_bytes = format >> 3;
2333 ptrdiff_t data_bytes;
2334 if (INT_MULTIPLY_WRAPV (size, format_bytes, &data_bytes))
2335 memory_full (SIZE_MAX);
2336 return selection_data_to_lisp_data (FRAME_DISPLAY_INFO (f), data,
2337 data_bytes, type, format);
2340 DEFUN ("x-get-atom-name", Fx_get_atom_name,
2341 Sx_get_atom_name, 1, 2, 0,
2342 doc: /* Return the X atom name for VALUE as a string.
2343 VALUE may be a number or a cons where the car is the upper 16 bits and
2344 the cdr is the lower 16 bits of a 32 bit value.
2345 Use the display for FRAME or the current frame if FRAME is not given or nil.
2347 If the value is 0 or the atom is not known, return the empty string. */)
2348 (Lisp_Object value, Lisp_Object frame)
2350 struct frame *f = decode_window_system_frame (frame);
2351 char *name = 0;
2352 char empty[] = "";
2353 Lisp_Object ret = Qnil;
2354 Display *dpy = FRAME_X_DISPLAY (f);
2355 Atom atom;
2356 bool had_errors_p;
2358 CONS_TO_INTEGER (value, Atom, atom);
2360 block_input ();
2361 x_catch_errors (dpy);
2362 name = atom ? XGetAtomName (dpy, atom) : empty;
2363 had_errors_p = x_had_errors_p (dpy);
2364 x_uncatch_errors_after_check ();
2366 if (!had_errors_p)
2367 ret = build_string (name);
2369 if (atom && name) XFree (name);
2370 if (NILP (ret)) ret = empty_unibyte_string;
2372 unblock_input ();
2374 return ret;
2377 DEFUN ("x-register-dnd-atom", Fx_register_dnd_atom,
2378 Sx_register_dnd_atom, 1, 2, 0,
2379 doc: /* Request that dnd events are made for ClientMessages with ATOM.
2380 ATOM can be a symbol or a string. The ATOM is interned on the display that
2381 FRAME is on. If FRAME is nil, the selected frame is used. */)
2382 (Lisp_Object atom, Lisp_Object frame)
2384 Atom x_atom;
2385 struct frame *f = decode_window_system_frame (frame);
2386 ptrdiff_t i;
2387 struct x_display_info *dpyinfo = FRAME_DISPLAY_INFO (f);
2390 if (SYMBOLP (atom))
2391 x_atom = symbol_to_x_atom (dpyinfo, atom);
2392 else if (STRINGP (atom))
2394 block_input ();
2395 x_atom = XInternAtom (FRAME_X_DISPLAY (f), SSDATA (atom), False);
2396 unblock_input ();
2398 else
2399 error ("ATOM must be a symbol or a string");
2401 for (i = 0; i < dpyinfo->x_dnd_atoms_length; ++i)
2402 if (dpyinfo->x_dnd_atoms[i] == x_atom)
2403 return Qnil;
2405 if (dpyinfo->x_dnd_atoms_length == dpyinfo->x_dnd_atoms_size)
2406 dpyinfo->x_dnd_atoms =
2407 xpalloc (dpyinfo->x_dnd_atoms, &dpyinfo->x_dnd_atoms_size,
2408 1, -1, sizeof *dpyinfo->x_dnd_atoms);
2410 dpyinfo->x_dnd_atoms[dpyinfo->x_dnd_atoms_length++] = x_atom;
2411 return Qnil;
2414 /* Convert an XClientMessageEvent to a Lisp event of type DRAG_N_DROP_EVENT. */
2416 bool
2417 x_handle_dnd_message (struct frame *f, const XClientMessageEvent *event,
2418 struct x_display_info *dpyinfo, struct input_event *bufp)
2420 Lisp_Object vec;
2421 Lisp_Object frame;
2422 /* format 32 => size 5, format 16 => size 10, format 8 => size 20 */
2423 unsigned long size = 160/event->format;
2424 int x, y;
2425 unsigned char *data = (unsigned char *) event->data.b;
2426 int idata[5];
2427 ptrdiff_t i;
2429 for (i = 0; i < dpyinfo->x_dnd_atoms_length; ++i)
2430 if (dpyinfo->x_dnd_atoms[i] == event->message_type) break;
2432 if (i == dpyinfo->x_dnd_atoms_length) return false;
2434 XSETFRAME (frame, f);
2436 /* On a 64 bit machine, the event->data.l array members are 64 bits (long),
2437 but the x_property_data_to_lisp (or rather selection_data_to_lisp_data)
2438 function expects them to be of size int (i.e. 32). So to be able to
2439 use that function, put the data in the form it expects if format is 32. */
2441 if (BITS_PER_LONG > 32 && event->format == 32)
2443 for (i = 0; i < 5; ++i) /* There are only 5 longs in a ClientMessage. */
2444 idata[i] = event->data.l[i];
2445 data = (unsigned char *) idata;
2448 vec = Fmake_vector (make_number (4), Qnil);
2449 ASET (vec, 0, SYMBOL_NAME (x_atom_to_symbol (FRAME_DISPLAY_INFO (f),
2450 event->message_type)));
2451 ASET (vec, 1, frame);
2452 ASET (vec, 2, make_number (event->format));
2453 ASET (vec, 3, x_property_data_to_lisp (f,
2454 data,
2455 event->message_type,
2456 event->format,
2457 size));
2459 x_relative_mouse_position (f, &x, &y);
2460 bufp->kind = DRAG_N_DROP_EVENT;
2461 bufp->frame_or_window = frame;
2462 bufp->timestamp = CurrentTime;
2463 bufp->x = make_number (x);
2464 bufp->y = make_number (y);
2465 bufp->arg = vec;
2466 bufp->modifiers = 0;
2468 return true;
2471 DEFUN ("x-send-client-message", Fx_send_client_message,
2472 Sx_send_client_message, 6, 6, 0,
2473 doc: /* Send a client message of MESSAGE-TYPE to window DEST on DISPLAY.
2475 For DISPLAY, specify either a frame or a display name (a string).
2476 If DISPLAY is nil, that stands for the selected frame's display.
2477 DEST may be a number, in which case it is a Window id. The value 0 may
2478 be used to send to the root window of the DISPLAY.
2479 If DEST is a cons, it is converted to a 32 bit number
2480 with the high 16 bits from the car and the lower 16 bit from the cdr. That
2481 number is then used as a window id.
2482 If DEST is a frame the event is sent to the outer window of that frame.
2483 A value of nil means the currently selected frame.
2484 If DEST is the string "PointerWindow" the event is sent to the window that
2485 contains the pointer. If DEST is the string "InputFocus" the event is
2486 sent to the window that has the input focus.
2487 FROM is the frame sending the event. Use nil for currently selected frame.
2488 MESSAGE-TYPE is the name of an Atom as a string.
2489 FORMAT must be one of 8, 16 or 32 and determines the size of the values in
2490 bits. VALUES is a list of numbers, cons and/or strings containing the values
2491 to send. If a value is a string, it is converted to an Atom and the value of
2492 the Atom is sent. If a value is a cons, it is converted to a 32 bit number
2493 with the high 16 bits from the car and the lower 16 bit from the cdr.
2494 If more values than fits into the event is given, the excessive values
2495 are ignored. */)
2496 (Lisp_Object display, Lisp_Object dest, Lisp_Object from,
2497 Lisp_Object message_type, Lisp_Object format, Lisp_Object values)
2499 struct x_display_info *dpyinfo = check_x_display_info (display);
2501 CHECK_STRING (message_type);
2502 x_send_client_event (display, dest, from,
2503 XInternAtom (dpyinfo->display,
2504 SSDATA (message_type),
2505 False),
2506 format, values);
2508 return Qnil;
2511 void
2512 x_send_client_event (Lisp_Object display, Lisp_Object dest, Lisp_Object from,
2513 Atom message_type, Lisp_Object format, Lisp_Object values)
2515 struct x_display_info *dpyinfo = check_x_display_info (display);
2516 Window wdest;
2517 XEvent event;
2518 struct frame *f = decode_window_system_frame (from);
2519 bool to_root;
2521 CHECK_NUMBER (format);
2522 CHECK_CONS (values);
2524 if (x_check_property_data (values) == -1)
2525 error ("Bad data in VALUES, must be number, cons or string");
2527 if (XINT (format) != 8 && XINT (format) != 16 && XINT (format) != 32)
2528 error ("FORMAT must be one of 8, 16 or 32");
2530 event.xclient.type = ClientMessage;
2531 event.xclient.format = XINT (format);
2533 if (FRAMEP (dest) || NILP (dest))
2535 struct frame *fdest = decode_window_system_frame (dest);
2536 wdest = FRAME_OUTER_WINDOW (fdest);
2538 else if (STRINGP (dest))
2540 if (strcmp (SSDATA (dest), "PointerWindow") == 0)
2541 wdest = PointerWindow;
2542 else if (strcmp (SSDATA (dest), "InputFocus") == 0)
2543 wdest = InputFocus;
2544 else
2545 error ("DEST as a string must be one of PointerWindow or InputFocus");
2547 else if (NUMBERP (dest) || CONSP (dest))
2548 CONS_TO_INTEGER (dest, Window, wdest);
2549 else
2550 error ("DEST must be a frame, nil, string, number or cons");
2552 if (wdest == 0) wdest = dpyinfo->root_window;
2553 to_root = wdest == dpyinfo->root_window;
2555 block_input ();
2557 event.xclient.send_event = True;
2558 event.xclient.serial = 0;
2559 event.xclient.message_type = message_type;
2560 event.xclient.display = dpyinfo->display;
2562 /* Some clients (metacity for example) expects sending window to be here
2563 when sending to the root window. */
2564 event.xclient.window = to_root ? FRAME_OUTER_WINDOW (f) : wdest;
2566 memset (event.xclient.data.l, 0, sizeof (event.xclient.data.l));
2567 x_fill_property_data (dpyinfo->display, values, event.xclient.data.b,
2568 event.xclient.format);
2570 /* If event mask is 0 the event is sent to the client that created
2571 the destination window. But if we are sending to the root window,
2572 there is no such client. Then we set the event mask to 0xffffff. The
2573 event then goes to clients selecting for events on the root window. */
2574 x_catch_errors (dpyinfo->display);
2576 bool propagate = !to_root;
2577 long mask = to_root ? 0xffffff : 0;
2579 XSendEvent (dpyinfo->display, wdest, propagate, mask, &event);
2580 XFlush (dpyinfo->display);
2582 x_uncatch_errors ();
2583 unblock_input ();
2587 void
2588 syms_of_xselect (void)
2590 defsubr (&Sx_get_selection_internal);
2591 defsubr (&Sx_own_selection_internal);
2592 defsubr (&Sx_disown_selection_internal);
2593 defsubr (&Sx_selection_owner_p);
2594 defsubr (&Sx_selection_exists_p);
2596 defsubr (&Sx_get_atom_name);
2597 defsubr (&Sx_send_client_message);
2598 defsubr (&Sx_register_dnd_atom);
2600 reading_selection_reply = Fcons (Qnil, Qnil);
2601 staticpro (&reading_selection_reply);
2602 reading_selection_window = 0;
2603 reading_which_selection = 0;
2605 property_change_wait_list = 0;
2606 prop_location_identifier = 0;
2607 property_change_reply = Fcons (Qnil, Qnil);
2608 staticpro (&property_change_reply);
2610 converted_selections = NULL;
2611 conversion_fail_tag = None;
2613 /* FIXME: Duplicate definition in nsselect.c. */
2614 DEFVAR_LISP ("selection-converter-alist", Vselection_converter_alist,
2615 doc: /* An alist associating X Windows selection-types with functions.
2616 These functions are called to convert the selection, with three args:
2617 the name of the selection (typically `PRIMARY', `SECONDARY', or `CLIPBOARD');
2618 a desired type to which the selection should be converted;
2619 and the local selection value (whatever was given to
2620 `x-own-selection-internal').
2622 The function should return the value to send to the X server
2623 (typically a string). A return value of nil
2624 means that the conversion could not be done.
2625 A return value which is the symbol `NULL'
2626 means that a side-effect was executed,
2627 and there is no meaningful selection value. */);
2628 Vselection_converter_alist = Qnil;
2630 DEFVAR_LISP ("x-lost-selection-functions", Vx_lost_selection_functions,
2631 doc: /* A list of functions to be called when Emacs loses an X selection.
2632 (This happens when some other X client makes its own selection
2633 or when a Lisp program explicitly clears the selection.)
2634 The functions are called with one argument, the selection type
2635 (a symbol, typically `PRIMARY', `SECONDARY', or `CLIPBOARD'). */);
2636 Vx_lost_selection_functions = Qnil;
2638 DEFVAR_LISP ("x-sent-selection-functions", Vx_sent_selection_functions,
2639 doc: /* A list of functions to be called when Emacs answers a selection request.
2640 The functions are called with three arguments:
2641 - the selection name (typically `PRIMARY', `SECONDARY', or `CLIPBOARD');
2642 - the selection-type which Emacs was asked to convert the
2643 selection into before sending (for example, `STRING' or `LENGTH');
2644 - a flag indicating success or failure for responding to the request.
2645 We might have failed (and declined the request) for any number of reasons,
2646 including being asked for a selection that we no longer own, or being asked
2647 to convert into a type that we don't know about or that is inappropriate.
2648 This hook doesn't let you change the behavior of Emacs's selection replies,
2649 it merely informs you that they have happened. */);
2650 Vx_sent_selection_functions = Qnil;
2652 DEFVAR_LISP ("x-select-enable-clipboard-manager",
2653 Vx_select_enable_clipboard_manager,
2654 doc: /* Whether to enable X clipboard manager support.
2655 If non-nil, then whenever Emacs is killed or an Emacs frame is deleted
2656 while owning the X clipboard, the clipboard contents are saved to the
2657 clipboard manager if one is present. */);
2658 Vx_select_enable_clipboard_manager = Qt;
2660 DEFVAR_INT ("x-selection-timeout", x_selection_timeout,
2661 doc: /* Number of milliseconds to wait for a selection reply.
2662 If the selection owner doesn't reply in this time, we give up.
2663 A value of 0 means wait as long as necessary. This is initialized from the
2664 \"*selectionTimeout\" resource. */);
2665 x_selection_timeout = 0;
2667 /* QPRIMARY is defined in keyboard.c. */
2668 DEFSYM (QSECONDARY, "SECONDARY");
2669 DEFSYM (QSTRING, "STRING");
2670 DEFSYM (QINTEGER, "INTEGER");
2671 DEFSYM (QCLIPBOARD, "CLIPBOARD");
2672 DEFSYM (QTIMESTAMP, "TIMESTAMP");
2673 DEFSYM (QTEXT, "TEXT");
2675 /* These are types of selection. */
2676 DEFSYM (QCOMPOUND_TEXT, "COMPOUND_TEXT");
2677 DEFSYM (QUTF8_STRING, "UTF8_STRING");
2679 DEFSYM (QDELETE, "DELETE");
2680 DEFSYM (QMULTIPLE, "MULTIPLE");
2681 DEFSYM (QINCR, "INCR");
2682 DEFSYM (QEMACS_TMP, "_EMACS_TMP_");
2683 DEFSYM (QTARGETS, "TARGETS");
2684 DEFSYM (QATOM, "ATOM");
2685 DEFSYM (QCLIPBOARD_MANAGER, "CLIPBOARD_MANAGER");
2686 DEFSYM (QSAVE_TARGETS, "SAVE_TARGETS");
2687 DEFSYM (QNULL, "NULL");
2688 DEFSYM (Qforeign_selection, "foreign-selection");
2689 DEFSYM (Qx_lost_selection_functions, "x-lost-selection-functions");
2690 DEFSYM (Qx_sent_selection_functions, "x-sent-selection-functions");