#ifndef __SCMH
#define __SCMH
-/* Copyright (C) 1995, 1996 Free Software Foundation, Inc.
+/* Copyright (C) 1995, 1996, 1998, 1999, 2000 Free Software Foundation, Inc.
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
*
* You should have received a copy of the GNU General Public License
* along with this software; see the file COPYING. If not, write to
- * the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
+ * the Free Software Foundation, Inc., 59 Temple Place, Suite 330,
+ * Boston, MA 02111-1307 USA
*
* As a special exception, the Free Software Foundation gives permission
* for additional uses of the text contained in its release of GUILE.
*
* If you write modifications of your own for GUILE, it is your choice
* whether to permit this exception to apply to your modifications.
- * If you do not wish that, delete this exception notice.
- */
+ * If you do not wish that, delete this exception notice. */
\f
+
+/* "What's the difference between _scm.h and __scm.h?"
+
+ _scm.h is not installed; it's only visible to the libguile sources
+ themselves.
+
+ __scm.h is installed, and is #included by <libguile.h>. If both
+ the client and libguile need some piece of information, and it
+ doesn't fit well into the header file for any particular module, it
+ should go in __scm.h. */
+
+
/* {Supported Options}
*
* These may be defined or undefined.
*/
-/* If the compile FLAG `CAUTIOUS' is #defined then the number of
+/* Old async mechanism */
+/* #define GUILE_OLD_ASYNC_CLICK */
+
+/* New scheme for garbage collection */
+#define GUILE_NEW_GC_SCHEME
+
+/* #define GUILE_DEBUG_FREELIST */
+
+/* If the compile FLAG `SCM_CAUTIOUS' is #defined then the number of
* arguments is always checked for application of closures. If the
- * compile FLAG `RECKLESS' is #defined then they are not checked.
+ * compile FLAG `SCM_RECKLESS' is #defined then they are not checked.
* Otherwise, number of argument checks for closures are made only when
* the function position (whose value is the closure) of a combination is
* not an ILOC or GLOC. When the function position of a combination is a
* symbol it will be checked only the first time it is evaluated because
* it will then be replaced with an ILOC or GLOC.
*/
-#undef RECKLESS
-#define CAUTIOUS
+#undef SCM_RECKLESS
+#define SCM_CAUTIOUS
/* After looking up a local for the first time, rewrite the
* code graph, caching its position.
/* All the number support there is.
*/
-#define SCM_FLOATS
#define BIGNUMS
/* GC should relinquish empty cons-pair arenas.
*/
+#ifndef GUILE_NEW_GC_SCHEME
#define GC_FREE_SEGMENTS
+#endif
/* Provide a scheme-accessible count-down timer that
* generates a pseudo-interrupt.
*/
#undef ENGNOT
-/* Include support for uniform arrays?
- *
- * Possibly some of the initialization code depends on this
- * being defined, but that is a bug and should be fixed.
- */
-#define ARRAYS
-
#undef SCM_CAREFUL_INTS
\f
/* {Unsupported Options}
*
- * These must be defined.
+ * These must be defined as given here.
*/
#define CCLO
-#define SICP
+
+/* Guile Scheme supports the #f/() distinction; Guile Lisp won't. We
+ have horrible plans for their unification. */
+#undef SICP
\f
-/* Random options (net yet supported or in final form). */
+/* Random options (not yet supported or in final form). */
+
+#define STACK_CHECKING
+#undef NO_CEVAL_STACK_CHECKING
+
+\f
+/* What did the configure script discover about the outside world? */
+#include "libguile/scmconfig.h"
-#undef DEBUG_EXTENSIONS
-#undef READER_EXTENSIONS
-#undef SCM_STACK_LIMIT 20000
-#undef NO_CEVAL_STACK_CHECK
-#undef LONGLONGS
+#ifdef HAVE_LONG_LONGS
/* Some auto-generated .h files contain unused prototypes
* that need these typedefs.
*/
-typedef long long_long;
-typedef unsigned long ulong_long;
+typedef long long long_long;
+typedef unsigned long long ulong_long;
-
-\f
-/* What did the configure script discover about the outside world? */
-#include <scmconfig.h>
-
-\f
-/* Write prototype declarations like this:
- int foo PROTO(int a, int b);
- At definitions, use K&R style declarations, but make sure there's a
- declarative prototype (as above) in scope. This will give you
- argument type checking, when available, and be harmless otherwise. */
-#ifdef __STDC__
-# define PROTO(x) x
-#else
-# define PROTO(x) (x)
-#endif
+#endif /* HAVE_LONG_LONGS */
\f
/* Define
*
- * SCM_CHAR_SCM_CODE_LIMIT == UCHAR_MAX + 1
+ * SCM_CHAR_CODE_LIMIT == UCHAR_MAX + 1
* SCM_MOST_POSITIVE_FIXNUM (LONG_MAX>>2)
* SCM_MOST_NEGATIVE_FIXNUM == SCM_SRS((long)LONG_MIN, 2)
*/
#ifdef HAVE_LIMITS_H
# include <limits.h>
# ifdef UCHAR_MAX
-# define SCM_CHAR_SCM_CODE_LIMIT (UCHAR_MAX+1L)
+# define SCM_CHAR_CODE_LIMIT (UCHAR_MAX+1L)
# else
-# define SCM_CHAR_SCM_CODE_LIMIT 256L
+# define SCM_CHAR_CODE_LIMIT 256L
# endif /* def UCHAR_MAX */
# define SCM_MOST_POSITIVE_FIXNUM (LONG_MAX>>2)
# ifdef _UNICOS /* Stupid cray bug */
# define SCM_MOST_NEGATIVE_FIXNUM SCM_SRS((long)LONG_MIN, 2)
# endif /* UNICOS */
#else
-# define SCM_CHAR_SCM_CODE_LIMIT 256L
+# define SCM_CHAR_CODE_LIMIT 256L
# define SCM_MOST_POSITIVE_FIXNUM ((long)((unsigned long)~0L>>3))
# if (0 != ~0)
# define SCM_MOST_NEGATIVE_FIXNUM (-SCM_MOST_POSITIVE_FIXNUM-1)
#endif /* def HAVE_LIMITS_H */
\f
-#include "tags.h"
+#ifdef STDC_HEADERS
+# include <stdlib.h>
+# ifdef AMIGA
+# include <stddef.h>
+# endif /* def AMIGA */
+# define scm_sizet size_t
+#else
+# ifdef _SIZE_T
+# define scm_sizet size_t
+# else
+# define scm_sizet unsigned int
+# endif /* def _SIZE_T */
+#endif /* def STDC_HEADERS */
+
+\f
+
+#include "libguile/tags.h"
\f
#ifdef vms
#endif
\f
+#ifndef USE_THREADS
+#define SCM_THREAD_DEFER
+#define SCM_THREAD_ALLOW
+#define SCM_THREAD_REDEFER
+#define SCM_THREAD_SWITCHING_CODE
+#endif
+
+#ifdef GUILE_OLD_ASYNC_CLICK
extern unsigned int scm_async_clock;
-#define SCM_ASYNC_TICK if (0 == --scm_async_clock) scm_async_click ()
+
+#define SCM_ASYNC_TICK \
+do { \
+ if (0 == --scm_async_clock) \
+ scm_async_click (); \
+} while(0)
+#else
+extern int scm_asyncs_pending_p;
+
+#define SCM_ASYNC_TICK /*fixme* should change names */ \
+do { \
+ if (scm_asyncs_pending_p) \
+ scm_async_click (); \
+} while (0)
+#endif
#ifdef SCM_CAREFUL_INTS
#define SCM_CHECK_NOT_DISABLED \
#endif
+/* Anthony Green writes:
+ When the compiler sees...
+ DEFER_INTS;
+ [critical code here]
+ ALLOW_INTS;
+ ...it doesn't actually promise to keep the critical code within the
+ boundries of the DEFER/ALLOW_INTS instructions. It may very well
+ schedule it outside of the magic defined in those macros.
+
+ However, GCC's volatile asm feature forms a barrier over which code is
+ never moved. So if you add...
+ asm ("");
+ ...to each of the DEFER_INTS and ALLOW_INTS macros, the critical
+ code will always remain in place. asm's without inputs or outputs
+ are implicitly volatile. */
+#ifdef __GNUC__
+#define SCM_FENCE asm /* volatile */ ("")
+#else
+#define SCM_FENCE
+#endif
+
#define SCM_DEFER_INTS \
-{ \
+do { \
+ SCM_FENCE; \
SCM_CHECK_NOT_DISABLED; \
+ SCM_THREAD_DEFER; \
+ SCM_FENCE; \
scm_ints_disabled = 1; \
-} \
+ SCM_FENCE; \
+} while (0)
#define SCM_ALLOW_INTS_ONLY \
-{ \
+do { \
+ SCM_THREAD_ALLOW; \
scm_ints_disabled = 0; \
-} \
+} while (0)
#define SCM_ALLOW_INTS \
-{ \
+do { \
+ SCM_FENCE; \
SCM_CHECK_NOT_ENABLED; \
+ SCM_THREAD_SWITCHING_CODE; \
+ SCM_FENCE; \
scm_ints_disabled = 0; \
- SCM_ASYNC_TICK; \
-} \
+ SCM_FENCE; \
+ SCM_THREAD_ALLOW; \
+ SCM_FENCE; \
+} while (0)
#define SCM_REDEFER_INTS \
-{ \
+do { \
+ SCM_FENCE; \
+ SCM_THREAD_REDEFER; \
++scm_ints_disabled; \
-} \
+ SCM_FENCE; \
+} while (0)
#define SCM_REALLOW_INTS \
-{ \
+do { \
+ SCM_FENCE; \
+ SCM_THREAD_SWITCHING_CODE; \
+ SCM_FENCE; \
--scm_ints_disabled; \
- if (!scm_ints_disabled) \
- SCM_ASYNC_TICK; \
-} \
+ SCM_FENCE; \
+} while (0)
+#define SCM_TICK \
+do { \
+ SCM_DEFER_INTS; \
+ SCM_ALLOW_INTS; \
+ SCM_ASYNC_TICK; \
+} while (0)
+
+\f
+
+/* Classification of critical sections
+ *
+ * When Guile moves to POSIX threads, it won't be possible to prevent
+ * context switching. In fact, the whole idea of context switching is
+ * bogus if threads are run by different processors. Therefore, we
+ * must ultimately eliminate all critical sections or enforce them by
+ * use of mutecis.
+ *
+ * All instances of SCM_DEFER_INTS and SCM_ALLOW_INTS should therefore
+ * be classified and replaced by one of the delimiters below. If you
+ * understand what this is all about, I'd like to encourage you to
+ * help with this task. The set of classes below must of course be
+ * incrementally augmented.
+ *
+ * MDJ 980419 <djurfeldt@nada.kth.se>
+ */
+
+/* A sections
+ *
+ * Allocation of a cell with type tag in the CAR.
+ *
+ * With POSIX threads, each thread will have a private pool of free
+ * cells. Therefore, this type of section can be removed. But! It
+ * is important that the CDR is initialized first (with the CAR still
+ * indicating a free cell) so that we can guarantee a consistent heap
+ * at all times.
+ */
+
+#ifdef SCM_POSIX_THREADS
+#define SCM_ENTER_A_SECTION
+#define SCM_EXIT_A_SECTION
+#else
+#define SCM_ENTER_A_SECTION SCM_DEFER_INTS
+#define SCM_EXIT_A_SECTION SCM_ALLOW_INTS
+#endif
\f
#ifdef SCM_RECKLESS
#define SCM_ASSERT(_cond, _arg, _pos, _subr)
+#define SCM_ASSERT_TYPE(_cond, _arg, _pos, _subr)
#define SCM_ASRTGO(_cond, _label)
#else
#define SCM_ASSERT(_cond, _arg, _pos, _subr) \
if (!(_cond)) \
scm_wta(_arg, (char *)(_pos), _subr)
+#define SCM_ASSERT_TYPE(_cond, _arg, _pos, _subr, _msg) \
+ if (!(_cond)) \
+ scm_wrong_type_arg_msg(_subr, _pos, _arg, _msg)
#define SCM_ASRTGO(_cond, _label) \
if (!(_cond)) \
goto _label
#endif
-#define SCM_SYSERROR(_subr) \
- scm_everr (SCM_UNDEFINED, SCM_EOL, SCM_UNDEFINED, \
- strerror (errno), _subr)
-
- /* equivalent to:
- scm_throw (system_error_sym, \
- scm_listify (scm_makfrom0str (strerror (errno)), \
- scm_makfrom0str (_subr), \
- SCM_UNDEFINED));
- */
-#ifdef ENOSYS
-# define SCM_SYSMISSING(_subr) \
- scm_everr (SCM_UNDEFINED, SCM_EOL, SCM_UNDEFINED, \
- strerror (ENOSYS), _subr)
-#else
-# define SCM_SYSMISSING(_subr) \
- scm_everr (SCM_UNDEFINED, SCM_EOL, SCM_UNDEFINED, \
- "missing function", _subr)
-#endif
+/*
+ * SCM_WTA_DISPATCH
+ */
+
+extern SCM scm_call_generic_0 (SCM gf);
+
+#define SCM_WTA_DISPATCH_0(gf, arg, pos, subr) \
+ return ((gf) \
+ ? scm_call_generic_0 ((gf)) \
+ : scm_wta ((arg), (char *) (pos), (subr)))
+#define SCM_GASSERT0(cond, gf, arg, pos, subr) \
+ if (!(cond)) SCM_WTA_DISPATCH_0((gf), (arg), (pos), (subr))
+
+extern SCM scm_call_generic_1 (SCM gf, SCM a1);
+
+#define SCM_WTA_DISPATCH_1(gf, a1, pos, subr) \
+ return ((gf) \
+ ? scm_call_generic_1 ((gf), (a1)) \
+ : scm_wta ((a1), (char *) (pos), (subr)))
+#define SCM_GASSERT1(cond, gf, a1, pos, subr) \
+ if (!(cond)) SCM_WTA_DISPATCH_1((gf), (a1), (pos), (subr))
+
+extern SCM scm_call_generic_2 (SCM gf, SCM a1, SCM a2);
+
+#define SCM_WTA_DISPATCH_2(gf, a1, a2, pos, subr) \
+ return ((gf) \
+ ? scm_call_generic_2 ((gf), (a1), (a2)) \
+ : scm_wta ((pos) == SCM_ARG1 ? (a1) : (a2), (char *) (pos), (subr)))
+#define SCM_GASSERT2(cond, gf, a1, a2, pos, subr) \
+ if (!(cond)) SCM_WTA_DISPATCH_2((gf), (a1), (a2), (pos), (subr))
+
+extern SCM scm_apply_generic (SCM gf, SCM args);
+
+#define SCM_WTA_DISPATCH_n(gf, args, pos, subr) \
+ return ((gf) \
+ ? scm_apply_generic ((gf), (args)) \
+ : scm_wta (scm_list_ref ((args), SCM_MAKINUM ((pos) - 1)), \
+ (char *) (pos), \
+ (subr)))
+#define SCM_GASSERTn(cond, gf, args, pos, subr) \
+ if (!(cond)) SCM_WTA_DISPATCH_n((gf), (args), (pos), (subr))
+
+#ifndef SCM_MAGIC_SNARFER
+/* Let these macros pass through if
+ we are snarfing; thus we can tell the
+ difference between the use of an actual
+ number vs. the use of one of these macros --
+ actual numbers in SCM_VALIDATE_* and SCM_ASSERT
+ constructs must match the formal argument name,
+ but using SCM_ARG* avoids the test */
+
#define SCM_ARGn 0
#define SCM_ARG1 1
#define SCM_ARG2 2
#define SCM_ARG4 4
#define SCM_ARG5 5
#define SCM_ARG6 6
-#define SCM_ARG7 7
-#define SCM_ARGERR(X) ((X) < SCM_WNA \
+#define SCM_ARG7 7
+ /* #define SCM_ARGERR(X) ((X) < SCM_WNA \
? (char *)(X) \
: "wrong type argument")
+ */
/* Following must match entry indexes in scm_errmsgs[].
* Also, SCM_WNA must follow the last SCM_ARGn in sequence.
*/
#define SCM_WNA 8
-#define SCM_OVSCM_FLOW 9
+ /* #define SCM_OVSCM_FLOW 9 */
#define SCM_OUTOFRANGE 10
#define SCM_NALLOC 11
-#define SCM_STACK_SCM_OVSCM_FLOW 12
-#define SCM_EXIT 13
+ /* #define SCM_STACK_OVFLOW 12 */
+ /* #define SCM_EXIT 13 */
+#endif /* SCM_MAGIC_SNARFER */
/* (...still matching scm_errmsgs) These
* are signals. Signals may become errors
#define SCM_ORD_SIG(X) ((X) + SCM_HUP_SIGNAL)
#define SCM_NUM_SIGS (SCM_SIG_ORD (SCM_TICK_SIGNAL) + 1)
+#if 0
struct errdesc
{
char *msg;
extern struct errdesc scm_errmsgs[];
+#endif
\f
\f
-#ifdef __STDC__
-
-#else /* STDC */
-
-#endif /* STDC */
-
#endif /* __SCMH */
+
+/*
+ Local Variables:
+ c-file-style: "gnu"
+ End:
+*/