1 /* Copyright (C) 1995,1996,1997,1998,1999,2000,2001, 2002, 2003, 2004, 2006, 2008, 2009 Free Software Foundation, Inc.
3 * This library is free software; you can redistribute it and/or
4 * modify it under the terms of the GNU Lesser General Public License
5 * as published by the Free Software Foundation; either version 3 of
6 * the License, or (at your option) any later version.
8 * This library is distributed in the hope that it will be useful, but
9 * WITHOUT ANY WARRANTY; without even the implied warranty of
10 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
11 * Lesser General Public License for more details.
13 * You should have received a copy of the GNU Lesser General Public
14 * License along with this library; if not, write to the Free Software
15 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
31 extern unsigned long * __libc_ia64_register_backing_store_base
;
34 #include "libguile/_scm.h"
35 #include "libguile/eval.h"
36 #include "libguile/stime.h"
37 #include "libguile/stackchk.h"
38 #include "libguile/struct.h"
39 #include "libguile/smob.h"
40 #include "libguile/arrays.h"
41 #include "libguile/async.h"
42 #include "libguile/ports.h"
43 #include "libguile/root.h"
44 #include "libguile/strings.h"
45 #include "libguile/vectors.h"
46 #include "libguile/weaks.h"
47 #include "libguile/hashtab.h"
48 #include "libguile/tags.h"
50 #include "libguile/validate.h"
51 #include "libguile/deprecation.h"
52 #include "libguile/gc.h"
54 #include "libguile/private-gc.h"
56 #ifdef GUILE_DEBUG_MALLOC
57 #include "libguile/debug-malloc.h"
69 INIT_MALLOC_LIMIT is the initial amount of malloc usage which will
72 After startup (at the guile> prompt), we have approximately 100k of
73 alloced memory, which won't go away on GC. Let's set the init such
74 that we get a nice yield on the next allocation:
76 #define SCM_DEFAULT_INIT_MALLOC_LIMIT 200*1024
77 #define SCM_DEFAULT_MALLOC_MINYIELD 40
79 /* #define DEBUGINFO */
83 /* Function for non-cell memory management.
87 scm_realloc (void *mem
, size_t size
)
91 SCM_SYSCALL (ptr
= realloc (mem
, size
));
95 /* Time is hard: trigger a full, ``stop-the-world'' GC, and try again. */
98 SCM_SYSCALL (ptr
= realloc (mem
, size
));
102 scm_memory_error ("realloc");
106 scm_malloc (size_t sz
)
108 return scm_realloc (NULL
, sz
);
112 Hmm. Should we use the C convention for arguments (i.e. N_ELTS,
116 scm_calloc (size_t sz
)
121 By default, try to use calloc, as it is likely more efficient than
122 calling memset by hand.
124 SCM_SYSCALL (ptr
= calloc (sz
, 1));
128 ptr
= scm_realloc (NULL
, sz
);
129 memset (ptr
, 0x0, sz
);
135 scm_strndup (const char *str
, size_t n
)
137 char *dst
= scm_malloc (n
+ 1);
138 memcpy (dst
, str
, n
);
144 scm_strdup (const char *str
)
146 return scm_strndup (str
, strlen (str
));
152 scm_gc_register_collectable_memory (void *mem
, size_t size
, const char *what
)
155 #ifdef GUILE_DEBUG_MALLOC
157 scm_malloc_register (mem
);
163 scm_gc_unregister_collectable_memory (void *mem
, size_t size
, const char *what
)
166 #ifdef GUILE_DEBUG_MALLOC
168 scm_malloc_unregister (mem
);
172 /* Allocate SIZE bytes of memory whose contents should not be scanned for
173 pointers (useful, e.g., for strings). */
175 scm_gc_malloc_pointerless (size_t size
, const char *what
)
177 return GC_MALLOC_ATOMIC (size
);
181 scm_gc_malloc (size_t size
, const char *what
)
184 The straightforward implementation below has the problem
185 that it might call the GC twice, once in scm_malloc and then
186 again in scm_gc_register_collectable_memory. We don't really
187 want the second GC since it will not find new garbage.
189 Note: this is a theoretical peeve. In reality, malloc () never
190 returns NULL. Usually, memory is overcommitted, and when you try
191 to write it the program is killed with signal 11. --hwn
197 /* `GC_MALLOC ()' doesn't handle zero. */
198 size
= sizeof (void *);
200 ptr
= GC_MALLOC (size
);
206 scm_gc_calloc (size_t size
, const char *what
)
208 /* `GC_MALLOC ()' always returns a zeroed buffer. */
209 return scm_gc_malloc (size
, what
);
214 scm_gc_realloc (void *mem
, size_t old_size
, size_t new_size
, const char *what
)
218 ptr
= GC_REALLOC (mem
, new_size
);
220 #ifdef GUILE_DEBUG_MALLOC
222 scm_malloc_reregister (mem
, ptr
, what
);
229 scm_gc_free (void *mem
, size_t size
, const char *what
)
231 scm_gc_unregister_collectable_memory (mem
, size
, what
);
236 scm_gc_strndup (const char *str
, size_t n
, const char *what
)
238 char *dst
= GC_MALLOC_ATOMIC (n
+ 1);
239 memcpy (dst
, str
, n
);
245 scm_gc_strdup (const char *str
, const char *what
)
247 return scm_gc_strndup (str
, strlen (str
), what
);
250 #if SCM_ENABLE_DEPRECATED == 1
252 /* {Deprecated front end to malloc}
254 * scm_must_malloc, scm_must_realloc, scm_must_free, scm_done_malloc,
257 * These functions provide services comparable to malloc, realloc, and
258 * free. They should be used when allocating memory that will be under
259 * control of the garbage collector, i.e., if the memory may be freed
260 * during garbage collection.
262 * They are deprecated because they weren't really used the way
263 * outlined above, and making sure to return the right amount from
264 * smob free routines was sometimes difficult when dealing with nested
265 * data structures. We basically want everybody to review their code
266 * and use the more symmetrical scm_gc_malloc/scm_gc_free functions
267 * instead. In some cases, where scm_must_malloc has been used
268 * incorrectly (i.e. for non-GC-able memory), use scm_malloc/free.
272 scm_must_malloc (size_t size
, const char *what
)
274 scm_c_issue_deprecation_warning
275 ("scm_must_malloc is deprecated. "
276 "Use scm_gc_malloc and scm_gc_free instead.");
278 return scm_gc_malloc (size
, what
);
282 scm_must_realloc (void *where
,
287 scm_c_issue_deprecation_warning
288 ("scm_must_realloc is deprecated. "
289 "Use scm_gc_realloc and scm_gc_free instead.");
291 return scm_gc_realloc (where
, old_size
, size
, what
);
295 scm_must_strndup (const char *str
, size_t length
)
297 scm_c_issue_deprecation_warning
298 ("scm_must_strndup is deprecated. "
299 "Use scm_gc_strndup and scm_gc_free instead.");
301 return scm_gc_strndup (str
, length
, "string");
305 scm_must_strdup (const char *str
)
307 scm_c_issue_deprecation_warning
308 ("scm_must_strdup is deprecated. "
309 "Use scm_gc_strdup and scm_gc_free instead.");
311 return scm_gc_strdup (str
, "string");
315 scm_must_free (void *obj
)
316 #define FUNC_NAME "scm_must_free"
318 scm_c_issue_deprecation_warning
319 ("scm_must_free is deprecated. "
320 "Use scm_gc_malloc and scm_gc_free instead.");
322 #ifdef GUILE_DEBUG_MALLOC
323 scm_malloc_unregister (obj
);
329 fprintf (stderr
,"freeing NULL pointer");
337 scm_done_malloc (long size
)
339 scm_c_issue_deprecation_warning
340 ("scm_done_malloc is deprecated. "
341 "Use scm_gc_register_collectable_memory instead.");
344 scm_gc_register_collectable_memory (NULL
, size
, "foreign mallocs");
346 scm_gc_unregister_collectable_memory (NULL
, -size
, "foreign mallocs");
350 scm_done_free (long size
)
352 scm_c_issue_deprecation_warning
353 ("scm_done_free is deprecated. "
354 "Use scm_gc_unregister_collectable_memory instead.");
357 scm_gc_unregister_collectable_memory (NULL
, size
, "foreign mallocs");
359 scm_gc_register_collectable_memory (NULL
, -size
, "foreign mallocs");
362 #endif /* SCM_ENABLE_DEPRECATED == 1 */