3 Copyright (C) 1989, 1990, 1992, 1993, 1998, 2001, 2002, 2003, 2004,
4 2005, 2006, 2007 Free Software Foundation, Inc.
5 See the end of the file for license conditions.
7 This is a list of the status of GNU Emacs on various machines and systems.
9 For each system and machine, we give the configuration name you should
10 pass to the `configure' script to prepare to build Emacs for that
13 The `configure' script uses the configuration name to decide which
14 machine and operating system description files `src/config.h' should
15 include. The machine description files are all in `src/m', and have
16 names similar to, but not identical to, the machine names used in
17 configuration names. The operating system files are all in `src/s',
18 and are named similarly. See the `configure' script if you need to
19 know which configuration names use which machine and operating system
22 If you add support for a new configuration, add a section to this
23 file, and then edit the `configure' script to tell it which
24 configuration name(s) should select your new machine description and
25 system description files.
28 Here are the configurations Emacs is intended to work with, with the
29 corresponding configuration names. You can postpend version numbers
30 to operating system names (i.e. sunos4.1) or architecture names (i.e.
31 hppa1.1). If you leave out the version number, the `configure' script
32 will configure Emacs for the latest version it knows about.
34 Alpha (DEC) running GNU/Linux (alpha-dec-linux-gnu)
36 DEC C compiler version 5.9 (DEC C V5.9-005 on Digital UNIX V4.0f)
37 is reported to produce bogus binaries of Emacs 21.2 when the
38 command-line switches "-O4 -arch ev6 -tune ev6" are used. Using
39 just -O4 produces a good executable.
41 For 4.0 revision 564, and 4.0A and 4.0B, Emacs 20 seems to work
42 with no special configuration options. However, if you use GCC as
43 your compiler, you will need version 2.8.1 or later, as older
44 versions fail to build with a message "Invalid dimension for the
47 Note that the X11 libraries on GNU/Linux systems for the Alpha are
48 said to have bugs that prevent Emacs from working with X (as of
49 November 1995). Recent releases work (July 2000).
51 Apple Macintosh running Mac OS X
53 For installation on all versions of the Mac OS platform, see the file
56 Apple PowerPC Macintosh running GNU/Linux
58 There are special considerations for a variety of this system which
59 is known as the ``Yellow Dog [GNU/]Linux'': Emacs may crash during
60 dumping. To solve this, edit the header file src/m/macppc.h in the
61 Emacs distribution, and remove the "#if 0" and "#endif" directives
62 which surround the following block near the end of the file:
64 #if 0 /* This breaks things on PPC GNU/Linux except for Yellowdog,
65 even with identical GCC, as, ld. Let's take it out until we
66 know what's really going on here. */
67 /* GCC 2.95 and newer on GNU/Linux PPC changed the load address to
70 #if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 95)
71 #define DATA_SEG_BITS 0x10000000
76 After that, reconfigure and rebuild Emacs. It should now build
79 Cubix QBx/386 (i386-cubix-sysv)
81 Changes merged in 19.1. Systems before 2/A/0 may fail to compile etags.c
82 due to a compiler bug.
84 DECstation (mips-dec-ultrix or mips-dec-osf)
86 This machine is the older Mips-based DECstation.
87 Emacs should now work on the Alpha CPU.
89 19.25 works on Ultrix 4.2. The 19.26 pretest was reported to work
90 on Ultrix 4.2a and on 4.4.
92 One user reported 19.25 did not work at all with --with-x-toolkit
93 using X11R5 patch level 10, but worked ok with X11R5 pl26.
95 See under Ultrix for problems using X windows on Ultrix.
96 Note that this is a MIPS machine.
98 For Ultrix versions 4.1 or earlier, you may need to define
99 SYSTEM_MALLOC in `src/m/pmax.h', because XvmsAlloc.o in libX11.a seems
100 to insist on defining malloc itself.
102 For Ultrix versions prior to 4.0, you may need to delete
103 the definition of START_FILES from `src/m/pmax.h'.
105 Motorola Delta 147 (m68k-motorola-sysv)
107 The EMacs 19.26 pretest was reported to work.
109 Motorola Delta boxes running System V/68 release 3.
110 Tested on 147 board with SVR3V7, no X and gcc.
111 Tested on 167 board with SVR3V7, no X, cc, gnucc and gcc.
112 Reports say it works with X too.
114 The installation script chooses the compiler itself. gnucc is
117 Fujitsu DS/90 (sparc-fujitsu-sysv4)
119 Changes merged in 20.3.
121 GEC 63 (local-gec63-usg5.2)
123 Changes are partially merged in version 18, but certainly require
124 more work. Let us know if you get this working, and we'll give it a
125 real configuration name.
127 Harris Power PC (powerpc-harris-powerunix)
129 Patches have been merged in 19.31.
131 Hewlett-Packard 9000 series 200 or 300 (m68k-hp-bsd or m68k-hp-hpux
134 These machines are 68000-series CPUs running HP/UX
135 (a derivative of sysV with some BSD features) or BSD 4.3 ported by Utah.
136 The operating system suffix determines which system Emacs is built for.
138 Series 200 HPUX runs Emacs only if it has the "HP/UX upgrade".
140 Version 19 works under BSD. The 19.26 pretest was reported
141 to work on HPUX 9. 19.31 works on HPUX 10.01, but there are
142 some problems on 10.10 which have not been resolved. Emacs 19.34
143 works on HPUX 10.20 provided you compile with GCC; with the HP C
144 compiler, subprocess commands do not work.
146 On HPUX 9, Emacs sometimes crashes with SIGBUS or SIGSEGV after you
147 delete a frame. We think this is due to a bug in the X libraries
148 provided by HP. With the alternative X libraries in
149 /usr/contrib/mitX11R5/lib, the problem does not happen.
151 If you are running HP/UX release 8.0 or later, you need the optional
152 "C/ANSI C" software in order to build Emacs (older releases of HP/UX
153 do not require any special software). If the file "/etc/filesets/C"
154 exists on your machine, you have this software, otherwise you do not.
156 Note that HP has used two incompatible assembler syntaxes,
157 and has recently changed the format of C function frames.
158 `src/crt0.c' and `src/alloca.s' have been conditionalised for the new
159 assembler and new function-entry sequence. You may need to define
160 OLD_HP_ASSEMBLER if you are using an older hpux version. If you
161 have an official (bought from HP) series 300 machine you have
162 the new assembler. Kernels that are 5.+ or later have new
163 assembler. A Series 200 that has been upgraded to a 68010
164 processor and a 5.+ kernel has the new compiler.
166 Define C_SWITCH_MACHINE to be +X to make a version of Emacs that
167 runs on both 68010 and 68020 based HP/UX's.
169 Define HPUX_68010 if you are using the new assembler, for
170 a system that has a 68010 without a 68881. This is to say,
171 a s200 (upgraded) or s310.
173 Define the symbol HPUX_NET if you have the optional network features
174 that include the `netunam' system call. This is referred to as
175 Network Services (NS/9000) in HP literature.
177 HP 9000 series 500: not supported.
179 The series 500 has a seriously incompatible memory architecture
180 which relocates data in memory during execution of a program,
181 and support for it would be difficult to implement.
183 HP 9000 series 700 or 800 (Spectrum) (hppa1.0-hp-hpux or hppa1.1-hp-hpux
184 or ...hpux9shr, or ...-nextstep)
186 Use hppa1.1 for the 700 series and hppa1.0 for the 800
187 series machines. (Emacs may not actually care which one you use.)
189 Support for NextSTEP was added in 19.31.
191 Emacs 20 may work on HPUX 10. You need patch PHSS_6202 to install
192 the Xaw and Xmu libraries. On HPUX 10.20 you may need to compile with GCC;
193 when Emacs was compiled with HP's C compiler, HP92453-01 A.10.32.03,
194 the subprocess features failed to work.
196 19.26 is believed to work on HPUX 9 provided you compile with GCC.
197 As of version 19.16, Emacs was reported to build (using GCC) and run
198 on HP 9000/700 series machines running HP/UX versions 8.07 and 9.01.
199 The HP compiler is known to fail on some versions if you use +O3,
200 but it may work with lower optimization levels.
202 Use hppa1.1-hp-hpux9shr to use shared libraries on HPUX version 9.
203 You may need to create the X libraries libXaw.a and libXmu.a from
204 the MIT X distribute, and you may need to edit src/Makefile's
205 definition of LIBXT to look like this:
207 LIBXT= $(LIBW) -lXmu -lXt $(LIBXTR6) -lXext
209 Some people report trouble using the GNU memory allocator under
210 HP/UX version 9. The problems often manifest as lots of ^@'s in the
213 We are told that these problems go away if you obtain the latest
214 patches for the HP/UX C compiler. James J Dempsey
215 <jjd@spserv.bbn.com> says that this set of versions works for him:
217 HP92453-01 A.09.28 HP C Compiler
219 HP92453-01 A.09.28 HP C Compiler
220 HP-UX SLLIC/OPTIMIZER HP-UX.09.00.23 02/18/93
221 Ucode Code Generator - HP-UX.09.00.23.5 (patch) 2/18/93
223 For 700 series machines, the HP-UX patch needed is known as
224 PHSS_2653. (Perhaps for 800 series machines as well; we don't
225 know.) If you are on the Internet, you should be able to obtain
226 this patch by using telnet to access the machine
227 support.mayfield.hp.com and logging in as "hpslreg" and following
228 the instructions there. Or you may be able to use this
231 HP Patch Server: http://support.mayfield.hp.com/patches/html/patches.html
232 HP Support Line: http://support.mayfield.hp.com
234 Please do not ask FSF for further support on this. If you have any
235 trouble obtaining the patch, contact HP Software Support.
237 If your buffer fills up with nulls (^@) at some point, it could well
238 be that problem. That problem does not happen when people use GCC
239 to compile Emacs. On the other hand, the HP compiler version 9.34
240 was reported to work for the 19.26 pretest. 9.65 was also reported to work.
242 If you turn on the DSUSP character (delayed suspend),
243 Emacs 19.26 does not know how to turn it off on HPUX.
244 You need to turn it off manually.
246 If you are running HP/UX release 8.0 or later, you need the optional
247 "C/ANSI C" software in order to build Emacs (older releases of HP/UX
248 do not require any special software). If the file "/etc/filesets/C"
249 exists on your machine, you have this software, otherwise you do not.
251 IBM PS/2 (i386-ibm-aix1.1 or i386-ibm-aix1.2)
253 Changes merged in version 19. You may need to copy
254 /usr/lib/samples/hft/hftctl.c to the Emacs src directory.
256 i386-ibm-aix1.1 may not work with certain new X window managers, and
259 IBM RS/6000 (rs6000-ibm-aix*)
261 Emacs 19.26 is believed to work; its pretest was tested.
263 Compiling with the system's `cc' and CFLAGS containing `-O5' might
264 fail because libXbsd isn't found. This is a compiler bug;
265 re-configure Emacs so that it isn't compiled with `-O5'.
267 On AIX 4.3.x and 4.4, compiling with /bin/c89 fails because it
268 treats certain warnings as errors. Use `cc' instead.
270 At last report, Emacs didn't run well on terminals. Informed
271 persons say that the tty VMIN and VTIME settings have been
272 corrupted; if you have a fix, please send it to us.
274 Compiling with -O using the IBM compiler has been known
275 to make Emacs work incorrectly. It's reported that on
276 AIX 3.2.5 with an IBM compiler earlier than 1.03.00.14,
277 cc -O fails for some files. You need to install any
278 PTF containing APAR #IX42810 to bring the compiler to
279 the 1.03.00.14 level to allow optimized compiles.
281 There are reports that IBM compiler versions earlier than 1.03.00.02
282 fail even without -O. However, another report said that compiler
283 version 1.02.01.00 did work, on AIX 3.2.4, with Emacs 19.31.
285 As of 19.11, if you strip the Emacs executable, it ceases to work.
287 If you are using AIX 3.2.3, you may get a core dump when loading
288 ange-ftp. You may be able to fix the problem by defining LIBS_TERMCAP
289 as -ltermcap -lcurses. Please tell us if this fails to work.
291 If anyone can fix the above problems, or confirm that they don't happen
292 with certain versions of various programs, we would appreciate it.
294 IBM System/390 running GNU/Linux (s390-*-linux-gnu)
296 As of Emacs 21.2, a 31-bit only version is supported on this
299 Integrated Solutions `Optimum V' (m68k-isi-bsd4.2 or -bsd4.3)
301 18.52 said to work on some sort of ISI machine.
302 Version 18.45 worked (running on a Optimum V (VME bus, 68020)
303 BSD 4.2 (3.05e) system). 18.42 is reported to work on
304 a Qbus 68010 system. Has not been tried on `WorkStation' `Cluster
305 Compute Node' `Cluster WorkStation' or `Server Node' (Love the
308 Compilation with -O is rumored to break something.
310 On recent system versions, you may need to undefine the macro UMAX
311 in `lib-src/loadst.c' and `src/getpagesize.h'. They stupidly defined this
312 in a system header file, which confuses Emacs (which thinks that UMAX
313 indicates the Umax operating system).
315 Intel 386 (i386-*-bsdi2, i386-*-freebsd, i386-*-linux-gnu,
316 i386-*-sol2.4, i386-*-sysv3, i386-intsys-sysv,
317 i386-*-sysv4, i386-*-sysv4.2,
318 i386-*-sysv5.3, i386-*-bsd4.2, i386-*-cygwin,
319 i386-*-bsd386, i386-*-386bsd,
320 i386-*-msdos, i386-*-windowsnt.
321 i386... can be replaced with i486... or i586...)
323 In the above configurations, * means that the manufacturer's name
324 you specify does not matter, and you can use any name you like
325 (but it should not contain any dashes or stars).
327 When using the ISC configurations, be sure to specify the isc
328 version number - for example, if you're running ISC 3.0, use
329 i386-unknown-isc3.0 as your configuration name.
330 Use i386-*-linux-gnu for GNU/Linux systems; Emacs runs as of version 19.26.
331 Use i386-*-cygwin for Cygwin; Emacs builds as of version 22.1, in both X11
332 and non-X11 modes. (The Cygwin site has source and binaries for 21.2.)
333 Use i386-intsys-sysv for Integrated Solutions 386 machines.
334 It may also be correct for Microport systems.
336 On GNU/Linux systems, Emacs 19.23 was said to work properly with libc
337 version 4.5.21, but not with 4.5.19. If your system uses QMAGIC
338 for the executable format, you must edit config.h to define LINUX_QMAGIC.
340 On GNU/Linux, configure may fail to put these definitions in config.h:
342 #define HAVE_GETTIMEOFDAY
345 #define HAVE_XSCREENNUMBEROFSCREEN
347 To work around the problem, add those definitions by hand.
348 It is possible that this problem happens only with X11R6.
349 Newer system versions have fixed it.
351 The 19.26 pretest was reported to work on SVR4.3 and on Freebsd.
353 19.29 is reported to crash when using Motif on Solaris 2.5.
354 The reasons are not yet known.
356 Use i386-*-bsdiN for BSDI BSD/OS version N; Emacs runs as of version 19.23.
357 In some system versions, `make' is broken; use GNU make instead.
358 Shell bugs in version 1.0 of BSD/OS cause configure
359 to do the wrong thing with --with-x-toolkit; the workaround is to edit
360 configure to run another shell such as bash.
362 For System V release 3, use i386-*-sysv3.
363 For System V release 4, use i386-*-sysv4.
364 For System V release 4.2, use i386-*-sysv4.2.
366 If you are using SCO Unix, see notes at end under SCO.
368 On 386bsd, NetBSD and FreeBSD, at one time, it was necessary to use
369 GNU make, not the system's make. Assuming it's installed as gmake,
370 do `gmake install MAKE=gmake'. However, more recently it is
371 reported that using the system Make on NetBSD 1.3.1 works ok.
373 If you are using System V release 4.2, you may find that `cc -E'
374 puts spurious spaces in `src/xmakefile'. If that happens,
375 specify CPP=/lib/cpp as an option when you run make.
376 There is no problem if you compile with GCC.
378 Note that use of Linux with GCC 2.4 and the DLL 4.4 libraries
379 requires the experimental "net 2" network patches (no relation to
380 Berkeley Net 2). There is a report that (some version of) Linux
381 requires including `/usr/src/linux/include/linux' in buffer.c
382 but no coherent explanation of why that might be so. If it is so,
383 in current versions of Linux, something else should probably be changed.
385 Some sysV.3 systems seem to have bugs in `opendir';
386 for them, alter `config.h' to define NONSYSTEM_DIR_LIBRARY
387 and undefine SYSV_SYSTEM_DIR.
389 If you use optimization on V.3, you may need the option -W2,'-y 0'
390 to prevent certain faulty optimization.
392 On 386/ix, to link with shared libraries, add #define USG_SHARED_LIBRARIES
395 On SCO, there are problems in regexp matching when Emacs is compiled
396 with the system compiler. The compiler version is "Microsoft C
397 version 6", SCO 4.2.0h Dev Sys Maintenance Supplement 01/06/93;
398 Quick C Compiler Version 1.00.46 (Beta). The solution is to compile
401 On ISC systems (2.02 and more recent), don't try to use the versions
402 of X that come with the system; use XFree86 instead.
404 There is no consistency in the handling of certain system header files
407 Some versions have sys/sioctl.h, and require it in sysdep.c.
408 But some versions do not have sys/sioctl.h.
409 For a given version of the system, this may depend on whether you have
410 X Windows or TCP/IP. Define or undefine NO_SIOCTL_H in config.h
411 according to whether you have the file.
413 Likewise, some versions have been known to need sys/ttold.h, sys/stream.h,
414 and sys/ptem.h included in sysdep.c. If your system has these files,
415 try defining NEED_PTEM_H in config.h if you have trouble without it.
417 You may find that adding -I/usr/X/include or -I/usr/netinclude or both
418 to CFLAGS avoids compilation errors on certain systems.
420 Some versions convince sysdep.c to try to use `struct tchars'
421 but define `struct tc' instead; add `#define tchars tc'
422 to config.h to solve this problem.
424 Iris 2500 and Iris 2500 Turbo (m68k-sgi-iris3.5 or m68k-sgi-iris3.6)
426 Version 18 was said to work; use m68k-sgi-iris3.5 for system version 2.5
427 and m68k-sgi-iris3.6 for system version 3.6.
428 Note that the 3030 is the same as the Iris 2500 Turbo.
430 Iris 4D (mips-sgi-irix[456].*)
432 Emacs 21.3 is reported to work on IRIX 6.5.x.
434 You can build a 64-bit executable (with larger maximum buffer size)
435 on Irix 6.5 by specifying the 64-bit ABI using the `-64' compiler
436 flag or otherwise (see cc(1)). This may work on earlier Irix 6
437 systems if you edit src/s/irix6-0.h following irix6-5.h.
439 If compiling with GCC on Irix 6 yields an error "conflicting types
440 for `initstate'", install GCC 2.95 or a newer version, and this
441 problem should go away. It is possible that this problem results
442 from upgrading the operating system without reinstalling GCC; so you
443 could also try reinstalling the same version of GCC, and telling us
444 whether that fixes the problem.
446 Mips (mips-mips-riscos, mips-mips-riscos4.0, or mips-mips-bsd)
448 The C compiler on Riscos 4.51 dumps core trying to optimize
449 parts of Emacs. Try without optimization or try GCC.
451 Meanwhile, the linker on that system returns success even if
452 there are undefined symbols; as a result, configure gets the
453 wrong answers to various questions. No work-around is known
454 except to edit src/config.h by hand to indicate which functions
457 Use mips-mips-riscos4.0 for RISCOS version 4.
458 Use mips-mips-bsd with the BSD world.
460 Note that the proper configuration names for DECstations are
461 mips-dec-ultrix and mips-dec-osf.
463 If you are compiling with GCC, then you must run fixincludes;
464 the alternative of using -traditional won't work because
465 the definition of SIGN_EXTEND_CHAR uses the keyword `signed'.
467 If the SYSV world is the default, then you probably need the following
468 line in etc/Makefile:
470 CFLAGS= -g -systype bsd43
472 Some operating systems on MIPS machines give SIGTRAP for division by
473 zero instead of the usual signals. The only real solution is to fix
474 the system to give a proper signal.
476 In the meantime, you can change init_data in data.c if you wish.
477 Change it to handle SIGTRAP as well as SIGFPE. But this will have a
478 great disadvantage: you will not be able to run Emacs under a
479 debugger. I think crashing on division by zero is a lesser problem.
481 dsg@mitre.org reported needing to use --x-libraries=/bsd43/usr/lib
482 on a riscos4bsd site. But it is not clear whether this is needed in
483 general or only because of quirks on a particular site.
485 NCR Intel system (i386-ncr-sysv4.2)
487 This system works in 19.31, but if you don't link it with GNU ld,
488 you may need to set LD_RUN_PATH at link time to specify where
489 to find the X libraries.
491 NEC EWS4800 (mips-nec-sysv4)
493 This system works in 20.4, but you should use the compiler
494 /usr/abiccs/bin/cc (MIPS ABI MODE).
496 NeXT (m68k-next-nextstep)
498 Emacs 19 has not been tested extensively yet, but it seems to work
499 in a NeXTStep 3.0 terminal window, and under the X server called
500 co-Xist. You may need to specify -traditional when src/Makefile
503 NeXT users might want to implement direct operation with NeXTStep,
504 but from the point of view of the GNU project, that is a
507 Thanks to Thorsten Ohl for working on the NeXT port of Emacs 19.
509 Pmax (DEC Mips) (mips-dec-ultrix or mips-dec-osf1)
511 See under DECstation, above.
513 Prime EXL (i386-prime-sysv)
515 Minor changes merged in 19.1.
517 Sequent Symmetry (i386-sequent-bsd, i386-sequent-ptx, i386-sequent-ptx4)
519 19.33 has changes to support ptx 4 (a modified SVR4).
521 Emacs 19 should work on Dynix (BSD). However, if you compile with
522 the Sequent compiler, you may find Emacs does not restore the
523 terminal settings on exit. If this happens, compile with GCC.
525 Emacs 19.27 contains patches that should support
526 DYNIX/ptx 1.4 and 2.1 with the native cc compiler.
528 GCC can't compile src/process.c due to a non-standard Sequent asm
529 keyword extension supported by cc and used for the network byte/word
530 swapping functions in the PTX /usr/include/netinet/in.h file. GCC
531 2.5.8 includes the file <sys/byteorder.h> which can be included into
532 netinet/in.h to perform these byte/word swapping functions in the
533 same manner. Patches have been submitted to the FSF against GCC
534 2.6.0 to fix this problem and allow Emacs to be built with GCC.
536 If your machine does not have TCP/IP installed, you will have to edit the
537 src/s/ptx.h file and comment out #define TCPIP_INSTALLED.
539 Siemens Nixdorf RM600 and RM400 (mips-siemens-sysv4)
541 Changes merged in 19.29. The version configured with
542 `--with-x' works without any modifications, but `--with-x-toolkit'
543 works only if the Athena library and the Toolkit library are linked
544 statically. For this, edit `src/Makefile' after the `configure' run
545 and modify the lines with `-lXaw' and `-lXt' as follows:
547 LIBW= /usr/lib/libXaw.a
548 LIBXT= $(LIBW) -lXmu /usr/lib/libXt.a $(LIBXTR6) -lXext
550 In addition, `--with-x-toolkit=motif' works only
551 if the Motif library and the Toolkit library are linked statically.
552 To do this, edit `src/Makefile' after the `configure' run
553 and modify the lines with `-lXm' and `-lXt' as follows:
555 LIBW= /usr/lib/libXm.a /usr/ccs/lib/libgen.a
556 LIBXT= $(LIBW) -lXmu /usr/lib/libXt.a $(LIBXTR6) -lXext
558 SONY News (m68k-sony-bsd4.2 or m68k-sony-bsd4.3)
560 18.52 worked. Use m68k-sony-bsd4.3 for system release 3.
562 SONY News 3000 series (RISC NEWS) (mips-sony-bsd)
564 The 19.26 pretest is reported to work.
566 Some versions of the operating system give SIGTRAP for division by zero
567 instead of the usual signals. This causes division by zero
568 to make Emacs crash. The system should be fixed to give the proper signal.
569 Changing Emacs is not a proper solution, because it would prevent
570 Emacs from working under any debugger. But you can change init_data
571 in data.c if you wish.
573 Sun 3, Sun 4 (sparc), Sun 386 (sparc-sun-solaris2.*,
574 i386-sun-solaris2.*, sparc*-*-linux-gnu)
576 To build a 32-bit Emacs (i.e. if you are having any sort of problem
577 bootstrapping a 64-bit version), you can use the Sun Studio compiler
578 and configure Emacs with:
579 env CC="cc -xarch=v7" CFLAGS='' ./configure # on SPARC systems
580 env CC="cc -xarch=386" CFLAGS='' ./configure # on x86 systems
581 On Solaris 2.10, it is also possible to use /usr/sfw/bin/gcc to build
582 a 32-bit version of Emacs. Just make sure you point ./configure to
585 env CC='/usr/sfw/bin/gcc -m32' ./configure
587 To build a 64-bit Emacs (with larger maximum buffer size and
588 including large file support) on a Solaris system which supports
589 64-bit executables, use the Sun compiler, configuring something like
590 this (see the cc documentation for information on 64-bit
593 env CC="cc -xarch=v9" CFLAGS='' ./configure # on SPARC systems
594 env CC="cc -xarch=amd64" CFLAGS='' ./configure # on x86 systems
596 As of version 2.95, GCC doesn't support the 64-bit ABI properly, but
599 Some versions of Solaris 8 have a bug in their XIM (X Input Method)
600 implementation which causes Emacs to dump core when one of several
601 frames is closed. To avoid this, either install patch 108773-12
602 (for Sparc) or 108874-12 (for x86), or configure Emacs with the
603 `--with-xim=no' switch (you can use Leim input methods instead).
605 On Solaris 2.7, building Emacs with WorkShop Compilers 5.0 98/12/15
606 C 5.0 failed, apparently with non-default CFLAGS, most probably due to
607 compiler bugs. Using Sun Solaris 2.7 Sun WorkShop 6 update 1 C
608 release was reported to work without problems. It worked OK on
609 another system with Solaris 8 using apparently the same 5.0 compiler
610 and the default CFLAGS.
612 Emacs 21.1 and 21.2 built with Sun's ProWorks PC3.0.1 compiler on
613 Intel/Solaris 8 was reported to abort and dump core during startup.
614 Using GCC or a newer SUN compiler (Sun WokShop 6 update 2 C 5.3
615 2001/05/15) solves the problem.
617 Emacs 20.5 and later work on SPARC GNU/Linux with the 32-bit ABI.
618 As of release 2.95, GCC doesn't work properly with the 64-bit ABI
619 (applicable on UltraSPARC), but that isn't the default mode.
621 Emacs 20.3 fails to build on Solaris 2.5 if you use GCC 2.7.2.3.
622 Installing GCC 2.8 fixes the problem.
624 19.32 works on Solaris 2.4 and 2.5. On Solaris 2.5
625 you may need one of these patches to prevent Emacs from crashing
627 103093-03: [README] SunOS 5.5: kernel patch (2140557 bytes)
628 102832-01: [README] OpenWindows 3.5: Xview Jumbo Patch (4181613 bytes)
629 103242-04: [README] SunOS 5.5: linker patch (595363 bytes)
631 There are reports that using SunSoft cc with -xO4 -xdepend produces
632 bad code for some part of Emacs.
634 Emacs works ok Sunos 4.1.x
635 provided you completely replace your C shared library
636 using one of the SunOS 4.1.x jumbo replacement patches from Sun.
637 Here are the patch numbers for Sunos 4.1.3:
638 100890-10 SunOS 4.1.3: domestic libc jumbo patch
639 100891-10 SunOS 4.1.3: international libc jumbo patch
641 Some people report that Emacs crashes immediately on startup when
642 used with a non-X terminal, but we think this is due to compiling
643 with GCC and failing to use GCC's "fixed" system header files.
645 Some Sun versions of X windows use the clipboard, not the selections,
646 for transferring text between clients. The Cut, Paste and Copy items
647 in the menu bar Edit menu work with the clipboard.
649 A user reported irreproducible segmentation faults when using 19.29
650 on Solaris 2.3 and 2.4 after compiling it with the Sun compiler.
651 The problem went away when GCC 2.7.0 was used instead. We do not know
652 whether anything in Emacs is partly to blame for this.
654 X11R6 is set up to make shared libraries only, on Sunos 4.
655 Therefore, in order to link Emacs, you need to create static X libraries.
656 To do this, rebuild X11 after setting
657 #define ForceNormalLib YES
658 #define SeparateSharedCompile YES
659 in site.def (after #ifdef AfterVendorCF).
661 If you compile with Sun's ANSI compiler acc, you need additional options
662 when linking temacs, such as
663 /usr/lang/SC2.0.1/values-Xt.o -L/usr/lang/SC2.0.1/cg87 -L/usr/lang/SC2.0.1
664 (those should be added just before the libraries) and you need to
665 add -lansi just before -lc. The precise file names depend on the
666 compiler version, so we cannot easily arrange to supply them.
668 On Solaris 2, you need to install patch 100947-02 to fix a system bug.
669 Presumably this patch comes from Sun. You must alter the definition of
670 LD_SWITCH_SYSTEM if your X11 libraries are not in /usr/openwin/lib.
671 You must make sure that /usr/ucblib is not in your LD_LIBRARY_PATH.
673 On Solaris 2.2, with a multiprocessor SparcCenter 1000, Emacs 19.17 is
674 reported to hang sometimes if it exits while it has one or more
675 subprocesses (e.g. the `wakeup' subprocess used by `display-time').
676 Emacs and its subprocesses become zombies, and in their zombie state
677 slow down their host and disable rlogin and telnet. This is most
678 likely due to a bug in Solaris 2.2's multiprocessor support,
679 rather than an Emacs bug.
681 On Solaris, do not use /usr/ucb/cc. Use /opt/SUNWspro/bin/cc. Make
682 sure that /usr/ccs/bin and /opt/SUNWspro/bin are in your PATH before
683 /usr/ucb. (Most free software packages have the same requirement on
684 Solaris.) With this compiler, use `/opt/SUNWspro/bin/cc -E' as the
685 preprocessor. If this inserts extra whitespace into its output (see
686 the PROBLEMS file) then add the option `-Xs'.
688 If you have trouble using open-network-stream, get the distribution
689 of `bind' (the BSD name-server), build libresolv.a, and link Emacs
690 with -lresolv, by copying the #definition of LIBS_SYSTEM in
691 src/s/sunos4-1.h to src/config.h. This problem is due to obsolete
692 software in the nonshared standard library.
694 Note that Emacs on a Sun is not really as big as it looks.
695 As dumped, it includes around 200k of zeros between the
696 original text section and the original data section
697 (now remapped as part of the text). These are never
700 To build a single Emacs that will run on Sun 2 and Sun 3
701 HARDWARE, just build it on the Sun 2.
703 On Sunos 4.1.3, the word is that Emacs can loop infinitely
704 on startup with X due perhaps to a bug in Sunos. Installing all of
705 these Sun patches fixes the problem. We don't know which of them
708 100075-11 100224-06 100347-03 100482-05 100557-02 100623-03 100804-03
709 101080-01 100103-12 100249-09 100496-02 100564-07 100630-02 100891-10
710 101134-01 100170-09 100296-04 100377-09 100507-04 100567-04 100650-02
711 101070-01 101145-01 100173-10 100305-15 100383-06 100513-04 100570-05
712 100689-01 101071-03 101200-02 100178-09 100338-05 100421-03 100536-02
713 100584-05 100784-01 101072-01 101207-01
715 Tadpole 68K (m68k-tadpole-sysv)
717 Changes merged in 19.1.
719 You may need to edit Makefile to change the variables LIBDIR and
720 BINDIR from /usr/local to /usr/contrib.
722 To give movemail access to /usr/mail, you may need to execute
724 chmod 2755 etc/movemail; chgrp mail etc/movemail
726 Tandem Integrity S2 (mips-tandem-sysv)
728 Changes merged in 18.56 but subprocess support is turned off.
729 You will probably want to see if you can make subprocesses work.
731 You must edit `lib-src/Makefile' to define LOADLIBES = -mld.
733 Vaxen running Berkeley Unix (vax-dec-bsd4.1, vax-dec-bsd4.2, vax-dec-bsd4.3),
734 Ultrix (vax-dec-ultrix),
735 System V (vax-dec-sysv0, vax-dec-sysv2), or
740 See under Ultrix for problems using X windows on Ultrix (vax-dec-ultrix).
742 18.27 worked on System V rel 2 (vax-dec-sysv2).
744 18.36 worked on System V rel 0 (vax-dec-sysv0).
746 Richard Levitte <levitte@e.kth.se> distributes a set of patches to
747 Emacs 18.59 to make it work nicely under VMS. Emacs 19 probably
748 won't work very well, or even compile. Levitte is working on a
749 port, so these problems should be fixed in the near future.
752 Here are notes about some of the systems supported:
754 Berkeley 4.1 (bsd4.1)
758 Berkeley 4.2 (bsd4.2)
760 Works on several machines.
762 Berkeley 4.3 (bsd4.3)
764 Works, on Vaxes at least.
766 Linux (actually GNU/Linux)
768 Most of the complete systems which use the Linux kernel are close
769 enough to the GNU system to be considered variant GNU systems. We
770 call them "Linux-based GNU systems," or GNU/Linux for short.
772 It is not coincidence that many of the other components used with
773 Linux--including GNU Emacs--were developed specifically for the GNU
774 project. The GNU project was launched in 1984 to develop a free
775 complete Unix-like operating system. To reach this goal, we had to
776 develop whatever system components were not available as freely
777 redistributable software from some other source.
779 The GNU project wants users of GNU/Linux systems to be aware of how
780 these systems relate to the GNU project, because that will help
781 spread the GNU idea that software should be free--and thus encourage
782 people to write more free software. See the file LINUX-GNU in this
783 directory for more explanation.
787 See under "Intel 386".
791 For installation on MSDOS, see the file INSTALL (search for `MSDOG',
792 near the end of the file). See the "MS-DOS" chapter of the manual
793 for information about using Emacs on MSDOS.
797 If you are using MMDF instead of sendmail, you need to remove
798 /usr/lib/sendmail or modify lisp/paths.el before compiling.
799 lisp/paths.el (which is loaded during the build) will attempt to use
800 sendmail if it exists.
802 If you are using SMAIL, you need to define the macro
805 System V rel 0 (usg5.0)
807 Works, on Vaxes and 3bxxx's.
808 There are some problems in 18.37 due to shortnames/cccp problems:
809 use the emacs 17 cpp if you have it.
811 System V rel 2 (usg5.2)
813 Works on various machines.
814 On some (maybe all) machines the library -lPW exists and contains
815 a version of `alloca'. On these machines, to use it, put
817 #define LIB_STANDARD -lPW -lc
818 in the `src/m/MACHINENAME.h' file for the machine.
820 If you find that the character Meta-DEL makes Emacs crash,
821 find where function init_sys_modes in sysdep.c sets sg.c_cc[VQUIT]
822 and make it store 7 there. I have as yet no evidence of whether
823 this problem, known in HP/UX, exists in other system V versions.
825 System V rel 2.2 (usg5.2.2)
827 In 5.2.2 AT&T undid, incompatibly, their previous incompatible
828 change to the way the nlist library is called. A different s- file
829 is used to enable the other interface.
831 They call themselves the right choice--can't they choose?
833 Emacs version 18 unexec is currently not working properly
834 on 5.2.2. Nobody knows why yet. A workaround is to define
835 NO_REMAP. It is not yet known whether this applies to all
836 machines running 5.2.2.
838 System V rel 3 (usg5.3)
840 Some versions of this system support ptys and BSD-style sockets.
841 On such systems, you should define HAVE_PTYS and HAVE_SOCKETS in config.h.
843 If you want to link Emacs with shared libraries, define
844 USG_SHARED_LIBRARIES.
846 You may have to add ANSI idempotence #-lines to your sys/types.h
847 file to get Emacs to compile correctly. This may be necessary on
848 other pre-ANSI systems as well.
850 On an AT&T 6386WGS using System V Release 3.2 and X11R3, the X support
851 cannot be made to work. Whether or not the GNU relocating malloc is
852 used, the symptom is that the first call Emacs makes to sbrk(0) returns
853 (char *)-1. Sorry, you're stuck with character-only mode. Try
854 installing XFree86 to fix this.
856 System V rel 4.0.3 and 4.0.4 (usg5.4)
858 Supported, including shared libraries for ELF, but ptys do not work
859 because TIOCGPGRP fails to work on ptys (but Dell 2.2 seems to have
860 fixed this). This failure is probably due to a misunderstanding of
861 the consequences of the POSIX spec: many system designers mistakenly
862 think that POSIX requires this feature to fail. This is untrue;
863 ptys are an extension, and POSIX says that extensions *when used*
864 may change the action of standard facilities in any fashion.
866 If you get compilation errors about wrong number of
867 arguments to getpgrp, define GETPGRP_NO_ARG.
869 The standard C preprocessor may generate xmakefile incorrectly. However,
870 /lib/cpp will work, so use `make CPP=/lib/cpp'. Standard cpp
871 seems to work OK under Dell 2.2.
873 Some versions 3 and earlier of V.4, on the Intel 386 and 860, had
874 problems in the X11 libraries. These prevent Emacs from working
875 with X. You can use Emacs with X provided your copy of X is based
876 on X11 release 4 or newer, or is Dell's 2.2 (which is a 4.0.3).
877 Unfortunately, the only way you can tell whether your X11 library is
878 new enough is to try compiling Emacs to use X. If emacs runs, your
879 X11 library is new enough.
881 In this context, GSV4 and GSV4i are alternate names for X11R4.
882 OL2.* is X11R3 based. OL3 is in between X11R3 and X11R4, and may or
883 may not work, depending on who made the Unix system. If the library
884 libXol is part of the X distribution, then you have X11R3 and Emacs
887 Most versions of V.4 support sockets. If `/usr/lib/libsocket.so'
888 exists, your system supports them. If yours does not, you must add
889 #undef HAVE_SOCKETS in config.h, after the inclusion of s-usg5-4.h.
890 (Any system that supports Internet should implement sockets.)
894 Recent versions of Ultrix appear to support the features of Berkeley 4.3.
895 Ultrix was at the BSD 4.2 level for a long time after BSD 4.3 came out.
897 Ultrix 3.0 has incompatibilities in its X library if you have the
898 Ultrix version of X (UWS version 2.0). To solve them, you need to
899 prevent XvmsAlloc.o in Xlib from being used. Israel Pinkas says:
901 I added the following lines to config.h after the X defines:
903 #if defined(ultrix) && defined(X11)
904 #define OBJECTS_SYSTEM calloc.o
907 Then I ran the following:
909 ar x /usr/lib/libc.a calloc.o
911 The problem is said to be gone in UWS version 2.1.
915 Richard Levitte <levitte@e.kth.se> distributes a set of patches to
916 Emacs 18.59 to make it work nicely under VMS. Emacs 19 probably
917 won't work very well, or even compile. Levitte is working on a
918 port, so these problems should be fixed in the near future.
920 Note that Emacs for VMS is usually distributed in a special VMS
921 distribution. See the file ../vms/VMSINSTALL for info on moving
922 Unix distributions to VMS, and other VMS-related topics.
924 Windows NT/95/98/ME/2000
926 For installation on all versions of the MS-Windows platform, see the
931 No special procedures should be needed to build a 64-bit Emacs. To
932 build a 32-bit Emacs, first ensure that the necessary 32-bit system
933 libraries and include files are installed. Then use:
935 env CC="gcc -m32" ./configure --build=i386-linux-gnu \
936 --x-libraries=/usr/X11R6/lib
938 (using the location of the 32-bit X libraries on your system).
946 This file is part of GNU Emacs.
948 GNU Emacs is free software; you can redistribute it and/or modify
949 it under the terms of the GNU General Public License as published by
950 the Free Software Foundation; either version 3, or (at your option)
953 GNU Emacs is distributed in the hope that it will be useful,
954 but WITHOUT ANY WARRANTY; without even the implied warranty of
955 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
956 GNU General Public License for more details.
958 You should have received a copy of the GNU General Public License
959 along with GNU Emacs; see the file COPYING. If not, write to the
960 Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
961 Boston, MA 02110-1301, USA.
963 arch-tag: 7d2e93c7-e982-40ec-9055-3cd064042473