src/s/darwin.h

   1 /* System description header file for Darwin (Mac OS X).
   2    Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007,
   3                  2008 Free Software Foundation, Inc.
   4
   5 This file is part of GNU Emacs.
   6
   7 GNU Emacs is free software: you can redistribute it and/or modify
   8 it under the terms of the GNU General Public License as published by
   9 the Free Software Foundation, either version 3 of the License, or
  10 (at your option) any later version.
  11
  12 GNU Emacs is distributed in the hope that it will be useful,
  13 but WITHOUT ANY WARRANTY; without even the implied warranty of
  14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15 GNU General Public License for more details.
  16
  17 You should have received a copy of the GNU General Public License
  18 along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.  */
  19
  20
  21 /*
  22  *      Define symbols to identify the version of Unix this is.
  23  *      Define all the symbols that apply correctly.
  24  */
  25
  26 /* #define UNIPLUS */
  27 /* #define USG5 */
  28 /* #define USG */
  29 /* #define HPUX */
  30 /* #define UMAX */
  31 /* #define BSD4_1 */
  32 #define BSD4_2
  33 /* BSD4_3 and BSD4_4 are already defined in sys/param.h */
  34 /* #define BSD4_3 */
  35 /* #define BSD4_4 */
  36 #define BSD_SYSTEM
  37 /* #define VMS */
  38
  39 #if 0 /* Don't define DARWIN on Mac OS X because CoreFoundation.h uses
  40          it to distinguish Mac OS X from bare Darwin.  */
  41 #ifndef DARWIN
  42 #define DARWIN 1
  43 #endif
  44 #endif
  45
  46 /* MAC_OS is used to conditionally compile code common to both MAC_OS8
  47    and MAC_OSX.  */
  48 #ifdef MAC_OSX
  49 #ifdef HAVE_CARBON
  50 #define MAC_OS
  51 /* We need a little extra space, see ../../lisp/loadup.el. */
  52 #define SYSTEM_PURESIZE_EXTRA 30000
  53
  54 #endif
  55 #endif
  56
  57 /* SYSTEM_TYPE should indicate the kind of system you are using.
  58  It sets the Lisp variable system-type.  */
  59
  60 #define SYSTEM_TYPE "darwin"
  61
  62 /* NOMULTIPLEJOBS should be defined if your system's shell
  63  does not have "job control" (the ability to stop a program,
  64  run some other program, then continue the first one).  */
  65
  66 /* #define NOMULTIPLEJOBS */
  67
  68 /* Emacs can read input using SIGIO and buffering characters itself,
  69    or using CBREAK mode and making C-g cause SIGINT.
  70    The choice is controlled by the variable interrupt_input.
  71
  72    Define INTERRUPT_INPUT to make interrupt_input = 1 the default (use SIGIO)
  73
  74    Emacs uses the presence or absence of the SIGIO and BROKEN_SIGIO macros
  75    to indicate whether or not signal-driven I/O is possible.  It uses
  76    INTERRUPT_INPUT to decide whether to use it by default.
  77
  78    SIGIO can be used only on systems that implement it (4.2 and 4.3).
  79    CBREAK mode has two disadvantages
  80      1) At least in 4.2, it is impossible to handle the Meta key properly.
  81         I hear that in system V this problem does not exist.
  82      2) Control-G causes output to be discarded.
  83         I do not know whether this can be fixed in system V.
  84
  85    Another method of doing input is planned but not implemented.
  86    It would have Emacs fork off a separate process
  87    to read the input and send it to the true Emacs process
  88    through a pipe. */
  89
  90 #define INTERRUPT_INPUT
  91
  92 /* Letter to use in finding device name of first pty,
  93   if system supports pty's.  'a' means it is /dev/ptya0  */
  94
  95 #define FIRST_PTY_LETTER 'p'
  96
  97 /*
  98  *      Define HAVE_TERMIOS if the system provides POSIX-style
  99  *      functions and macros for terminal control.
 100  *
 101  *      Define HAVE_TERMIO if the system provides sysV-style ioctls
 102  *      for terminal control.
 103  *
 104  *      Do not define both.  HAVE_TERMIOS is preferred, if it is
 105  *      supported on your system.
 106  */
 107
 108 #define HAVE_TERMIOS
 109 /* #define HAVE_TERMIO */
 110
 111 #define NO_TERMIO
 112
 113 /*
 114  *      Define HAVE_PTYS if the system supports pty devices.
 115  *      Note: PTYs are broken on darwin <6.  Use at your own risk.
 116  */
 117
 118 #define HAVE_PTYS
 119
 120 /**
 121  * PTYs only work correctly on Darwin 7 or higher.  So make the
 122  * default for process-connection-type dependent on the kernel
 123  * version.
 124  */
 125 #define MIN_PTY_KERNEL_VERSION '7'
 126
 127 /*
 128  *      Define NONSYSTEM_DIR_LIBRARY to make Emacs emulate
 129  *      The 4.2 opendir, etc., library functions.
 130  */
 131
 132 /* #define NONSYSTEM_DIR_LIBRARY */
 133
 134 /* Define this symbol if your system has the functions bcopy, etc. */
 135
 136 #define BSTRING
 137
 138 /* subprocesses should be defined if you want to
 139    have code for asynchronous subprocesses
 140    (as used in M-x compile and M-x shell).
 141    This is generally OS dependent, and not supported
 142    under most USG systems. */
 143
 144 #define subprocesses
 145
 146 /* If your system uses COFF (Common Object File Format) then define the
 147    preprocessor symbol "COFF". */
 148
 149 /* #define COFF */
 150
 151 /* define MAIL_USE_FLOCK if the mailer uses flock
 152    to interlock access to /usr/spool/mail/$USER.
 153    The alternative is that a lock file named
 154    /usr/spool/mail/$USER.lock.  */
 155
 156 #define MAIL_USE_FLOCK
 157
 158 /* Define CLASH_DETECTION if you want lock files to be written
 159    so that Emacs can tell instantly when you try to modify
 160    a file that someone else has modified in his Emacs.  */
 161
 162 #define CLASH_DETECTION
 163
 164 /* Define this if your operating system declares signal handlers to
 165    have a type other than the usual.  `The usual' is `void' for ANSI C
 166    systems (i.e. when the __STDC__ macro is defined), and `int' for
 167    pre-ANSI systems.  If you're using GCC on an older system, __STDC__
 168    will be defined, but the system's include files will still say that
 169    signal returns int or whatever; in situations like that, define
 170    this to be what the system's include files want.  */
 171 /* #define SIGTYPE int */
 172
 173 /* If the character used to separate elements of the executable path
 174    is not ':', #define this to be the appropriate character constant.  */
 175 /* #define SEPCHAR ':' */
 176
 177 /* Define this if the system can use mmap for buffer text allocation.  */
 178 /* #define USE_MMAP_FOR_BUFFERS 1 */
 179
 180 /* ============================================================ */
 181
 182 /* Here, add any special hacks needed
 183    to make Emacs work on this system.  For example,
 184    you might define certain system call names that don't
 185    exist on your system, or that do different things on
 186    your system and must be used only through an encapsulation
 187    (Which you should place, by convention, in sysdep.c).  */
 188
 189 /* Some compilers tend to put everything declared static
 190    into the initialized data area, which becomes pure after dumping Emacs.
 191    On these systems, you must #define static as nothing to foil this.
 192    Note that emacs carefully avoids static vars inside functions.  */
 193
 194 /* #define static */
 195
 196 /* If the system's imake configuration file defines `NeedWidePrototypes'
 197    as `NO', we must define NARROWPROTO manually.  Such a define is
 198    generated in the Makefile generated by `xmkmf'.  If we don't
 199    define NARROWPROTO, we will see the wrong function prototypes
 200    for X functions taking float or double parameters.  */
 201
 202 /*  #define NARROWPROTO 1 */
 203
 204 /* ============================================================ */
 205
 206 /* After adding support for a new system, modify the large case
 207    statement in the `configure' script to recognize reasonable
 208    configuration names, and add a description of the system to
 209    `etc/MACHINES'.
 210
 211    If you've just fixed a problem in an existing configuration file,
 212    you should also check `etc/MACHINES' to make sure its descriptions
 213    of known problems in that configuration should be updated.  */
 214
 215
 216 /* Avoid the use of the name init_process (process.c) because it is
 217    also the name of a Mach system call.  */
 218 #define init_process emacs_init_process
 219
 220 /* Used in dispnew.c.  Copied from freebsd.h. */
 221 #define PENDING_OUTPUT_COUNT(FILE) ((FILE)->_p - (FILE)->_bf._base)
 222
 223 /* System uses OXTABS instead of the expected TAB3.  (Copied from
 224    bsd386.h.)  */
 225 #define TAB3 OXTABS
 226
 227 /* Darwin ld insists on the use of malloc routines in the System
 228    framework.  */
 229 #define SYSTEM_MALLOC
 230
 231 /* Define HAVE_SOCKETS if system supports 4.2-compatible sockets.  */
 232 #define HAVE_SOCKETS
 233
 234 /* In Carbon, asynchronous I/O (using SIGIO) can't be used for window
 235    events because they don't come from sockets, even though it works
 236    fine on tty's.  */
 237 #ifdef HAVE_CARBON
 238 #define NO_SOCK_SIGIO
 239 #endif
 240
 241 /* Extra initialization calls in main for Mac OS X system type.  */
 242 #ifdef HAVE_CARBON
 243 #define SYMS_SYSTEM syms_of_mac()
 244 #endif
 245
 246 /* Definitions for how to dump.  Copied from nextstep.h.  */
 247
 248 #define UNEXEC unexmacosx.o
 249
 250 #define START_FILES pre-crt0.o
 251
 252 /* start_of_text isn't actually used, so make it compile without error.  */
 253 #define TEXT_START (0)
 254
 255 /* This seems to be right for end_of_text, but it may not be used anyway.  */
 256 #define TEXT_END get_etext()
 257
 258 /* This seems to be right for end_of_data, but it may not be used anyway.  */
 259 #define DATA_END get_edata()
 260
 261 /* Definitions for how to compile & link.  */
 262
 263 /* Indicate that we are compiling for Mac OS X.  */
 264 #define C_SWITCH_SYSTEM -fpascal-strings -DMAC_OSX
 265
 266 #ifdef HAVE_CARBON
 267
 268 #ifdef HAVE_AVAILABILITYMACROS_H
 269 #include <AvailabilityMacros.h>
 270 #endif
 271
 272 /* Whether to use the Image I/O framework for reading images.  */
 273 #ifndef USE_MAC_IMAGE_IO
 274 #if MAC_OS_X_VERSION_MAX_ALLOWED >= 1040 && (MAC_OS_X_VERSION_MIN_REQUIRED >= 1040 || MAC_OS_X_VERSION_MIN_REQUIRED < 1020)
 275 #define USE_MAC_IMAGE_IO 1
 276 #endif
 277 #endif
 278
 279 /* If the Image I/O framework is not used, fall back on QuickTime.  */
 280 #if USE_MAC_IMAGE_IO
 281 #define LIBS_IMAGE
 282 #else
 283 #define LIBS_IMAGE -framework QuickTime
 284 #endif
 285
 286 #endif  /* HAVE_CARBON */
 287
 288 /* Link in the Carbon lib. */
 289 #ifdef HAVE_CARBON
 290 #define LIBS_CARBON -framework Carbon LIBS_IMAGE
 291 #else
 292 #define LIBS_CARBON
 293 #endif
 294
 295 /* The -headerpad option tells ld (see man page) to leave room at the
 296    end of the header for adding load commands.  Needed for dumping.
 297    0x690 is the total size of 30 segment load commands (at 56
 298    each).  */
 299 #define LD_SWITCH_SYSTEM_TEMACS -prebind LIBS_CARBON -Xlinker -headerpad -Xlinker 690
 300
 301 #define C_SWITCH_SYSTEM_TEMACS -Dtemacs
 302
 303 /* The ncurses library has been moved out of the System framework in
 304    Mac OS X 10.2.  So if ./configure detects it, set the command-line
 305    option to use it.  */
 306 #ifdef HAVE_LIBNCURSES
 307 #define LIBS_TERMCAP -lncurses
 308 /* This prevents crashes when running Emacs in Terminal.app under
 309    10.2.  */
 310 #define TERMINFO
 311 #endif
 312
 313 /* Link this program just by running cc.  */
 314 #define ORDINARY_LINK
 315
 316 /* We don't have a g library, so override the -lg LIBS_DEBUG switch.  */
 317 #define LIBS_DEBUG
 318
 319 /* Adding -lm confuses the dynamic linker, so omit it.  */
 320 #define LIB_MATH
 321
 322 /* Tell src/Makefile.in to create files in the Mac OS X application
 323    bundle mac/Emacs.app.  */
 324 #ifdef HAVE_CARBON
 325 #define OTHER_FILES macosx-app
 326 #endif
 327
 328
 329 /* Define the following so emacs symbols will not conflict with those
 330    in the System framework.  Otherwise -prebind will not work.  */
 331
 332 /* Do not define abort in emacs.c.  */
 333 #define NO_ABORT
 334
 335 /* Do not define matherr in floatfns.c.  */
 336 #define NO_MATHERR
 337
 338
 339 /* The following solves the problem that Emacs hangs when evaluating
 340    (make-comint "test0" "/nodir/nofile" nil "") when /nodir/nofile
 341    does not exist.  */
 342 #undef HAVE_WORKING_VFORK
 343 #define vfork fork
 344
 345 /* Don't close pty in process.c to make it as controlling terminal.
 346    It is already a controlling terminal of subprocess, because we did
 347    ioctl TIOCSCTTY.  */
 348 #define DONT_REOPEN_PTY
 349
 350 #ifdef temacs
 351 #define malloc unexec_malloc
 352 #define realloc unexec_realloc
 353 #define free unexec_free
 354 #endif
 355
 356 /* This makes create_process in process.c save and restore signal
 357    handlers correctly.  Suggested by Nozomu Ando.*/
 358 #define POSIX_SIGNALS
 359
 360 /* Reroute calls to SELECT to the version defined in mac.c to fix the
 361    problem of Emacs requiring an extra return to be typed to start
 362    working when started from the command line.  */
 363 #if defined (HAVE_CARBON) && (defined (emacs) || defined (temacs))
 364 #define select sys_select
 365 #endif
 366
 367 /* Use the GC_MAKE_GCPROS_NOOPS (see lisp.h) method for marking the
 368    stack.  */
 369 #define GC_MARK_STACK   GC_MAKE_GCPROS_NOOPS
 370
 371 /* arch-tag: 481d443d-4f89-43ea-b5fb-49706d95fa41
 372    (do not change this comment) */