Newer Older
1 2
Emacs machines list

Copyright (C) 1989, 1990, 1992, 1993, 1998, 2001, 2002, 2003, 2004,
Glenn Morris's avatar
Glenn Morris committed
  2005, 2006, 2007, 2008  Free Software Foundation, Inc.
See the end of the file for license conditions.

7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33
This is a list of the status of GNU Emacs on various machines and systems.

For each system and machine, we give the configuration name you should
pass to the `configure' script to prepare to build Emacs for that

The `configure' script uses the configuration name to decide which
machine and operating system description files `src/config.h' should
include.  The machine description files are all in `src/m', and have
names similar to, but not identical to, the machine names used in
configuration names.  The operating system files are all in `src/s',
and are named similarly.  See the `configure' script if you need to
know which configuration names use which machine and operating system
description files.

If you add support for a new configuration, add a section to this
file, and then edit the `configure' script to tell it which
configuration name(s) should select your new machine description and
system description files.

Here are the configurations Emacs is intended to work with, with the
corresponding configuration names.  You can postpend version numbers
to operating system names (i.e. sunos4.1) or architecture names (i.e.
hppa1.1).  If you leave out the version number, the `configure' script
will configure Emacs for the latest version it knows about.

Alpha (DEC) running GNU/Linux (alpha-dec-linux-gnu)

36 37 38 39 40
  DEC C compiler version 5.9 (DEC C V5.9-005 on Digital UNIX V4.0f)
  is reported to produce bogus binaries of Emacs 21.2 when the
  command-line switches "-O4 -arch ev6 -tune ev6" are used.  Using
  just -O4 produces a good executable.

41 42 43 44 45 46 47 48 49 50
  For 4.0 revision 564, and 4.0A and 4.0B, Emacs 20 seems to work
  with no special configuration options.  However, if you use GCC as
  your compiler, you will need version 2.8.1 or later, as older
  versions fail to build with a message "Invalid dimension for the
  charset-ID 160".

  Note that the X11 libraries on GNU/Linux systems for the Alpha are
  said to have bugs that prevent Emacs from working with X (as of
  November 1995).  Recent releases work (July 2000).

51 52
Apple Macintosh running Mac OS X

Juanma Barranquero's avatar
Juanma Barranquero committed
  For installation on all versions of the Mac OS platform, see the file
54 55

56 57 58
Apple PowerPC Macintosh running GNU/Linux

  There are special considerations for a variety of this system which
Eli Zaretskii's avatar
Eli Zaretskii committed
  is known as the ``Yellow Dog [GNU/]Linux'': Emacs may crash during
60 61 62 63
  dumping.  To solve this, edit the header file src/m/macppc.h in the
  Emacs distribution, and remove the "#if 0" and "#endif" directives
  which surround the following block near the end of the file:

    #if 0  /* This breaks things on PPC GNU/Linux except for Yellowdog,
65 66 67 68 69 70 71 72 73 74 75 76 77 78
	      even with identical GCC, as, ld.  Let's take it out until we
	      know what's really going on here.  */
    /* GCC 2.95 and newer on GNU/Linux PPC changed the load address to
       0x10000000.  */
    #if defined __linux__
    #if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 95)
    #define DATA_SEG_BITS  0x10000000
    #endif /* 0 */

  After that, reconfigure and rebuild Emacs.  It should now build

79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144
Cubix QBx/386 (i386-cubix-sysv)

  Changes merged in 19.1.  Systems before 2/A/0 may fail to compile etags.c
  due to a compiler bug.

DECstation (mips-dec-ultrix or mips-dec-osf)

  This machine is the older Mips-based DECstation.
  Emacs should now work on the Alpha CPU.

  19.25 works on Ultrix 4.2.  The 19.26 pretest was reported to work
  on Ultrix 4.2a and on 4.4.

  One user reported 19.25 did not work at all with --with-x-toolkit
  using X11R5 patch level 10, but worked ok with X11R5 pl26.

  See under Ultrix for problems using X windows on Ultrix.
  Note that this is a MIPS machine.

  For Ultrix versions 4.1 or earlier, you may need to define
  SYSTEM_MALLOC in `src/m/pmax.h', because XvmsAlloc.o in libX11.a seems
  to insist on defining malloc itself.

  For Ultrix versions prior to 4.0, you may need to delete
  the definition of START_FILES from `src/m/pmax.h'.

Motorola Delta 147 (m68k-motorola-sysv)

  The EMacs 19.26 pretest was reported to work.

  Motorola Delta boxes running System V/68 release 3.
  Tested on 147 board with SVR3V7, no X and gcc.
  Tested on 167 board with SVR3V7, no X, cc, gnucc and gcc.
  Reports say it works with X too.

  The installation script chooses the compiler itself.  gnucc is

Fujitsu DS/90 (sparc-fujitsu-sysv4)

  Changes merged in 20.3.

GEC 63 (local-gec63-usg5.2)

  Changes are partially merged in version 18, but certainly require
  more work.  Let us know if you get this working, and we'll give it a
  real configuration name.

Harris Power PC (powerpc-harris-powerunix)

  Patches have been merged in 19.31.

Hewlett-Packard 9000 series 200 or 300 (m68k-hp-bsd or m68k-hp-hpux
				        or m68k-hp-netbsd)

  These machines are 68000-series CPUs running HP/UX
  (a derivative of sysV with some BSD features) or BSD 4.3 ported by Utah.
  The operating system suffix determines which system Emacs is built for.

  Series 200 HPUX runs Emacs only if it has the "HP/UX upgrade".

  Version 19 works under BSD.  The 19.26 pretest was reported
  to work on HPUX 9.  19.31 works on HPUX 10.01, but there are
  some problems on 10.10 which have not been resolved.  Emacs 19.34
  works on HPUX 10.20 provided you compile with GCC; with the HP C
  compiler, subprocess commands do not work.
Juanma Barranquero's avatar
Juanma Barranquero committed

146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211
  On HPUX 9, Emacs sometimes crashes with SIGBUS or SIGSEGV after you
  delete a frame.  We think this is due to a bug in the X libraries
  provided by HP.  With the alternative X libraries in
  /usr/contrib/mitX11R5/lib, the problem does not happen.

  If you are running HP/UX release 8.0 or later, you need the optional
  "C/ANSI C" software in order to build Emacs (older releases of HP/UX
  do not require any special software).  If the file "/etc/filesets/C"
  exists on your machine, you have this software, otherwise you do not.

  Note that HP has used two incompatible assembler syntaxes,
  and has recently changed the format of C function frames.
  `src/crt0.c' and `src/alloca.s' have been conditionalised for the new
  assembler and new function-entry sequence.  You may need to define
  OLD_HP_ASSEMBLER if you are using an older hpux version.  If you
  have an official (bought from HP) series 300 machine you have
  the new assembler.  Kernels that are 5.+ or later have new
  assembler.  A Series 200 that has been upgraded to a 68010
  processor and a 5.+ kernel has the new compiler.

  Define C_SWITCH_MACHINE to be +X to make a version of Emacs that
  runs on both 68010 and 68020 based HP/UX's.

  Define HPUX_68010 if you are using the new assembler, for
  a system that has a 68010 without a 68881.  This is to say,
  a s200 (upgraded) or s310.

  Define the symbol HPUX_NET if you have the optional network features
  that include the `netunam' system call.  This is referred to as
  Network Services (NS/9000) in HP literature.

HP 9000 series 500: not supported.

  The series 500 has a seriously incompatible memory architecture
  which relocates data in memory during execution of a program,
  and support for it would be difficult to implement.

HP 9000 series 700 or 800 (Spectrum) (hppa1.0-hp-hpux or hppa1.1-hp-hpux
				      or ...hpux9shr, or ...-nextstep)

  Use hppa1.1 for the 700 series and hppa1.0 for the 800
  series machines.  (Emacs may not actually care which one you use.)

  Support for NextSTEP was added in 19.31.

  Emacs 20 may work on HPUX 10.  You need patch PHSS_6202 to install
  the Xaw and Xmu libraries.  On HPUX 10.20 you may need to compile with GCC;
  when Emacs was compiled with HP's C compiler, HP92453-01 A.10.32.03,
  the subprocess features failed to work.

  19.26 is believed to work on HPUX 9 provided you compile with GCC.
  As of version 19.16, Emacs was reported to build (using GCC) and run
  on HP 9000/700 series machines running HP/UX versions 8.07 and 9.01.
  The HP compiler is known to fail on some versions if you use +O3,
  but it may work with lower optimization levels.

  Use hppa1.1-hp-hpux9shr to use shared libraries on HPUX version 9.
  You may need to create the X libraries libXaw.a and libXmu.a from
  the MIT X distribute, and you may need to edit src/Makefile's
  definition of LIBXT to look like this:

     LIBXT= $(LIBW) -lXmu -lXt $(LIBXTR6) -lXext

  Some people report trouble using the GNU memory allocator under
  HP/UX version 9.  The problems often manifest as lots of ^@'s in the
Juanma Barranquero's avatar
Juanma Barranquero committed

213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266
  We are told that these problems go away if you obtain the latest
  patches for the HP/UX C compiler.  James J Dempsey
  <> says that this set of versions works for him:
	    HP92453-01 A.09.28 HP C Compiler
	    HP92453-01 A.09.28 HP C Compiler
	     HP-UX SLLIC/OPTIMIZER  HP-UX.09.00.23  02/18/93
	     Ucode Code Generator - HP-UX. (patch)  2/18/93

  For 700 series machines, the HP-UX patch needed is known as
  PHSS_2653.  (Perhaps for 800 series machines as well; we don't
  know.)  If you are on the Internet, you should be able to obtain
  this patch by using telnet to access the machine and logging in as "hpslreg" and following
  the instructions there.  Or you may be able to use this
  web site:

    HP Patch Server:
    HP Support Line:

  Please do not ask FSF for further support on this.  If you have any
  trouble obtaining the patch, contact HP Software Support.

  If your buffer fills up with nulls (^@) at some point, it could well
  be that problem.  That problem does not happen when people use GCC
  to compile Emacs.  On the other hand, the HP compiler version 9.34
  was reported to work for the 19.26 pretest.  9.65 was also reported to work.

  If you turn on the DSUSP character (delayed suspend),
  Emacs 19.26 does not know how to turn it off on HPUX.
  You need to turn it off manually.

  If you are running HP/UX release 8.0 or later, you need the optional
  "C/ANSI C" software in order to build Emacs (older releases of HP/UX
  do not require any special software).  If the file "/etc/filesets/C"
  exists on your machine, you have this software, otherwise you do not.

IBM PS/2 (i386-ibm-aix1.1 or i386-ibm-aix1.2)

  Changes merged in version 19.  You may need to copy
  /usr/lib/samples/hft/hftctl.c to the Emacs src directory.

  i386-ibm-aix1.1 may not work with certain new X window managers, and
  may be suboptimal.

IBM RS/6000 (rs6000-ibm-aix*)

  Emacs 19.26 is believed to work; its pretest was tested.

  Compiling with the system's `cc' and CFLAGS containing `-O5' might
  fail because libXbsd isn't found.  This is a compiler bug;
  re-configure Emacs so that it isn't compiled with `-O5'.

267 268 269
  On AIX 4.3.x and 4.4, compiling with /bin/c89 fails because it
  treats certain warnings as errors.  Use `cc' instead.

270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293
  At last report, Emacs didn't run well on terminals.  Informed
  persons say that the tty VMIN and VTIME settings have been
  corrupted; if you have a fix, please send it to us.

  Compiling with -O using the IBM compiler has been known
  to make Emacs work incorrectly.  It's reported that on
  AIX 3.2.5 with an IBM compiler earlier than,
  cc -O fails for some files.  You need to install any
  PTF containing APAR #IX42810 to bring the compiler to
  the level to allow optimized compiles.

  There are reports that IBM compiler versions earlier than
  fail even without -O.  However, another report said that compiler
  version did work, on AIX 3.2.4, with Emacs 19.31.

  As of 19.11, if you strip the Emacs executable, it ceases to work.

  If you are using AIX 3.2.3, you may get a core dump when loading
  ange-ftp.  You may be able to fix the problem by defining LIBS_TERMCAP
  as -ltermcap -lcurses.  Please tell us if this fails to work.

  If anyone can fix the above problems, or confirm that they don't happen
  with certain versions of various programs, we would appreciate it.

Eli Zaretskii's avatar
Eli Zaretskii committed
294 295 296 297 298
IBM System/390 running GNU/Linux (s390-*-linux-gnu)

  As of Emacs 21.2, a 31-bit only version is supported on this

299 300 301 302 303 304 305
Integrated Solutions `Optimum V' (m68k-isi-bsd4.2 or -bsd4.3)

  18.52 said to work on some sort of ISI machine.
  Version 18.45 worked (running on a Optimum V (VME bus, 68020)
  BSD 4.2 (3.05e) system).  18.42 is reported to work on
  a Qbus 68010 system.  Has not been tried on `WorkStation' `Cluster
  Compute Node' `Cluster WorkStation' or `Server Node'  (Love the
Juanma Barranquero's avatar
Juanma Barranquero committed
307 308 309 310 311 312 313 314

  Compilation with -O is rumored to break something.

  On recent system versions, you may need to undefine the macro UMAX
  in `lib-src/loadst.c' and `src/getpagesize.h'.  They stupidly defined this
  in a system header file, which confuses Emacs (which thinks that UMAX
  indicates the Umax operating system).

Intel 386 (i386-*-bsdi2,        i386-*-freebsd,  i386-*-linux-gnu,
316 317
	   i386-*-sol2.4,	i386-*-sysv3,    i386-intsys-sysv,
	   i386-*-sysv4,	i386-*-sysv4.2,
Juanma Barranquero's avatar
Juanma Barranquero committed
	   i386-*-sysv5.3,	i386-*-bsd4.2,   i386-*-cygwin,
	   i386-*-bsd386,   i386-*-386bsd,
320 321 322 323 324 325 326 327 328 329 330
	   i386-*-msdos,	i386-*-windowsnt.
	   i386... can be replaced with i486... or i586...)

  In the above configurations, * means that the manufacturer's name
  you specify does not matter, and you can use any name you like
  (but it should not contain any dashes or stars).

  When using the ISC configurations, be sure to specify the isc
	version number - for example, if you're running ISC 3.0, use
	i386-unknown-isc3.0 as your configuration name.
  Use i386-*-linux-gnu for GNU/Linux systems; Emacs runs as of version 19.26.
  Use i386-*-cygwin for Cygwin; Emacs builds as of version 22.1, in both X11
Juanma Barranquero's avatar
Juanma Barranquero committed
  and non-X11 modes.  (The Cygwin site has source and binaries for 21.2.)
333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376
  Use i386-intsys-sysv for Integrated Solutions 386 machines.
  It may also be correct for Microport systems.

  On GNU/Linux systems, Emacs 19.23 was said to work properly with libc
  version 4.5.21, but not with 4.5.19.  If your system uses QMAGIC
  for the executable format, you must edit config.h to define LINUX_QMAGIC.

  On GNU/Linux, configure may fail to put these definitions in config.h:

    #define HAVE_MKDIR
    #define HAVE_RMDIR

  To work around the problem, add those definitions by hand.
  It is possible that this problem happens only with X11R6.
  Newer system versions have fixed it.

  The 19.26 pretest was reported to work on SVR4.3 and on Freebsd.

  19.29 is reported to crash when using Motif on Solaris 2.5.
  The reasons are not yet known.

  Use i386-*-bsdiN for BSDI BSD/OS version N; Emacs runs as of version 19.23.
  In some system versions, `make' is broken; use GNU make instead.
  Shell bugs in version 1.0 of BSD/OS cause configure
  to do the wrong thing with --with-x-toolkit; the workaround is to edit
  configure to run another shell such as bash.

  For System V release 3, use i386-*-sysv3.
  For System V release 4, use i386-*-sysv4.
  For System V release 4.2, use i386-*-sysv4.2.

  If you are using SCO Unix, see notes at end under SCO.

  On 386bsd, NetBSD and FreeBSD, at one time, it was necessary to use
  GNU make, not the system's make.  Assuming it's installed as gmake,
  do `gmake install MAKE=gmake'.  However, more recently it is
  reported that using the system Make on NetBSD 1.3.1 works ok.

  If you are using System V release 4.2, you may find that `cc -E'
  puts spurious spaces in `src/xmakefile'.  If that happens,
  specify CPP=/lib/cpp as an option when you run make.
  There is no problem if you compile with GCC.
Juanma Barranquero's avatar
Juanma Barranquero committed

378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431
  Note that use of Linux with GCC 2.4 and the DLL 4.4 libraries
  requires the experimental "net 2" network patches (no relation to
  Berkeley Net 2).  There is a report that (some version of) Linux
  requires including `/usr/src/linux/include/linux' in buffer.c
  but no coherent explanation of why that might be so.  If it is so,
  in current versions of Linux, something else should probably be changed.

  Some sysV.3 systems seem to have bugs in `opendir';
  for them, alter `config.h' to define NONSYSTEM_DIR_LIBRARY
  and undefine SYSV_SYSTEM_DIR.

  If you use optimization on V.3, you may need the option -W2,'-y 0'
  to prevent certain faulty optimization.

  On 386/ix, to link with shared libraries, add #define USG_SHARED_LIBRARIES
  to config.h.

  On SCO, there are problems in regexp matching when Emacs is compiled
  with the system compiler.  The compiler version is "Microsoft C
  version 6", SCO 4.2.0h Dev Sys Maintenance Supplement 01/06/93;
  Quick C Compiler Version 1.00.46 (Beta).  The solution is to compile
  with GCC.

  On ISC systems (2.02 and more recent), don't try to use the versions
  of X that come with the system; use XFree86 instead.

  There is no consistency in the handling of certain system header files
  on V.3.

  Some versions have sys/sioctl.h, and require it in sysdep.c.
  But some versions do not have sys/sioctl.h.
  For a given version of the system, this may depend on whether you have
  X Windows or TCP/IP.  Define or undefine NO_SIOCTL_H in config.h
  according to whether you have the file.

  Likewise, some versions have been known to need sys/ttold.h, sys/stream.h,
  and sys/ptem.h included in sysdep.c.  If your system has these files,
  try defining NEED_PTEM_H in config.h if you have trouble without it.

  You may find that adding -I/usr/X/include or -I/usr/netinclude or both
  to CFLAGS avoids compilation errors on certain systems.

  Some versions convince sysdep.c to try to use `struct tchars'
  but define `struct tc' instead; add `#define tchars tc'
  to config.h to solve this problem.

Iris 2500 and Iris 2500 Turbo (m68k-sgi-iris3.5 or m68k-sgi-iris3.6)

  Version 18 was said to work; use m68k-sgi-iris3.5 for system version 2.5
  and m68k-sgi-iris3.6 for system version 3.6.
  Note that the 3030 is the same as the Iris 2500 Turbo.

Iris 4D (mips-sgi-irix[456].*)

432 433
  Emacs 21.3 is reported to work on IRIX 6.5.x.

434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540
  You can build a 64-bit executable (with larger maximum buffer size)
  on Irix 6.5 by specifying the 64-bit ABI using the `-64' compiler
  flag or otherwise (see cc(1)).  This may work on earlier Irix 6
  systems if you edit src/s/irix6-0.h following irix6-5.h.

  If compiling with GCC on Irix 6 yields an error "conflicting types
  for `initstate'", install GCC 2.95 or a newer version, and this
  problem should go away.  It is possible that this problem results
  from upgrading the operating system without reinstalling GCC; so you
  could also try reinstalling the same version of GCC, and telling us
  whether that fixes the problem.

Mips (mips-mips-riscos, mips-mips-riscos4.0, or mips-mips-bsd)

  The C compiler on Riscos 4.51 dumps core trying to optimize
  parts of Emacs.  Try without optimization or try GCC.

  Meanwhile, the linker on that system returns success even if
  there are undefined symbols; as a result, configure gets the
  wrong answers to various questions.  No work-around is known
  except to edit src/config.h by hand to indicate which functions
  don't exist.

  Use mips-mips-riscos4.0 for RISCOS version 4.
  Use mips-mips-bsd with the BSD world.

  Note that the proper configuration names for DECstations are
  mips-dec-ultrix and mips-dec-osf.

  If you are compiling with GCC, then you must run fixincludes;
  the alternative of using -traditional won't work because
  the definition of SIGN_EXTEND_CHAR uses the keyword `signed'.

  If the SYSV world is the default, then you probably need the following
  line in etc/Makefile:

    CFLAGS= -g -systype bsd43

  Some operating systems on MIPS machines give SIGTRAP for division by
  zero instead of the usual signals.  The only real solution is to fix
  the system to give a proper signal.

  In the meantime, you can change init_data in data.c if you wish.
  Change it to handle SIGTRAP as well as SIGFPE.  But this will have a
  great disadvantage: you will not be able to run Emacs under a
  debugger.  I think crashing on division by zero is a lesser problem. reported needing to use --x-libraries=/bsd43/usr/lib
  on a riscos4bsd site.  But it is not clear whether this is needed in
  general or only because of quirks on a particular site.

NCR Intel system (i386-ncr-sysv4.2)

  This system works in 19.31, but if you don't link it with GNU ld,
  you may need to set LD_RUN_PATH at link time to specify where
  to find the X libraries.

NEC EWS4800 (mips-nec-sysv4)

  This system works in 20.4, but you should use the compiler
  /usr/abiccs/bin/cc (MIPS ABI MODE).

NeXT (m68k-next-nextstep)

  Emacs 19 has not been tested extensively yet, but it seems to work
  in a NeXTStep 3.0 terminal window, and under the X server called
  co-Xist.  You may need to specify -traditional when src/Makefile
  builds xmakefile.

  NeXT users might want to implement direct operation with NeXTStep,
  but from the point of view of the GNU project, that is a

  Thanks to Thorsten Ohl for working on the NeXT port of Emacs 19.

Pmax (DEC Mips)  (mips-dec-ultrix or mips-dec-osf1)

  See under DECstation, above.

Prime EXL (i386-prime-sysv)

  Minor changes merged in 19.1.

Sequent Symmetry (i386-sequent-bsd, i386-sequent-ptx, i386-sequent-ptx4)

  19.33 has changes to support ptx 4 (a modified SVR4).

  Emacs 19 should work on Dynix (BSD).  However, if you compile with
  the Sequent compiler, you may find Emacs does not restore the
  terminal settings on exit.  If this happens, compile with GCC.

  Emacs 19.27 contains patches that should support
  DYNIX/ptx 1.4 and 2.1 with the native cc compiler.

  GCC can't compile src/process.c due to a non-standard Sequent asm
  keyword extension supported by cc and used for the network byte/word
  swapping functions in the PTX /usr/include/netinet/in.h file.  GCC
  2.5.8 includes the file <sys/byteorder.h> which can be included into
  netinet/in.h to perform these byte/word swapping functions in the
  same manner.  Patches have been submitted to the FSF against GCC
  2.6.0 to fix this problem and allow Emacs to be built with GCC.

  If your machine does not have TCP/IP installed, you will have to edit the
  src/s/ptx.h file and comment out #define TCPIP_INSTALLED.

Siemens Nixdorf RM600 and RM400 (mips-siemens-sysv4)

  Changes merged in 19.29.  The version configured with
542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572
  `--with-x' works without any modifications, but `--with-x-toolkit'
  works only if the Athena library and the Toolkit library are linked
  statically.  For this, edit `src/Makefile' after the `configure' run
  and modify the lines with `-lXaw' and `-lXt' as follows:

    LIBW= /usr/lib/libXaw.a
    LIBXT= $(LIBW) -lXmu /usr/lib/libXt.a $(LIBXTR6) -lXext

  In addition, `--with-x-toolkit=motif' works only
  if the Motif library and the Toolkit library are linked statically.
  To do this, edit `src/Makefile' after the `configure' run
  and modify the lines with `-lXm' and `-lXt' as follows:

    LIBW= /usr/lib/libXm.a /usr/ccs/lib/libgen.a
    LIBXT= $(LIBW) -lXmu /usr/lib/libXt.a $(LIBXTR6) -lXext

SONY News (m68k-sony-bsd4.2 or m68k-sony-bsd4.3)

  18.52 worked.  Use m68k-sony-bsd4.3 for system release 3.

SONY News 3000 series (RISC NEWS) (mips-sony-bsd)

  The 19.26 pretest is reported to work.

  Some versions of the operating system give SIGTRAP for division by zero
  instead of the usual signals.  This causes division by zero
  to make Emacs crash.  The system should be fixed to give the proper signal.
  Changing Emacs is not a proper solution, because it would prevent
  Emacs from working under any debugger.  But you can change init_data
  in data.c if you wish.

Sun 3, Sun 4 (sparc), Sun 386 (sparc-sun-solaris2.*,
574 575
			       i386-sun-solaris2.*, sparc*-*-linux-gnu)

576 577 578 579 580 581 582 583 584 585 586
  To build a 32-bit Emacs (i.e. if you are having any sort of problem
  bootstrapping a 64-bit version), you can use the Sun Studio compiler
  and configure Emacs with:
    env CC="cc -xarch=v7" CFLAGS='' ./configure    # on SPARC systems
    env CC="cc -xarch=386" CFLAGS='' ./configure   # on x86 systems
  On Solaris 2.10, it is also possible to use /usr/sfw/bin/gcc to build
  a 32-bit version of Emacs.  Just make sure you point ./configure to
  the right compiler:

    env CC='/usr/sfw/bin/gcc -m32' ./configure

587 588 589 590
  To build a 64-bit Emacs (with larger maximum buffer size and
  including large file support) on a Solaris system which supports
  64-bit executables, use the Sun compiler, configuring something like
  this (see the cc documentation for information on 64-bit
591 592 593 594

    env CC="cc -xarch=v9" CFLAGS='' ./configure    # on SPARC systems
    env CC="cc -xarch=amd64" CFLAGS='' ./configure # on x86 systems
595 596 597 598

  As of version 2.95, GCC doesn't support the 64-bit ABI properly, but
  later releases may.

599 600 601 602 603 604
  Some versions of Solaris 8 have a bug in their XIM (X Input Method)
  implementation which causes Emacs to dump core when one of several
  frames is closed.  To avoid this, either install patch 108773-12
  (for Sparc) or 108874-12 (for x86), or configure Emacs with the
  `--with-xim=no' switch (you can use Leim input methods instead).

605 606 607 608 609 610 611
  On Solaris 2.7, building Emacs with WorkShop Compilers 5.0 98/12/15
  C 5.0 failed, apparently with non-default CFLAGS, most probably due to
  compiler bugs.  Using Sun Solaris 2.7 Sun WorkShop 6 update 1 C
  release was reported to work without problems.  It worked OK on
  another system with Solaris 8 using apparently the same 5.0 compiler
  and the default CFLAGS.

612 613 614 615 616
  Emacs 21.1 and 21.2 built with Sun's ProWorks PC3.0.1 compiler on
  Intel/Solaris 8 was reported to abort and dump core during startup.
  Using GCC or a newer SUN compiler (Sun WokShop 6 update 2 C 5.3
  2001/05/15) solves the problem.

617 618 619 620 621 622 623 624 625 626
  Emacs 20.5 and later work on SPARC GNU/Linux with the 32-bit ABI.
  As of release 2.95, GCC doesn't work properly with the 64-bit ABI
  (applicable on UltraSPARC), but that isn't the default mode.

  Emacs 20.3 fails to build on Solaris 2.5 if you use GCC
  Installing GCC 2.8 fixes the problem.

  19.32 works on Solaris 2.4 and 2.5.  On Solaris 2.5
  you may need one of these patches to prevent Emacs from crashing
  when it starts up:
Juanma Barranquero's avatar
Juanma Barranquero committed
627 628
        103093-03: [README] SunOS 5.5: kernel patch (2140557 bytes)
        102832-01: [README] OpenWindows 3.5: Xview Jumbo Patch (4181613 bytes)
629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683
	103242-04: [README] SunOS 5.5: linker patch (595363 bytes)

  There are reports that using SunSoft cc with -xO4 -xdepend produces
  bad code for some part of Emacs.

  Emacs works ok Sunos 4.1.x
  provided you completely replace your C shared library
  using one of the SunOS 4.1.x jumbo replacement patches from Sun.
  Here are the patch numbers for Sunos 4.1.3:
   100890-10   SunOS 4.1.3: domestic libc jumbo patch
   100891-10   SunOS 4.1.3: international libc jumbo patch

  Some people report that Emacs crashes immediately on startup when
  used with a non-X terminal, but we think this is due to compiling
  with GCC and failing to use GCC's "fixed" system header files.

  Some Sun versions of X windows use the clipboard, not the selections,
  for transferring text between clients.  The Cut, Paste and Copy items
  in the menu bar Edit menu work with the clipboard.

  A user reported irreproducible segmentation faults when using 19.29
  on Solaris 2.3 and 2.4 after compiling it with the Sun compiler.
  The problem went away when GCC 2.7.0 was used instead.  We do not know
  whether anything in Emacs is partly to blame for this.

  X11R6 is set up to make shared libraries only, on Sunos 4.
  Therefore, in order to link Emacs, you need to create static X libraries.
  To do this, rebuild X11 after setting
    #define ForceNormalLib YES
    #define SeparateSharedCompile YES
  in site.def (after #ifdef AfterVendorCF).

  If you compile with Sun's ANSI compiler acc, you need additional options
  when linking temacs, such as
     /usr/lang/SC2.0.1/values-Xt.o -L/usr/lang/SC2.0.1/cg87 -L/usr/lang/SC2.0.1
  (those should be added just before the libraries) and you need to
  add -lansi just before -lc.  The precise file names depend on the
  compiler version, so we cannot easily arrange to supply them.

  On Solaris 2, you need to install patch 100947-02 to fix a system bug.
  Presumably this patch comes from Sun.  You must alter the definition of
  LD_SWITCH_SYSTEM if your X11 libraries are not in /usr/openwin/lib.
  You must make sure that /usr/ucblib is not in your LD_LIBRARY_PATH.

  On Solaris 2.2, with a multiprocessor SparcCenter 1000, Emacs 19.17 is
  reported to hang sometimes if it exits while it has one or more
  subprocesses (e.g. the `wakeup' subprocess used by `display-time').
  Emacs and its subprocesses become zombies, and in their zombie state
  slow down their host and disable rlogin and telnet.  This is most
  likely due to a bug in Solaris 2.2's multiprocessor support,
  rather than an Emacs bug.

  On Solaris, do not use /usr/ucb/cc.  Use /opt/SUNWspro/bin/cc.  Make
  sure that /usr/ccs/bin and /opt/SUNWspro/bin are in your PATH before
  /usr/ucb.  (Most free software packages have the same requirement on
684 685 686
  Solaris.)  With this compiler, use `/opt/SUNWspro/bin/cc -E' as the
  preprocessor.  If this inserts extra whitespace into its output (see
  the PROBLEMS file) then add the option `-Xs'.
687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848 849 850 851 852 853

  If you have trouble using open-network-stream, get the distribution
  of `bind' (the BSD name-server), build libresolv.a, and link Emacs
  with -lresolv, by copying the #definition of LIBS_SYSTEM in
  src/s/sunos4-1.h to src/config.h.  This problem is due to obsolete
  software in the nonshared standard library.

  Note that Emacs on a Sun is not really as big as it looks.
  As dumped, it includes around 200k of zeros between the
  original text section and the original data section
  (now remapped as part of the text).  These are never
  swapped in.

  To build a single Emacs that will run on Sun 2 and Sun 3
  HARDWARE, just build it on the Sun 2.

  On Sunos 4.1.3, the word is that Emacs can loop infinitely
  on startup with X due perhaps to a bug in Sunos.  Installing all of
  these Sun patches fixes the problem.  We don't know which of them
  are really relevant.

    100075-11 100224-06 100347-03 100482-05 100557-02 100623-03 100804-03
    101080-01 100103-12 100249-09 100496-02 100564-07 100630-02 100891-10
    101134-01 100170-09 100296-04 100377-09 100507-04 100567-04 100650-02
    101070-01 101145-01 100173-10 100305-15 100383-06 100513-04 100570-05
    100689-01 101071-03 101200-02 100178-09 100338-05 100421-03 100536-02
    100584-05 100784-01 101072-01 101207-01

Tadpole 68K (m68k-tadpole-sysv)

  Changes merged in 19.1.

  You may need to edit Makefile to change the variables LIBDIR and
  BINDIR from /usr/local to /usr/contrib.

  To give movemail access to /usr/mail, you may need to execute

    chmod 2755 etc/movemail; chgrp mail etc/movemail

Tandem Integrity S2 (mips-tandem-sysv)

  Changes merged in 18.56 but subprocess support is turned off.
  You will probably want to see if you can make subprocesses work.

  You must edit `lib-src/Makefile' to define LOADLIBES = -mld.

Vaxen running Berkeley Unix (vax-dec-bsd4.1, vax-dec-bsd4.2, vax-dec-bsd4.3),
	      Ultrix (vax-dec-ultrix),
              System V (vax-dec-sysv0, vax-dec-sysv2), or
              VMS (vax-dec-vms)


  See under Ultrix for problems using X windows on Ultrix (vax-dec-ultrix).

  18.27 worked on System V rel 2 (vax-dec-sysv2).

  18.36 worked on System V rel 0 (vax-dec-sysv0).

  Richard Levitte <> distributes a set of patches to
  Emacs 18.59 to make it work nicely under VMS.  Emacs 19 probably
  won't work very well, or even compile.  Levitte is working on a
  port, so these problems should be fixed in the near future.

Here are notes about some of the systems supported:

Berkeley 4.1 (bsd4.1)

  Works on vaxes.

Berkeley 4.2 (bsd4.2)

  Works on several machines.

Berkeley 4.3 (bsd4.3)

  Works, on Vaxes at least.

Linux (actually GNU/Linux)

  Most of the complete systems which use the Linux kernel are close
  enough to the GNU system to be considered variant GNU systems.  We
  call them "Linux-based GNU systems," or GNU/Linux for short.

  It is not coincidence that many of the other components used with
  Linux--including GNU Emacs--were developed specifically for the GNU
  project.  The GNU project was launched in 1984 to develop a free
  complete Unix-like operating system.  To reach this goal, we had to
  develop whatever system components were not available as freely
  redistributable software from some other source.

  The GNU project wants users of GNU/Linux systems to be aware of how
  these systems relate to the GNU project, because that will help
  spread the GNU idea that software should be free--and thus encourage
  people to write more free software.  See the file LINUX-GNU in this
  directory for more explanation.


  See under "Intel 386".


  For installation on MSDOS, see the file INSTALL (search for `MSDOG',
  near the end of the file).  See the "MS-DOS" chapter of the manual
  for information about using Emacs on MSDOS.

SCO Unix

  If you are using MMDF instead of sendmail, you need to remove
  /usr/lib/sendmail or modify lisp/paths.el before compiling.
  lisp/paths.el (which is loaded during the build) will attempt to use
  sendmail if it exists.

  If you are using SMAIL, you need to define the macro
  SMAIL in config.h.

System V rel 0 (usg5.0)

  Works, on Vaxes and 3bxxx's.
  There are some problems in 18.37 due to shortnames/cccp problems:
  use the emacs 17 cpp if you have it.

System V rel 2 (usg5.2)

  Works on various machines.
  On some (maybe all) machines the library -lPW exists and contains
  a version of `alloca'.  On these machines, to use it, put
     #define HAVE_ALLOCA
     #define LIB_STANDARD -lPW -lc
  in the `src/m/MACHINENAME.h' file for the machine.

  If you find that the character Meta-DEL makes Emacs crash,
  find where function init_sys_modes in sysdep.c sets sg.c_cc[VQUIT]
  and make it store 7 there.  I have as yet no evidence of whether
  this problem, known in HP/UX, exists in other system V versions.

System V rel 2.2 (usg5.2.2)

  In 5.2.2 AT&T undid, incompatibly, their previous incompatible
  change to the way the nlist library is called.  A different s- file
  is used to enable the other interface.

  They call themselves the right choice--can't they choose?

  Emacs version 18 unexec is currently not working properly
  on 5.2.2.  Nobody knows why yet.  A workaround is to define
  NO_REMAP.  It is not yet known whether this applies to all
  machines running 5.2.2.

System V rel 3 (usg5.3)

  Some versions of this system support ptys and BSD-style sockets.
  On such systems, you should define HAVE_PTYS and HAVE_SOCKETS in config.h.

  If you want to link Emacs with shared libraries, define

  You may have to add ANSI idempotence #-lines to your sys/types.h
  file to get Emacs to compile correctly.  This may be necessary on
  other pre-ANSI systems as well.

  On an AT&T 6386WGS using System V Release 3.2 and X11R3, the X support
  cannot be made to work.  Whether or not the GNU relocating malloc is
  used, the symptom is that the first call Emacs makes to sbrk(0) returns
  (char *)-1.  Sorry, you're stuck with character-only mode.  Try
  installing XFree86 to fix this.
855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 882 883 884 885 886 887 888 889 890 891 892 893 894 895 896 897 898 899 900 901 902 903 904 905 906 907 908 909 910 911 912 913 914 915 916 917 918 919 920 921 922 923 924 925 926 927 928

System V rel 4.0.3 and 4.0.4 (usg5.4)

  Supported, including shared libraries for ELF, but ptys do not work
  because TIOCGPGRP fails to work on ptys (but Dell 2.2 seems to have
  fixed this).  This failure is probably due to a misunderstanding of
  the consequences of the POSIX spec: many system designers mistakenly
  think that POSIX requires this feature to fail.  This is untrue;
  ptys are an extension, and POSIX says that extensions *when used*
  may change the action of standard facilities in any fashion.

  If you get compilation errors about wrong number of
  arguments to getpgrp, define GETPGRP_NO_ARG.

  The standard C preprocessor may generate xmakefile incorrectly.  However,
  /lib/cpp will work, so use `make CPP=/lib/cpp'.  Standard cpp
  seems to work OK under Dell 2.2.

  Some versions 3 and earlier of V.4, on the Intel 386 and 860, had
  problems in the X11 libraries.  These prevent Emacs from working
  with X.  You can use Emacs with X provided your copy of X is based
  on X11 release 4 or newer, or is Dell's 2.2 (which is a 4.0.3).
  Unfortunately, the only way you can tell whether your X11 library is
  new enough is to try compiling Emacs to use X.  If emacs runs, your
  X11 library is new enough.

  In this context, GSV4 and GSV4i are alternate names for X11R4.
  OL2.* is X11R3 based.  OL3 is in between X11R3 and X11R4, and may or
  may not work, depending on who made the Unix system.  If the library
  libXol is part of the X distribution, then you have X11R3 and Emacs
  won't work with X.

  Most versions of V.4 support sockets.  If `/usr/lib/'
  exists, your system supports them.  If yours does not, you must add
  #undef HAVE_SOCKETS in config.h, after the inclusion of s-usg5-4.h.
  (Any system that supports Internet should implement sockets.)

Ultrix (bsd4.3)

  Recent versions of Ultrix appear to support the features of Berkeley 4.3.
  Ultrix was at the BSD 4.2 level for a long time after BSD 4.3 came out.

  Ultrix 3.0 has incompatibilities in its X library if you have the
  Ultrix version of X (UWS version 2.0).  To solve them, you need to
  prevent XvmsAlloc.o in Xlib from being used.  Israel Pinkas says:

    I added the following lines to config.h after the X defines:

    #if defined(ultrix) && defined(X11)
    #define OBJECTS_SYSTEM calloc.o

    Then I ran the following:

    ar x /usr/lib/libc.a calloc.o

  The problem is said to be gone in UWS version 2.1.

VMS (vmsM.N)

  Richard Levitte <> distributes a set of patches to
  Emacs 18.59 to make it work nicely under VMS.  Emacs 19 probably
  won't work very well, or even compile.  Levitte is working on a
  port, so these problems should be fixed in the near future.

  Note that Emacs for VMS is usually distributed in a special VMS
  distribution.  See the file ../vms/VMSINSTALL for info on moving
  Unix distributions to VMS, and other VMS-related topics.

Windows NT/95/98/ME/2000

  For installation on all versions of the MS-Windows platform, see the
  file nt/INSTALL.

929 930 931 932 933 934 935 936 937 938 939
X86_64 GNU/Linux

  No special procedures should be needed to build a 64-bit Emacs.  To
  build a 32-bit Emacs, first ensure that the necessary 32-bit system
  libraries and include files are installed.  Then use:

    env CC="gcc -m32" ./configure --build=i386-linux-gnu \

  (using the location of the 32-bit X libraries on your system).

940 941
Local variables:
mode: text
943 944
fill-prefix: "  "
Miles Bader's avatar
Miles Bader committed

946 947 948 949
This file is part of GNU Emacs.

GNU Emacs is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3, or (at your option)
951 952 953 954 955 956 957 958 959 960 961
any later version.

GNU Emacs is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with GNU Emacs; see the file COPYING.  If not, write to the
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
Boston, MA 02110-1301, USA.

Miles Bader's avatar
Miles Bader committed
arch-tag: 7d2e93c7-e982-40ec-9055-3cd064042473