]> code.delx.au - gnu-emacs/blob - src/alloc.c
* comint.el (comint-replace-by-expanded-history-before-point):
[gnu-emacs] / src / alloc.c
1 /* Storage allocation and gc for GNU Emacs Lisp interpreter.
2 Copyright (C) 1985, 1986, 1988, 1993, 1994, 1995, 1997, 1998, 1999,
3 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009
4 Free Software Foundation, Inc.
5
6 This file is part of GNU Emacs.
7
8 GNU Emacs is free software: you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation, either version 3 of the License, or
11 (at your option) any later version.
12
13 GNU Emacs is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
17
18 You should have received a copy of the GNU General Public License
19 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
20
21 #include <config.h>
22 #include <stdio.h>
23 #include <limits.h> /* For CHAR_BIT. */
24 #include <setjmp.h>
25
26 #ifdef STDC_HEADERS
27 #include <stddef.h> /* For offsetof, used by PSEUDOVECSIZE. */
28 #endif
29
30 #ifdef ALLOC_DEBUG
31 #undef INLINE
32 #endif
33
34 /* Note that this declares bzero on OSF/1. How dumb. */
35
36 #include <signal.h>
37
38 #ifdef HAVE_GTK_AND_PTHREAD
39 #include <pthread.h>
40 #endif
41
42 /* This file is part of the core Lisp implementation, and thus must
43 deal with the real data structures. If the Lisp implementation is
44 replaced, this file likely will not be used. */
45
46 #undef HIDE_LISP_IMPLEMENTATION
47 #include "lisp.h"
48 #include "process.h"
49 #include "intervals.h"
50 #include "puresize.h"
51 #include "buffer.h"
52 #include "window.h"
53 #include "keyboard.h"
54 #include "frame.h"
55 #include "blockinput.h"
56 #include "character.h"
57 #include "syssignal.h"
58 #include "termhooks.h" /* For struct terminal. */
59 #include <setjmp.h>
60
61 /* GC_MALLOC_CHECK defined means perform validity checks of malloc'd
62 memory. Can do this only if using gmalloc.c. */
63
64 #if defined SYSTEM_MALLOC || defined DOUG_LEA_MALLOC
65 #undef GC_MALLOC_CHECK
66 #endif
67
68 #ifdef HAVE_UNISTD_H
69 #include <unistd.h>
70 #else
71 extern POINTER_TYPE *sbrk ();
72 #endif
73
74 #ifdef HAVE_FCNTL_H
75 #define INCLUDED_FCNTL
76 #include <fcntl.h>
77 #endif
78 #ifndef O_WRONLY
79 #define O_WRONLY 1
80 #endif
81
82 #ifdef WINDOWSNT
83 #include <fcntl.h>
84 #include "w32.h"
85 #endif
86
87 #ifdef DOUG_LEA_MALLOC
88
89 #include <malloc.h>
90 /* malloc.h #defines this as size_t, at least in glibc2. */
91 #ifndef __malloc_size_t
92 #define __malloc_size_t int
93 #endif
94
95 /* Specify maximum number of areas to mmap. It would be nice to use a
96 value that explicitly means "no limit". */
97
98 #define MMAP_MAX_AREAS 100000000
99
100 #else /* not DOUG_LEA_MALLOC */
101
102 /* The following come from gmalloc.c. */
103
104 #define __malloc_size_t size_t
105 extern __malloc_size_t _bytes_used;
106 extern __malloc_size_t __malloc_extra_blocks;
107
108 #endif /* not DOUG_LEA_MALLOC */
109
110 #if ! defined (SYSTEM_MALLOC) && defined (HAVE_GTK_AND_PTHREAD)
111
112 /* When GTK uses the file chooser dialog, different backends can be loaded
113 dynamically. One such a backend is the Gnome VFS backend that gets loaded
114 if you run Gnome. That backend creates several threads and also allocates
115 memory with malloc.
116
117 If Emacs sets malloc hooks (! SYSTEM_MALLOC) and the emacs_blocked_*
118 functions below are called from malloc, there is a chance that one
119 of these threads preempts the Emacs main thread and the hook variables
120 end up in an inconsistent state. So we have a mutex to prevent that (note
121 that the backend handles concurrent access to malloc within its own threads
122 but Emacs code running in the main thread is not included in that control).
123
124 When UNBLOCK_INPUT is called, reinvoke_input_signal may be called. If this
125 happens in one of the backend threads we will have two threads that tries
126 to run Emacs code at once, and the code is not prepared for that.
127 To prevent that, we only call BLOCK/UNBLOCK from the main thread. */
128
129 static pthread_mutex_t alloc_mutex;
130
131 #define BLOCK_INPUT_ALLOC \
132 do \
133 { \
134 if (pthread_equal (pthread_self (), main_thread)) \
135 BLOCK_INPUT; \
136 pthread_mutex_lock (&alloc_mutex); \
137 } \
138 while (0)
139 #define UNBLOCK_INPUT_ALLOC \
140 do \
141 { \
142 pthread_mutex_unlock (&alloc_mutex); \
143 if (pthread_equal (pthread_self (), main_thread)) \
144 UNBLOCK_INPUT; \
145 } \
146 while (0)
147
148 #else /* SYSTEM_MALLOC || not HAVE_GTK_AND_PTHREAD */
149
150 #define BLOCK_INPUT_ALLOC BLOCK_INPUT
151 #define UNBLOCK_INPUT_ALLOC UNBLOCK_INPUT
152
153 #endif /* SYSTEM_MALLOC || not HAVE_GTK_AND_PTHREAD */
154
155 /* Value of _bytes_used, when spare_memory was freed. */
156
157 static __malloc_size_t bytes_used_when_full;
158
159 static __malloc_size_t bytes_used_when_reconsidered;
160
161 /* Mark, unmark, query mark bit of a Lisp string. S must be a pointer
162 to a struct Lisp_String. */
163
164 #define MARK_STRING(S) ((S)->size |= ARRAY_MARK_FLAG)
165 #define UNMARK_STRING(S) ((S)->size &= ~ARRAY_MARK_FLAG)
166 #define STRING_MARKED_P(S) (((S)->size & ARRAY_MARK_FLAG) != 0)
167
168 #define VECTOR_MARK(V) ((V)->size |= ARRAY_MARK_FLAG)
169 #define VECTOR_UNMARK(V) ((V)->size &= ~ARRAY_MARK_FLAG)
170 #define VECTOR_MARKED_P(V) (((V)->size & ARRAY_MARK_FLAG) != 0)
171
172 /* Value is the number of bytes/chars of S, a pointer to a struct
173 Lisp_String. This must be used instead of STRING_BYTES (S) or
174 S->size during GC, because S->size contains the mark bit for
175 strings. */
176
177 #define GC_STRING_BYTES(S) (STRING_BYTES (S))
178 #define GC_STRING_CHARS(S) ((S)->size & ~ARRAY_MARK_FLAG)
179
180 /* Number of bytes of consing done since the last gc. */
181
182 int consing_since_gc;
183
184 /* Count the amount of consing of various sorts of space. */
185
186 EMACS_INT cons_cells_consed;
187 EMACS_INT floats_consed;
188 EMACS_INT vector_cells_consed;
189 EMACS_INT symbols_consed;
190 EMACS_INT string_chars_consed;
191 EMACS_INT misc_objects_consed;
192 EMACS_INT intervals_consed;
193 EMACS_INT strings_consed;
194
195 /* Minimum number of bytes of consing since GC before next GC. */
196
197 EMACS_INT gc_cons_threshold;
198
199 /* Similar minimum, computed from Vgc_cons_percentage. */
200
201 EMACS_INT gc_relative_threshold;
202
203 static Lisp_Object Vgc_cons_percentage;
204
205 /* Minimum number of bytes of consing since GC before next GC,
206 when memory is full. */
207
208 EMACS_INT memory_full_cons_threshold;
209
210 /* Nonzero during GC. */
211
212 int gc_in_progress;
213
214 /* Nonzero means abort if try to GC.
215 This is for code which is written on the assumption that
216 no GC will happen, so as to verify that assumption. */
217
218 int abort_on_gc;
219
220 /* Nonzero means display messages at beginning and end of GC. */
221
222 int garbage_collection_messages;
223
224 #ifndef VIRT_ADDR_VARIES
225 extern
226 #endif /* VIRT_ADDR_VARIES */
227 int malloc_sbrk_used;
228
229 #ifndef VIRT_ADDR_VARIES
230 extern
231 #endif /* VIRT_ADDR_VARIES */
232 int malloc_sbrk_unused;
233
234 /* Number of live and free conses etc. */
235
236 static int total_conses, total_markers, total_symbols, total_vector_size;
237 static int total_free_conses, total_free_markers, total_free_symbols;
238 static int total_free_floats, total_floats;
239
240 /* Points to memory space allocated as "spare", to be freed if we run
241 out of memory. We keep one large block, four cons-blocks, and
242 two string blocks. */
243
244 static char *spare_memory[7];
245
246 /* Amount of spare memory to keep in large reserve block. */
247
248 #define SPARE_MEMORY (1 << 14)
249
250 /* Number of extra blocks malloc should get when it needs more core. */
251
252 static int malloc_hysteresis;
253
254 /* Non-nil means defun should do purecopy on the function definition. */
255
256 Lisp_Object Vpurify_flag;
257
258 /* Non-nil means we are handling a memory-full error. */
259
260 Lisp_Object Vmemory_full;
261
262 #ifndef HAVE_SHM
263
264 /* Initialize it to a nonzero value to force it into data space
265 (rather than bss space). That way unexec will remap it into text
266 space (pure), on some systems. We have not implemented the
267 remapping on more recent systems because this is less important
268 nowadays than in the days of small memories and timesharing. */
269
270 EMACS_INT pure[(PURESIZE + sizeof (EMACS_INT) - 1) / sizeof (EMACS_INT)] = {1,};
271 #define PUREBEG (char *) pure
272
273 #else /* HAVE_SHM */
274
275 #define pure PURE_SEG_BITS /* Use shared memory segment */
276 #define PUREBEG (char *)PURE_SEG_BITS
277
278 #endif /* HAVE_SHM */
279
280 /* Pointer to the pure area, and its size. */
281
282 static char *purebeg;
283 static size_t pure_size;
284
285 /* Number of bytes of pure storage used before pure storage overflowed.
286 If this is non-zero, this implies that an overflow occurred. */
287
288 static size_t pure_bytes_used_before_overflow;
289
290 /* Value is non-zero if P points into pure space. */
291
292 #define PURE_POINTER_P(P) \
293 (((PNTR_COMPARISON_TYPE) (P) \
294 < (PNTR_COMPARISON_TYPE) ((char *) purebeg + pure_size)) \
295 && ((PNTR_COMPARISON_TYPE) (P) \
296 >= (PNTR_COMPARISON_TYPE) purebeg))
297
298 /* Total number of bytes allocated in pure storage. */
299
300 EMACS_INT pure_bytes_used;
301
302 /* Index in pure at which next pure Lisp object will be allocated.. */
303
304 static EMACS_INT pure_bytes_used_lisp;
305
306 /* Number of bytes allocated for non-Lisp objects in pure storage. */
307
308 static EMACS_INT pure_bytes_used_non_lisp;
309
310 /* If nonzero, this is a warning delivered by malloc and not yet
311 displayed. */
312
313 char *pending_malloc_warning;
314
315 /* Pre-computed signal argument for use when memory is exhausted. */
316
317 Lisp_Object Vmemory_signal_data;
318
319 /* Maximum amount of C stack to save when a GC happens. */
320
321 #ifndef MAX_SAVE_STACK
322 #define MAX_SAVE_STACK 16000
323 #endif
324
325 /* Buffer in which we save a copy of the C stack at each GC. */
326
327 static char *stack_copy;
328 static int stack_copy_size;
329
330 /* Non-zero means ignore malloc warnings. Set during initialization.
331 Currently not used. */
332
333 static int ignore_warnings;
334
335 Lisp_Object Qgc_cons_threshold, Qchar_table_extra_slots;
336
337 /* Hook run after GC has finished. */
338
339 Lisp_Object Vpost_gc_hook, Qpost_gc_hook;
340
341 Lisp_Object Vgc_elapsed; /* accumulated elapsed time in GC */
342 EMACS_INT gcs_done; /* accumulated GCs */
343
344 static void mark_buffer P_ ((Lisp_Object));
345 static void mark_terminals P_ ((void));
346 extern void mark_kboards P_ ((void));
347 extern void mark_ttys P_ ((void));
348 extern void mark_backtrace P_ ((void));
349 static void gc_sweep P_ ((void));
350 static void mark_glyph_matrix P_ ((struct glyph_matrix *));
351 static void mark_face_cache P_ ((struct face_cache *));
352
353 #ifdef HAVE_WINDOW_SYSTEM
354 extern void mark_fringe_data P_ ((void));
355 #endif /* HAVE_WINDOW_SYSTEM */
356
357 static struct Lisp_String *allocate_string P_ ((void));
358 static void compact_small_strings P_ ((void));
359 static void free_large_strings P_ ((void));
360 static void sweep_strings P_ ((void));
361
362 extern int message_enable_multibyte;
363
364 /* When scanning the C stack for live Lisp objects, Emacs keeps track
365 of what memory allocated via lisp_malloc is intended for what
366 purpose. This enumeration specifies the type of memory. */
367
368 enum mem_type
369 {
370 MEM_TYPE_NON_LISP,
371 MEM_TYPE_BUFFER,
372 MEM_TYPE_CONS,
373 MEM_TYPE_STRING,
374 MEM_TYPE_MISC,
375 MEM_TYPE_SYMBOL,
376 MEM_TYPE_FLOAT,
377 /* We used to keep separate mem_types for subtypes of vectors such as
378 process, hash_table, frame, terminal, and window, but we never made
379 use of the distinction, so it only caused source-code complexity
380 and runtime slowdown. Minor but pointless. */
381 MEM_TYPE_VECTORLIKE
382 };
383
384 static POINTER_TYPE *lisp_align_malloc P_ ((size_t, enum mem_type));
385 static POINTER_TYPE *lisp_malloc P_ ((size_t, enum mem_type));
386 void refill_memory_reserve ();
387
388
389 #if GC_MARK_STACK || defined GC_MALLOC_CHECK
390
391 #if GC_MARK_STACK == GC_USE_GCPROS_CHECK_ZOMBIES
392 #include <stdio.h> /* For fprintf. */
393 #endif
394
395 /* A unique object in pure space used to make some Lisp objects
396 on free lists recognizable in O(1). */
397
398 static Lisp_Object Vdead;
399
400 #ifdef GC_MALLOC_CHECK
401
402 enum mem_type allocated_mem_type;
403 static int dont_register_blocks;
404
405 #endif /* GC_MALLOC_CHECK */
406
407 /* A node in the red-black tree describing allocated memory containing
408 Lisp data. Each such block is recorded with its start and end
409 address when it is allocated, and removed from the tree when it
410 is freed.
411
412 A red-black tree is a balanced binary tree with the following
413 properties:
414
415 1. Every node is either red or black.
416 2. Every leaf is black.
417 3. If a node is red, then both of its children are black.
418 4. Every simple path from a node to a descendant leaf contains
419 the same number of black nodes.
420 5. The root is always black.
421
422 When nodes are inserted into the tree, or deleted from the tree,
423 the tree is "fixed" so that these properties are always true.
424
425 A red-black tree with N internal nodes has height at most 2
426 log(N+1). Searches, insertions and deletions are done in O(log N).
427 Please see a text book about data structures for a detailed
428 description of red-black trees. Any book worth its salt should
429 describe them. */
430
431 struct mem_node
432 {
433 /* Children of this node. These pointers are never NULL. When there
434 is no child, the value is MEM_NIL, which points to a dummy node. */
435 struct mem_node *left, *right;
436
437 /* The parent of this node. In the root node, this is NULL. */
438 struct mem_node *parent;
439
440 /* Start and end of allocated region. */
441 void *start, *end;
442
443 /* Node color. */
444 enum {MEM_BLACK, MEM_RED} color;
445
446 /* Memory type. */
447 enum mem_type type;
448 };
449
450 /* Base address of stack. Set in main. */
451
452 Lisp_Object *stack_base;
453
454 /* Root of the tree describing allocated Lisp memory. */
455
456 static struct mem_node *mem_root;
457
458 /* Lowest and highest known address in the heap. */
459
460 static void *min_heap_address, *max_heap_address;
461
462 /* Sentinel node of the tree. */
463
464 static struct mem_node mem_z;
465 #define MEM_NIL &mem_z
466
467 static POINTER_TYPE *lisp_malloc P_ ((size_t, enum mem_type));
468 static struct Lisp_Vector *allocate_vectorlike P_ ((EMACS_INT));
469 static void lisp_free P_ ((POINTER_TYPE *));
470 static void mark_stack P_ ((void));
471 static int live_vector_p P_ ((struct mem_node *, void *));
472 static int live_buffer_p P_ ((struct mem_node *, void *));
473 static int live_string_p P_ ((struct mem_node *, void *));
474 static int live_cons_p P_ ((struct mem_node *, void *));
475 static int live_symbol_p P_ ((struct mem_node *, void *));
476 static int live_float_p P_ ((struct mem_node *, void *));
477 static int live_misc_p P_ ((struct mem_node *, void *));
478 static void mark_maybe_object P_ ((Lisp_Object));
479 static void mark_memory P_ ((void *, void *, int));
480 static void mem_init P_ ((void));
481 static struct mem_node *mem_insert P_ ((void *, void *, enum mem_type));
482 static void mem_insert_fixup P_ ((struct mem_node *));
483 static void mem_rotate_left P_ ((struct mem_node *));
484 static void mem_rotate_right P_ ((struct mem_node *));
485 static void mem_delete P_ ((struct mem_node *));
486 static void mem_delete_fixup P_ ((struct mem_node *));
487 static INLINE struct mem_node *mem_find P_ ((void *));
488
489
490 #if GC_MARK_STACK == GC_MARK_STACK_CHECK_GCPROS
491 static void check_gcpros P_ ((void));
492 #endif
493
494 #endif /* GC_MARK_STACK || GC_MALLOC_CHECK */
495
496 /* Recording what needs to be marked for gc. */
497
498 struct gcpro *gcprolist;
499
500 /* Addresses of staticpro'd variables. Initialize it to a nonzero
501 value; otherwise some compilers put it into BSS. */
502
503 #define NSTATICS 0x640
504 static Lisp_Object *staticvec[NSTATICS] = {&Vpurify_flag};
505
506 /* Index of next unused slot in staticvec. */
507
508 static int staticidx = 0;
509
510 static POINTER_TYPE *pure_alloc P_ ((size_t, int));
511
512
513 /* Value is SZ rounded up to the next multiple of ALIGNMENT.
514 ALIGNMENT must be a power of 2. */
515
516 #define ALIGN(ptr, ALIGNMENT) \
517 ((POINTER_TYPE *) ((((EMACS_UINT)(ptr)) + (ALIGNMENT) - 1) \
518 & ~((ALIGNMENT) - 1)))
519
520
521 \f
522 /************************************************************************
523 Malloc
524 ************************************************************************/
525
526 /* Function malloc calls this if it finds we are near exhausting storage. */
527
528 void
529 malloc_warning (str)
530 char *str;
531 {
532 pending_malloc_warning = str;
533 }
534
535
536 /* Display an already-pending malloc warning. */
537
538 void
539 display_malloc_warning ()
540 {
541 call3 (intern ("display-warning"),
542 intern ("alloc"),
543 build_string (pending_malloc_warning),
544 intern ("emergency"));
545 pending_malloc_warning = 0;
546 }
547
548
549 #ifdef DOUG_LEA_MALLOC
550 # define BYTES_USED (mallinfo ().uordblks)
551 #else
552 # define BYTES_USED _bytes_used
553 #endif
554 \f
555 /* Called if we can't allocate relocatable space for a buffer. */
556
557 void
558 buffer_memory_full ()
559 {
560 /* If buffers use the relocating allocator, no need to free
561 spare_memory, because we may have plenty of malloc space left
562 that we could get, and if we don't, the malloc that fails will
563 itself cause spare_memory to be freed. If buffers don't use the
564 relocating allocator, treat this like any other failing
565 malloc. */
566
567 #ifndef REL_ALLOC
568 memory_full ();
569 #endif
570
571 /* This used to call error, but if we've run out of memory, we could
572 get infinite recursion trying to build the string. */
573 xsignal (Qnil, Vmemory_signal_data);
574 }
575
576
577 #ifdef XMALLOC_OVERRUN_CHECK
578
579 /* Check for overrun in malloc'ed buffers by wrapping a 16 byte header
580 and a 16 byte trailer around each block.
581
582 The header consists of 12 fixed bytes + a 4 byte integer contaning the
583 original block size, while the trailer consists of 16 fixed bytes.
584
585 The header is used to detect whether this block has been allocated
586 through these functions -- as it seems that some low-level libc
587 functions may bypass the malloc hooks.
588 */
589
590
591 #define XMALLOC_OVERRUN_CHECK_SIZE 16
592
593 static char xmalloc_overrun_check_header[XMALLOC_OVERRUN_CHECK_SIZE-4] =
594 { 0x9a, 0x9b, 0xae, 0xaf,
595 0xbf, 0xbe, 0xce, 0xcf,
596 0xea, 0xeb, 0xec, 0xed };
597
598 static char xmalloc_overrun_check_trailer[XMALLOC_OVERRUN_CHECK_SIZE] =
599 { 0xaa, 0xab, 0xac, 0xad,
600 0xba, 0xbb, 0xbc, 0xbd,
601 0xca, 0xcb, 0xcc, 0xcd,
602 0xda, 0xdb, 0xdc, 0xdd };
603
604 /* Macros to insert and extract the block size in the header. */
605
606 #define XMALLOC_PUT_SIZE(ptr, size) \
607 (ptr[-1] = (size & 0xff), \
608 ptr[-2] = ((size >> 8) & 0xff), \
609 ptr[-3] = ((size >> 16) & 0xff), \
610 ptr[-4] = ((size >> 24) & 0xff))
611
612 #define XMALLOC_GET_SIZE(ptr) \
613 (size_t)((unsigned)(ptr[-1]) | \
614 ((unsigned)(ptr[-2]) << 8) | \
615 ((unsigned)(ptr[-3]) << 16) | \
616 ((unsigned)(ptr[-4]) << 24))
617
618
619 /* The call depth in overrun_check functions. For example, this might happen:
620 xmalloc()
621 overrun_check_malloc()
622 -> malloc -> (via hook)_-> emacs_blocked_malloc
623 -> overrun_check_malloc
624 call malloc (hooks are NULL, so real malloc is called).
625 malloc returns 10000.
626 add overhead, return 10016.
627 <- (back in overrun_check_malloc)
628 add overhead again, return 10032
629 xmalloc returns 10032.
630
631 (time passes).
632
633 xfree(10032)
634 overrun_check_free(10032)
635 decrease overhed
636 free(10016) <- crash, because 10000 is the original pointer. */
637
638 static int check_depth;
639
640 /* Like malloc, but wraps allocated block with header and trailer. */
641
642 POINTER_TYPE *
643 overrun_check_malloc (size)
644 size_t size;
645 {
646 register unsigned char *val;
647 size_t overhead = ++check_depth == 1 ? XMALLOC_OVERRUN_CHECK_SIZE*2 : 0;
648
649 val = (unsigned char *) malloc (size + overhead);
650 if (val && check_depth == 1)
651 {
652 bcopy (xmalloc_overrun_check_header, val, XMALLOC_OVERRUN_CHECK_SIZE - 4);
653 val += XMALLOC_OVERRUN_CHECK_SIZE;
654 XMALLOC_PUT_SIZE(val, size);
655 bcopy (xmalloc_overrun_check_trailer, val + size, XMALLOC_OVERRUN_CHECK_SIZE);
656 }
657 --check_depth;
658 return (POINTER_TYPE *)val;
659 }
660
661
662 /* Like realloc, but checks old block for overrun, and wraps new block
663 with header and trailer. */
664
665 POINTER_TYPE *
666 overrun_check_realloc (block, size)
667 POINTER_TYPE *block;
668 size_t size;
669 {
670 register unsigned char *val = (unsigned char *)block;
671 size_t overhead = ++check_depth == 1 ? XMALLOC_OVERRUN_CHECK_SIZE*2 : 0;
672
673 if (val
674 && check_depth == 1
675 && bcmp (xmalloc_overrun_check_header,
676 val - XMALLOC_OVERRUN_CHECK_SIZE,
677 XMALLOC_OVERRUN_CHECK_SIZE - 4) == 0)
678 {
679 size_t osize = XMALLOC_GET_SIZE (val);
680 if (bcmp (xmalloc_overrun_check_trailer,
681 val + osize,
682 XMALLOC_OVERRUN_CHECK_SIZE))
683 abort ();
684 bzero (val + osize, XMALLOC_OVERRUN_CHECK_SIZE);
685 val -= XMALLOC_OVERRUN_CHECK_SIZE;
686 bzero (val, XMALLOC_OVERRUN_CHECK_SIZE);
687 }
688
689 val = (unsigned char *) realloc ((POINTER_TYPE *)val, size + overhead);
690
691 if (val && check_depth == 1)
692 {
693 bcopy (xmalloc_overrun_check_header, val, XMALLOC_OVERRUN_CHECK_SIZE - 4);
694 val += XMALLOC_OVERRUN_CHECK_SIZE;
695 XMALLOC_PUT_SIZE(val, size);
696 bcopy (xmalloc_overrun_check_trailer, val + size, XMALLOC_OVERRUN_CHECK_SIZE);
697 }
698 --check_depth;
699 return (POINTER_TYPE *)val;
700 }
701
702 /* Like free, but checks block for overrun. */
703
704 void
705 overrun_check_free (block)
706 POINTER_TYPE *block;
707 {
708 unsigned char *val = (unsigned char *)block;
709
710 ++check_depth;
711 if (val
712 && check_depth == 1
713 && bcmp (xmalloc_overrun_check_header,
714 val - XMALLOC_OVERRUN_CHECK_SIZE,
715 XMALLOC_OVERRUN_CHECK_SIZE - 4) == 0)
716 {
717 size_t osize = XMALLOC_GET_SIZE (val);
718 if (bcmp (xmalloc_overrun_check_trailer,
719 val + osize,
720 XMALLOC_OVERRUN_CHECK_SIZE))
721 abort ();
722 #ifdef XMALLOC_CLEAR_FREE_MEMORY
723 val -= XMALLOC_OVERRUN_CHECK_SIZE;
724 memset (val, 0xff, osize + XMALLOC_OVERRUN_CHECK_SIZE*2);
725 #else
726 bzero (val + osize, XMALLOC_OVERRUN_CHECK_SIZE);
727 val -= XMALLOC_OVERRUN_CHECK_SIZE;
728 bzero (val, XMALLOC_OVERRUN_CHECK_SIZE);
729 #endif
730 }
731
732 free (val);
733 --check_depth;
734 }
735
736 #undef malloc
737 #undef realloc
738 #undef free
739 #define malloc overrun_check_malloc
740 #define realloc overrun_check_realloc
741 #define free overrun_check_free
742 #endif
743
744 #ifdef SYNC_INPUT
745 /* When using SYNC_INPUT, we don't call malloc from a signal handler, so
746 there's no need to block input around malloc. */
747 #define MALLOC_BLOCK_INPUT ((void)0)
748 #define MALLOC_UNBLOCK_INPUT ((void)0)
749 #else
750 #define MALLOC_BLOCK_INPUT BLOCK_INPUT
751 #define MALLOC_UNBLOCK_INPUT UNBLOCK_INPUT
752 #endif
753
754 /* Like malloc but check for no memory and block interrupt input.. */
755
756 POINTER_TYPE *
757 xmalloc (size)
758 size_t size;
759 {
760 register POINTER_TYPE *val;
761
762 MALLOC_BLOCK_INPUT;
763 val = (POINTER_TYPE *) malloc (size);
764 MALLOC_UNBLOCK_INPUT;
765
766 if (!val && size)
767 memory_full ();
768 return val;
769 }
770
771
772 /* Like realloc but check for no memory and block interrupt input.. */
773
774 POINTER_TYPE *
775 xrealloc (block, size)
776 POINTER_TYPE *block;
777 size_t size;
778 {
779 register POINTER_TYPE *val;
780
781 MALLOC_BLOCK_INPUT;
782 /* We must call malloc explicitly when BLOCK is 0, since some
783 reallocs don't do this. */
784 if (! block)
785 val = (POINTER_TYPE *) malloc (size);
786 else
787 val = (POINTER_TYPE *) realloc (block, size);
788 MALLOC_UNBLOCK_INPUT;
789
790 if (!val && size) memory_full ();
791 return val;
792 }
793
794
795 /* Like free but block interrupt input. */
796
797 void
798 xfree (block)
799 POINTER_TYPE *block;
800 {
801 if (!block)
802 return;
803 MALLOC_BLOCK_INPUT;
804 free (block);
805 MALLOC_UNBLOCK_INPUT;
806 /* We don't call refill_memory_reserve here
807 because that duplicates doing so in emacs_blocked_free
808 and the criterion should go there. */
809 }
810
811
812 /* Like strdup, but uses xmalloc. */
813
814 char *
815 xstrdup (s)
816 const char *s;
817 {
818 size_t len = strlen (s) + 1;
819 char *p = (char *) xmalloc (len);
820 bcopy (s, p, len);
821 return p;
822 }
823
824
825 /* Unwind for SAFE_ALLOCA */
826
827 Lisp_Object
828 safe_alloca_unwind (arg)
829 Lisp_Object arg;
830 {
831 register struct Lisp_Save_Value *p = XSAVE_VALUE (arg);
832
833 p->dogc = 0;
834 xfree (p->pointer);
835 p->pointer = 0;
836 free_misc (arg);
837 return Qnil;
838 }
839
840
841 /* Like malloc but used for allocating Lisp data. NBYTES is the
842 number of bytes to allocate, TYPE describes the intended use of the
843 allcated memory block (for strings, for conses, ...). */
844
845 #ifndef USE_LSB_TAG
846 static void *lisp_malloc_loser;
847 #endif
848
849 static POINTER_TYPE *
850 lisp_malloc (nbytes, type)
851 size_t nbytes;
852 enum mem_type type;
853 {
854 register void *val;
855
856 MALLOC_BLOCK_INPUT;
857
858 #ifdef GC_MALLOC_CHECK
859 allocated_mem_type = type;
860 #endif
861
862 val = (void *) malloc (nbytes);
863
864 #ifndef USE_LSB_TAG
865 /* If the memory just allocated cannot be addressed thru a Lisp
866 object's pointer, and it needs to be,
867 that's equivalent to running out of memory. */
868 if (val && type != MEM_TYPE_NON_LISP)
869 {
870 Lisp_Object tem;
871 XSETCONS (tem, (char *) val + nbytes - 1);
872 if ((char *) XCONS (tem) != (char *) val + nbytes - 1)
873 {
874 lisp_malloc_loser = val;
875 free (val);
876 val = 0;
877 }
878 }
879 #endif
880
881 #if GC_MARK_STACK && !defined GC_MALLOC_CHECK
882 if (val && type != MEM_TYPE_NON_LISP)
883 mem_insert (val, (char *) val + nbytes, type);
884 #endif
885
886 MALLOC_UNBLOCK_INPUT;
887 if (!val && nbytes)
888 memory_full ();
889 return val;
890 }
891
892 /* Free BLOCK. This must be called to free memory allocated with a
893 call to lisp_malloc. */
894
895 static void
896 lisp_free (block)
897 POINTER_TYPE *block;
898 {
899 MALLOC_BLOCK_INPUT;
900 free (block);
901 #if GC_MARK_STACK && !defined GC_MALLOC_CHECK
902 mem_delete (mem_find (block));
903 #endif
904 MALLOC_UNBLOCK_INPUT;
905 }
906
907 /* Allocation of aligned blocks of memory to store Lisp data. */
908 /* The entry point is lisp_align_malloc which returns blocks of at most */
909 /* BLOCK_BYTES and guarantees they are aligned on a BLOCK_ALIGN boundary. */
910
911 /* Use posix_memalloc if the system has it and we're using the system's
912 malloc (because our gmalloc.c routines don't have posix_memalign although
913 its memalloc could be used). */
914 #if defined (HAVE_POSIX_MEMALIGN) && defined (SYSTEM_MALLOC)
915 #define USE_POSIX_MEMALIGN 1
916 #endif
917
918 /* BLOCK_ALIGN has to be a power of 2. */
919 #define BLOCK_ALIGN (1 << 10)
920
921 /* Padding to leave at the end of a malloc'd block. This is to give
922 malloc a chance to minimize the amount of memory wasted to alignment.
923 It should be tuned to the particular malloc library used.
924 On glibc-2.3.2, malloc never tries to align, so a padding of 0 is best.
925 posix_memalign on the other hand would ideally prefer a value of 4
926 because otherwise, there's 1020 bytes wasted between each ablocks.
927 In Emacs, testing shows that those 1020 can most of the time be
928 efficiently used by malloc to place other objects, so a value of 0 can
929 still preferable unless you have a lot of aligned blocks and virtually
930 nothing else. */
931 #define BLOCK_PADDING 0
932 #define BLOCK_BYTES \
933 (BLOCK_ALIGN - sizeof (struct ablock *) - BLOCK_PADDING)
934
935 /* Internal data structures and constants. */
936
937 #define ABLOCKS_SIZE 16
938
939 /* An aligned block of memory. */
940 struct ablock
941 {
942 union
943 {
944 char payload[BLOCK_BYTES];
945 struct ablock *next_free;
946 } x;
947 /* `abase' is the aligned base of the ablocks. */
948 /* It is overloaded to hold the virtual `busy' field that counts
949 the number of used ablock in the parent ablocks.
950 The first ablock has the `busy' field, the others have the `abase'
951 field. To tell the difference, we assume that pointers will have
952 integer values larger than 2 * ABLOCKS_SIZE. The lowest bit of `busy'
953 is used to tell whether the real base of the parent ablocks is `abase'
954 (if not, the word before the first ablock holds a pointer to the
955 real base). */
956 struct ablocks *abase;
957 /* The padding of all but the last ablock is unused. The padding of
958 the last ablock in an ablocks is not allocated. */
959 #if BLOCK_PADDING
960 char padding[BLOCK_PADDING];
961 #endif
962 };
963
964 /* A bunch of consecutive aligned blocks. */
965 struct ablocks
966 {
967 struct ablock blocks[ABLOCKS_SIZE];
968 };
969
970 /* Size of the block requested from malloc or memalign. */
971 #define ABLOCKS_BYTES (sizeof (struct ablocks) - BLOCK_PADDING)
972
973 #define ABLOCK_ABASE(block) \
974 (((unsigned long) (block)->abase) <= (1 + 2 * ABLOCKS_SIZE) \
975 ? (struct ablocks *)(block) \
976 : (block)->abase)
977
978 /* Virtual `busy' field. */
979 #define ABLOCKS_BUSY(abase) ((abase)->blocks[0].abase)
980
981 /* Pointer to the (not necessarily aligned) malloc block. */
982 #ifdef USE_POSIX_MEMALIGN
983 #define ABLOCKS_BASE(abase) (abase)
984 #else
985 #define ABLOCKS_BASE(abase) \
986 (1 & (long) ABLOCKS_BUSY (abase) ? abase : ((void**)abase)[-1])
987 #endif
988
989 /* The list of free ablock. */
990 static struct ablock *free_ablock;
991
992 /* Allocate an aligned block of nbytes.
993 Alignment is on a multiple of BLOCK_ALIGN and `nbytes' has to be
994 smaller or equal to BLOCK_BYTES. */
995 static POINTER_TYPE *
996 lisp_align_malloc (nbytes, type)
997 size_t nbytes;
998 enum mem_type type;
999 {
1000 void *base, *val;
1001 struct ablocks *abase;
1002
1003 eassert (nbytes <= BLOCK_BYTES);
1004
1005 MALLOC_BLOCK_INPUT;
1006
1007 #ifdef GC_MALLOC_CHECK
1008 allocated_mem_type = type;
1009 #endif
1010
1011 if (!free_ablock)
1012 {
1013 int i;
1014 EMACS_INT aligned; /* int gets warning casting to 64-bit pointer. */
1015
1016 #ifdef DOUG_LEA_MALLOC
1017 /* Prevent mmap'ing the chunk. Lisp data may not be mmap'ed
1018 because mapped region contents are not preserved in
1019 a dumped Emacs. */
1020 mallopt (M_MMAP_MAX, 0);
1021 #endif
1022
1023 #ifdef USE_POSIX_MEMALIGN
1024 {
1025 int err = posix_memalign (&base, BLOCK_ALIGN, ABLOCKS_BYTES);
1026 if (err)
1027 base = NULL;
1028 abase = base;
1029 }
1030 #else
1031 base = malloc (ABLOCKS_BYTES);
1032 abase = ALIGN (base, BLOCK_ALIGN);
1033 #endif
1034
1035 if (base == 0)
1036 {
1037 MALLOC_UNBLOCK_INPUT;
1038 memory_full ();
1039 }
1040
1041 aligned = (base == abase);
1042 if (!aligned)
1043 ((void**)abase)[-1] = base;
1044
1045 #ifdef DOUG_LEA_MALLOC
1046 /* Back to a reasonable maximum of mmap'ed areas. */
1047 mallopt (M_MMAP_MAX, MMAP_MAX_AREAS);
1048 #endif
1049
1050 #ifndef USE_LSB_TAG
1051 /* If the memory just allocated cannot be addressed thru a Lisp
1052 object's pointer, and it needs to be, that's equivalent to
1053 running out of memory. */
1054 if (type != MEM_TYPE_NON_LISP)
1055 {
1056 Lisp_Object tem;
1057 char *end = (char *) base + ABLOCKS_BYTES - 1;
1058 XSETCONS (tem, end);
1059 if ((char *) XCONS (tem) != end)
1060 {
1061 lisp_malloc_loser = base;
1062 free (base);
1063 MALLOC_UNBLOCK_INPUT;
1064 memory_full ();
1065 }
1066 }
1067 #endif
1068
1069 /* Initialize the blocks and put them on the free list.
1070 Is `base' was not properly aligned, we can't use the last block. */
1071 for (i = 0; i < (aligned ? ABLOCKS_SIZE : ABLOCKS_SIZE - 1); i++)
1072 {
1073 abase->blocks[i].abase = abase;
1074 abase->blocks[i].x.next_free = free_ablock;
1075 free_ablock = &abase->blocks[i];
1076 }
1077 ABLOCKS_BUSY (abase) = (struct ablocks *) (long) aligned;
1078
1079 eassert (0 == ((EMACS_UINT)abase) % BLOCK_ALIGN);
1080 eassert (ABLOCK_ABASE (&abase->blocks[3]) == abase); /* 3 is arbitrary */
1081 eassert (ABLOCK_ABASE (&abase->blocks[0]) == abase);
1082 eassert (ABLOCKS_BASE (abase) == base);
1083 eassert (aligned == (long) ABLOCKS_BUSY (abase));
1084 }
1085
1086 abase = ABLOCK_ABASE (free_ablock);
1087 ABLOCKS_BUSY (abase) = (struct ablocks *) (2 + (long) ABLOCKS_BUSY (abase));
1088 val = free_ablock;
1089 free_ablock = free_ablock->x.next_free;
1090
1091 #if GC_MARK_STACK && !defined GC_MALLOC_CHECK
1092 if (val && type != MEM_TYPE_NON_LISP)
1093 mem_insert (val, (char *) val + nbytes, type);
1094 #endif
1095
1096 MALLOC_UNBLOCK_INPUT;
1097 if (!val && nbytes)
1098 memory_full ();
1099
1100 eassert (0 == ((EMACS_UINT)val) % BLOCK_ALIGN);
1101 return val;
1102 }
1103
1104 static void
1105 lisp_align_free (block)
1106 POINTER_TYPE *block;
1107 {
1108 struct ablock *ablock = block;
1109 struct ablocks *abase = ABLOCK_ABASE (ablock);
1110
1111 MALLOC_BLOCK_INPUT;
1112 #if GC_MARK_STACK && !defined GC_MALLOC_CHECK
1113 mem_delete (mem_find (block));
1114 #endif
1115 /* Put on free list. */
1116 ablock->x.next_free = free_ablock;
1117 free_ablock = ablock;
1118 /* Update busy count. */
1119 ABLOCKS_BUSY (abase) = (struct ablocks *) (-2 + (long) ABLOCKS_BUSY (abase));
1120
1121 if (2 > (long) ABLOCKS_BUSY (abase))
1122 { /* All the blocks are free. */
1123 int i = 0, aligned = (long) ABLOCKS_BUSY (abase);
1124 struct ablock **tem = &free_ablock;
1125 struct ablock *atop = &abase->blocks[aligned ? ABLOCKS_SIZE : ABLOCKS_SIZE - 1];
1126
1127 while (*tem)
1128 {
1129 if (*tem >= (struct ablock *) abase && *tem < atop)
1130 {
1131 i++;
1132 *tem = (*tem)->x.next_free;
1133 }
1134 else
1135 tem = &(*tem)->x.next_free;
1136 }
1137 eassert ((aligned & 1) == aligned);
1138 eassert (i == (aligned ? ABLOCKS_SIZE : ABLOCKS_SIZE - 1));
1139 #ifdef USE_POSIX_MEMALIGN
1140 eassert ((unsigned long)ABLOCKS_BASE (abase) % BLOCK_ALIGN == 0);
1141 #endif
1142 free (ABLOCKS_BASE (abase));
1143 }
1144 MALLOC_UNBLOCK_INPUT;
1145 }
1146
1147 /* Return a new buffer structure allocated from the heap with
1148 a call to lisp_malloc. */
1149
1150 struct buffer *
1151 allocate_buffer ()
1152 {
1153 struct buffer *b
1154 = (struct buffer *) lisp_malloc (sizeof (struct buffer),
1155 MEM_TYPE_BUFFER);
1156 b->size = sizeof (struct buffer) / sizeof (EMACS_INT);
1157 XSETPVECTYPE (b, PVEC_BUFFER);
1158 return b;
1159 }
1160
1161 \f
1162 #ifndef SYSTEM_MALLOC
1163
1164 /* Arranging to disable input signals while we're in malloc.
1165
1166 This only works with GNU malloc. To help out systems which can't
1167 use GNU malloc, all the calls to malloc, realloc, and free
1168 elsewhere in the code should be inside a BLOCK_INPUT/UNBLOCK_INPUT
1169 pair; unfortunately, we have no idea what C library functions
1170 might call malloc, so we can't really protect them unless you're
1171 using GNU malloc. Fortunately, most of the major operating systems
1172 can use GNU malloc. */
1173
1174 #ifndef SYNC_INPUT
1175 /* When using SYNC_INPUT, we don't call malloc from a signal handler, so
1176 there's no need to block input around malloc. */
1177
1178 #ifndef DOUG_LEA_MALLOC
1179 extern void * (*__malloc_hook) P_ ((size_t, const void *));
1180 extern void * (*__realloc_hook) P_ ((void *, size_t, const void *));
1181 extern void (*__free_hook) P_ ((void *, const void *));
1182 /* Else declared in malloc.h, perhaps with an extra arg. */
1183 #endif /* DOUG_LEA_MALLOC */
1184 static void * (*old_malloc_hook) P_ ((size_t, const void *));
1185 static void * (*old_realloc_hook) P_ ((void *, size_t, const void*));
1186 static void (*old_free_hook) P_ ((void*, const void*));
1187
1188 /* This function is used as the hook for free to call. */
1189
1190 static void
1191 emacs_blocked_free (ptr, ptr2)
1192 void *ptr;
1193 const void *ptr2;
1194 {
1195 BLOCK_INPUT_ALLOC;
1196
1197 #ifdef GC_MALLOC_CHECK
1198 if (ptr)
1199 {
1200 struct mem_node *m;
1201
1202 m = mem_find (ptr);
1203 if (m == MEM_NIL || m->start != ptr)
1204 {
1205 fprintf (stderr,
1206 "Freeing `%p' which wasn't allocated with malloc\n", ptr);
1207 abort ();
1208 }
1209 else
1210 {
1211 /* fprintf (stderr, "free %p...%p (%p)\n", m->start, m->end, ptr); */
1212 mem_delete (m);
1213 }
1214 }
1215 #endif /* GC_MALLOC_CHECK */
1216
1217 __free_hook = old_free_hook;
1218 free (ptr);
1219
1220 /* If we released our reserve (due to running out of memory),
1221 and we have a fair amount free once again,
1222 try to set aside another reserve in case we run out once more. */
1223 if (! NILP (Vmemory_full)
1224 /* Verify there is enough space that even with the malloc
1225 hysteresis this call won't run out again.
1226 The code here is correct as long as SPARE_MEMORY
1227 is substantially larger than the block size malloc uses. */
1228 && (bytes_used_when_full
1229 > ((bytes_used_when_reconsidered = BYTES_USED)
1230 + max (malloc_hysteresis, 4) * SPARE_MEMORY)))
1231 refill_memory_reserve ();
1232
1233 __free_hook = emacs_blocked_free;
1234 UNBLOCK_INPUT_ALLOC;
1235 }
1236
1237
1238 /* This function is the malloc hook that Emacs uses. */
1239
1240 static void *
1241 emacs_blocked_malloc (size, ptr)
1242 size_t size;
1243 const void *ptr;
1244 {
1245 void *value;
1246
1247 BLOCK_INPUT_ALLOC;
1248 __malloc_hook = old_malloc_hook;
1249 #ifdef DOUG_LEA_MALLOC
1250 /* Segfaults on my system. --lorentey */
1251 /* mallopt (M_TOP_PAD, malloc_hysteresis * 4096); */
1252 #else
1253 __malloc_extra_blocks = malloc_hysteresis;
1254 #endif
1255
1256 value = (void *) malloc (size);
1257
1258 #ifdef GC_MALLOC_CHECK
1259 {
1260 struct mem_node *m = mem_find (value);
1261 if (m != MEM_NIL)
1262 {
1263 fprintf (stderr, "Malloc returned %p which is already in use\n",
1264 value);
1265 fprintf (stderr, "Region in use is %p...%p, %u bytes, type %d\n",
1266 m->start, m->end, (char *) m->end - (char *) m->start,
1267 m->type);
1268 abort ();
1269 }
1270
1271 if (!dont_register_blocks)
1272 {
1273 mem_insert (value, (char *) value + max (1, size), allocated_mem_type);
1274 allocated_mem_type = MEM_TYPE_NON_LISP;
1275 }
1276 }
1277 #endif /* GC_MALLOC_CHECK */
1278
1279 __malloc_hook = emacs_blocked_malloc;
1280 UNBLOCK_INPUT_ALLOC;
1281
1282 /* fprintf (stderr, "%p malloc\n", value); */
1283 return value;
1284 }
1285
1286
1287 /* This function is the realloc hook that Emacs uses. */
1288
1289 static void *
1290 emacs_blocked_realloc (ptr, size, ptr2)
1291 void *ptr;
1292 size_t size;
1293 const void *ptr2;
1294 {
1295 void *value;
1296
1297 BLOCK_INPUT_ALLOC;
1298 __realloc_hook = old_realloc_hook;
1299
1300 #ifdef GC_MALLOC_CHECK
1301 if (ptr)
1302 {
1303 struct mem_node *m = mem_find (ptr);
1304 if (m == MEM_NIL || m->start != ptr)
1305 {
1306 fprintf (stderr,
1307 "Realloc of %p which wasn't allocated with malloc\n",
1308 ptr);
1309 abort ();
1310 }
1311
1312 mem_delete (m);
1313 }
1314
1315 /* fprintf (stderr, "%p -> realloc\n", ptr); */
1316
1317 /* Prevent malloc from registering blocks. */
1318 dont_register_blocks = 1;
1319 #endif /* GC_MALLOC_CHECK */
1320
1321 value = (void *) realloc (ptr, size);
1322
1323 #ifdef GC_MALLOC_CHECK
1324 dont_register_blocks = 0;
1325
1326 {
1327 struct mem_node *m = mem_find (value);
1328 if (m != MEM_NIL)
1329 {
1330 fprintf (stderr, "Realloc returns memory that is already in use\n");
1331 abort ();
1332 }
1333
1334 /* Can't handle zero size regions in the red-black tree. */
1335 mem_insert (value, (char *) value + max (size, 1), MEM_TYPE_NON_LISP);
1336 }
1337
1338 /* fprintf (stderr, "%p <- realloc\n", value); */
1339 #endif /* GC_MALLOC_CHECK */
1340
1341 __realloc_hook = emacs_blocked_realloc;
1342 UNBLOCK_INPUT_ALLOC;
1343
1344 return value;
1345 }
1346
1347
1348 #ifdef HAVE_GTK_AND_PTHREAD
1349 /* Called from Fdump_emacs so that when the dumped Emacs starts, it has a
1350 normal malloc. Some thread implementations need this as they call
1351 malloc before main. The pthread_self call in BLOCK_INPUT_ALLOC then
1352 calls malloc because it is the first call, and we have an endless loop. */
1353
1354 void
1355 reset_malloc_hooks ()
1356 {
1357 __free_hook = old_free_hook;
1358 __malloc_hook = old_malloc_hook;
1359 __realloc_hook = old_realloc_hook;
1360 }
1361 #endif /* HAVE_GTK_AND_PTHREAD */
1362
1363
1364 /* Called from main to set up malloc to use our hooks. */
1365
1366 void
1367 uninterrupt_malloc ()
1368 {
1369 #ifdef HAVE_GTK_AND_PTHREAD
1370 #ifdef DOUG_LEA_MALLOC
1371 pthread_mutexattr_t attr;
1372
1373 /* GLIBC has a faster way to do this, but lets keep it portable.
1374 This is according to the Single UNIX Specification. */
1375 pthread_mutexattr_init (&attr);
1376 pthread_mutexattr_settype (&attr, PTHREAD_MUTEX_RECURSIVE);
1377 pthread_mutex_init (&alloc_mutex, &attr);
1378 #else /* !DOUG_LEA_MALLOC */
1379 /* Some systems such as Solaris 2.6 doesn't have a recursive mutex,
1380 and the bundled gmalloc.c doesn't require it. */
1381 pthread_mutex_init (&alloc_mutex, NULL);
1382 #endif /* !DOUG_LEA_MALLOC */
1383 #endif /* HAVE_GTK_AND_PTHREAD */
1384
1385 if (__free_hook != emacs_blocked_free)
1386 old_free_hook = __free_hook;
1387 __free_hook = emacs_blocked_free;
1388
1389 if (__malloc_hook != emacs_blocked_malloc)
1390 old_malloc_hook = __malloc_hook;
1391 __malloc_hook = emacs_blocked_malloc;
1392
1393 if (__realloc_hook != emacs_blocked_realloc)
1394 old_realloc_hook = __realloc_hook;
1395 __realloc_hook = emacs_blocked_realloc;
1396 }
1397
1398 #endif /* not SYNC_INPUT */
1399 #endif /* not SYSTEM_MALLOC */
1400
1401
1402 \f
1403 /***********************************************************************
1404 Interval Allocation
1405 ***********************************************************************/
1406
1407 /* Number of intervals allocated in an interval_block structure.
1408 The 1020 is 1024 minus malloc overhead. */
1409
1410 #define INTERVAL_BLOCK_SIZE \
1411 ((1020 - sizeof (struct interval_block *)) / sizeof (struct interval))
1412
1413 /* Intervals are allocated in chunks in form of an interval_block
1414 structure. */
1415
1416 struct interval_block
1417 {
1418 /* Place `intervals' first, to preserve alignment. */
1419 struct interval intervals[INTERVAL_BLOCK_SIZE];
1420 struct interval_block *next;
1421 };
1422
1423 /* Current interval block. Its `next' pointer points to older
1424 blocks. */
1425
1426 static struct interval_block *interval_block;
1427
1428 /* Index in interval_block above of the next unused interval
1429 structure. */
1430
1431 static int interval_block_index;
1432
1433 /* Number of free and live intervals. */
1434
1435 static int total_free_intervals, total_intervals;
1436
1437 /* List of free intervals. */
1438
1439 INTERVAL interval_free_list;
1440
1441 /* Total number of interval blocks now in use. */
1442
1443 static int n_interval_blocks;
1444
1445
1446 /* Initialize interval allocation. */
1447
1448 static void
1449 init_intervals ()
1450 {
1451 interval_block = NULL;
1452 interval_block_index = INTERVAL_BLOCK_SIZE;
1453 interval_free_list = 0;
1454 n_interval_blocks = 0;
1455 }
1456
1457
1458 /* Return a new interval. */
1459
1460 INTERVAL
1461 make_interval ()
1462 {
1463 INTERVAL val;
1464
1465 /* eassert (!handling_signal); */
1466
1467 MALLOC_BLOCK_INPUT;
1468
1469 if (interval_free_list)
1470 {
1471 val = interval_free_list;
1472 interval_free_list = INTERVAL_PARENT (interval_free_list);
1473 }
1474 else
1475 {
1476 if (interval_block_index == INTERVAL_BLOCK_SIZE)
1477 {
1478 register struct interval_block *newi;
1479
1480 newi = (struct interval_block *) lisp_malloc (sizeof *newi,
1481 MEM_TYPE_NON_LISP);
1482
1483 newi->next = interval_block;
1484 interval_block = newi;
1485 interval_block_index = 0;
1486 n_interval_blocks++;
1487 }
1488 val = &interval_block->intervals[interval_block_index++];
1489 }
1490
1491 MALLOC_UNBLOCK_INPUT;
1492
1493 consing_since_gc += sizeof (struct interval);
1494 intervals_consed++;
1495 RESET_INTERVAL (val);
1496 val->gcmarkbit = 0;
1497 return val;
1498 }
1499
1500
1501 /* Mark Lisp objects in interval I. */
1502
1503 static void
1504 mark_interval (i, dummy)
1505 register INTERVAL i;
1506 Lisp_Object dummy;
1507 {
1508 eassert (!i->gcmarkbit); /* Intervals are never shared. */
1509 i->gcmarkbit = 1;
1510 mark_object (i->plist);
1511 }
1512
1513
1514 /* Mark the interval tree rooted in TREE. Don't call this directly;
1515 use the macro MARK_INTERVAL_TREE instead. */
1516
1517 static void
1518 mark_interval_tree (tree)
1519 register INTERVAL tree;
1520 {
1521 /* No need to test if this tree has been marked already; this
1522 function is always called through the MARK_INTERVAL_TREE macro,
1523 which takes care of that. */
1524
1525 traverse_intervals_noorder (tree, mark_interval, Qnil);
1526 }
1527
1528
1529 /* Mark the interval tree rooted in I. */
1530
1531 #define MARK_INTERVAL_TREE(i) \
1532 do { \
1533 if (!NULL_INTERVAL_P (i) && !i->gcmarkbit) \
1534 mark_interval_tree (i); \
1535 } while (0)
1536
1537
1538 #define UNMARK_BALANCE_INTERVALS(i) \
1539 do { \
1540 if (! NULL_INTERVAL_P (i)) \
1541 (i) = balance_intervals (i); \
1542 } while (0)
1543
1544 \f
1545 /* Number support. If USE_LISP_UNION_TYPE is in effect, we
1546 can't create number objects in macros. */
1547 #ifndef make_number
1548 Lisp_Object
1549 make_number (n)
1550 EMACS_INT n;
1551 {
1552 Lisp_Object obj;
1553 obj.s.val = n;
1554 obj.s.type = Lisp_Int;
1555 return obj;
1556 }
1557 #endif
1558 \f
1559 /***********************************************************************
1560 String Allocation
1561 ***********************************************************************/
1562
1563 /* Lisp_Strings are allocated in string_block structures. When a new
1564 string_block is allocated, all the Lisp_Strings it contains are
1565 added to a free-list string_free_list. When a new Lisp_String is
1566 needed, it is taken from that list. During the sweep phase of GC,
1567 string_blocks that are entirely free are freed, except two which
1568 we keep.
1569
1570 String data is allocated from sblock structures. Strings larger
1571 than LARGE_STRING_BYTES, get their own sblock, data for smaller
1572 strings is sub-allocated out of sblocks of size SBLOCK_SIZE.
1573
1574 Sblocks consist internally of sdata structures, one for each
1575 Lisp_String. The sdata structure points to the Lisp_String it
1576 belongs to. The Lisp_String points back to the `u.data' member of
1577 its sdata structure.
1578
1579 When a Lisp_String is freed during GC, it is put back on
1580 string_free_list, and its `data' member and its sdata's `string'
1581 pointer is set to null. The size of the string is recorded in the
1582 `u.nbytes' member of the sdata. So, sdata structures that are no
1583 longer used, can be easily recognized, and it's easy to compact the
1584 sblocks of small strings which we do in compact_small_strings. */
1585
1586 /* Size in bytes of an sblock structure used for small strings. This
1587 is 8192 minus malloc overhead. */
1588
1589 #define SBLOCK_SIZE 8188
1590
1591 /* Strings larger than this are considered large strings. String data
1592 for large strings is allocated from individual sblocks. */
1593
1594 #define LARGE_STRING_BYTES 1024
1595
1596 /* Structure describing string memory sub-allocated from an sblock.
1597 This is where the contents of Lisp strings are stored. */
1598
1599 struct sdata
1600 {
1601 /* Back-pointer to the string this sdata belongs to. If null, this
1602 structure is free, and the NBYTES member of the union below
1603 contains the string's byte size (the same value that STRING_BYTES
1604 would return if STRING were non-null). If non-null, STRING_BYTES
1605 (STRING) is the size of the data, and DATA contains the string's
1606 contents. */
1607 struct Lisp_String *string;
1608
1609 #ifdef GC_CHECK_STRING_BYTES
1610
1611 EMACS_INT nbytes;
1612 unsigned char data[1];
1613
1614 #define SDATA_NBYTES(S) (S)->nbytes
1615 #define SDATA_DATA(S) (S)->data
1616
1617 #else /* not GC_CHECK_STRING_BYTES */
1618
1619 union
1620 {
1621 /* When STRING in non-null. */
1622 unsigned char data[1];
1623
1624 /* When STRING is null. */
1625 EMACS_INT nbytes;
1626 } u;
1627
1628
1629 #define SDATA_NBYTES(S) (S)->u.nbytes
1630 #define SDATA_DATA(S) (S)->u.data
1631
1632 #endif /* not GC_CHECK_STRING_BYTES */
1633 };
1634
1635
1636 /* Structure describing a block of memory which is sub-allocated to
1637 obtain string data memory for strings. Blocks for small strings
1638 are of fixed size SBLOCK_SIZE. Blocks for large strings are made
1639 as large as needed. */
1640
1641 struct sblock
1642 {
1643 /* Next in list. */
1644 struct sblock *next;
1645
1646 /* Pointer to the next free sdata block. This points past the end
1647 of the sblock if there isn't any space left in this block. */
1648 struct sdata *next_free;
1649
1650 /* Start of data. */
1651 struct sdata first_data;
1652 };
1653
1654 /* Number of Lisp strings in a string_block structure. The 1020 is
1655 1024 minus malloc overhead. */
1656
1657 #define STRING_BLOCK_SIZE \
1658 ((1020 - sizeof (struct string_block *)) / sizeof (struct Lisp_String))
1659
1660 /* Structure describing a block from which Lisp_String structures
1661 are allocated. */
1662
1663 struct string_block
1664 {
1665 /* Place `strings' first, to preserve alignment. */
1666 struct Lisp_String strings[STRING_BLOCK_SIZE];
1667 struct string_block *next;
1668 };
1669
1670 /* Head and tail of the list of sblock structures holding Lisp string
1671 data. We always allocate from current_sblock. The NEXT pointers
1672 in the sblock structures go from oldest_sblock to current_sblock. */
1673
1674 static struct sblock *oldest_sblock, *current_sblock;
1675
1676 /* List of sblocks for large strings. */
1677
1678 static struct sblock *large_sblocks;
1679
1680 /* List of string_block structures, and how many there are. */
1681
1682 static struct string_block *string_blocks;
1683 static int n_string_blocks;
1684
1685 /* Free-list of Lisp_Strings. */
1686
1687 static struct Lisp_String *string_free_list;
1688
1689 /* Number of live and free Lisp_Strings. */
1690
1691 static int total_strings, total_free_strings;
1692
1693 /* Number of bytes used by live strings. */
1694
1695 static int total_string_size;
1696
1697 /* Given a pointer to a Lisp_String S which is on the free-list
1698 string_free_list, return a pointer to its successor in the
1699 free-list. */
1700
1701 #define NEXT_FREE_LISP_STRING(S) (*(struct Lisp_String **) (S))
1702
1703 /* Return a pointer to the sdata structure belonging to Lisp string S.
1704 S must be live, i.e. S->data must not be null. S->data is actually
1705 a pointer to the `u.data' member of its sdata structure; the
1706 structure starts at a constant offset in front of that. */
1707
1708 #ifdef GC_CHECK_STRING_BYTES
1709
1710 #define SDATA_OF_STRING(S) \
1711 ((struct sdata *) ((S)->data - sizeof (struct Lisp_String *) \
1712 - sizeof (EMACS_INT)))
1713
1714 #else /* not GC_CHECK_STRING_BYTES */
1715
1716 #define SDATA_OF_STRING(S) \
1717 ((struct sdata *) ((S)->data - sizeof (struct Lisp_String *)))
1718
1719 #endif /* not GC_CHECK_STRING_BYTES */
1720
1721
1722 #ifdef GC_CHECK_STRING_OVERRUN
1723
1724 /* We check for overrun in string data blocks by appending a small
1725 "cookie" after each allocated string data block, and check for the
1726 presence of this cookie during GC. */
1727
1728 #define GC_STRING_OVERRUN_COOKIE_SIZE 4
1729 static char string_overrun_cookie[GC_STRING_OVERRUN_COOKIE_SIZE] =
1730 { 0xde, 0xad, 0xbe, 0xef };
1731
1732 #else
1733 #define GC_STRING_OVERRUN_COOKIE_SIZE 0
1734 #endif
1735
1736 /* Value is the size of an sdata structure large enough to hold NBYTES
1737 bytes of string data. The value returned includes a terminating
1738 NUL byte, the size of the sdata structure, and padding. */
1739
1740 #ifdef GC_CHECK_STRING_BYTES
1741
1742 #define SDATA_SIZE(NBYTES) \
1743 ((sizeof (struct Lisp_String *) \
1744 + (NBYTES) + 1 \
1745 + sizeof (EMACS_INT) \
1746 + sizeof (EMACS_INT) - 1) \
1747 & ~(sizeof (EMACS_INT) - 1))
1748
1749 #else /* not GC_CHECK_STRING_BYTES */
1750
1751 #define SDATA_SIZE(NBYTES) \
1752 ((sizeof (struct Lisp_String *) \
1753 + (NBYTES) + 1 \
1754 + sizeof (EMACS_INT) - 1) \
1755 & ~(sizeof (EMACS_INT) - 1))
1756
1757 #endif /* not GC_CHECK_STRING_BYTES */
1758
1759 /* Extra bytes to allocate for each string. */
1760
1761 #define GC_STRING_EXTRA (GC_STRING_OVERRUN_COOKIE_SIZE)
1762
1763 /* Initialize string allocation. Called from init_alloc_once. */
1764
1765 static void
1766 init_strings ()
1767 {
1768 total_strings = total_free_strings = total_string_size = 0;
1769 oldest_sblock = current_sblock = large_sblocks = NULL;
1770 string_blocks = NULL;
1771 n_string_blocks = 0;
1772 string_free_list = NULL;
1773 empty_unibyte_string = make_pure_string ("", 0, 0, 0);
1774 empty_multibyte_string = make_pure_string ("", 0, 0, 1);
1775 }
1776
1777
1778 #ifdef GC_CHECK_STRING_BYTES
1779
1780 static int check_string_bytes_count;
1781
1782 static void check_string_bytes P_ ((int));
1783 static void check_sblock P_ ((struct sblock *));
1784
1785 #define CHECK_STRING_BYTES(S) STRING_BYTES (S)
1786
1787
1788 /* Like GC_STRING_BYTES, but with debugging check. */
1789
1790 int
1791 string_bytes (s)
1792 struct Lisp_String *s;
1793 {
1794 int nbytes = (s->size_byte < 0 ? s->size & ~ARRAY_MARK_FLAG : s->size_byte);
1795 if (!PURE_POINTER_P (s)
1796 && s->data
1797 && nbytes != SDATA_NBYTES (SDATA_OF_STRING (s)))
1798 abort ();
1799 return nbytes;
1800 }
1801
1802 /* Check validity of Lisp strings' string_bytes member in B. */
1803
1804 static void
1805 check_sblock (b)
1806 struct sblock *b;
1807 {
1808 struct sdata *from, *end, *from_end;
1809
1810 end = b->next_free;
1811
1812 for (from = &b->first_data; from < end; from = from_end)
1813 {
1814 /* Compute the next FROM here because copying below may
1815 overwrite data we need to compute it. */
1816 int nbytes;
1817
1818 /* Check that the string size recorded in the string is the
1819 same as the one recorded in the sdata structure. */
1820 if (from->string)
1821 CHECK_STRING_BYTES (from->string);
1822
1823 if (from->string)
1824 nbytes = GC_STRING_BYTES (from->string);
1825 else
1826 nbytes = SDATA_NBYTES (from);
1827
1828 nbytes = SDATA_SIZE (nbytes);
1829 from_end = (struct sdata *) ((char *) from + nbytes + GC_STRING_EXTRA);
1830 }
1831 }
1832
1833
1834 /* Check validity of Lisp strings' string_bytes member. ALL_P
1835 non-zero means check all strings, otherwise check only most
1836 recently allocated strings. Used for hunting a bug. */
1837
1838 static void
1839 check_string_bytes (all_p)
1840 int all_p;
1841 {
1842 if (all_p)
1843 {
1844 struct sblock *b;
1845
1846 for (b = large_sblocks; b; b = b->next)
1847 {
1848 struct Lisp_String *s = b->first_data.string;
1849 if (s)
1850 CHECK_STRING_BYTES (s);
1851 }
1852
1853 for (b = oldest_sblock; b; b = b->next)
1854 check_sblock (b);
1855 }
1856 else
1857 check_sblock (current_sblock);
1858 }
1859
1860 #endif /* GC_CHECK_STRING_BYTES */
1861
1862 #ifdef GC_CHECK_STRING_FREE_LIST
1863
1864 /* Walk through the string free list looking for bogus next pointers.
1865 This may catch buffer overrun from a previous string. */
1866
1867 static void
1868 check_string_free_list ()
1869 {
1870 struct Lisp_String *s;
1871
1872 /* Pop a Lisp_String off the free-list. */
1873 s = string_free_list;
1874 while (s != NULL)
1875 {
1876 if ((unsigned)s < 1024)
1877 abort();
1878 s = NEXT_FREE_LISP_STRING (s);
1879 }
1880 }
1881 #else
1882 #define check_string_free_list()
1883 #endif
1884
1885 /* Return a new Lisp_String. */
1886
1887 static struct Lisp_String *
1888 allocate_string ()
1889 {
1890 struct Lisp_String *s;
1891
1892 /* eassert (!handling_signal); */
1893
1894 MALLOC_BLOCK_INPUT;
1895
1896 /* If the free-list is empty, allocate a new string_block, and
1897 add all the Lisp_Strings in it to the free-list. */
1898 if (string_free_list == NULL)
1899 {
1900 struct string_block *b;
1901 int i;
1902
1903 b = (struct string_block *) lisp_malloc (sizeof *b, MEM_TYPE_STRING);
1904 bzero (b, sizeof *b);
1905 b->next = string_blocks;
1906 string_blocks = b;
1907 ++n_string_blocks;
1908
1909 for (i = STRING_BLOCK_SIZE - 1; i >= 0; --i)
1910 {
1911 s = b->strings + i;
1912 NEXT_FREE_LISP_STRING (s) = string_free_list;
1913 string_free_list = s;
1914 }
1915
1916 total_free_strings += STRING_BLOCK_SIZE;
1917 }
1918
1919 check_string_free_list ();
1920
1921 /* Pop a Lisp_String off the free-list. */
1922 s = string_free_list;
1923 string_free_list = NEXT_FREE_LISP_STRING (s);
1924
1925 MALLOC_UNBLOCK_INPUT;
1926
1927 /* Probably not strictly necessary, but play it safe. */
1928 bzero (s, sizeof *s);
1929
1930 --total_free_strings;
1931 ++total_strings;
1932 ++strings_consed;
1933 consing_since_gc += sizeof *s;
1934
1935 #ifdef GC_CHECK_STRING_BYTES
1936 if (!noninteractive)
1937 {
1938 if (++check_string_bytes_count == 200)
1939 {
1940 check_string_bytes_count = 0;
1941 check_string_bytes (1);
1942 }
1943 else
1944 check_string_bytes (0);
1945 }
1946 #endif /* GC_CHECK_STRING_BYTES */
1947
1948 return s;
1949 }
1950
1951
1952 /* Set up Lisp_String S for holding NCHARS characters, NBYTES bytes,
1953 plus a NUL byte at the end. Allocate an sdata structure for S, and
1954 set S->data to its `u.data' member. Store a NUL byte at the end of
1955 S->data. Set S->size to NCHARS and S->size_byte to NBYTES. Free
1956 S->data if it was initially non-null. */
1957
1958 void
1959 allocate_string_data (s, nchars, nbytes)
1960 struct Lisp_String *s;
1961 int nchars, nbytes;
1962 {
1963 struct sdata *data, *old_data;
1964 struct sblock *b;
1965 int needed, old_nbytes;
1966
1967 /* Determine the number of bytes needed to store NBYTES bytes
1968 of string data. */
1969 needed = SDATA_SIZE (nbytes);
1970 old_data = s->data ? SDATA_OF_STRING (s) : NULL;
1971 old_nbytes = GC_STRING_BYTES (s);
1972
1973 MALLOC_BLOCK_INPUT;
1974
1975 if (nbytes > LARGE_STRING_BYTES)
1976 {
1977 size_t size = sizeof *b - sizeof (struct sdata) + needed;
1978
1979 #ifdef DOUG_LEA_MALLOC
1980 /* Prevent mmap'ing the chunk. Lisp data may not be mmap'ed
1981 because mapped region contents are not preserved in
1982 a dumped Emacs.
1983
1984 In case you think of allowing it in a dumped Emacs at the
1985 cost of not being able to re-dump, there's another reason:
1986 mmap'ed data typically have an address towards the top of the
1987 address space, which won't fit into an EMACS_INT (at least on
1988 32-bit systems with the current tagging scheme). --fx */
1989 mallopt (M_MMAP_MAX, 0);
1990 #endif
1991
1992 b = (struct sblock *) lisp_malloc (size + GC_STRING_EXTRA, MEM_TYPE_NON_LISP);
1993
1994 #ifdef DOUG_LEA_MALLOC
1995 /* Back to a reasonable maximum of mmap'ed areas. */
1996 mallopt (M_MMAP_MAX, MMAP_MAX_AREAS);
1997 #endif
1998
1999 b->next_free = &b->first_data;
2000 b->first_data.string = NULL;
2001 b->next = large_sblocks;
2002 large_sblocks = b;
2003 }
2004 else if (current_sblock == NULL
2005 || (((char *) current_sblock + SBLOCK_SIZE
2006 - (char *) current_sblock->next_free)
2007 < (needed + GC_STRING_EXTRA)))
2008 {
2009 /* Not enough room in the current sblock. */
2010 b = (struct sblock *) lisp_malloc (SBLOCK_SIZE, MEM_TYPE_NON_LISP);
2011 b->next_free = &b->first_data;
2012 b->first_data.string = NULL;
2013 b->next = NULL;
2014
2015 if (current_sblock)
2016 current_sblock->next = b;
2017 else
2018 oldest_sblock = b;
2019 current_sblock = b;
2020 }
2021 else
2022 b = current_sblock;
2023
2024 data = b->next_free;
2025 b->next_free = (struct sdata *) ((char *) data + needed + GC_STRING_EXTRA);
2026
2027 MALLOC_UNBLOCK_INPUT;
2028
2029 data->string = s;
2030 s->data = SDATA_DATA (data);
2031 #ifdef GC_CHECK_STRING_BYTES
2032 SDATA_NBYTES (data) = nbytes;
2033 #endif
2034 s->size = nchars;
2035 s->size_byte = nbytes;
2036 s->data[nbytes] = '\0';
2037 #ifdef GC_CHECK_STRING_OVERRUN
2038 bcopy (string_overrun_cookie, (char *) data + needed,
2039 GC_STRING_OVERRUN_COOKIE_SIZE);
2040 #endif
2041
2042 /* If S had already data assigned, mark that as free by setting its
2043 string back-pointer to null, and recording the size of the data
2044 in it. */
2045 if (old_data)
2046 {
2047 SDATA_NBYTES (old_data) = old_nbytes;
2048 old_data->string = NULL;
2049 }
2050
2051 consing_since_gc += needed;
2052 }
2053
2054
2055 /* Sweep and compact strings. */
2056
2057 static void
2058 sweep_strings ()
2059 {
2060 struct string_block *b, *next;
2061 struct string_block *live_blocks = NULL;
2062
2063 string_free_list = NULL;
2064 total_strings = total_free_strings = 0;
2065 total_string_size = 0;
2066
2067 /* Scan strings_blocks, free Lisp_Strings that aren't marked. */
2068 for (b = string_blocks; b; b = next)
2069 {
2070 int i, nfree = 0;
2071 struct Lisp_String *free_list_before = string_free_list;
2072
2073 next = b->next;
2074
2075 for (i = 0; i < STRING_BLOCK_SIZE; ++i)
2076 {
2077 struct Lisp_String *s = b->strings + i;
2078
2079 if (s->data)
2080 {
2081 /* String was not on free-list before. */
2082 if (STRING_MARKED_P (s))
2083 {
2084 /* String is live; unmark it and its intervals. */
2085 UNMARK_STRING (s);
2086
2087 if (!NULL_INTERVAL_P (s->intervals))
2088 UNMARK_BALANCE_INTERVALS (s->intervals);
2089
2090 ++total_strings;
2091 total_string_size += STRING_BYTES (s);
2092 }
2093 else
2094 {
2095 /* String is dead. Put it on the free-list. */
2096 struct sdata *data = SDATA_OF_STRING (s);
2097
2098 /* Save the size of S in its sdata so that we know
2099 how large that is. Reset the sdata's string
2100 back-pointer so that we know it's free. */
2101 #ifdef GC_CHECK_STRING_BYTES
2102 if (GC_STRING_BYTES (s) != SDATA_NBYTES (data))
2103 abort ();
2104 #else
2105 data->u.nbytes = GC_STRING_BYTES (s);
2106 #endif
2107 data->string = NULL;
2108
2109 /* Reset the strings's `data' member so that we
2110 know it's free. */
2111 s->data = NULL;
2112
2113 /* Put the string on the free-list. */
2114 NEXT_FREE_LISP_STRING (s) = string_free_list;
2115 string_free_list = s;
2116 ++nfree;
2117 }
2118 }
2119 else
2120 {
2121 /* S was on the free-list before. Put it there again. */
2122 NEXT_FREE_LISP_STRING (s) = string_free_list;
2123 string_free_list = s;
2124 ++nfree;
2125 }
2126 }
2127
2128 /* Free blocks that contain free Lisp_Strings only, except
2129 the first two of them. */
2130 if (nfree == STRING_BLOCK_SIZE
2131 && total_free_strings > STRING_BLOCK_SIZE)
2132 {
2133 lisp_free (b);
2134 --n_string_blocks;
2135 string_free_list = free_list_before;
2136 }
2137 else
2138 {
2139 total_free_strings += nfree;
2140 b->next = live_blocks;
2141 live_blocks = b;
2142 }
2143 }
2144
2145 check_string_free_list ();
2146
2147 string_blocks = live_blocks;
2148 free_large_strings ();
2149 compact_small_strings ();
2150
2151 check_string_free_list ();
2152 }
2153
2154
2155 /* Free dead large strings. */
2156
2157 static void
2158 free_large_strings ()
2159 {
2160 struct sblock *b, *next;
2161 struct sblock *live_blocks = NULL;
2162
2163 for (b = large_sblocks; b; b = next)
2164 {
2165 next = b->next;
2166
2167 if (b->first_data.string == NULL)
2168 lisp_free (b);
2169 else
2170 {
2171 b->next = live_blocks;
2172 live_blocks = b;
2173 }
2174 }
2175
2176 large_sblocks = live_blocks;
2177 }
2178
2179
2180 /* Compact data of small strings. Free sblocks that don't contain
2181 data of live strings after compaction. */
2182
2183 static void
2184 compact_small_strings ()
2185 {
2186 struct sblock *b, *tb, *next;
2187 struct sdata *from, *to, *end, *tb_end;
2188 struct sdata *to_end, *from_end;
2189
2190 /* TB is the sblock we copy to, TO is the sdata within TB we copy
2191 to, and TB_END is the end of TB. */
2192 tb = oldest_sblock;
2193 tb_end = (struct sdata *) ((char *) tb + SBLOCK_SIZE);
2194 to = &tb->first_data;
2195
2196 /* Step through the blocks from the oldest to the youngest. We
2197 expect that old blocks will stabilize over time, so that less
2198 copying will happen this way. */
2199 for (b = oldest_sblock; b; b = b->next)
2200 {
2201 end = b->next_free;
2202 xassert ((char *) end <= (char *) b + SBLOCK_SIZE);
2203
2204 for (from = &b->first_data; from < end; from = from_end)
2205 {
2206 /* Compute the next FROM here because copying below may
2207 overwrite data we need to compute it. */
2208 int nbytes;
2209
2210 #ifdef GC_CHECK_STRING_BYTES
2211 /* Check that the string size recorded in the string is the
2212 same as the one recorded in the sdata structure. */
2213 if (from->string
2214 && GC_STRING_BYTES (from->string) != SDATA_NBYTES (from))
2215 abort ();
2216 #endif /* GC_CHECK_STRING_BYTES */
2217
2218 if (from->string)
2219 nbytes = GC_STRING_BYTES (from->string);
2220 else
2221 nbytes = SDATA_NBYTES (from);
2222
2223 if (nbytes > LARGE_STRING_BYTES)
2224 abort ();
2225
2226 nbytes = SDATA_SIZE (nbytes);
2227 from_end = (struct sdata *) ((char *) from + nbytes + GC_STRING_EXTRA);
2228
2229 #ifdef GC_CHECK_STRING_OVERRUN
2230 if (bcmp (string_overrun_cookie,
2231 ((char *) from_end) - GC_STRING_OVERRUN_COOKIE_SIZE,
2232 GC_STRING_OVERRUN_COOKIE_SIZE))
2233 abort ();
2234 #endif
2235
2236 /* FROM->string non-null means it's alive. Copy its data. */
2237 if (from->string)
2238 {
2239 /* If TB is full, proceed with the next sblock. */
2240 to_end = (struct sdata *) ((char *) to + nbytes + GC_STRING_EXTRA);
2241 if (to_end > tb_end)
2242 {
2243 tb->next_free = to;
2244 tb = tb->next;
2245 tb_end = (struct sdata *) ((char *) tb + SBLOCK_SIZE);
2246 to = &tb->first_data;
2247 to_end = (struct sdata *) ((char *) to + nbytes + GC_STRING_EXTRA);
2248 }
2249
2250 /* Copy, and update the string's `data' pointer. */
2251 if (from != to)
2252 {
2253 xassert (tb != b || to <= from);
2254 safe_bcopy ((char *) from, (char *) to, nbytes + GC_STRING_EXTRA);
2255 to->string->data = SDATA_DATA (to);
2256 }
2257
2258 /* Advance past the sdata we copied to. */
2259 to = to_end;
2260 }
2261 }
2262 }
2263
2264 /* The rest of the sblocks following TB don't contain live data, so
2265 we can free them. */
2266 for (b = tb->next; b; b = next)
2267 {
2268 next = b->next;
2269 lisp_free (b);
2270 }
2271
2272 tb->next_free = to;
2273 tb->next = NULL;
2274 current_sblock = tb;
2275 }
2276
2277
2278 DEFUN ("make-string", Fmake_string, Smake_string, 2, 2, 0,
2279 doc: /* Return a newly created string of length LENGTH, with INIT in each element.
2280 LENGTH must be an integer.
2281 INIT must be an integer that represents a character. */)
2282 (length, init)
2283 Lisp_Object length, init;
2284 {
2285 register Lisp_Object val;
2286 register unsigned char *p, *end;
2287 int c, nbytes;
2288
2289 CHECK_NATNUM (length);
2290 CHECK_NUMBER (init);
2291
2292 c = XINT (init);
2293 if (ASCII_CHAR_P (c))
2294 {
2295 nbytes = XINT (length);
2296 val = make_uninit_string (nbytes);
2297 p = SDATA (val);
2298 end = p + SCHARS (val);
2299 while (p != end)
2300 *p++ = c;
2301 }
2302 else
2303 {
2304 unsigned char str[MAX_MULTIBYTE_LENGTH];
2305 int len = CHAR_STRING (c, str);
2306
2307 nbytes = len * XINT (length);
2308 val = make_uninit_multibyte_string (XINT (length), nbytes);
2309 p = SDATA (val);
2310 end = p + nbytes;
2311 while (p != end)
2312 {
2313 bcopy (str, p, len);
2314 p += len;
2315 }
2316 }
2317
2318 *p = 0;
2319 return val;
2320 }
2321
2322
2323 DEFUN ("make-bool-vector", Fmake_bool_vector, Smake_bool_vector, 2, 2, 0,
2324 doc: /* Return a new bool-vector of length LENGTH, using INIT for each element.
2325 LENGTH must be a number. INIT matters only in whether it is t or nil. */)
2326 (length, init)
2327 Lisp_Object length, init;
2328 {
2329 register Lisp_Object val;
2330 struct Lisp_Bool_Vector *p;
2331 int real_init, i;
2332 int length_in_chars, length_in_elts, bits_per_value;
2333
2334 CHECK_NATNUM (length);
2335
2336 bits_per_value = sizeof (EMACS_INT) * BOOL_VECTOR_BITS_PER_CHAR;
2337
2338 length_in_elts = (XFASTINT (length) + bits_per_value - 1) / bits_per_value;
2339 length_in_chars = ((XFASTINT (length) + BOOL_VECTOR_BITS_PER_CHAR - 1)
2340 / BOOL_VECTOR_BITS_PER_CHAR);
2341
2342 /* We must allocate one more elements than LENGTH_IN_ELTS for the
2343 slot `size' of the struct Lisp_Bool_Vector. */
2344 val = Fmake_vector (make_number (length_in_elts + 1), Qnil);
2345
2346 /* Get rid of any bits that would cause confusion. */
2347 XVECTOR (val)->size = 0; /* No Lisp_Object to trace in there. */
2348 /* Use XVECTOR (val) rather than `p' because p->size is not TRT. */
2349 XSETPVECTYPE (XVECTOR (val), PVEC_BOOL_VECTOR);
2350
2351 p = XBOOL_VECTOR (val);
2352 p->size = XFASTINT (length);
2353
2354 real_init = (NILP (init) ? 0 : -1);
2355 for (i = 0; i < length_in_chars ; i++)
2356 p->data[i] = real_init;
2357
2358 /* Clear the extraneous bits in the last byte. */
2359 if (XINT (length) != length_in_chars * BOOL_VECTOR_BITS_PER_CHAR)
2360 p->data[length_in_chars - 1]
2361 &= (1 << (XINT (length) % BOOL_VECTOR_BITS_PER_CHAR)) - 1;
2362
2363 return val;
2364 }
2365
2366
2367 /* Make a string from NBYTES bytes at CONTENTS, and compute the number
2368 of characters from the contents. This string may be unibyte or
2369 multibyte, depending on the contents. */
2370
2371 Lisp_Object
2372 make_string (contents, nbytes)
2373 const char *contents;
2374 int nbytes;
2375 {
2376 register Lisp_Object val;
2377 int nchars, multibyte_nbytes;
2378
2379 parse_str_as_multibyte (contents, nbytes, &nchars, &multibyte_nbytes);
2380 if (nbytes == nchars || nbytes != multibyte_nbytes)
2381 /* CONTENTS contains no multibyte sequences or contains an invalid
2382 multibyte sequence. We must make unibyte string. */
2383 val = make_unibyte_string (contents, nbytes);
2384 else
2385 val = make_multibyte_string (contents, nchars, nbytes);
2386 return val;
2387 }
2388
2389
2390 /* Make an unibyte string from LENGTH bytes at CONTENTS. */
2391
2392 Lisp_Object
2393 make_unibyte_string (contents, length)
2394 const char *contents;
2395 int length;
2396 {
2397 register Lisp_Object val;
2398 val = make_uninit_string (length);
2399 bcopy (contents, SDATA (val), length);
2400 STRING_SET_UNIBYTE (val);
2401 return val;
2402 }
2403
2404
2405 /* Make a multibyte string from NCHARS characters occupying NBYTES
2406 bytes at CONTENTS. */
2407
2408 Lisp_Object
2409 make_multibyte_string (contents, nchars, nbytes)
2410 const char *contents;
2411 int nchars, nbytes;
2412 {
2413 register Lisp_Object val;
2414 val = make_uninit_multibyte_string (nchars, nbytes);
2415 bcopy (contents, SDATA (val), nbytes);
2416 return val;
2417 }
2418
2419
2420 /* Make a string from NCHARS characters occupying NBYTES bytes at
2421 CONTENTS. It is a multibyte string if NBYTES != NCHARS. */
2422
2423 Lisp_Object
2424 make_string_from_bytes (contents, nchars, nbytes)
2425 const char *contents;
2426 int nchars, nbytes;
2427 {
2428 register Lisp_Object val;
2429 val = make_uninit_multibyte_string (nchars, nbytes);
2430 bcopy (contents, SDATA (val), nbytes);
2431 if (SBYTES (val) == SCHARS (val))
2432 STRING_SET_UNIBYTE (val);
2433 return val;
2434 }
2435
2436
2437 /* Make a string from NCHARS characters occupying NBYTES bytes at
2438 CONTENTS. The argument MULTIBYTE controls whether to label the
2439 string as multibyte. If NCHARS is negative, it counts the number of
2440 characters by itself. */
2441
2442 Lisp_Object
2443 make_specified_string (contents, nchars, nbytes, multibyte)
2444 const char *contents;
2445 int nchars, nbytes;
2446 int multibyte;
2447 {
2448 register Lisp_Object val;
2449
2450 if (nchars < 0)
2451 {
2452 if (multibyte)
2453 nchars = multibyte_chars_in_text (contents, nbytes);
2454 else
2455 nchars = nbytes;
2456 }
2457 val = make_uninit_multibyte_string (nchars, nbytes);
2458 bcopy (contents, SDATA (val), nbytes);
2459 if (!multibyte)
2460 STRING_SET_UNIBYTE (val);
2461 return val;
2462 }
2463
2464
2465 /* Make a string from the data at STR, treating it as multibyte if the
2466 data warrants. */
2467
2468 Lisp_Object
2469 build_string (str)
2470 const char *str;
2471 {
2472 return make_string (str, strlen (str));
2473 }
2474
2475
2476 /* Return an unibyte Lisp_String set up to hold LENGTH characters
2477 occupying LENGTH bytes. */
2478
2479 Lisp_Object
2480 make_uninit_string (length)
2481 int length;
2482 {
2483 Lisp_Object val;
2484
2485 if (!length)
2486 return empty_unibyte_string;
2487 val = make_uninit_multibyte_string (length, length);
2488 STRING_SET_UNIBYTE (val);
2489 return val;
2490 }
2491
2492
2493 /* Return a multibyte Lisp_String set up to hold NCHARS characters
2494 which occupy NBYTES bytes. */
2495
2496 Lisp_Object
2497 make_uninit_multibyte_string (nchars, nbytes)
2498 int nchars, nbytes;
2499 {
2500 Lisp_Object string;
2501 struct Lisp_String *s;
2502
2503 if (nchars < 0)
2504 abort ();
2505 if (!nbytes)
2506 return empty_multibyte_string;
2507
2508 s = allocate_string ();
2509 allocate_string_data (s, nchars, nbytes);
2510 XSETSTRING (string, s);
2511 string_chars_consed += nbytes;
2512 return string;
2513 }
2514
2515
2516 \f
2517 /***********************************************************************
2518 Float Allocation
2519 ***********************************************************************/
2520
2521 /* We store float cells inside of float_blocks, allocating a new
2522 float_block with malloc whenever necessary. Float cells reclaimed
2523 by GC are put on a free list to be reallocated before allocating
2524 any new float cells from the latest float_block. */
2525
2526 #define FLOAT_BLOCK_SIZE \
2527 (((BLOCK_BYTES - sizeof (struct float_block *) \
2528 /* The compiler might add padding at the end. */ \
2529 - (sizeof (struct Lisp_Float) - sizeof (int))) * CHAR_BIT) \
2530 / (sizeof (struct Lisp_Float) * CHAR_BIT + 1))
2531
2532 #define GETMARKBIT(block,n) \
2533 (((block)->gcmarkbits[(n) / (sizeof(int) * CHAR_BIT)] \
2534 >> ((n) % (sizeof(int) * CHAR_BIT))) \
2535 & 1)
2536
2537 #define SETMARKBIT(block,n) \
2538 (block)->gcmarkbits[(n) / (sizeof(int) * CHAR_BIT)] \
2539 |= 1 << ((n) % (sizeof(int) * CHAR_BIT))
2540
2541 #define UNSETMARKBIT(block,n) \
2542 (block)->gcmarkbits[(n) / (sizeof(int) * CHAR_BIT)] \
2543 &= ~(1 << ((n) % (sizeof(int) * CHAR_BIT)))
2544
2545 #define FLOAT_BLOCK(fptr) \
2546 ((struct float_block *)(((EMACS_UINT)(fptr)) & ~(BLOCK_ALIGN - 1)))
2547
2548 #define FLOAT_INDEX(fptr) \
2549 ((((EMACS_UINT)(fptr)) & (BLOCK_ALIGN - 1)) / sizeof (struct Lisp_Float))
2550
2551 struct float_block
2552 {
2553 /* Place `floats' at the beginning, to ease up FLOAT_INDEX's job. */
2554 struct Lisp_Float floats[FLOAT_BLOCK_SIZE];
2555 int gcmarkbits[1 + FLOAT_BLOCK_SIZE / (sizeof(int) * CHAR_BIT)];
2556 struct float_block *next;
2557 };
2558
2559 #define FLOAT_MARKED_P(fptr) \
2560 GETMARKBIT (FLOAT_BLOCK (fptr), FLOAT_INDEX ((fptr)))
2561
2562 #define FLOAT_MARK(fptr) \
2563 SETMARKBIT (FLOAT_BLOCK (fptr), FLOAT_INDEX ((fptr)))
2564
2565 #define FLOAT_UNMARK(fptr) \
2566 UNSETMARKBIT (FLOAT_BLOCK (fptr), FLOAT_INDEX ((fptr)))
2567
2568 /* Current float_block. */
2569
2570 struct float_block *float_block;
2571
2572 /* Index of first unused Lisp_Float in the current float_block. */
2573
2574 int float_block_index;
2575
2576 /* Total number of float blocks now in use. */
2577
2578 int n_float_blocks;
2579
2580 /* Free-list of Lisp_Floats. */
2581
2582 struct Lisp_Float *float_free_list;
2583
2584
2585 /* Initialize float allocation. */
2586
2587 static void
2588 init_float ()
2589 {
2590 float_block = NULL;
2591 float_block_index = FLOAT_BLOCK_SIZE; /* Force alloc of new float_block. */
2592 float_free_list = 0;
2593 n_float_blocks = 0;
2594 }
2595
2596
2597 /* Explicitly free a float cell by putting it on the free-list. */
2598
2599 static void
2600 free_float (ptr)
2601 struct Lisp_Float *ptr;
2602 {
2603 ptr->u.chain = float_free_list;
2604 float_free_list = ptr;
2605 }
2606
2607
2608 /* Return a new float object with value FLOAT_VALUE. */
2609
2610 Lisp_Object
2611 make_float (float_value)
2612 double float_value;
2613 {
2614 register Lisp_Object val;
2615
2616 /* eassert (!handling_signal); */
2617
2618 MALLOC_BLOCK_INPUT;
2619
2620 if (float_free_list)
2621 {
2622 /* We use the data field for chaining the free list
2623 so that we won't use the same field that has the mark bit. */
2624 XSETFLOAT (val, float_free_list);
2625 float_free_list = float_free_list->u.chain;
2626 }
2627 else
2628 {
2629 if (float_block_index == FLOAT_BLOCK_SIZE)
2630 {
2631 register struct float_block *new;
2632
2633 new = (struct float_block *) lisp_align_malloc (sizeof *new,
2634 MEM_TYPE_FLOAT);
2635 new->next = float_block;
2636 bzero ((char *) new->gcmarkbits, sizeof new->gcmarkbits);
2637 float_block = new;
2638 float_block_index = 0;
2639 n_float_blocks++;
2640 }
2641 XSETFLOAT (val, &float_block->floats[float_block_index]);
2642 float_block_index++;
2643 }
2644
2645 MALLOC_UNBLOCK_INPUT;
2646
2647 XFLOAT_INIT (val, float_value);
2648 eassert (!FLOAT_MARKED_P (XFLOAT (val)));
2649 consing_since_gc += sizeof (struct Lisp_Float);
2650 floats_consed++;
2651 return val;
2652 }
2653
2654
2655 \f
2656 /***********************************************************************
2657 Cons Allocation
2658 ***********************************************************************/
2659
2660 /* We store cons cells inside of cons_blocks, allocating a new
2661 cons_block with malloc whenever necessary. Cons cells reclaimed by
2662 GC are put on a free list to be reallocated before allocating
2663 any new cons cells from the latest cons_block. */
2664
2665 #define CONS_BLOCK_SIZE \
2666 (((BLOCK_BYTES - sizeof (struct cons_block *)) * CHAR_BIT) \
2667 / (sizeof (struct Lisp_Cons) * CHAR_BIT + 1))
2668
2669 #define CONS_BLOCK(fptr) \
2670 ((struct cons_block *)(((EMACS_UINT)(fptr)) & ~(BLOCK_ALIGN - 1)))
2671
2672 #define CONS_INDEX(fptr) \
2673 ((((EMACS_UINT)(fptr)) & (BLOCK_ALIGN - 1)) / sizeof (struct Lisp_Cons))
2674
2675 struct cons_block
2676 {
2677 /* Place `conses' at the beginning, to ease up CONS_INDEX's job. */
2678 struct Lisp_Cons conses[CONS_BLOCK_SIZE];
2679 int gcmarkbits[1 + CONS_BLOCK_SIZE / (sizeof(int) * CHAR_BIT)];
2680 struct cons_block *next;
2681 };
2682
2683 #define CONS_MARKED_P(fptr) \
2684 GETMARKBIT (CONS_BLOCK (fptr), CONS_INDEX ((fptr)))
2685
2686 #define CONS_MARK(fptr) \
2687 SETMARKBIT (CONS_BLOCK (fptr), CONS_INDEX ((fptr)))
2688
2689 #define CONS_UNMARK(fptr) \
2690 UNSETMARKBIT (CONS_BLOCK (fptr), CONS_INDEX ((fptr)))
2691
2692 /* Current cons_block. */
2693
2694 struct cons_block *cons_block;
2695
2696 /* Index of first unused Lisp_Cons in the current block. */
2697
2698 int cons_block_index;
2699
2700 /* Free-list of Lisp_Cons structures. */
2701
2702 struct Lisp_Cons *cons_free_list;
2703
2704 /* Total number of cons blocks now in use. */
2705
2706 static int n_cons_blocks;
2707
2708
2709 /* Initialize cons allocation. */
2710
2711 static void
2712 init_cons ()
2713 {
2714 cons_block = NULL;
2715 cons_block_index = CONS_BLOCK_SIZE; /* Force alloc of new cons_block. */
2716 cons_free_list = 0;
2717 n_cons_blocks = 0;
2718 }
2719
2720
2721 /* Explicitly free a cons cell by putting it on the free-list. */
2722
2723 void
2724 free_cons (ptr)
2725 struct Lisp_Cons *ptr;
2726 {
2727 ptr->u.chain = cons_free_list;
2728 #if GC_MARK_STACK
2729 ptr->car = Vdead;
2730 #endif
2731 cons_free_list = ptr;
2732 }
2733
2734 DEFUN ("cons", Fcons, Scons, 2, 2, 0,
2735 doc: /* Create a new cons, give it CAR and CDR as components, and return it. */)
2736 (car, cdr)
2737 Lisp_Object car, cdr;
2738 {
2739 register Lisp_Object val;
2740
2741 /* eassert (!handling_signal); */
2742
2743 MALLOC_BLOCK_INPUT;
2744
2745 if (cons_free_list)
2746 {
2747 /* We use the cdr for chaining the free list
2748 so that we won't use the same field that has the mark bit. */
2749 XSETCONS (val, cons_free_list);
2750 cons_free_list = cons_free_list->u.chain;
2751 }
2752 else
2753 {
2754 if (cons_block_index == CONS_BLOCK_SIZE)
2755 {
2756 register struct cons_block *new;
2757 new = (struct cons_block *) lisp_align_malloc (sizeof *new,
2758 MEM_TYPE_CONS);
2759 bzero ((char *) new->gcmarkbits, sizeof new->gcmarkbits);
2760 new->next = cons_block;
2761 cons_block = new;
2762 cons_block_index = 0;
2763 n_cons_blocks++;
2764 }
2765 XSETCONS (val, &cons_block->conses[cons_block_index]);
2766 cons_block_index++;
2767 }
2768
2769 MALLOC_UNBLOCK_INPUT;
2770
2771 XSETCAR (val, car);
2772 XSETCDR (val, cdr);
2773 eassert (!CONS_MARKED_P (XCONS (val)));
2774 consing_since_gc += sizeof (struct Lisp_Cons);
2775 cons_cells_consed++;
2776 return val;
2777 }
2778
2779 /* Get an error now if there's any junk in the cons free list. */
2780 void
2781 check_cons_list ()
2782 {
2783 #ifdef GC_CHECK_CONS_LIST
2784 struct Lisp_Cons *tail = cons_free_list;
2785
2786 while (tail)
2787 tail = tail->u.chain;
2788 #endif
2789 }
2790
2791 /* Make a list of 1, 2, 3, 4 or 5 specified objects. */
2792
2793 Lisp_Object
2794 list1 (arg1)
2795 Lisp_Object arg1;
2796 {
2797 return Fcons (arg1, Qnil);
2798 }
2799
2800 Lisp_Object
2801 list2 (arg1, arg2)
2802 Lisp_Object arg1, arg2;
2803 {
2804 return Fcons (arg1, Fcons (arg2, Qnil));
2805 }
2806
2807
2808 Lisp_Object
2809 list3 (arg1, arg2, arg3)
2810 Lisp_Object arg1, arg2, arg3;
2811 {
2812 return Fcons (arg1, Fcons (arg2, Fcons (arg3, Qnil)));
2813 }
2814
2815
2816 Lisp_Object
2817 list4 (arg1, arg2, arg3, arg4)
2818 Lisp_Object arg1, arg2, arg3, arg4;
2819 {
2820 return Fcons (arg1, Fcons (arg2, Fcons (arg3, Fcons (arg4, Qnil))));
2821 }
2822
2823
2824 Lisp_Object
2825 list5 (arg1, arg2, arg3, arg4, arg5)
2826 Lisp_Object arg1, arg2, arg3, arg4, arg5;
2827 {
2828 return Fcons (arg1, Fcons (arg2, Fcons (arg3, Fcons (arg4,
2829 Fcons (arg5, Qnil)))));
2830 }
2831
2832
2833 DEFUN ("list", Flist, Slist, 0, MANY, 0,
2834 doc: /* Return a newly created list with specified arguments as elements.
2835 Any number of arguments, even zero arguments, are allowed.
2836 usage: (list &rest OBJECTS) */)
2837 (nargs, args)
2838 int nargs;
2839 register Lisp_Object *args;
2840 {
2841 register Lisp_Object val;
2842 val = Qnil;
2843
2844 while (nargs > 0)
2845 {
2846 nargs--;
2847 val = Fcons (args[nargs], val);
2848 }
2849 return val;
2850 }
2851
2852
2853 DEFUN ("make-list", Fmake_list, Smake_list, 2, 2, 0,
2854 doc: /* Return a newly created list of length LENGTH, with each element being INIT. */)
2855 (length, init)
2856 register Lisp_Object length, init;
2857 {
2858 register Lisp_Object val;
2859 register int size;
2860
2861 CHECK_NATNUM (length);
2862 size = XFASTINT (length);
2863
2864 val = Qnil;
2865 while (size > 0)
2866 {
2867 val = Fcons (init, val);
2868 --size;
2869
2870 if (size > 0)
2871 {
2872 val = Fcons (init, val);
2873 --size;
2874
2875 if (size > 0)
2876 {
2877 val = Fcons (init, val);
2878 --size;
2879
2880 if (size > 0)
2881 {
2882 val = Fcons (init, val);
2883 --size;
2884
2885 if (size > 0)
2886 {
2887 val = Fcons (init, val);
2888 --size;
2889 }
2890 }
2891 }
2892 }
2893
2894 QUIT;
2895 }
2896
2897 return val;
2898 }
2899
2900
2901 \f
2902 /***********************************************************************
2903 Vector Allocation
2904 ***********************************************************************/
2905
2906 /* Singly-linked list of all vectors. */
2907
2908 static struct Lisp_Vector *all_vectors;
2909
2910 /* Total number of vector-like objects now in use. */
2911
2912 static int n_vectors;
2913
2914
2915 /* Value is a pointer to a newly allocated Lisp_Vector structure
2916 with room for LEN Lisp_Objects. */
2917
2918 static struct Lisp_Vector *
2919 allocate_vectorlike (len)
2920 EMACS_INT len;
2921 {
2922 struct Lisp_Vector *p;
2923 size_t nbytes;
2924
2925 MALLOC_BLOCK_INPUT;
2926
2927 #ifdef DOUG_LEA_MALLOC
2928 /* Prevent mmap'ing the chunk. Lisp data may not be mmap'ed
2929 because mapped region contents are not preserved in
2930 a dumped Emacs. */
2931 mallopt (M_MMAP_MAX, 0);
2932 #endif
2933
2934 /* This gets triggered by code which I haven't bothered to fix. --Stef */
2935 /* eassert (!handling_signal); */
2936
2937 nbytes = sizeof *p + (len - 1) * sizeof p->contents[0];
2938 p = (struct Lisp_Vector *) lisp_malloc (nbytes, MEM_TYPE_VECTORLIKE);
2939
2940 #ifdef DOUG_LEA_MALLOC
2941 /* Back to a reasonable maximum of mmap'ed areas. */
2942 mallopt (M_MMAP_MAX, MMAP_MAX_AREAS);
2943 #endif
2944
2945 consing_since_gc += nbytes;
2946 vector_cells_consed += len;
2947
2948 p->next = all_vectors;
2949 all_vectors = p;
2950
2951 MALLOC_UNBLOCK_INPUT;
2952
2953 ++n_vectors;
2954 return p;
2955 }
2956
2957
2958 /* Allocate a vector with NSLOTS slots. */
2959
2960 struct Lisp_Vector *
2961 allocate_vector (nslots)
2962 EMACS_INT nslots;
2963 {
2964 struct Lisp_Vector *v = allocate_vectorlike (nslots);
2965 v->size = nslots;
2966 return v;
2967 }
2968
2969
2970 /* Allocate other vector-like structures. */
2971
2972 struct Lisp_Vector *
2973 allocate_pseudovector (memlen, lisplen, tag)
2974 int memlen, lisplen;
2975 EMACS_INT tag;
2976 {
2977 struct Lisp_Vector *v = allocate_vectorlike (memlen);
2978 EMACS_INT i;
2979
2980 /* Only the first lisplen slots will be traced normally by the GC. */
2981 v->size = lisplen;
2982 for (i = 0; i < lisplen; ++i)
2983 v->contents[i] = Qnil;
2984
2985 XSETPVECTYPE (v, tag); /* Add the appropriate tag. */
2986 return v;
2987 }
2988
2989 struct Lisp_Hash_Table *
2990 allocate_hash_table (void)
2991 {
2992 return ALLOCATE_PSEUDOVECTOR (struct Lisp_Hash_Table, count, PVEC_HASH_TABLE);
2993 }
2994
2995
2996 struct window *
2997 allocate_window ()
2998 {
2999 return ALLOCATE_PSEUDOVECTOR(struct window, current_matrix, PVEC_WINDOW);
3000 }
3001
3002
3003 struct terminal *
3004 allocate_terminal ()
3005 {
3006 struct terminal *t = ALLOCATE_PSEUDOVECTOR (struct terminal,
3007 next_terminal, PVEC_TERMINAL);
3008 /* Zero out the non-GC'd fields. FIXME: This should be made unnecessary. */
3009 bzero (&(t->next_terminal),
3010 ((char*)(t+1)) - ((char*)&(t->next_terminal)));
3011
3012 return t;
3013 }
3014
3015 struct frame *
3016 allocate_frame ()
3017 {
3018 struct frame *f = ALLOCATE_PSEUDOVECTOR (struct frame,
3019 face_cache, PVEC_FRAME);
3020 /* Zero out the non-GC'd fields. FIXME: This should be made unnecessary. */
3021 bzero (&(f->face_cache),
3022 ((char*)(f+1)) - ((char*)&(f->face_cache)));
3023 return f;
3024 }
3025
3026
3027 struct Lisp_Process *
3028 allocate_process ()
3029 {
3030 return ALLOCATE_PSEUDOVECTOR (struct Lisp_Process, pid, PVEC_PROCESS);
3031 }
3032
3033
3034 DEFUN ("make-vector", Fmake_vector, Smake_vector, 2, 2, 0,
3035 doc: /* Return a newly created vector of length LENGTH, with each element being INIT.
3036 See also the function `vector'. */)
3037 (length, init)
3038 register Lisp_Object length, init;
3039 {
3040 Lisp_Object vector;
3041 register EMACS_INT sizei;
3042 register int index;
3043 register struct Lisp_Vector *p;
3044
3045 CHECK_NATNUM (length);
3046 sizei = XFASTINT (length);
3047
3048 p = allocate_vector (sizei);
3049 for (index = 0; index < sizei; index++)
3050 p->contents[index] = init;
3051
3052 XSETVECTOR (vector, p);
3053 return vector;
3054 }
3055
3056
3057 DEFUN ("vector", Fvector, Svector, 0, MANY, 0,
3058 doc: /* Return a newly created vector with specified arguments as elements.
3059 Any number of arguments, even zero arguments, are allowed.
3060 usage: (vector &rest OBJECTS) */)
3061 (nargs, args)
3062 register int nargs;
3063 Lisp_Object *args;
3064 {
3065 register Lisp_Object len, val;
3066 register int index;
3067 register struct Lisp_Vector *p;
3068
3069 XSETFASTINT (len, nargs);
3070 val = Fmake_vector (len, Qnil);
3071 p = XVECTOR (val);
3072 for (index = 0; index < nargs; index++)
3073 p->contents[index] = args[index];
3074 return val;
3075 }
3076
3077
3078 DEFUN ("make-byte-code", Fmake_byte_code, Smake_byte_code, 4, MANY, 0,
3079 doc: /* Create a byte-code object with specified arguments as elements.
3080 The arguments should be the arglist, bytecode-string, constant vector,
3081 stack size, (optional) doc string, and (optional) interactive spec.
3082 The first four arguments are required; at most six have any
3083 significance.
3084 usage: (make-byte-code ARGLIST BYTE-CODE CONSTANTS DEPTH &optional DOCSTRING INTERACTIVE-SPEC &rest ELEMENTS) */)
3085 (nargs, args)
3086 register int nargs;
3087 Lisp_Object *args;
3088 {
3089 register Lisp_Object len, val;
3090 register int index;
3091 register struct Lisp_Vector *p;
3092
3093 XSETFASTINT (len, nargs);
3094 if (!NILP (Vpurify_flag))
3095 val = make_pure_vector ((EMACS_INT) nargs);
3096 else
3097 val = Fmake_vector (len, Qnil);
3098
3099 if (STRINGP (args[1]) && STRING_MULTIBYTE (args[1]))
3100 /* BYTECODE-STRING must have been produced by Emacs 20.2 or the
3101 earlier because they produced a raw 8-bit string for byte-code
3102 and now such a byte-code string is loaded as multibyte while
3103 raw 8-bit characters converted to multibyte form. Thus, now we
3104 must convert them back to the original unibyte form. */
3105 args[1] = Fstring_as_unibyte (args[1]);
3106
3107 p = XVECTOR (val);
3108 for (index = 0; index < nargs; index++)
3109 {
3110 if (!NILP (Vpurify_flag))
3111 args[index] = Fpurecopy (args[index]);
3112 p->contents[index] = args[index];
3113 }
3114 XSETPVECTYPE (p, PVEC_COMPILED);
3115 XSETCOMPILED (val, p);
3116 return val;
3117 }
3118
3119
3120 \f
3121 /***********************************************************************
3122 Symbol Allocation
3123 ***********************************************************************/
3124
3125 /* Each symbol_block is just under 1020 bytes long, since malloc
3126 really allocates in units of powers of two and uses 4 bytes for its
3127 own overhead. */
3128
3129 #define SYMBOL_BLOCK_SIZE \
3130 ((1020 - sizeof (struct symbol_block *)) / sizeof (struct Lisp_Symbol))
3131
3132 struct symbol_block
3133 {
3134 /* Place `symbols' first, to preserve alignment. */
3135 struct Lisp_Symbol symbols[SYMBOL_BLOCK_SIZE];
3136 struct symbol_block *next;
3137 };
3138
3139 /* Current symbol block and index of first unused Lisp_Symbol
3140 structure in it. */
3141
3142 static struct symbol_block *symbol_block;
3143 static int symbol_block_index;
3144
3145 /* List of free symbols. */
3146
3147 static struct Lisp_Symbol *symbol_free_list;
3148
3149 /* Total number of symbol blocks now in use. */
3150
3151 static int n_symbol_blocks;
3152
3153
3154 /* Initialize symbol allocation. */
3155
3156 static void
3157 init_symbol ()
3158 {
3159 symbol_block = NULL;
3160 symbol_block_index = SYMBOL_BLOCK_SIZE;
3161 symbol_free_list = 0;
3162 n_symbol_blocks = 0;
3163 }
3164
3165
3166 DEFUN ("make-symbol", Fmake_symbol, Smake_symbol, 1, 1, 0,
3167 doc: /* Return a newly allocated uninterned symbol whose name is NAME.
3168 Its value and function definition are void, and its property list is nil. */)
3169 (name)
3170 Lisp_Object name;
3171 {
3172 register Lisp_Object val;
3173 register struct Lisp_Symbol *p;
3174
3175 CHECK_STRING (name);
3176
3177 /* eassert (!handling_signal); */
3178
3179 MALLOC_BLOCK_INPUT;
3180
3181 if (symbol_free_list)
3182 {
3183 XSETSYMBOL (val, symbol_free_list);
3184 symbol_free_list = symbol_free_list->next;
3185 }
3186 else
3187 {
3188 if (symbol_block_index == SYMBOL_BLOCK_SIZE)
3189 {
3190 struct symbol_block *new;
3191 new = (struct symbol_block *) lisp_malloc (sizeof *new,
3192 MEM_TYPE_SYMBOL);
3193 new->next = symbol_block;
3194 symbol_block = new;
3195 symbol_block_index = 0;
3196 n_symbol_blocks++;
3197 }
3198 XSETSYMBOL (val, &symbol_block->symbols[symbol_block_index]);
3199 symbol_block_index++;
3200 }
3201
3202 MALLOC_UNBLOCK_INPUT;
3203
3204 p = XSYMBOL (val);
3205 p->xname = name;
3206 p->plist = Qnil;
3207 p->value = Qunbound;
3208 p->function = Qunbound;
3209 p->next = NULL;
3210 p->gcmarkbit = 0;
3211 p->interned = SYMBOL_UNINTERNED;
3212 p->constant = 0;
3213 p->indirect_variable = 0;
3214 consing_since_gc += sizeof (struct Lisp_Symbol);
3215 symbols_consed++;
3216 return val;
3217 }
3218
3219
3220 \f
3221 /***********************************************************************
3222 Marker (Misc) Allocation
3223 ***********************************************************************/
3224
3225 /* Allocation of markers and other objects that share that structure.
3226 Works like allocation of conses. */
3227
3228 #define MARKER_BLOCK_SIZE \
3229 ((1020 - sizeof (struct marker_block *)) / sizeof (union Lisp_Misc))
3230
3231 struct marker_block
3232 {
3233 /* Place `markers' first, to preserve alignment. */
3234 union Lisp_Misc markers[MARKER_BLOCK_SIZE];
3235 struct marker_block *next;
3236 };
3237
3238 static struct marker_block *marker_block;
3239 static int marker_block_index;
3240
3241 static union Lisp_Misc *marker_free_list;
3242
3243 /* Total number of marker blocks now in use. */
3244
3245 static int n_marker_blocks;
3246
3247 static void
3248 init_marker ()
3249 {
3250 marker_block = NULL;
3251 marker_block_index = MARKER_BLOCK_SIZE;
3252 marker_free_list = 0;
3253 n_marker_blocks = 0;
3254 }
3255
3256 /* Return a newly allocated Lisp_Misc object, with no substructure. */
3257
3258 Lisp_Object
3259 allocate_misc ()
3260 {
3261 Lisp_Object val;
3262
3263 /* eassert (!handling_signal); */
3264
3265 MALLOC_BLOCK_INPUT;
3266
3267 if (marker_free_list)
3268 {
3269 XSETMISC (val, marker_free_list);
3270 marker_free_list = marker_free_list->u_free.chain;
3271 }
3272 else
3273 {
3274 if (marker_block_index == MARKER_BLOCK_SIZE)
3275 {
3276 struct marker_block *new;
3277 new = (struct marker_block *) lisp_malloc (sizeof *new,
3278 MEM_TYPE_MISC);
3279 new->next = marker_block;
3280 marker_block = new;
3281 marker_block_index = 0;
3282 n_marker_blocks++;
3283 total_free_markers += MARKER_BLOCK_SIZE;
3284 }
3285 XSETMISC (val, &marker_block->markers[marker_block_index]);
3286 marker_block_index++;
3287 }
3288
3289 MALLOC_UNBLOCK_INPUT;
3290
3291 --total_free_markers;
3292 consing_since_gc += sizeof (union Lisp_Misc);
3293 misc_objects_consed++;
3294 XMISCANY (val)->gcmarkbit = 0;
3295 return val;
3296 }
3297
3298 /* Free a Lisp_Misc object */
3299
3300 void
3301 free_misc (misc)
3302 Lisp_Object misc;
3303 {
3304 XMISCTYPE (misc) = Lisp_Misc_Free;
3305 XMISC (misc)->u_free.chain = marker_free_list;
3306 marker_free_list = XMISC (misc);
3307
3308 total_free_markers++;
3309 }
3310
3311 /* Return a Lisp_Misc_Save_Value object containing POINTER and
3312 INTEGER. This is used to package C values to call record_unwind_protect.
3313 The unwind function can get the C values back using XSAVE_VALUE. */
3314
3315 Lisp_Object
3316 make_save_value (pointer, integer)
3317 void *pointer;
3318 int integer;
3319 {
3320 register Lisp_Object val;
3321 register struct Lisp_Save_Value *p;
3322
3323 val = allocate_misc ();
3324 XMISCTYPE (val) = Lisp_Misc_Save_Value;
3325 p = XSAVE_VALUE (val);
3326 p->pointer = pointer;
3327 p->integer = integer;
3328 p->dogc = 0;
3329 return val;
3330 }
3331
3332 DEFUN ("make-marker", Fmake_marker, Smake_marker, 0, 0, 0,
3333 doc: /* Return a newly allocated marker which does not point at any place. */)
3334 ()
3335 {
3336 register Lisp_Object val;
3337 register struct Lisp_Marker *p;
3338
3339 val = allocate_misc ();
3340 XMISCTYPE (val) = Lisp_Misc_Marker;
3341 p = XMARKER (val);
3342 p->buffer = 0;
3343 p->bytepos = 0;
3344 p->charpos = 0;
3345 p->next = NULL;
3346 p->insertion_type = 0;
3347 return val;
3348 }
3349
3350 /* Put MARKER back on the free list after using it temporarily. */
3351
3352 void
3353 free_marker (marker)
3354 Lisp_Object marker;
3355 {
3356 unchain_marker (XMARKER (marker));
3357 free_misc (marker);
3358 }
3359
3360 \f
3361 /* Return a newly created vector or string with specified arguments as
3362 elements. If all the arguments are characters that can fit
3363 in a string of events, make a string; otherwise, make a vector.
3364
3365 Any number of arguments, even zero arguments, are allowed. */
3366
3367 Lisp_Object
3368 make_event_array (nargs, args)
3369 register int nargs;
3370 Lisp_Object *args;
3371 {
3372 int i;
3373
3374 for (i = 0; i < nargs; i++)
3375 /* The things that fit in a string
3376 are characters that are in 0...127,
3377 after discarding the meta bit and all the bits above it. */
3378 if (!INTEGERP (args[i])
3379 || (XUINT (args[i]) & ~(-CHAR_META)) >= 0200)
3380 return Fvector (nargs, args);
3381
3382 /* Since the loop exited, we know that all the things in it are
3383 characters, so we can make a string. */
3384 {
3385 Lisp_Object result;
3386
3387 result = Fmake_string (make_number (nargs), make_number (0));
3388 for (i = 0; i < nargs; i++)
3389 {
3390 SSET (result, i, XINT (args[i]));
3391 /* Move the meta bit to the right place for a string char. */
3392 if (XINT (args[i]) & CHAR_META)
3393 SSET (result, i, SREF (result, i) | 0x80);
3394 }
3395
3396 return result;
3397 }
3398 }
3399
3400
3401 \f
3402 /************************************************************************
3403 Memory Full Handling
3404 ************************************************************************/
3405
3406
3407 /* Called if malloc returns zero. */
3408
3409 void
3410 memory_full ()
3411 {
3412 int i;
3413
3414 Vmemory_full = Qt;
3415
3416 memory_full_cons_threshold = sizeof (struct cons_block);
3417
3418 /* The first time we get here, free the spare memory. */
3419 for (i = 0; i < sizeof (spare_memory) / sizeof (char *); i++)
3420 if (spare_memory[i])
3421 {
3422 if (i == 0)
3423 free (spare_memory[i]);
3424 else if (i >= 1 && i <= 4)
3425 lisp_align_free (spare_memory[i]);
3426 else
3427 lisp_free (spare_memory[i]);
3428 spare_memory[i] = 0;
3429 }
3430
3431 /* Record the space now used. When it decreases substantially,
3432 we can refill the memory reserve. */
3433 #ifndef SYSTEM_MALLOC
3434 bytes_used_when_full = BYTES_USED;
3435 #endif
3436
3437 /* This used to call error, but if we've run out of memory, we could
3438 get infinite recursion trying to build the string. */
3439 xsignal (Qnil, Vmemory_signal_data);
3440 }
3441
3442 /* If we released our reserve (due to running out of memory),
3443 and we have a fair amount free once again,
3444 try to set aside another reserve in case we run out once more.
3445
3446 This is called when a relocatable block is freed in ralloc.c,
3447 and also directly from this file, in case we're not using ralloc.c. */
3448
3449 void
3450 refill_memory_reserve ()
3451 {
3452 #ifndef SYSTEM_MALLOC
3453 if (spare_memory[0] == 0)
3454 spare_memory[0] = (char *) malloc ((size_t) SPARE_MEMORY);
3455 if (spare_memory[1] == 0)
3456 spare_memory[1] = (char *) lisp_align_malloc (sizeof (struct cons_block),
3457 MEM_TYPE_CONS);
3458 if (spare_memory[2] == 0)
3459 spare_memory[2] = (char *) lisp_align_malloc (sizeof (struct cons_block),
3460 MEM_TYPE_CONS);
3461 if (spare_memory[3] == 0)
3462 spare_memory[3] = (char *) lisp_align_malloc (sizeof (struct cons_block),
3463 MEM_TYPE_CONS);
3464 if (spare_memory[4] == 0)
3465 spare_memory[4] = (char *) lisp_align_malloc (sizeof (struct cons_block),
3466 MEM_TYPE_CONS);
3467 if (spare_memory[5] == 0)
3468 spare_memory[5] = (char *) lisp_malloc (sizeof (struct string_block),
3469 MEM_TYPE_STRING);
3470 if (spare_memory[6] == 0)
3471 spare_memory[6] = (char *) lisp_malloc (sizeof (struct string_block),
3472 MEM_TYPE_STRING);
3473 if (spare_memory[0] && spare_memory[1] && spare_memory[5])
3474 Vmemory_full = Qnil;
3475 #endif
3476 }
3477 \f
3478 /************************************************************************
3479 C Stack Marking
3480 ************************************************************************/
3481
3482 #if GC_MARK_STACK || defined GC_MALLOC_CHECK
3483
3484 /* Conservative C stack marking requires a method to identify possibly
3485 live Lisp objects given a pointer value. We do this by keeping
3486 track of blocks of Lisp data that are allocated in a red-black tree
3487 (see also the comment of mem_node which is the type of nodes in
3488 that tree). Function lisp_malloc adds information for an allocated
3489 block to the red-black tree with calls to mem_insert, and function
3490 lisp_free removes it with mem_delete. Functions live_string_p etc
3491 call mem_find to lookup information about a given pointer in the
3492 tree, and use that to determine if the pointer points to a Lisp
3493 object or not. */
3494
3495 /* Initialize this part of alloc.c. */
3496
3497 static void
3498 mem_init ()
3499 {
3500 mem_z.left = mem_z.right = MEM_NIL;
3501 mem_z.parent = NULL;
3502 mem_z.color = MEM_BLACK;
3503 mem_z.start = mem_z.end = NULL;
3504 mem_root = MEM_NIL;
3505 }
3506
3507
3508 /* Value is a pointer to the mem_node containing START. Value is
3509 MEM_NIL if there is no node in the tree containing START. */
3510
3511 static INLINE struct mem_node *
3512 mem_find (start)
3513 void *start;
3514 {
3515 struct mem_node *p;
3516
3517 if (start < min_heap_address || start > max_heap_address)
3518 return MEM_NIL;
3519
3520 /* Make the search always successful to speed up the loop below. */
3521 mem_z.start = start;
3522 mem_z.end = (char *) start + 1;
3523
3524 p = mem_root;
3525 while (start < p->start || start >= p->end)
3526 p = start < p->start ? p->left : p->right;
3527 return p;
3528 }
3529
3530
3531 /* Insert a new node into the tree for a block of memory with start
3532 address START, end address END, and type TYPE. Value is a
3533 pointer to the node that was inserted. */
3534
3535 static struct mem_node *
3536 mem_insert (start, end, type)
3537 void *start, *end;
3538 enum mem_type type;
3539 {
3540 struct mem_node *c, *parent, *x;
3541
3542 if (min_heap_address == NULL || start < min_heap_address)
3543 min_heap_address = start;
3544 if (max_heap_address == NULL || end > max_heap_address)
3545 max_heap_address = end;
3546
3547 /* See where in the tree a node for START belongs. In this
3548 particular application, it shouldn't happen that a node is already
3549 present. For debugging purposes, let's check that. */
3550 c = mem_root;
3551 parent = NULL;
3552
3553 #if GC_MARK_STACK != GC_MAKE_GCPROS_NOOPS
3554
3555 while (c != MEM_NIL)
3556 {
3557 if (start >= c->start && start < c->end)
3558 abort ();
3559 parent = c;
3560 c = start < c->start ? c->left : c->right;
3561 }
3562
3563 #else /* GC_MARK_STACK == GC_MARK_STACK_CHECK_GCPROS */
3564
3565 while (c != MEM_NIL)
3566 {
3567 parent = c;
3568 c = start < c->start ? c->left : c->right;
3569 }
3570
3571 #endif /* GC_MARK_STACK == GC_MARK_STACK_CHECK_GCPROS */
3572
3573 /* Create a new node. */
3574 #ifdef GC_MALLOC_CHECK
3575 x = (struct mem_node *) _malloc_internal (sizeof *x);
3576 if (x == NULL)
3577 abort ();
3578 #else
3579 x = (struct mem_node *) xmalloc (sizeof *x);
3580 #endif
3581 x->start = start;
3582 x->end = end;
3583 x->type = type;
3584 x->parent = parent;
3585 x->left = x->right = MEM_NIL;
3586 x->color = MEM_RED;
3587
3588 /* Insert it as child of PARENT or install it as root. */
3589 if (parent)
3590 {
3591 if (start < parent->start)
3592 parent->left = x;
3593 else
3594 parent->right = x;
3595 }
3596 else
3597 mem_root = x;
3598
3599 /* Re-establish red-black tree properties. */
3600 mem_insert_fixup (x);
3601
3602 return x;
3603 }
3604
3605
3606 /* Re-establish the red-black properties of the tree, and thereby
3607 balance the tree, after node X has been inserted; X is always red. */
3608
3609 static void
3610 mem_insert_fixup (x)
3611 struct mem_node *x;
3612 {
3613 while (x != mem_root && x->parent->color == MEM_RED)
3614 {
3615 /* X is red and its parent is red. This is a violation of
3616 red-black tree property #3. */
3617
3618 if (x->parent == x->parent->parent->left)
3619 {
3620 /* We're on the left side of our grandparent, and Y is our
3621 "uncle". */
3622 struct mem_node *y = x->parent->parent->right;
3623
3624 if (y->color == MEM_RED)
3625 {
3626 /* Uncle and parent are red but should be black because
3627 X is red. Change the colors accordingly and proceed
3628 with the grandparent. */
3629 x->parent->color = MEM_BLACK;
3630 y->color = MEM_BLACK;
3631 x->parent->parent->color = MEM_RED;
3632 x = x->parent->parent;
3633 }
3634 else
3635 {
3636 /* Parent and uncle have different colors; parent is
3637 red, uncle is black. */
3638 if (x == x->parent->right)
3639 {
3640 x = x->parent;
3641 mem_rotate_left (x);
3642 }
3643
3644 x->parent->color = MEM_BLACK;
3645 x->parent->parent->color = MEM_RED;
3646 mem_rotate_right (x->parent->parent);
3647 }
3648 }
3649 else
3650 {
3651 /* This is the symmetrical case of above. */
3652 struct mem_node *y = x->parent->parent->left;
3653
3654 if (y->color == MEM_RED)
3655 {
3656 x->parent->color = MEM_BLACK;
3657 y->color = MEM_BLACK;
3658 x->parent->parent->color = MEM_RED;
3659 x = x->parent->parent;
3660 }
3661 else
3662 {
3663 if (x == x->parent->left)
3664 {
3665 x = x->parent;
3666 mem_rotate_right (x);
3667 }
3668
3669 x->parent->color = MEM_BLACK;
3670 x->parent->parent->color = MEM_RED;
3671 mem_rotate_left (x->parent->parent);
3672 }
3673 }
3674 }
3675
3676 /* The root may have been changed to red due to the algorithm. Set
3677 it to black so that property #5 is satisfied. */
3678 mem_root->color = MEM_BLACK;
3679 }
3680
3681
3682 /* (x) (y)
3683 / \ / \
3684 a (y) ===> (x) c
3685 / \ / \
3686 b c a b */
3687
3688 static void
3689 mem_rotate_left (x)
3690 struct mem_node *x;
3691 {
3692 struct mem_node *y;
3693
3694 /* Turn y's left sub-tree into x's right sub-tree. */
3695 y = x->right;
3696 x->right = y->left;
3697 if (y->left != MEM_NIL)
3698 y->left->parent = x;
3699
3700 /* Y's parent was x's parent. */
3701 if (y != MEM_NIL)
3702 y->parent = x->parent;
3703
3704 /* Get the parent to point to y instead of x. */
3705 if (x->parent)
3706 {
3707 if (x == x->parent->left)
3708 x->parent->left = y;
3709 else
3710 x->parent->right = y;
3711 }
3712 else
3713 mem_root = y;
3714
3715 /* Put x on y's left. */
3716 y->left = x;
3717 if (x != MEM_NIL)
3718 x->parent = y;
3719 }
3720
3721
3722 /* (x) (Y)
3723 / \ / \
3724 (y) c ===> a (x)
3725 / \ / \
3726 a b b c */
3727
3728 static void
3729 mem_rotate_right (x)
3730 struct mem_node *x;
3731 {
3732 struct mem_node *y = x->left;
3733
3734 x->left = y->right;
3735 if (y->right != MEM_NIL)
3736 y->right->parent = x;
3737
3738 if (y != MEM_NIL)
3739 y->parent = x->parent;
3740 if (x->parent)
3741 {
3742 if (x == x->parent->right)
3743 x->parent->right = y;
3744 else
3745 x->parent->left = y;
3746 }
3747 else
3748 mem_root = y;
3749
3750 y->right = x;
3751 if (x != MEM_NIL)
3752 x->parent = y;
3753 }
3754
3755
3756 /* Delete node Z from the tree. If Z is null or MEM_NIL, do nothing. */
3757
3758 static void
3759 mem_delete (z)
3760 struct mem_node *z;
3761 {
3762 struct mem_node *x, *y;
3763
3764 if (!z || z == MEM_NIL)
3765 return;
3766
3767 if (z->left == MEM_NIL || z->right == MEM_NIL)
3768 y = z;
3769 else
3770 {
3771 y = z->right;
3772 while (y->left != MEM_NIL)
3773 y = y->left;
3774 }
3775
3776 if (y->left != MEM_NIL)
3777 x = y->left;
3778 else
3779 x = y->right;
3780
3781 x->parent = y->parent;
3782 if (y->parent)
3783 {
3784 if (y == y->parent->left)
3785 y->parent->left = x;
3786 else
3787 y->parent->right = x;
3788 }
3789 else
3790 mem_root = x;
3791
3792 if (y != z)
3793 {
3794 z->start = y->start;
3795 z->end = y->end;
3796 z->type = y->type;
3797 }
3798
3799 if (y->color == MEM_BLACK)
3800 mem_delete_fixup (x);
3801
3802 #ifdef GC_MALLOC_CHECK
3803 _free_internal (y);
3804 #else
3805 xfree (y);
3806 #endif
3807 }
3808
3809
3810 /* Re-establish the red-black properties of the tree, after a
3811 deletion. */
3812
3813 static void
3814 mem_delete_fixup (x)
3815 struct mem_node *x;
3816 {
3817 while (x != mem_root && x->color == MEM_BLACK)
3818 {
3819 if (x == x->parent->left)
3820 {
3821 struct mem_node *w = x->parent->right;
3822
3823 if (w->color == MEM_RED)
3824 {
3825 w->color = MEM_BLACK;
3826 x->parent->color = MEM_RED;
3827 mem_rotate_left (x->parent);
3828 w = x->parent->right;
3829 }
3830
3831 if (w->left->color == MEM_BLACK && w->right->color == MEM_BLACK)
3832 {
3833 w->color = MEM_RED;
3834 x = x->parent;
3835 }
3836 else
3837 {
3838 if (w->right->color == MEM_BLACK)
3839 {
3840 w->left->color = MEM_BLACK;
3841 w->color = MEM_RED;
3842 mem_rotate_right (w);
3843 w = x->parent->right;
3844 }
3845 w->color = x->parent->color;
3846 x->parent->color = MEM_BLACK;
3847 w->right->color = MEM_BLACK;
3848 mem_rotate_left (x->parent);
3849 x = mem_root;
3850 }
3851 }
3852 else
3853 {
3854 struct mem_node *w = x->parent->left;
3855
3856 if (w->color == MEM_RED)
3857 {
3858 w->color = MEM_BLACK;
3859 x->parent->color = MEM_RED;
3860 mem_rotate_right (x->parent);
3861 w = x->parent->left;
3862 }
3863
3864 if (w->right->color == MEM_BLACK && w->left->color == MEM_BLACK)
3865 {
3866 w->color = MEM_RED;
3867 x = x->parent;
3868 }
3869 else
3870 {
3871 if (w->left->color == MEM_BLACK)
3872 {
3873 w->right->color = MEM_BLACK;
3874 w->color = MEM_RED;
3875 mem_rotate_left (w);
3876 w = x->parent->left;
3877 }
3878
3879 w->color = x->parent->color;
3880 x->parent->color = MEM_BLACK;
3881 w->left->color = MEM_BLACK;
3882 mem_rotate_right (x->parent);
3883 x = mem_root;
3884 }
3885 }
3886 }
3887
3888 x->color = MEM_BLACK;
3889 }
3890
3891
3892 /* Value is non-zero if P is a pointer to a live Lisp string on
3893 the heap. M is a pointer to the mem_block for P. */
3894
3895 static INLINE int
3896 live_string_p (m, p)
3897 struct mem_node *m;
3898 void *p;
3899 {
3900 if (m->type == MEM_TYPE_STRING)
3901 {
3902 struct string_block *b = (struct string_block *) m->start;
3903 int offset = (char *) p - (char *) &b->strings[0];
3904
3905 /* P must point to the start of a Lisp_String structure, and it
3906 must not be on the free-list. */
3907 return (offset >= 0
3908 && offset % sizeof b->strings[0] == 0
3909 && offset < (STRING_BLOCK_SIZE * sizeof b->strings[0])
3910 && ((struct Lisp_String *) p)->data != NULL);
3911 }
3912 else
3913 return 0;
3914 }
3915
3916
3917 /* Value is non-zero if P is a pointer to a live Lisp cons on
3918 the heap. M is a pointer to the mem_block for P. */
3919
3920 static INLINE int
3921 live_cons_p (m, p)
3922 struct mem_node *m;
3923 void *p;
3924 {
3925 if (m->type == MEM_TYPE_CONS)
3926 {
3927 struct cons_block *b = (struct cons_block *) m->start;
3928 int offset = (char *) p - (char *) &b->conses[0];
3929
3930 /* P must point to the start of a Lisp_Cons, not be
3931 one of the unused cells in the current cons block,
3932 and not be on the free-list. */
3933 return (offset >= 0
3934 && offset % sizeof b->conses[0] == 0
3935 && offset < (CONS_BLOCK_SIZE * sizeof b->conses[0])
3936 && (b != cons_block
3937 || offset / sizeof b->conses[0] < cons_block_index)
3938 && !EQ (((struct Lisp_Cons *) p)->car, Vdead));
3939 }
3940 else
3941 return 0;
3942 }
3943
3944
3945 /* Value is non-zero if P is a pointer to a live Lisp symbol on
3946 the heap. M is a pointer to the mem_block for P. */
3947
3948 static INLINE int
3949 live_symbol_p (m, p)
3950 struct mem_node *m;
3951 void *p;
3952 {
3953 if (m->type == MEM_TYPE_SYMBOL)
3954 {
3955 struct symbol_block *b = (struct symbol_block *) m->start;
3956 int offset = (char *) p - (char *) &b->symbols[0];
3957
3958 /* P must point to the start of a Lisp_Symbol, not be
3959 one of the unused cells in the current symbol block,
3960 and not be on the free-list. */
3961 return (offset >= 0
3962 && offset % sizeof b->symbols[0] == 0
3963 && offset < (SYMBOL_BLOCK_SIZE * sizeof b->symbols[0])
3964 && (b != symbol_block
3965 || offset / sizeof b->symbols[0] < symbol_block_index)
3966 && !EQ (((struct Lisp_Symbol *) p)->function, Vdead));
3967 }
3968 else
3969 return 0;
3970 }
3971
3972
3973 /* Value is non-zero if P is a pointer to a live Lisp float on
3974 the heap. M is a pointer to the mem_block for P. */
3975
3976 static INLINE int
3977 live_float_p (m, p)
3978 struct mem_node *m;
3979 void *p;
3980 {
3981 if (m->type == MEM_TYPE_FLOAT)
3982 {
3983 struct float_block *b = (struct float_block *) m->start;
3984 int offset = (char *) p - (char *) &b->floats[0];
3985
3986 /* P must point to the start of a Lisp_Float and not be
3987 one of the unused cells in the current float block. */
3988 return (offset >= 0
3989 && offset % sizeof b->floats[0] == 0
3990 && offset < (FLOAT_BLOCK_SIZE * sizeof b->floats[0])
3991 && (b != float_block
3992 || offset / sizeof b->floats[0] < float_block_index));
3993 }
3994 else
3995 return 0;
3996 }
3997
3998
3999 /* Value is non-zero if P is a pointer to a live Lisp Misc on
4000 the heap. M is a pointer to the mem_block for P. */
4001
4002 static INLINE int
4003 live_misc_p (m, p)
4004 struct mem_node *m;
4005 void *p;
4006 {
4007 if (m->type == MEM_TYPE_MISC)
4008 {
4009 struct marker_block *b = (struct marker_block *) m->start;
4010 int offset = (char *) p - (char *) &b->markers[0];
4011
4012 /* P must point to the start of a Lisp_Misc, not be
4013 one of the unused cells in the current misc block,
4014 and not be on the free-list. */
4015 return (offset >= 0
4016 && offset % sizeof b->markers[0] == 0
4017 && offset < (MARKER_BLOCK_SIZE * sizeof b->markers[0])
4018 && (b != marker_block
4019 || offset / sizeof b->markers[0] < marker_block_index)
4020 && ((union Lisp_Misc *) p)->u_any.type != Lisp_Misc_Free);
4021 }
4022 else
4023 return 0;
4024 }
4025
4026
4027 /* Value is non-zero if P is a pointer to a live vector-like object.
4028 M is a pointer to the mem_block for P. */
4029
4030 static INLINE int
4031 live_vector_p (m, p)
4032 struct mem_node *m;
4033 void *p;
4034 {
4035 return (p == m->start && m->type == MEM_TYPE_VECTORLIKE);
4036 }
4037
4038
4039 /* Value is non-zero if P is a pointer to a live buffer. M is a
4040 pointer to the mem_block for P. */
4041
4042 static INLINE int
4043 live_buffer_p (m, p)
4044 struct mem_node *m;
4045 void *p;
4046 {
4047 /* P must point to the start of the block, and the buffer
4048 must not have been killed. */
4049 return (m->type == MEM_TYPE_BUFFER
4050 && p == m->start
4051 && !NILP (((struct buffer *) p)->name));
4052 }
4053
4054 #endif /* GC_MARK_STACK || defined GC_MALLOC_CHECK */
4055
4056 #if GC_MARK_STACK
4057
4058 #if GC_MARK_STACK == GC_USE_GCPROS_CHECK_ZOMBIES
4059
4060 /* Array of objects that are kept alive because the C stack contains
4061 a pattern that looks like a reference to them . */
4062
4063 #define MAX_ZOMBIES 10
4064 static Lisp_Object zombies[MAX_ZOMBIES];
4065
4066 /* Number of zombie objects. */
4067
4068 static int nzombies;
4069
4070 /* Number of garbage collections. */
4071
4072 static int ngcs;
4073
4074 /* Average percentage of zombies per collection. */
4075
4076 static double avg_zombies;
4077
4078 /* Max. number of live and zombie objects. */
4079
4080 static int max_live, max_zombies;
4081
4082 /* Average number of live objects per GC. */
4083
4084 static double avg_live;
4085
4086 DEFUN ("gc-status", Fgc_status, Sgc_status, 0, 0, "",
4087 doc: /* Show information about live and zombie objects. */)
4088 ()
4089 {
4090 Lisp_Object args[8], zombie_list = Qnil;
4091 int i;
4092 for (i = 0; i < nzombies; i++)
4093 zombie_list = Fcons (zombies[i], zombie_list);
4094 args[0] = build_string ("%d GCs, avg live/zombies = %.2f/%.2f (%f%%), max %d/%d\nzombies: %S");
4095 args[1] = make_number (ngcs);
4096 args[2] = make_float (avg_live);
4097 args[3] = make_float (avg_zombies);
4098 args[4] = make_float (avg_zombies / avg_live / 100);
4099 args[5] = make_number (max_live);
4100 args[6] = make_number (max_zombies);
4101 args[7] = zombie_list;
4102 return Fmessage (8, args);
4103 }
4104
4105 #endif /* GC_MARK_STACK == GC_USE_GCPROS_CHECK_ZOMBIES */
4106
4107
4108 /* Mark OBJ if we can prove it's a Lisp_Object. */
4109
4110 static INLINE void
4111 mark_maybe_object (obj)
4112 Lisp_Object obj;
4113 {
4114 void *po = (void *) XPNTR (obj);
4115 struct mem_node *m = mem_find (po);
4116
4117 if (m != MEM_NIL)
4118 {
4119 int mark_p = 0;
4120
4121 switch (XTYPE (obj))
4122 {
4123 case Lisp_String:
4124 mark_p = (live_string_p (m, po)
4125 && !STRING_MARKED_P ((struct Lisp_String *) po));
4126 break;
4127
4128 case Lisp_Cons:
4129 mark_p = (live_cons_p (m, po) && !CONS_MARKED_P (XCONS (obj)));
4130 break;
4131
4132 case Lisp_Symbol:
4133 mark_p = (live_symbol_p (m, po) && !XSYMBOL (obj)->gcmarkbit);
4134 break;
4135
4136 case Lisp_Float:
4137 mark_p = (live_float_p (m, po) && !FLOAT_MARKED_P (XFLOAT (obj)));
4138 break;
4139
4140 case Lisp_Vectorlike:
4141 /* Note: can't check BUFFERP before we know it's a
4142 buffer because checking that dereferences the pointer
4143 PO which might point anywhere. */
4144 if (live_vector_p (m, po))
4145 mark_p = !SUBRP (obj) && !VECTOR_MARKED_P (XVECTOR (obj));
4146 else if (live_buffer_p (m, po))
4147 mark_p = BUFFERP (obj) && !VECTOR_MARKED_P (XBUFFER (obj));
4148 break;
4149
4150 case Lisp_Misc:
4151 mark_p = (live_misc_p (m, po) && !XMISCANY (obj)->gcmarkbit);
4152 break;
4153
4154 case Lisp_Int:
4155 case Lisp_Type_Limit:
4156 break;
4157 }
4158
4159 if (mark_p)
4160 {
4161 #if GC_MARK_STACK == GC_USE_GCPROS_CHECK_ZOMBIES
4162 if (nzombies < MAX_ZOMBIES)
4163 zombies[nzombies] = obj;
4164 ++nzombies;
4165 #endif
4166 mark_object (obj);
4167 }
4168 }
4169 }
4170
4171
4172 /* If P points to Lisp data, mark that as live if it isn't already
4173 marked. */
4174
4175 static INLINE void
4176 mark_maybe_pointer (p)
4177 void *p;
4178 {
4179 struct mem_node *m;
4180
4181 /* Quickly rule out some values which can't point to Lisp data. */
4182 if ((EMACS_INT) p %
4183 #ifdef USE_LSB_TAG
4184 8 /* USE_LSB_TAG needs Lisp data to be aligned on multiples of 8. */
4185 #else
4186 2 /* We assume that Lisp data is aligned on even addresses. */
4187 #endif
4188 )
4189 return;
4190
4191 m = mem_find (p);
4192 if (m != MEM_NIL)
4193 {
4194 Lisp_Object obj = Qnil;
4195
4196 switch (m->type)
4197 {
4198 case MEM_TYPE_NON_LISP:
4199 /* Nothing to do; not a pointer to Lisp memory. */
4200 break;
4201
4202 case MEM_TYPE_BUFFER:
4203 if (live_buffer_p (m, p) && !VECTOR_MARKED_P((struct buffer *)p))
4204 XSETVECTOR (obj, p);
4205 break;
4206
4207 case MEM_TYPE_CONS:
4208 if (live_cons_p (m, p) && !CONS_MARKED_P ((struct Lisp_Cons *) p))
4209 XSETCONS (obj, p);
4210 break;
4211
4212 case MEM_TYPE_STRING:
4213 if (live_string_p (m, p)
4214 && !STRING_MARKED_P ((struct Lisp_String *) p))
4215 XSETSTRING (obj, p);
4216 break;
4217
4218 case MEM_TYPE_MISC:
4219 if (live_misc_p (m, p) && !((struct Lisp_Free *) p)->gcmarkbit)
4220 XSETMISC (obj, p);
4221 break;
4222
4223 case MEM_TYPE_SYMBOL:
4224 if (live_symbol_p (m, p) && !((struct Lisp_Symbol *) p)->gcmarkbit)
4225 XSETSYMBOL (obj, p);
4226 break;
4227
4228 case MEM_TYPE_FLOAT:
4229 if (live_float_p (m, p) && !FLOAT_MARKED_P (p))
4230 XSETFLOAT (obj, p);
4231 break;
4232
4233 case MEM_TYPE_VECTORLIKE:
4234 if (live_vector_p (m, p))
4235 {
4236 Lisp_Object tem;
4237 XSETVECTOR (tem, p);
4238 if (!SUBRP (tem) && !VECTOR_MARKED_P (XVECTOR (tem)))
4239 obj = tem;
4240 }
4241 break;
4242
4243 default:
4244 abort ();
4245 }
4246
4247 if (!NILP (obj))
4248 mark_object (obj);
4249 }
4250 }
4251
4252
4253 /* Mark Lisp objects referenced from the address range START+OFFSET..END
4254 or END+OFFSET..START. */
4255
4256 static void
4257 mark_memory (start, end, offset)
4258 void *start, *end;
4259 int offset;
4260 {
4261 Lisp_Object *p;
4262 void **pp;
4263
4264 #if GC_MARK_STACK == GC_USE_GCPROS_CHECK_ZOMBIES
4265 nzombies = 0;
4266 #endif
4267
4268 /* Make START the pointer to the start of the memory region,
4269 if it isn't already. */
4270 if (end < start)
4271 {
4272 void *tem = start;
4273 start = end;
4274 end = tem;
4275 }
4276
4277 /* Mark Lisp_Objects. */
4278 for (p = (Lisp_Object *) ((char *) start + offset); (void *) p < end; ++p)
4279 mark_maybe_object (*p);
4280
4281 /* Mark Lisp data pointed to. This is necessary because, in some
4282 situations, the C compiler optimizes Lisp objects away, so that
4283 only a pointer to them remains. Example:
4284
4285 DEFUN ("testme", Ftestme, Stestme, 0, 0, 0, "")
4286 ()
4287 {
4288 Lisp_Object obj = build_string ("test");
4289 struct Lisp_String *s = XSTRING (obj);
4290 Fgarbage_collect ();
4291 fprintf (stderr, "test `%s'\n", s->data);
4292 return Qnil;
4293 }
4294
4295 Here, `obj' isn't really used, and the compiler optimizes it
4296 away. The only reference to the life string is through the
4297 pointer `s'. */
4298
4299 for (pp = (void **) ((char *) start + offset); (void *) pp < end; ++pp)
4300 mark_maybe_pointer (*pp);
4301 }
4302
4303 /* setjmp will work with GCC unless NON_SAVING_SETJMP is defined in
4304 the GCC system configuration. In gcc 3.2, the only systems for
4305 which this is so are i386-sco5 non-ELF, i386-sysv3 (maybe included
4306 by others?) and ns32k-pc532-min. */
4307
4308 #if !defined GC_SAVE_REGISTERS_ON_STACK && !defined GC_SETJMP_WORKS
4309
4310 static int setjmp_tested_p, longjmps_done;
4311
4312 #define SETJMP_WILL_LIKELY_WORK "\
4313 \n\
4314 Emacs garbage collector has been changed to use conservative stack\n\
4315 marking. Emacs has determined that the method it uses to do the\n\
4316 marking will likely work on your system, but this isn't sure.\n\
4317 \n\
4318 If you are a system-programmer, or can get the help of a local wizard\n\
4319 who is, please take a look at the function mark_stack in alloc.c, and\n\
4320 verify that the methods used are appropriate for your system.\n\
4321 \n\
4322 Please mail the result to <emacs-devel@gnu.org>.\n\
4323 "
4324
4325 #define SETJMP_WILL_NOT_WORK "\
4326 \n\
4327 Emacs garbage collector has been changed to use conservative stack\n\
4328 marking. Emacs has determined that the default method it uses to do the\n\
4329 marking will not work on your system. We will need a system-dependent\n\
4330 solution for your system.\n\
4331 \n\
4332 Please take a look at the function mark_stack in alloc.c, and\n\
4333 try to find a way to make it work on your system.\n\
4334 \n\
4335 Note that you may get false negatives, depending on the compiler.\n\
4336 In particular, you need to use -O with GCC for this test.\n\
4337 \n\
4338 Please mail the result to <emacs-devel@gnu.org>.\n\
4339 "
4340
4341
4342 /* Perform a quick check if it looks like setjmp saves registers in a
4343 jmp_buf. Print a message to stderr saying so. When this test
4344 succeeds, this is _not_ a proof that setjmp is sufficient for
4345 conservative stack marking. Only the sources or a disassembly
4346 can prove that. */
4347
4348 static void
4349 test_setjmp ()
4350 {
4351 char buf[10];
4352 register int x;
4353 jmp_buf jbuf;
4354 int result = 0;
4355
4356 /* Arrange for X to be put in a register. */
4357 sprintf (buf, "1");
4358 x = strlen (buf);
4359 x = 2 * x - 1;
4360
4361 setjmp (jbuf);
4362 if (longjmps_done == 1)
4363 {
4364 /* Came here after the longjmp at the end of the function.
4365
4366 If x == 1, the longjmp has restored the register to its
4367 value before the setjmp, and we can hope that setjmp
4368 saves all such registers in the jmp_buf, although that
4369 isn't sure.
4370
4371 For other values of X, either something really strange is
4372 taking place, or the setjmp just didn't save the register. */
4373
4374 if (x == 1)
4375 fprintf (stderr, SETJMP_WILL_LIKELY_WORK);
4376 else
4377 {
4378 fprintf (stderr, SETJMP_WILL_NOT_WORK);
4379 exit (1);
4380 }
4381 }
4382
4383 ++longjmps_done;
4384 x = 2;
4385 if (longjmps_done == 1)
4386 longjmp (jbuf, 1);
4387 }
4388
4389 #endif /* not GC_SAVE_REGISTERS_ON_STACK && not GC_SETJMP_WORKS */
4390
4391
4392 #if GC_MARK_STACK == GC_MARK_STACK_CHECK_GCPROS
4393
4394 /* Abort if anything GCPRO'd doesn't survive the GC. */
4395
4396 static void
4397 check_gcpros ()
4398 {
4399 struct gcpro *p;
4400 int i;
4401
4402 for (p = gcprolist; p; p = p->next)
4403 for (i = 0; i < p->nvars; ++i)
4404 if (!survives_gc_p (p->var[i]))
4405 /* FIXME: It's not necessarily a bug. It might just be that the
4406 GCPRO is unnecessary or should release the object sooner. */
4407 abort ();
4408 }
4409
4410 #elif GC_MARK_STACK == GC_USE_GCPROS_CHECK_ZOMBIES
4411
4412 static void
4413 dump_zombies ()
4414 {
4415 int i;
4416
4417 fprintf (stderr, "\nZombies kept alive = %d:\n", nzombies);
4418 for (i = 0; i < min (MAX_ZOMBIES, nzombies); ++i)
4419 {
4420 fprintf (stderr, " %d = ", i);
4421 debug_print (zombies[i]);
4422 }
4423 }
4424
4425 #endif /* GC_MARK_STACK == GC_USE_GCPROS_CHECK_ZOMBIES */
4426
4427
4428 /* Mark live Lisp objects on the C stack.
4429
4430 There are several system-dependent problems to consider when
4431 porting this to new architectures:
4432
4433 Processor Registers
4434
4435 We have to mark Lisp objects in CPU registers that can hold local
4436 variables or are used to pass parameters.
4437
4438 If GC_SAVE_REGISTERS_ON_STACK is defined, it should expand to
4439 something that either saves relevant registers on the stack, or
4440 calls mark_maybe_object passing it each register's contents.
4441
4442 If GC_SAVE_REGISTERS_ON_STACK is not defined, the current
4443 implementation assumes that calling setjmp saves registers we need
4444 to see in a jmp_buf which itself lies on the stack. This doesn't
4445 have to be true! It must be verified for each system, possibly
4446 by taking a look at the source code of setjmp.
4447
4448 Stack Layout
4449
4450 Architectures differ in the way their processor stack is organized.
4451 For example, the stack might look like this
4452
4453 +----------------+
4454 | Lisp_Object | size = 4
4455 +----------------+
4456 | something else | size = 2
4457 +----------------+
4458 | Lisp_Object | size = 4
4459 +----------------+
4460 | ... |
4461
4462 In such a case, not every Lisp_Object will be aligned equally. To
4463 find all Lisp_Object on the stack it won't be sufficient to walk
4464 the stack in steps of 4 bytes. Instead, two passes will be
4465 necessary, one starting at the start of the stack, and a second
4466 pass starting at the start of the stack + 2. Likewise, if the
4467 minimal alignment of Lisp_Objects on the stack is 1, four passes
4468 would be necessary, each one starting with one byte more offset
4469 from the stack start.
4470
4471 The current code assumes by default that Lisp_Objects are aligned
4472 equally on the stack. */
4473
4474 static void
4475 mark_stack ()
4476 {
4477 int i;
4478 /* jmp_buf may not be aligned enough on darwin-ppc64 */
4479 union aligned_jmpbuf {
4480 Lisp_Object o;
4481 jmp_buf j;
4482 } j;
4483 volatile int stack_grows_down_p = (char *) &j > (char *) stack_base;
4484 void *end;
4485
4486 /* This trick flushes the register windows so that all the state of
4487 the process is contained in the stack. */
4488 /* Fixme: Code in the Boehm GC suggests flushing (with `flushrs') is
4489 needed on ia64 too. See mach_dep.c, where it also says inline
4490 assembler doesn't work with relevant proprietary compilers. */
4491 #ifdef __sparc__
4492 #if defined (__sparc64__) && defined (__FreeBSD__)
4493 /* FreeBSD does not have a ta 3 handler. */
4494 asm ("flushw");
4495 #else
4496 asm ("ta 3");
4497 #endif
4498 #endif
4499
4500 /* Save registers that we need to see on the stack. We need to see
4501 registers used to hold register variables and registers used to
4502 pass parameters. */
4503 #ifdef GC_SAVE_REGISTERS_ON_STACK
4504 GC_SAVE_REGISTERS_ON_STACK (end);
4505 #else /* not GC_SAVE_REGISTERS_ON_STACK */
4506
4507 #ifndef GC_SETJMP_WORKS /* If it hasn't been checked yet that
4508 setjmp will definitely work, test it
4509 and print a message with the result
4510 of the test. */
4511 if (!setjmp_tested_p)
4512 {
4513 setjmp_tested_p = 1;
4514 test_setjmp ();
4515 }
4516 #endif /* GC_SETJMP_WORKS */
4517
4518 setjmp (j.j);
4519 end = stack_grows_down_p ? (char *) &j + sizeof j : (char *) &j;
4520 #endif /* not GC_SAVE_REGISTERS_ON_STACK */
4521
4522 /* This assumes that the stack is a contiguous region in memory. If
4523 that's not the case, something has to be done here to iterate
4524 over the stack segments. */
4525 #ifndef GC_LISP_OBJECT_ALIGNMENT
4526 #ifdef __GNUC__
4527 #define GC_LISP_OBJECT_ALIGNMENT __alignof__ (Lisp_Object)
4528 #else
4529 #define GC_LISP_OBJECT_ALIGNMENT sizeof (Lisp_Object)
4530 #endif
4531 #endif
4532 for (i = 0; i < sizeof (Lisp_Object); i += GC_LISP_OBJECT_ALIGNMENT)
4533 mark_memory (stack_base, end, i);
4534 /* Allow for marking a secondary stack, like the register stack on the
4535 ia64. */
4536 #ifdef GC_MARK_SECONDARY_STACK
4537 GC_MARK_SECONDARY_STACK ();
4538 #endif
4539
4540 #if GC_MARK_STACK == GC_MARK_STACK_CHECK_GCPROS
4541 check_gcpros ();
4542 #endif
4543 }
4544
4545 #endif /* GC_MARK_STACK != 0 */
4546
4547
4548 /* Determine whether it is safe to access memory at address P. */
4549 static int
4550 valid_pointer_p (p)
4551 void *p;
4552 {
4553 #ifdef WINDOWSNT
4554 return w32_valid_pointer_p (p, 16);
4555 #else
4556 int fd;
4557
4558 /* Obviously, we cannot just access it (we would SEGV trying), so we
4559 trick the o/s to tell us whether p is a valid pointer.
4560 Unfortunately, we cannot use NULL_DEVICE here, as emacs_write may
4561 not validate p in that case. */
4562
4563 if ((fd = emacs_open ("__Valid__Lisp__Object__", O_CREAT | O_WRONLY | O_TRUNC, 0666)) >= 0)
4564 {
4565 int valid = (emacs_write (fd, (char *)p, 16) == 16);
4566 emacs_close (fd);
4567 unlink ("__Valid__Lisp__Object__");
4568 return valid;
4569 }
4570
4571 return -1;
4572 #endif
4573 }
4574
4575 /* Return 1 if OBJ is a valid lisp object.
4576 Return 0 if OBJ is NOT a valid lisp object.
4577 Return -1 if we cannot validate OBJ.
4578 This function can be quite slow,
4579 so it should only be used in code for manual debugging. */
4580
4581 int
4582 valid_lisp_object_p (obj)
4583 Lisp_Object obj;
4584 {
4585 void *p;
4586 #if GC_MARK_STACK
4587 struct mem_node *m;
4588 #endif
4589
4590 if (INTEGERP (obj))
4591 return 1;
4592
4593 p = (void *) XPNTR (obj);
4594 if (PURE_POINTER_P (p))
4595 return 1;
4596
4597 #if !GC_MARK_STACK
4598 return valid_pointer_p (p);
4599 #else
4600
4601 m = mem_find (p);
4602
4603 if (m == MEM_NIL)
4604 {
4605 int valid = valid_pointer_p (p);
4606 if (valid <= 0)
4607 return valid;
4608
4609 if (SUBRP (obj))
4610 return 1;
4611
4612 return 0;
4613 }
4614
4615 switch (m->type)
4616 {
4617 case MEM_TYPE_NON_LISP:
4618 return 0;
4619
4620 case MEM_TYPE_BUFFER:
4621 return live_buffer_p (m, p);
4622
4623 case MEM_TYPE_CONS:
4624 return live_cons_p (m, p);
4625
4626 case MEM_TYPE_STRING:
4627 return live_string_p (m, p);
4628
4629 case MEM_TYPE_MISC:
4630 return live_misc_p (m, p);
4631
4632 case MEM_TYPE_SYMBOL:
4633 return live_symbol_p (m, p);
4634
4635 case MEM_TYPE_FLOAT:
4636 return live_float_p (m, p);
4637
4638 case MEM_TYPE_VECTORLIKE:
4639 return live_vector_p (m, p);
4640
4641 default:
4642 break;
4643 }
4644
4645 return 0;
4646 #endif
4647 }
4648
4649
4650
4651 \f
4652 /***********************************************************************
4653 Pure Storage Management
4654 ***********************************************************************/
4655
4656 /* Allocate room for SIZE bytes from pure Lisp storage and return a
4657 pointer to it. TYPE is the Lisp type for which the memory is
4658 allocated. TYPE < 0 means it's not used for a Lisp object. */
4659
4660 static POINTER_TYPE *
4661 pure_alloc (size, type)
4662 size_t size;
4663 int type;
4664 {
4665 POINTER_TYPE *result;
4666 #ifdef USE_LSB_TAG
4667 size_t alignment = (1 << GCTYPEBITS);
4668 #else
4669 size_t alignment = sizeof (EMACS_INT);
4670
4671 /* Give Lisp_Floats an extra alignment. */
4672 if (type == Lisp_Float)
4673 {
4674 #if defined __GNUC__ && __GNUC__ >= 2
4675 alignment = __alignof (struct Lisp_Float);
4676 #else
4677 alignment = sizeof (struct Lisp_Float);
4678 #endif
4679 }
4680 #endif
4681
4682 again:
4683 if (type >= 0)
4684 {
4685 /* Allocate space for a Lisp object from the beginning of the free
4686 space with taking account of alignment. */
4687 result = ALIGN (purebeg + pure_bytes_used_lisp, alignment);
4688 pure_bytes_used_lisp = ((char *)result - (char *)purebeg) + size;
4689 }
4690 else
4691 {
4692 /* Allocate space for a non-Lisp object from the end of the free
4693 space. */
4694 pure_bytes_used_non_lisp += size;
4695 result = purebeg + pure_size - pure_bytes_used_non_lisp;
4696 }
4697 pure_bytes_used = pure_bytes_used_lisp + pure_bytes_used_non_lisp;
4698
4699 if (pure_bytes_used <= pure_size)
4700 return result;
4701
4702 /* Don't allocate a large amount here,
4703 because it might get mmap'd and then its address
4704 might not be usable. */
4705 purebeg = (char *) xmalloc (10000);
4706 pure_size = 10000;
4707 pure_bytes_used_before_overflow += pure_bytes_used - size;
4708 pure_bytes_used = 0;
4709 pure_bytes_used_lisp = pure_bytes_used_non_lisp = 0;
4710 goto again;
4711 }
4712
4713
4714 /* Print a warning if PURESIZE is too small. */
4715
4716 void
4717 check_pure_size ()
4718 {
4719 if (pure_bytes_used_before_overflow)
4720 message ("emacs:0:Pure Lisp storage overflow (approx. %d bytes needed)",
4721 (int) (pure_bytes_used + pure_bytes_used_before_overflow));
4722 }
4723
4724
4725 /* Find the byte sequence {DATA[0], ..., DATA[NBYTES-1], '\0'} from
4726 the non-Lisp data pool of the pure storage, and return its start
4727 address. Return NULL if not found. */
4728
4729 static char *
4730 find_string_data_in_pure (data, nbytes)
4731 char *data;
4732 int nbytes;
4733 {
4734 int i, skip, bm_skip[256], last_char_skip, infinity, start, start_max;
4735 unsigned char *p;
4736 char *non_lisp_beg;
4737
4738 if (pure_bytes_used_non_lisp < nbytes + 1)
4739 return NULL;
4740
4741 /* Set up the Boyer-Moore table. */
4742 skip = nbytes + 1;
4743 for (i = 0; i < 256; i++)
4744 bm_skip[i] = skip;
4745
4746 p = (unsigned char *) data;
4747 while (--skip > 0)
4748 bm_skip[*p++] = skip;
4749
4750 last_char_skip = bm_skip['\0'];
4751
4752 non_lisp_beg = purebeg + pure_size - pure_bytes_used_non_lisp;
4753 start_max = pure_bytes_used_non_lisp - (nbytes + 1);
4754
4755 /* See the comments in the function `boyer_moore' (search.c) for the
4756 use of `infinity'. */
4757 infinity = pure_bytes_used_non_lisp + 1;
4758 bm_skip['\0'] = infinity;
4759
4760 p = (unsigned char *) non_lisp_beg + nbytes;
4761 start = 0;
4762 do
4763 {
4764 /* Check the last character (== '\0'). */
4765 do
4766 {
4767 start += bm_skip[*(p + start)];
4768 }
4769 while (start <= start_max);
4770
4771 if (start < infinity)
4772 /* Couldn't find the last character. */
4773 return NULL;
4774
4775 /* No less than `infinity' means we could find the last
4776 character at `p[start - infinity]'. */
4777 start -= infinity;
4778
4779 /* Check the remaining characters. */
4780 if (memcmp (data, non_lisp_beg + start, nbytes) == 0)
4781 /* Found. */
4782 return non_lisp_beg + start;
4783
4784 start += last_char_skip;
4785 }
4786 while (start <= start_max);
4787
4788 return NULL;
4789 }
4790
4791
4792 /* Return a string allocated in pure space. DATA is a buffer holding
4793 NCHARS characters, and NBYTES bytes of string data. MULTIBYTE
4794 non-zero means make the result string multibyte.
4795
4796 Must get an error if pure storage is full, since if it cannot hold
4797 a large string it may be able to hold conses that point to that
4798 string; then the string is not protected from gc. */
4799
4800 Lisp_Object
4801 make_pure_string (data, nchars, nbytes, multibyte)
4802 char *data;
4803 int nchars, nbytes;
4804 int multibyte;
4805 {
4806 Lisp_Object string;
4807 struct Lisp_String *s;
4808
4809 s = (struct Lisp_String *) pure_alloc (sizeof *s, Lisp_String);
4810 s->data = find_string_data_in_pure (data, nbytes);
4811 if (s->data == NULL)
4812 {
4813 s->data = (unsigned char *) pure_alloc (nbytes + 1, -1);
4814 bcopy (data, s->data, nbytes);
4815 s->data[nbytes] = '\0';
4816 }
4817 s->size = nchars;
4818 s->size_byte = multibyte ? nbytes : -1;
4819 s->intervals = NULL_INTERVAL;
4820 XSETSTRING (string, s);
4821 return string;
4822 }
4823
4824
4825 /* Return a cons allocated from pure space. Give it pure copies
4826 of CAR as car and CDR as cdr. */
4827
4828 Lisp_Object
4829 pure_cons (car, cdr)
4830 Lisp_Object car, cdr;
4831 {
4832 register Lisp_Object new;
4833 struct Lisp_Cons *p;
4834
4835 p = (struct Lisp_Cons *) pure_alloc (sizeof *p, Lisp_Cons);
4836 XSETCONS (new, p);
4837 XSETCAR (new, Fpurecopy (car));
4838 XSETCDR (new, Fpurecopy (cdr));
4839 return new;
4840 }
4841
4842
4843 /* Value is a float object with value NUM allocated from pure space. */
4844
4845 static Lisp_Object
4846 make_pure_float (num)
4847 double num;
4848 {
4849 register Lisp_Object new;
4850 struct Lisp_Float *p;
4851
4852 p = (struct Lisp_Float *) pure_alloc (sizeof *p, Lisp_Float);
4853 XSETFLOAT (new, p);
4854 XFLOAT_INIT (new, num);
4855 return new;
4856 }
4857
4858
4859 /* Return a vector with room for LEN Lisp_Objects allocated from
4860 pure space. */
4861
4862 Lisp_Object
4863 make_pure_vector (len)
4864 EMACS_INT len;
4865 {
4866 Lisp_Object new;
4867 struct Lisp_Vector *p;
4868 size_t size = sizeof *p + (len - 1) * sizeof (Lisp_Object);
4869
4870 p = (struct Lisp_Vector *) pure_alloc (size, Lisp_Vectorlike);
4871 XSETVECTOR (new, p);
4872 XVECTOR (new)->size = len;
4873 return new;
4874 }
4875
4876
4877 DEFUN ("purecopy", Fpurecopy, Spurecopy, 1, 1, 0,
4878 doc: /* Make a copy of object OBJ in pure storage.
4879 Recursively copies contents of vectors and cons cells.
4880 Does not copy symbols. Copies strings without text properties. */)
4881 (obj)
4882 register Lisp_Object obj;
4883 {
4884 if (NILP (Vpurify_flag))
4885 return obj;
4886
4887 if (PURE_POINTER_P (XPNTR (obj)))
4888 return obj;
4889
4890 if (CONSP (obj))
4891 return pure_cons (XCAR (obj), XCDR (obj));
4892 else if (FLOATP (obj))
4893 return make_pure_float (XFLOAT_DATA (obj));
4894 else if (STRINGP (obj))
4895 return make_pure_string (SDATA (obj), SCHARS (obj),
4896 SBYTES (obj),
4897 STRING_MULTIBYTE (obj));
4898 else if (COMPILEDP (obj) || VECTORP (obj))
4899 {
4900 register struct Lisp_Vector *vec;
4901 register int i;
4902 EMACS_INT size;
4903
4904 size = XVECTOR (obj)->size;
4905 if (size & PSEUDOVECTOR_FLAG)
4906 size &= PSEUDOVECTOR_SIZE_MASK;
4907 vec = XVECTOR (make_pure_vector (size));
4908 for (i = 0; i < size; i++)
4909 vec->contents[i] = Fpurecopy (XVECTOR (obj)->contents[i]);
4910 if (COMPILEDP (obj))
4911 {
4912 XSETPVECTYPE (vec, PVEC_COMPILED);
4913 XSETCOMPILED (obj, vec);
4914 }
4915 else
4916 XSETVECTOR (obj, vec);
4917 return obj;
4918 }
4919 else if (MARKERP (obj))
4920 error ("Attempt to copy a marker to pure storage");
4921
4922 return obj;
4923 }
4924
4925
4926 \f
4927 /***********************************************************************
4928 Protection from GC
4929 ***********************************************************************/
4930
4931 /* Put an entry in staticvec, pointing at the variable with address
4932 VARADDRESS. */
4933
4934 void
4935 staticpro (varaddress)
4936 Lisp_Object *varaddress;
4937 {
4938 staticvec[staticidx++] = varaddress;
4939 if (staticidx >= NSTATICS)
4940 abort ();
4941 }
4942
4943 \f
4944 /***********************************************************************
4945 Protection from GC
4946 ***********************************************************************/
4947
4948 /* Temporarily prevent garbage collection. */
4949
4950 int
4951 inhibit_garbage_collection ()
4952 {
4953 int count = SPECPDL_INDEX ();
4954 int nbits = min (VALBITS, BITS_PER_INT);
4955
4956 specbind (Qgc_cons_threshold, make_number (((EMACS_INT) 1 << (nbits - 1)) - 1));
4957 return count;
4958 }
4959
4960
4961 DEFUN ("garbage-collect", Fgarbage_collect, Sgarbage_collect, 0, 0, "",
4962 doc: /* Reclaim storage for Lisp objects no longer needed.
4963 Garbage collection happens automatically if you cons more than
4964 `gc-cons-threshold' bytes of Lisp data since previous garbage collection.
4965 `garbage-collect' normally returns a list with info on amount of space in use:
4966 ((USED-CONSES . FREE-CONSES) (USED-SYMS . FREE-SYMS)
4967 (USED-MARKERS . FREE-MARKERS) USED-STRING-CHARS USED-VECTOR-SLOTS
4968 (USED-FLOATS . FREE-FLOATS) (USED-INTERVALS . FREE-INTERVALS)
4969 (USED-STRINGS . FREE-STRINGS))
4970 However, if there was overflow in pure space, `garbage-collect'
4971 returns nil, because real GC can't be done. */)
4972 ()
4973 {
4974 register struct specbinding *bind;
4975 struct catchtag *catch;
4976 struct handler *handler;
4977 char stack_top_variable;
4978 register int i;
4979 int message_p;
4980 Lisp_Object total[8];
4981 int count = SPECPDL_INDEX ();
4982 EMACS_TIME t1, t2, t3;
4983
4984 if (abort_on_gc)
4985 abort ();
4986
4987 /* Can't GC if pure storage overflowed because we can't determine
4988 if something is a pure object or not. */
4989 if (pure_bytes_used_before_overflow)
4990 return Qnil;
4991
4992 CHECK_CONS_LIST ();
4993
4994 /* Don't keep undo information around forever.
4995 Do this early on, so it is no problem if the user quits. */
4996 {
4997 register struct buffer *nextb = all_buffers;
4998
4999 while (nextb)
5000 {
5001 /* If a buffer's undo list is Qt, that means that undo is
5002 turned off in that buffer. Calling truncate_undo_list on
5003 Qt tends to return NULL, which effectively turns undo back on.
5004 So don't call truncate_undo_list if undo_list is Qt. */
5005 if (! NILP (nextb->name) && ! EQ (nextb->undo_list, Qt))
5006 truncate_undo_list (nextb);
5007
5008 /* Shrink buffer gaps, but skip indirect and dead buffers. */
5009 if (nextb->base_buffer == 0 && !NILP (nextb->name)
5010 && ! nextb->text->inhibit_shrinking)
5011 {
5012 /* If a buffer's gap size is more than 10% of the buffer
5013 size, or larger than 2000 bytes, then shrink it
5014 accordingly. Keep a minimum size of 20 bytes. */
5015 int size = min (2000, max (20, (nextb->text->z_byte / 10)));
5016
5017 if (nextb->text->gap_size > size)
5018 {
5019 struct buffer *save_current = current_buffer;
5020 current_buffer = nextb;
5021 make_gap (-(nextb->text->gap_size - size));
5022 current_buffer = save_current;
5023 }
5024 }
5025
5026 nextb = nextb->next;
5027 }
5028 }
5029
5030 EMACS_GET_TIME (t1);
5031
5032 /* In case user calls debug_print during GC,
5033 don't let that cause a recursive GC. */
5034 consing_since_gc = 0;
5035
5036 /* Save what's currently displayed in the echo area. */
5037 message_p = push_message ();
5038 record_unwind_protect (pop_message_unwind, Qnil);
5039
5040 /* Save a copy of the contents of the stack, for debugging. */
5041 #if MAX_SAVE_STACK > 0
5042 if (NILP (Vpurify_flag))
5043 {
5044 i = &stack_top_variable - stack_bottom;
5045 if (i < 0) i = -i;
5046 if (i < MAX_SAVE_STACK)
5047 {
5048 if (stack_copy == 0)
5049 stack_copy = (char *) xmalloc (stack_copy_size = i);
5050 else if (stack_copy_size < i)
5051 stack_copy = (char *) xrealloc (stack_copy, (stack_copy_size = i));
5052 if (stack_copy)
5053 {
5054 if ((EMACS_INT) (&stack_top_variable - stack_bottom) > 0)
5055 bcopy (stack_bottom, stack_copy, i);
5056 else
5057 bcopy (&stack_top_variable, stack_copy, i);
5058 }
5059 }
5060 }
5061 #endif /* MAX_SAVE_STACK > 0 */
5062
5063 if (garbage_collection_messages)
5064 message1_nolog ("Garbage collecting...");
5065
5066 BLOCK_INPUT;
5067
5068 shrink_regexp_cache ();
5069
5070 gc_in_progress = 1;
5071
5072 /* clear_marks (); */
5073
5074 /* Mark all the special slots that serve as the roots of accessibility. */
5075
5076 for (i = 0; i < staticidx; i++)
5077 mark_object (*staticvec[i]);
5078
5079 for (bind = specpdl; bind != specpdl_ptr; bind++)
5080 {
5081 mark_object (bind->symbol);
5082 mark_object (bind->old_value);
5083 }
5084 mark_terminals ();
5085 mark_kboards ();
5086 mark_ttys ();
5087
5088 #ifdef USE_GTK
5089 {
5090 extern void xg_mark_data ();
5091 xg_mark_data ();
5092 }
5093 #endif
5094
5095 #if (GC_MARK_STACK == GC_MAKE_GCPROS_NOOPS \
5096 || GC_MARK_STACK == GC_MARK_STACK_CHECK_GCPROS)
5097 mark_stack ();
5098 #else
5099 {
5100 register struct gcpro *tail;
5101 for (tail = gcprolist; tail; tail = tail->next)
5102 for (i = 0; i < tail->nvars; i++)
5103 mark_object (tail->var[i]);
5104 }
5105 #endif
5106
5107 mark_byte_stack ();
5108 for (catch = catchlist; catch; catch = catch->next)
5109 {
5110 mark_object (catch->tag);
5111 mark_object (catch->val);
5112 }
5113 for (handler = handlerlist; handler; handler = handler->next)
5114 {
5115 mark_object (handler->handler);
5116 mark_object (handler->var);
5117 }
5118 mark_backtrace ();
5119
5120 #ifdef HAVE_WINDOW_SYSTEM
5121 mark_fringe_data ();
5122 #endif
5123
5124 #if GC_MARK_STACK == GC_USE_GCPROS_CHECK_ZOMBIES
5125 mark_stack ();
5126 #endif
5127
5128 /* Everything is now marked, except for the things that require special
5129 finalization, i.e. the undo_list.
5130 Look thru every buffer's undo list
5131 for elements that update markers that were not marked,
5132 and delete them. */
5133 {
5134 register struct buffer *nextb = all_buffers;
5135
5136 while (nextb)
5137 {
5138 /* If a buffer's undo list is Qt, that means that undo is
5139 turned off in that buffer. Calling truncate_undo_list on
5140 Qt tends to return NULL, which effectively turns undo back on.
5141 So don't call truncate_undo_list if undo_list is Qt. */
5142 if (! EQ (nextb->undo_list, Qt))
5143 {
5144 Lisp_Object tail, prev;
5145 tail = nextb->undo_list;
5146 prev = Qnil;
5147 while (CONSP (tail))
5148 {
5149 if (CONSP (XCAR (tail))
5150 && MARKERP (XCAR (XCAR (tail)))
5151 && !XMARKER (XCAR (XCAR (tail)))->gcmarkbit)
5152 {
5153 if (NILP (prev))
5154 nextb->undo_list = tail = XCDR (tail);
5155 else
5156 {
5157 tail = XCDR (tail);
5158 XSETCDR (prev, tail);
5159 }
5160 }
5161 else
5162 {
5163 prev = tail;
5164 tail = XCDR (tail);
5165 }
5166 }
5167 }
5168 /* Now that we have stripped the elements that need not be in the
5169 undo_list any more, we can finally mark the list. */
5170 mark_object (nextb->undo_list);
5171
5172 nextb = nextb->next;
5173 }
5174 }
5175
5176 gc_sweep ();
5177
5178 /* Clear the mark bits that we set in certain root slots. */
5179
5180 unmark_byte_stack ();
5181 VECTOR_UNMARK (&buffer_defaults);
5182 VECTOR_UNMARK (&buffer_local_symbols);
5183
5184 #if GC_MARK_STACK == GC_USE_GCPROS_CHECK_ZOMBIES && 0
5185 dump_zombies ();
5186 #endif
5187
5188 UNBLOCK_INPUT;
5189
5190 CHECK_CONS_LIST ();
5191
5192 /* clear_marks (); */
5193 gc_in_progress = 0;
5194
5195 consing_since_gc = 0;
5196 if (gc_cons_threshold < 10000)
5197 gc_cons_threshold = 10000;
5198
5199 if (FLOATP (Vgc_cons_percentage))
5200 { /* Set gc_cons_combined_threshold. */
5201 EMACS_INT total = 0;
5202
5203 total += total_conses * sizeof (struct Lisp_Cons);
5204 total += total_symbols * sizeof (struct Lisp_Symbol);
5205 total += total_markers * sizeof (union Lisp_Misc);
5206 total += total_string_size;
5207 total += total_vector_size * sizeof (Lisp_Object);
5208 total += total_floats * sizeof (struct Lisp_Float);
5209 total += total_intervals * sizeof (struct interval);
5210 total += total_strings * sizeof (struct Lisp_String);
5211
5212 gc_relative_threshold = total * XFLOAT_DATA (Vgc_cons_percentage);
5213 }
5214 else
5215 gc_relative_threshold = 0;
5216
5217 if (garbage_collection_messages)
5218 {
5219 if (message_p || minibuf_level > 0)
5220 restore_message ();
5221 else
5222 message1_nolog ("Garbage collecting...done");
5223 }
5224
5225 unbind_to (count, Qnil);
5226
5227 total[0] = Fcons (make_number (total_conses),
5228 make_number (total_free_conses));
5229 total[1] = Fcons (make_number (total_symbols),
5230 make_number (total_free_symbols));
5231 total[2] = Fcons (make_number (total_markers),
5232 make_number (total_free_markers));
5233 total[3] = make_number (total_string_size);
5234 total[4] = make_number (total_vector_size);
5235 total[5] = Fcons (make_number (total_floats),
5236 make_number (total_free_floats));
5237 total[6] = Fcons (make_number (total_intervals),
5238 make_number (total_free_intervals));
5239 total[7] = Fcons (make_number (total_strings),
5240 make_number (total_free_strings));
5241
5242 #if GC_MARK_STACK == GC_USE_GCPROS_CHECK_ZOMBIES
5243 {
5244 /* Compute average percentage of zombies. */
5245 double nlive = 0;
5246
5247 for (i = 0; i < 7; ++i)
5248 if (CONSP (total[i]))
5249 nlive += XFASTINT (XCAR (total[i]));
5250
5251 avg_live = (avg_live * ngcs + nlive) / (ngcs + 1);
5252 max_live = max (nlive, max_live);
5253 avg_zombies = (avg_zombies * ngcs + nzombies) / (ngcs + 1);
5254 max_zombies = max (nzombies, max_zombies);
5255 ++ngcs;
5256 }
5257 #endif
5258
5259 if (!NILP (Vpost_gc_hook))
5260 {
5261 int count = inhibit_garbage_collection ();
5262 safe_run_hooks (Qpost_gc_hook);
5263 unbind_to (count, Qnil);
5264 }
5265
5266 /* Accumulate statistics. */
5267 EMACS_GET_TIME (t2);
5268 EMACS_SUB_TIME (t3, t2, t1);
5269 if (FLOATP (Vgc_elapsed))
5270 Vgc_elapsed = make_float (XFLOAT_DATA (Vgc_elapsed) +
5271 EMACS_SECS (t3) +
5272 EMACS_USECS (t3) * 1.0e-6);
5273 gcs_done++;
5274
5275 return Flist (sizeof total / sizeof *total, total);
5276 }
5277
5278
5279 /* Mark Lisp objects in glyph matrix MATRIX. Currently the
5280 only interesting objects referenced from glyphs are strings. */
5281
5282 static void
5283 mark_glyph_matrix (matrix)
5284 struct glyph_matrix *matrix;
5285 {
5286 struct glyph_row *row = matrix->rows;
5287 struct glyph_row *end = row + matrix->nrows;
5288
5289 for (; row < end; ++row)
5290 if (row->enabled_p)
5291 {
5292 int area;
5293 for (area = LEFT_MARGIN_AREA; area < LAST_AREA; ++area)
5294 {
5295 struct glyph *glyph = row->glyphs[area];
5296 struct glyph *end_glyph = glyph + row->used[area];
5297
5298 for (; glyph < end_glyph; ++glyph)
5299 if (STRINGP (glyph->object)
5300 && !STRING_MARKED_P (XSTRING (glyph->object)))
5301 mark_object (glyph->object);
5302 }
5303 }
5304 }
5305
5306
5307 /* Mark Lisp faces in the face cache C. */
5308
5309 static void
5310 mark_face_cache (c)
5311 struct face_cache *c;
5312 {
5313 if (c)
5314 {
5315 int i, j;
5316 for (i = 0; i < c->used; ++i)
5317 {
5318 struct face *face = FACE_FROM_ID (c->f, i);
5319
5320 if (face)
5321 {
5322 for (j = 0; j < LFACE_VECTOR_SIZE; ++j)
5323 mark_object (face->lface[j]);
5324 }
5325 }
5326 }
5327 }
5328
5329
5330 \f
5331 /* Mark reference to a Lisp_Object.
5332 If the object referred to has not been seen yet, recursively mark
5333 all the references contained in it. */
5334
5335 #define LAST_MARKED_SIZE 500
5336 static Lisp_Object last_marked[LAST_MARKED_SIZE];
5337 int last_marked_index;
5338
5339 /* For debugging--call abort when we cdr down this many
5340 links of a list, in mark_object. In debugging,
5341 the call to abort will hit a breakpoint.
5342 Normally this is zero and the check never goes off. */
5343 static int mark_object_loop_halt;
5344
5345 /* Return non-zero if the object was not yet marked. */
5346 static int
5347 mark_vectorlike (ptr)
5348 struct Lisp_Vector *ptr;
5349 {
5350 register EMACS_INT size = ptr->size;
5351 register int i;
5352
5353 if (VECTOR_MARKED_P (ptr))
5354 return 0; /* Already marked */
5355 VECTOR_MARK (ptr); /* Else mark it */
5356 if (size & PSEUDOVECTOR_FLAG)
5357 size &= PSEUDOVECTOR_SIZE_MASK;
5358
5359 /* Note that this size is not the memory-footprint size, but only
5360 the number of Lisp_Object fields that we should trace.
5361 The distinction is used e.g. by Lisp_Process which places extra
5362 non-Lisp_Object fields at the end of the structure. */
5363 for (i = 0; i < size; i++) /* and then mark its elements */
5364 mark_object (ptr->contents[i]);
5365 return 1;
5366 }
5367
5368 /* Like mark_vectorlike but optimized for char-tables (and
5369 sub-char-tables) assuming that the contents are mostly integers or
5370 symbols. */
5371
5372 static void
5373 mark_char_table (ptr)
5374 struct Lisp_Vector *ptr;
5375 {
5376 register EMACS_INT size = ptr->size & PSEUDOVECTOR_SIZE_MASK;
5377 register int i;
5378
5379 VECTOR_MARK (ptr);
5380 for (i = 0; i < size; i++)
5381 {
5382 Lisp_Object val = ptr->contents[i];
5383
5384 if (INTEGERP (val) || SYMBOLP (val) && XSYMBOL (val)->gcmarkbit)
5385 continue;
5386 if (SUB_CHAR_TABLE_P (val))
5387 {
5388 if (! VECTOR_MARKED_P (XVECTOR (val)))
5389 mark_char_table (XVECTOR (val));
5390 }
5391 else
5392 mark_object (val);
5393 }
5394 }
5395
5396 void
5397 mark_object (arg)
5398 Lisp_Object arg;
5399 {
5400 register Lisp_Object obj = arg;
5401 #ifdef GC_CHECK_MARKED_OBJECTS
5402 void *po;
5403 struct mem_node *m;
5404 #endif
5405 int cdr_count = 0;
5406
5407 loop:
5408
5409 if (PURE_POINTER_P (XPNTR (obj)))
5410 return;
5411
5412 last_marked[last_marked_index++] = obj;
5413 if (last_marked_index == LAST_MARKED_SIZE)
5414 last_marked_index = 0;
5415
5416 /* Perform some sanity checks on the objects marked here. Abort if
5417 we encounter an object we know is bogus. This increases GC time
5418 by ~80%, and requires compilation with GC_MARK_STACK != 0. */
5419 #ifdef GC_CHECK_MARKED_OBJECTS
5420
5421 po = (void *) XPNTR (obj);
5422
5423 /* Check that the object pointed to by PO is known to be a Lisp
5424 structure allocated from the heap. */
5425 #define CHECK_ALLOCATED() \
5426 do { \
5427 m = mem_find (po); \
5428 if (m == MEM_NIL) \
5429 abort (); \
5430 } while (0)
5431
5432 /* Check that the object pointed to by PO is live, using predicate
5433 function LIVEP. */
5434 #define CHECK_LIVE(LIVEP) \
5435 do { \
5436 if (!LIVEP (m, po)) \
5437 abort (); \
5438 } while (0)
5439
5440 /* Check both of the above conditions. */
5441 #define CHECK_ALLOCATED_AND_LIVE(LIVEP) \
5442 do { \
5443 CHECK_ALLOCATED (); \
5444 CHECK_LIVE (LIVEP); \
5445 } while (0) \
5446
5447 #else /* not GC_CHECK_MARKED_OBJECTS */
5448
5449 #define CHECK_ALLOCATED() (void) 0
5450 #define CHECK_LIVE(LIVEP) (void) 0
5451 #define CHECK_ALLOCATED_AND_LIVE(LIVEP) (void) 0
5452
5453 #endif /* not GC_CHECK_MARKED_OBJECTS */
5454
5455 switch (SWITCH_ENUM_CAST (XTYPE (obj)))
5456 {
5457 case Lisp_String:
5458 {
5459 register struct Lisp_String *ptr = XSTRING (obj);
5460 CHECK_ALLOCATED_AND_LIVE (live_string_p);
5461 MARK_INTERVAL_TREE (ptr->intervals);
5462 MARK_STRING (ptr);
5463 #ifdef GC_CHECK_STRING_BYTES
5464 /* Check that the string size recorded in the string is the
5465 same as the one recorded in the sdata structure. */
5466 CHECK_STRING_BYTES (ptr);
5467 #endif /* GC_CHECK_STRING_BYTES */
5468 }
5469 break;
5470
5471 case Lisp_Vectorlike:
5472 #ifdef GC_CHECK_MARKED_OBJECTS
5473 m = mem_find (po);
5474 if (m == MEM_NIL && !SUBRP (obj)
5475 && po != &buffer_defaults
5476 && po != &buffer_local_symbols)
5477 abort ();
5478 #endif /* GC_CHECK_MARKED_OBJECTS */
5479
5480 if (BUFFERP (obj))
5481 {
5482 if (!VECTOR_MARKED_P (XBUFFER (obj)))
5483 {
5484 #ifdef GC_CHECK_MARKED_OBJECTS
5485 if (po != &buffer_defaults && po != &buffer_local_symbols)
5486 {
5487 struct buffer *b;
5488 for (b = all_buffers; b && b != po; b = b->next)
5489 ;
5490 if (b == NULL)
5491 abort ();
5492 }
5493 #endif /* GC_CHECK_MARKED_OBJECTS */
5494 mark_buffer (obj);
5495 }
5496 }
5497 else if (SUBRP (obj))
5498 break;
5499 else if (COMPILEDP (obj))
5500 /* We could treat this just like a vector, but it is better to
5501 save the COMPILED_CONSTANTS element for last and avoid
5502 recursion there. */
5503 {
5504 register struct Lisp_Vector *ptr = XVECTOR (obj);
5505 register EMACS_INT size = ptr->size;
5506 register int i;
5507
5508 if (VECTOR_MARKED_P (ptr))
5509 break; /* Already marked */
5510
5511 CHECK_LIVE (live_vector_p);
5512 VECTOR_MARK (ptr); /* Else mark it */
5513 size &= PSEUDOVECTOR_SIZE_MASK;
5514 for (i = 0; i < size; i++) /* and then mark its elements */
5515 {
5516 if (i != COMPILED_CONSTANTS)
5517 mark_object (ptr->contents[i]);
5518 }
5519 obj = ptr->contents[COMPILED_CONSTANTS];
5520 goto loop;
5521 }
5522 else if (FRAMEP (obj))
5523 {
5524 register struct frame *ptr = XFRAME (obj);
5525 if (mark_vectorlike (XVECTOR (obj)))
5526 mark_face_cache (ptr->face_cache);
5527 }
5528 else if (WINDOWP (obj))
5529 {
5530 register struct Lisp_Vector *ptr = XVECTOR (obj);
5531 struct window *w = XWINDOW (obj);
5532 if (mark_vectorlike (ptr))
5533 {
5534 /* Mark glyphs for leaf windows. Marking window matrices is
5535 sufficient because frame matrices use the same glyph
5536 memory. */
5537 if (NILP (w->hchild)
5538 && NILP (w->vchild)
5539 && w->current_matrix)
5540 {
5541 mark_glyph_matrix (w->current_matrix);
5542 mark_glyph_matrix (w->desired_matrix);
5543 }
5544 }
5545 }
5546 else if (HASH_TABLE_P (obj))
5547 {
5548 struct Lisp_Hash_Table *h = XHASH_TABLE (obj);
5549 if (mark_vectorlike ((struct Lisp_Vector *)h))
5550 { /* If hash table is not weak, mark all keys and values.
5551 For weak tables, mark only the vector. */
5552 if (NILP (h->weak))
5553 mark_object (h->key_and_value);
5554 else
5555 VECTOR_MARK (XVECTOR (h->key_and_value));
5556 }
5557 }
5558 else if (CHAR_TABLE_P (obj))
5559 {
5560 if (! VECTOR_MARKED_P (XVECTOR (obj)))
5561 mark_char_table (XVECTOR (obj));
5562 }
5563 else
5564 mark_vectorlike (XVECTOR (obj));
5565 break;
5566
5567 case Lisp_Symbol:
5568 {
5569 register struct Lisp_Symbol *ptr = XSYMBOL (obj);
5570 struct Lisp_Symbol *ptrx;
5571
5572 if (ptr->gcmarkbit) break;
5573 CHECK_ALLOCATED_AND_LIVE (live_symbol_p);
5574 ptr->gcmarkbit = 1;
5575 mark_object (ptr->value);
5576 mark_object (ptr->function);
5577 mark_object (ptr->plist);
5578
5579 if (!PURE_POINTER_P (XSTRING (ptr->xname)))
5580 MARK_STRING (XSTRING (ptr->xname));
5581 MARK_INTERVAL_TREE (STRING_INTERVALS (ptr->xname));
5582
5583 /* Note that we do not mark the obarray of the symbol.
5584 It is safe not to do so because nothing accesses that
5585 slot except to check whether it is nil. */
5586 ptr = ptr->next;
5587 if (ptr)
5588 {
5589 ptrx = ptr; /* Use of ptrx avoids compiler bug on Sun */
5590 XSETSYMBOL (obj, ptrx);
5591 goto loop;
5592 }
5593 }
5594 break;
5595
5596 case Lisp_Misc:
5597 CHECK_ALLOCATED_AND_LIVE (live_misc_p);
5598 if (XMISCANY (obj)->gcmarkbit)
5599 break;
5600 XMISCANY (obj)->gcmarkbit = 1;
5601
5602 switch (XMISCTYPE (obj))
5603 {
5604 case Lisp_Misc_Buffer_Local_Value:
5605 {
5606 register struct Lisp_Buffer_Local_Value *ptr
5607 = XBUFFER_LOCAL_VALUE (obj);
5608 /* If the cdr is nil, avoid recursion for the car. */
5609 if (EQ (ptr->cdr, Qnil))
5610 {
5611 obj = ptr->realvalue;
5612 goto loop;
5613 }
5614 mark_object (ptr->realvalue);
5615 mark_object (ptr->buffer);
5616 mark_object (ptr->frame);
5617 obj = ptr->cdr;
5618 goto loop;
5619 }
5620
5621 case Lisp_Misc_Marker:
5622 /* DO NOT mark thru the marker's chain.
5623 The buffer's markers chain does not preserve markers from gc;
5624 instead, markers are removed from the chain when freed by gc. */
5625 break;
5626
5627 case Lisp_Misc_Intfwd:
5628 case Lisp_Misc_Boolfwd:
5629 case Lisp_Misc_Objfwd:
5630 case Lisp_Misc_Buffer_Objfwd:
5631 case Lisp_Misc_Kboard_Objfwd:
5632 /* Don't bother with Lisp_Buffer_Objfwd,
5633 since all markable slots in current buffer marked anyway. */
5634 /* Don't need to do Lisp_Objfwd, since the places they point
5635 are protected with staticpro. */
5636 break;
5637
5638 case Lisp_Misc_Save_Value:
5639 #if GC_MARK_STACK
5640 {
5641 register struct Lisp_Save_Value *ptr = XSAVE_VALUE (obj);
5642 /* If DOGC is set, POINTER is the address of a memory
5643 area containing INTEGER potential Lisp_Objects. */
5644 if (ptr->dogc)
5645 {
5646 Lisp_Object *p = (Lisp_Object *) ptr->pointer;
5647 int nelt;
5648 for (nelt = ptr->integer; nelt > 0; nelt--, p++)
5649 mark_maybe_object (*p);
5650 }
5651 }
5652 #endif
5653 break;
5654
5655 case Lisp_Misc_Overlay:
5656 {
5657 struct Lisp_Overlay *ptr = XOVERLAY (obj);
5658 mark_object (ptr->start);
5659 mark_object (ptr->end);
5660 mark_object (ptr->plist);
5661 if (ptr->next)
5662 {
5663 XSETMISC (obj, ptr->next);
5664 goto loop;
5665 }
5666 }
5667 break;
5668
5669 default:
5670 abort ();
5671 }
5672 break;
5673
5674 case Lisp_Cons:
5675 {
5676 register struct Lisp_Cons *ptr = XCONS (obj);
5677 if (CONS_MARKED_P (ptr)) break;
5678 CHECK_ALLOCATED_AND_LIVE (live_cons_p);
5679 CONS_MARK (ptr);
5680 /* If the cdr is nil, avoid recursion for the car. */
5681 if (EQ (ptr->u.cdr, Qnil))
5682 {
5683 obj = ptr->car;
5684 cdr_count = 0;
5685 goto loop;
5686 }
5687 mark_object (ptr->car);
5688 obj = ptr->u.cdr;
5689 cdr_count++;
5690 if (cdr_count == mark_object_loop_halt)
5691 abort ();
5692 goto loop;
5693 }
5694
5695 case Lisp_Float:
5696 CHECK_ALLOCATED_AND_LIVE (live_float_p);
5697 FLOAT_MARK (XFLOAT (obj));
5698 break;
5699
5700 case Lisp_Int:
5701 break;
5702
5703 default:
5704 abort ();
5705 }
5706
5707 #undef CHECK_LIVE
5708 #undef CHECK_ALLOCATED
5709 #undef CHECK_ALLOCATED_AND_LIVE
5710 }
5711
5712 /* Mark the pointers in a buffer structure. */
5713
5714 static void
5715 mark_buffer (buf)
5716 Lisp_Object buf;
5717 {
5718 register struct buffer *buffer = XBUFFER (buf);
5719 register Lisp_Object *ptr, tmp;
5720 Lisp_Object base_buffer;
5721
5722 VECTOR_MARK (buffer);
5723
5724 MARK_INTERVAL_TREE (BUF_INTERVALS (buffer));
5725
5726 /* For now, we just don't mark the undo_list. It's done later in
5727 a special way just before the sweep phase, and after stripping
5728 some of its elements that are not needed any more. */
5729
5730 if (buffer->overlays_before)
5731 {
5732 XSETMISC (tmp, buffer->overlays_before);
5733 mark_object (tmp);
5734 }
5735 if (buffer->overlays_after)
5736 {
5737 XSETMISC (tmp, buffer->overlays_after);
5738 mark_object (tmp);
5739 }
5740
5741 /* buffer-local Lisp variables start at `undo_list',
5742 tho only the ones from `name' on are GC'd normally. */
5743 for (ptr = &buffer->name;
5744 (char *)ptr < (char *)buffer + sizeof (struct buffer);
5745 ptr++)
5746 mark_object (*ptr);
5747
5748 /* If this is an indirect buffer, mark its base buffer. */
5749 if (buffer->base_buffer && !VECTOR_MARKED_P (buffer->base_buffer))
5750 {
5751 XSETBUFFER (base_buffer, buffer->base_buffer);
5752 mark_buffer (base_buffer);
5753 }
5754 }
5755
5756 /* Mark the Lisp pointers in the terminal objects.
5757 Called by the Fgarbage_collector. */
5758
5759 static void
5760 mark_terminals (void)
5761 {
5762 struct terminal *t;
5763 for (t = terminal_list; t; t = t->next_terminal)
5764 {
5765 eassert (t->name != NULL);
5766 #ifdef HAVE_WINDOW_SYSTEM
5767 mark_image_cache (t->image_cache);
5768 #endif /* HAVE_WINDOW_SYSTEM */
5769 mark_vectorlike ((struct Lisp_Vector *)t);
5770 }
5771 }
5772
5773
5774
5775 /* Value is non-zero if OBJ will survive the current GC because it's
5776 either marked or does not need to be marked to survive. */
5777
5778 int
5779 survives_gc_p (obj)
5780 Lisp_Object obj;
5781 {
5782 int survives_p;
5783
5784 switch (XTYPE (obj))
5785 {
5786 case Lisp_Int:
5787 survives_p = 1;
5788 break;
5789
5790 case Lisp_Symbol:
5791 survives_p = XSYMBOL (obj)->gcmarkbit;
5792 break;
5793
5794 case Lisp_Misc:
5795 survives_p = XMISCANY (obj)->gcmarkbit;
5796 break;
5797
5798 case Lisp_String:
5799 survives_p = STRING_MARKED_P (XSTRING (obj));
5800 break;
5801
5802 case Lisp_Vectorlike:
5803 survives_p = SUBRP (obj) || VECTOR_MARKED_P (XVECTOR (obj));
5804 break;
5805
5806 case Lisp_Cons:
5807 survives_p = CONS_MARKED_P (XCONS (obj));
5808 break;
5809
5810 case Lisp_Float:
5811 survives_p = FLOAT_MARKED_P (XFLOAT (obj));
5812 break;
5813
5814 default:
5815 abort ();
5816 }
5817
5818 return survives_p || PURE_POINTER_P ((void *) XPNTR (obj));
5819 }
5820
5821
5822 \f
5823 /* Sweep: find all structures not marked, and free them. */
5824
5825 static void
5826 gc_sweep ()
5827 {
5828 /* Remove or mark entries in weak hash tables.
5829 This must be done before any object is unmarked. */
5830 sweep_weak_hash_tables ();
5831
5832 sweep_strings ();
5833 #ifdef GC_CHECK_STRING_BYTES
5834 if (!noninteractive)
5835 check_string_bytes (1);
5836 #endif
5837
5838 /* Put all unmarked conses on free list */
5839 {
5840 register struct cons_block *cblk;
5841 struct cons_block **cprev = &cons_block;
5842 register int lim = cons_block_index;
5843 register int num_free = 0, num_used = 0;
5844
5845 cons_free_list = 0;
5846
5847 for (cblk = cons_block; cblk; cblk = *cprev)
5848 {
5849 register int i = 0;
5850 int this_free = 0;
5851 int ilim = (lim + BITS_PER_INT - 1) / BITS_PER_INT;
5852
5853 /* Scan the mark bits an int at a time. */
5854 for (i = 0; i <= ilim; i++)
5855 {
5856 if (cblk->gcmarkbits[i] == -1)
5857 {
5858 /* Fast path - all cons cells for this int are marked. */
5859 cblk->gcmarkbits[i] = 0;
5860 num_used += BITS_PER_INT;
5861 }
5862 else
5863 {
5864 /* Some cons cells for this int are not marked.
5865 Find which ones, and free them. */
5866 int start, pos, stop;
5867
5868 start = i * BITS_PER_INT;
5869 stop = lim - start;
5870 if (stop > BITS_PER_INT)
5871 stop = BITS_PER_INT;
5872 stop += start;
5873
5874 for (pos = start; pos < stop; pos++)
5875 {
5876 if (!CONS_MARKED_P (&cblk->conses[pos]))
5877 {
5878 this_free++;
5879 cblk->conses[pos].u.chain = cons_free_list;
5880 cons_free_list = &cblk->conses[pos];
5881 #if GC_MARK_STACK
5882 cons_free_list->car = Vdead;
5883 #endif
5884 }
5885 else
5886 {
5887 num_used++;
5888 CONS_UNMARK (&cblk->conses[pos]);
5889 }
5890 }
5891 }
5892 }
5893
5894 lim = CONS_BLOCK_SIZE;
5895 /* If this block contains only free conses and we have already
5896 seen more than two blocks worth of free conses then deallocate
5897 this block. */
5898 if (this_free == CONS_BLOCK_SIZE && num_free > CONS_BLOCK_SIZE)
5899 {
5900 *cprev = cblk->next;
5901 /* Unhook from the free list. */
5902 cons_free_list = cblk->conses[0].u.chain;
5903 lisp_align_free (cblk);
5904 n_cons_blocks--;
5905 }
5906 else
5907 {
5908 num_free += this_free;
5909 cprev = &cblk->next;
5910 }
5911 }
5912 total_conses = num_used;
5913 total_free_conses = num_free;
5914 }
5915
5916 /* Put all unmarked floats on free list */
5917 {
5918 register struct float_block *fblk;
5919 struct float_block **fprev = &float_block;
5920 register int lim = float_block_index;
5921 register int num_free = 0, num_used = 0;
5922
5923 float_free_list = 0;
5924
5925 for (fblk = float_block; fblk; fblk = *fprev)
5926 {
5927 register int i;
5928 int this_free = 0;
5929 for (i = 0; i < lim; i++)
5930 if (!FLOAT_MARKED_P (&fblk->floats[i]))
5931 {
5932 this_free++;
5933 fblk->floats[i].u.chain = float_free_list;
5934 float_free_list = &fblk->floats[i];
5935 }
5936 else
5937 {
5938 num_used++;
5939 FLOAT_UNMARK (&fblk->floats[i]);
5940 }
5941 lim = FLOAT_BLOCK_SIZE;
5942 /* If this block contains only free floats and we have already
5943 seen more than two blocks worth of free floats then deallocate
5944 this block. */
5945 if (this_free == FLOAT_BLOCK_SIZE && num_free > FLOAT_BLOCK_SIZE)
5946 {
5947 *fprev = fblk->next;
5948 /* Unhook from the free list. */
5949 float_free_list = fblk->floats[0].u.chain;
5950 lisp_align_free (fblk);
5951 n_float_blocks--;
5952 }
5953 else
5954 {
5955 num_free += this_free;
5956 fprev = &fblk->next;
5957 }
5958 }
5959 total_floats = num_used;
5960 total_free_floats = num_free;
5961 }
5962
5963 /* Put all unmarked intervals on free list */
5964 {
5965 register struct interval_block *iblk;
5966 struct interval_block **iprev = &interval_block;
5967 register int lim = interval_block_index;
5968 register int num_free = 0, num_used = 0;
5969
5970 interval_free_list = 0;
5971
5972 for (iblk = interval_block; iblk; iblk = *iprev)
5973 {
5974 register int i;
5975 int this_free = 0;
5976
5977 for (i = 0; i < lim; i++)
5978 {
5979 if (!iblk->intervals[i].gcmarkbit)
5980 {
5981 SET_INTERVAL_PARENT (&iblk->intervals[i], interval_free_list);
5982 interval_free_list = &iblk->intervals[i];
5983 this_free++;
5984 }
5985 else
5986 {
5987 num_used++;
5988 iblk->intervals[i].gcmarkbit = 0;
5989 }
5990 }
5991 lim = INTERVAL_BLOCK_SIZE;
5992 /* If this block contains only free intervals and we have already
5993 seen more than two blocks worth of free intervals then
5994 deallocate this block. */
5995 if (this_free == INTERVAL_BLOCK_SIZE && num_free > INTERVAL_BLOCK_SIZE)
5996 {
5997 *iprev = iblk->next;
5998 /* Unhook from the free list. */
5999 interval_free_list = INTERVAL_PARENT (&iblk->intervals[0]);
6000 lisp_free (iblk);
6001 n_interval_blocks--;
6002 }
6003 else
6004 {
6005 num_free += this_free;
6006 iprev = &iblk->next;
6007 }
6008 }
6009 total_intervals = num_used;
6010 total_free_intervals = num_free;
6011 }
6012
6013 /* Put all unmarked symbols on free list */
6014 {
6015 register struct symbol_block *sblk;
6016 struct symbol_block **sprev = &symbol_block;
6017 register int lim = symbol_block_index;
6018 register int num_free = 0, num_used = 0;
6019
6020 symbol_free_list = NULL;
6021
6022 for (sblk = symbol_block; sblk; sblk = *sprev)
6023 {
6024 int this_free = 0;
6025 struct Lisp_Symbol *sym = sblk->symbols;
6026 struct Lisp_Symbol *end = sym + lim;
6027
6028 for (; sym < end; ++sym)
6029 {
6030 /* Check if the symbol was created during loadup. In such a case
6031 it might be pointed to by pure bytecode which we don't trace,
6032 so we conservatively assume that it is live. */
6033 int pure_p = PURE_POINTER_P (XSTRING (sym->xname));
6034
6035 if (!sym->gcmarkbit && !pure_p)
6036 {
6037 sym->next = symbol_free_list;
6038 symbol_free_list = sym;
6039 #if GC_MARK_STACK
6040 symbol_free_list->function = Vdead;
6041 #endif
6042 ++this_free;
6043 }
6044 else
6045 {
6046 ++num_used;
6047 if (!pure_p)
6048 UNMARK_STRING (XSTRING (sym->xname));
6049 sym->gcmarkbit = 0;
6050 }
6051 }
6052
6053 lim = SYMBOL_BLOCK_SIZE;
6054 /* If this block contains only free symbols and we have already
6055 seen more than two blocks worth of free symbols then deallocate
6056 this block. */
6057 if (this_free == SYMBOL_BLOCK_SIZE && num_free > SYMBOL_BLOCK_SIZE)
6058 {
6059 *sprev = sblk->next;
6060 /* Unhook from the free list. */
6061 symbol_free_list = sblk->symbols[0].next;
6062 lisp_free (sblk);
6063 n_symbol_blocks--;
6064 }
6065 else
6066 {
6067 num_free += this_free;
6068 sprev = &sblk->next;
6069 }
6070 }
6071 total_symbols = num_used;
6072 total_free_symbols = num_free;
6073 }
6074
6075 /* Put all unmarked misc's on free list.
6076 For a marker, first unchain it from the buffer it points into. */
6077 {
6078 register struct marker_block *mblk;
6079 struct marker_block **mprev = &marker_block;
6080 register int lim = marker_block_index;
6081 register int num_free = 0, num_used = 0;
6082
6083 marker_free_list = 0;
6084
6085 for (mblk = marker_block; mblk; mblk = *mprev)
6086 {
6087 register int i;
6088 int this_free = 0;
6089
6090 for (i = 0; i < lim; i++)
6091 {
6092 if (!mblk->markers[i].u_any.gcmarkbit)
6093 {
6094 if (mblk->markers[i].u_any.type == Lisp_Misc_Marker)
6095 unchain_marker (&mblk->markers[i].u_marker);
6096 /* Set the type of the freed object to Lisp_Misc_Free.
6097 We could leave the type alone, since nobody checks it,
6098 but this might catch bugs faster. */
6099 mblk->markers[i].u_marker.type = Lisp_Misc_Free;
6100 mblk->markers[i].u_free.chain = marker_free_list;
6101 marker_free_list = &mblk->markers[i];
6102 this_free++;
6103 }
6104 else
6105 {
6106 num_used++;
6107 mblk->markers[i].u_any.gcmarkbit = 0;
6108 }
6109 }
6110 lim = MARKER_BLOCK_SIZE;
6111 /* If this block contains only free markers and we have already
6112 seen more than two blocks worth of free markers then deallocate
6113 this block. */
6114 if (this_free == MARKER_BLOCK_SIZE && num_free > MARKER_BLOCK_SIZE)
6115 {
6116 *mprev = mblk->next;
6117 /* Unhook from the free list. */
6118 marker_free_list = mblk->markers[0].u_free.chain;
6119 lisp_free (mblk);
6120 n_marker_blocks--;
6121 }
6122 else
6123 {
6124 num_free += this_free;
6125 mprev = &mblk->next;
6126 }
6127 }
6128
6129 total_markers = num_used;
6130 total_free_markers = num_free;
6131 }
6132
6133 /* Free all unmarked buffers */
6134 {
6135 register struct buffer *buffer = all_buffers, *prev = 0, *next;
6136
6137 while (buffer)
6138 if (!VECTOR_MARKED_P (buffer))
6139 {
6140 if (prev)
6141 prev->next = buffer->next;
6142 else
6143 all_buffers = buffer->next;
6144 next = buffer->next;
6145 lisp_free (buffer);
6146 buffer = next;
6147 }
6148 else
6149 {
6150 VECTOR_UNMARK (buffer);
6151 UNMARK_BALANCE_INTERVALS (BUF_INTERVALS (buffer));
6152 prev = buffer, buffer = buffer->next;
6153 }
6154 }
6155
6156 /* Free all unmarked vectors */
6157 {
6158 register struct Lisp_Vector *vector = all_vectors, *prev = 0, *next;
6159 total_vector_size = 0;
6160
6161 while (vector)
6162 if (!VECTOR_MARKED_P (vector))
6163 {
6164 if (prev)
6165 prev->next = vector->next;
6166 else
6167 all_vectors = vector->next;
6168 next = vector->next;
6169 lisp_free (vector);
6170 n_vectors--;
6171 vector = next;
6172
6173 }
6174 else
6175 {
6176 VECTOR_UNMARK (vector);
6177 if (vector->size & PSEUDOVECTOR_FLAG)
6178 total_vector_size += (PSEUDOVECTOR_SIZE_MASK & vector->size);
6179 else
6180 total_vector_size += vector->size;
6181 prev = vector, vector = vector->next;
6182 }
6183 }
6184
6185 #ifdef GC_CHECK_STRING_BYTES
6186 if (!noninteractive)
6187 check_string_bytes (1);
6188 #endif
6189 }
6190
6191
6192
6193 \f
6194 /* Debugging aids. */
6195
6196 DEFUN ("memory-limit", Fmemory_limit, Smemory_limit, 0, 0, 0,
6197 doc: /* Return the address of the last byte Emacs has allocated, divided by 1024.
6198 This may be helpful in debugging Emacs's memory usage.
6199 We divide the value by 1024 to make sure it fits in a Lisp integer. */)
6200 ()
6201 {
6202 Lisp_Object end;
6203
6204 XSETINT (end, (EMACS_INT) sbrk (0) / 1024);
6205
6206 return end;
6207 }
6208
6209 DEFUN ("memory-use-counts", Fmemory_use_counts, Smemory_use_counts, 0, 0, 0,
6210 doc: /* Return a list of counters that measure how much consing there has been.
6211 Each of these counters increments for a certain kind of object.
6212 The counters wrap around from the largest positive integer to zero.
6213 Garbage collection does not decrease them.
6214 The elements of the value are as follows:
6215 (CONSES FLOATS VECTOR-CELLS SYMBOLS STRING-CHARS MISCS INTERVALS STRINGS)
6216 All are in units of 1 = one object consed
6217 except for VECTOR-CELLS and STRING-CHARS, which count the total length of
6218 objects consed.
6219 MISCS include overlays, markers, and some internal types.
6220 Frames, windows, buffers, and subprocesses count as vectors
6221 (but the contents of a buffer's text do not count here). */)
6222 ()
6223 {
6224 Lisp_Object consed[8];
6225
6226 consed[0] = make_number (min (MOST_POSITIVE_FIXNUM, cons_cells_consed));
6227 consed[1] = make_number (min (MOST_POSITIVE_FIXNUM, floats_consed));
6228 consed[2] = make_number (min (MOST_POSITIVE_FIXNUM, vector_cells_consed));
6229 consed[3] = make_number (min (MOST_POSITIVE_FIXNUM, symbols_consed));
6230 consed[4] = make_number (min (MOST_POSITIVE_FIXNUM, string_chars_consed));
6231 consed[5] = make_number (min (MOST_POSITIVE_FIXNUM, misc_objects_consed));
6232 consed[6] = make_number (min (MOST_POSITIVE_FIXNUM, intervals_consed));
6233 consed[7] = make_number (min (MOST_POSITIVE_FIXNUM, strings_consed));
6234
6235 return Flist (8, consed);
6236 }
6237
6238 int suppress_checking;
6239
6240 void
6241 die (msg, file, line)
6242 const char *msg;
6243 const char *file;
6244 int line;
6245 {
6246 fprintf (stderr, "\r\n%s:%d: Emacs fatal error: %s\r\n",
6247 file, line, msg);
6248 abort ();
6249 }
6250 \f
6251 /* Initialization */
6252
6253 void
6254 init_alloc_once ()
6255 {
6256 /* Used to do Vpurify_flag = Qt here, but Qt isn't set up yet! */
6257 purebeg = PUREBEG;
6258 pure_size = PURESIZE;
6259 pure_bytes_used = 0;
6260 pure_bytes_used_lisp = pure_bytes_used_non_lisp = 0;
6261 pure_bytes_used_before_overflow = 0;
6262
6263 /* Initialize the list of free aligned blocks. */
6264 free_ablock = NULL;
6265
6266 #if GC_MARK_STACK || defined GC_MALLOC_CHECK
6267 mem_init ();
6268 Vdead = make_pure_string ("DEAD", 4, 4, 0);
6269 #endif
6270
6271 all_vectors = 0;
6272 ignore_warnings = 1;
6273 #ifdef DOUG_LEA_MALLOC
6274 mallopt (M_TRIM_THRESHOLD, 128*1024); /* trim threshold */
6275 mallopt (M_MMAP_THRESHOLD, 64*1024); /* mmap threshold */
6276 mallopt (M_MMAP_MAX, MMAP_MAX_AREAS); /* max. number of mmap'ed areas */
6277 #endif
6278 init_strings ();
6279 init_cons ();
6280 init_symbol ();
6281 init_marker ();
6282 init_float ();
6283 init_intervals ();
6284 init_weak_hash_tables ();
6285
6286 #ifdef REL_ALLOC
6287 malloc_hysteresis = 32;
6288 #else
6289 malloc_hysteresis = 0;
6290 #endif
6291
6292 refill_memory_reserve ();
6293
6294 ignore_warnings = 0;
6295 gcprolist = 0;
6296 byte_stack_list = 0;
6297 staticidx = 0;
6298 consing_since_gc = 0;
6299 gc_cons_threshold = 100000 * sizeof (Lisp_Object);
6300 gc_relative_threshold = 0;
6301
6302 #ifdef VIRT_ADDR_VARIES
6303 malloc_sbrk_unused = 1<<22; /* A large number */
6304 malloc_sbrk_used = 100000; /* as reasonable as any number */
6305 #endif /* VIRT_ADDR_VARIES */
6306 }
6307
6308 void
6309 init_alloc ()
6310 {
6311 gcprolist = 0;
6312 byte_stack_list = 0;
6313 #if GC_MARK_STACK
6314 #if !defined GC_SAVE_REGISTERS_ON_STACK && !defined GC_SETJMP_WORKS
6315 setjmp_tested_p = longjmps_done = 0;
6316 #endif
6317 #endif
6318 Vgc_elapsed = make_float (0.0);
6319 gcs_done = 0;
6320 }
6321
6322 void
6323 syms_of_alloc ()
6324 {
6325 DEFVAR_INT ("gc-cons-threshold", &gc_cons_threshold,
6326 doc: /* *Number of bytes of consing between garbage collections.
6327 Garbage collection can happen automatically once this many bytes have been
6328 allocated since the last garbage collection. All data types count.
6329
6330 Garbage collection happens automatically only when `eval' is called.
6331
6332 By binding this temporarily to a large number, you can effectively
6333 prevent garbage collection during a part of the program.
6334 See also `gc-cons-percentage'. */);
6335
6336 DEFVAR_LISP ("gc-cons-percentage", &Vgc_cons_percentage,
6337 doc: /* *Portion of the heap used for allocation.
6338 Garbage collection can happen automatically once this portion of the heap
6339 has been allocated since the last garbage collection.
6340 If this portion is smaller than `gc-cons-threshold', this is ignored. */);
6341 Vgc_cons_percentage = make_float (0.1);
6342
6343 DEFVAR_INT ("pure-bytes-used", &pure_bytes_used,
6344 doc: /* Number of bytes of sharable Lisp data allocated so far. */);
6345
6346 DEFVAR_INT ("cons-cells-consed", &cons_cells_consed,
6347 doc: /* Number of cons cells that have been consed so far. */);
6348
6349 DEFVAR_INT ("floats-consed", &floats_consed,
6350 doc: /* Number of floats that have been consed so far. */);
6351
6352 DEFVAR_INT ("vector-cells-consed", &vector_cells_consed,
6353 doc: /* Number of vector cells that have been consed so far. */);
6354
6355 DEFVAR_INT ("symbols-consed", &symbols_consed,
6356 doc: /* Number of symbols that have been consed so far. */);
6357
6358 DEFVAR_INT ("string-chars-consed", &string_chars_consed,
6359 doc: /* Number of string characters that have been consed so far. */);
6360
6361 DEFVAR_INT ("misc-objects-consed", &misc_objects_consed,
6362 doc: /* Number of miscellaneous objects that have been consed so far. */);
6363
6364 DEFVAR_INT ("intervals-consed", &intervals_consed,
6365 doc: /* Number of intervals that have been consed so far. */);
6366
6367 DEFVAR_INT ("strings-consed", &strings_consed,
6368 doc: /* Number of strings that have been consed so far. */);
6369
6370 DEFVAR_LISP ("purify-flag", &Vpurify_flag,
6371 doc: /* Non-nil means loading Lisp code in order to dump an executable.
6372 This means that certain objects should be allocated in shared (pure) space. */);
6373
6374 DEFVAR_BOOL ("garbage-collection-messages", &garbage_collection_messages,
6375 doc: /* Non-nil means display messages at start and end of garbage collection. */);
6376 garbage_collection_messages = 0;
6377
6378 DEFVAR_LISP ("post-gc-hook", &Vpost_gc_hook,
6379 doc: /* Hook run after garbage collection has finished. */);
6380 Vpost_gc_hook = Qnil;
6381 Qpost_gc_hook = intern ("post-gc-hook");
6382 staticpro (&Qpost_gc_hook);
6383
6384 DEFVAR_LISP ("memory-signal-data", &Vmemory_signal_data,
6385 doc: /* Precomputed `signal' argument for memory-full error. */);
6386 /* We build this in advance because if we wait until we need it, we might
6387 not be able to allocate the memory to hold it. */
6388 Vmemory_signal_data
6389 = list2 (Qerror,
6390 build_string ("Memory exhausted--use M-x save-some-buffers then exit and restart Emacs"));
6391
6392 DEFVAR_LISP ("memory-full", &Vmemory_full,
6393 doc: /* Non-nil means Emacs cannot get much more Lisp memory. */);
6394 Vmemory_full = Qnil;
6395
6396 staticpro (&Qgc_cons_threshold);
6397 Qgc_cons_threshold = intern ("gc-cons-threshold");
6398
6399 staticpro (&Qchar_table_extra_slots);
6400 Qchar_table_extra_slots = intern ("char-table-extra-slots");
6401
6402 DEFVAR_LISP ("gc-elapsed", &Vgc_elapsed,
6403 doc: /* Accumulated time elapsed in garbage collections.
6404 The time is in seconds as a floating point value. */);
6405 DEFVAR_INT ("gcs-done", &gcs_done,
6406 doc: /* Accumulated number of garbage collections done. */);
6407
6408 defsubr (&Scons);
6409 defsubr (&Slist);
6410 defsubr (&Svector);
6411 defsubr (&Smake_byte_code);
6412 defsubr (&Smake_list);
6413 defsubr (&Smake_vector);
6414 defsubr (&Smake_string);
6415 defsubr (&Smake_bool_vector);
6416 defsubr (&Smake_symbol);
6417 defsubr (&Smake_marker);
6418 defsubr (&Spurecopy);
6419 defsubr (&Sgarbage_collect);
6420 defsubr (&Smemory_limit);
6421 defsubr (&Smemory_use_counts);
6422
6423 #if GC_MARK_STACK == GC_USE_GCPROS_CHECK_ZOMBIES
6424 defsubr (&Sgc_status);
6425 #endif
6426 }
6427
6428 /* arch-tag: 6695ca10-e3c5-4c2c-8bc3-ed26a7dda857
6429 (do not change this comment) */