1Emacs machines list 2 3Copyright (C) 1989, 1990, 1992, 1993, 1998, 2001, 2002, 2003, 2004, 4 2005, 2006, 2007 Free Software Foundation, Inc. 5See the end of the file for license conditions. 6 7This is a list of the status of GNU Emacs on various machines and systems. 8 9For each system and machine, we give the configuration name you should 10pass to the `configure' script to prepare to build Emacs for that 11system/machine. 12 13The `configure' script uses the configuration name to decide which 14machine and operating system description files `src/config.h' should 15include. The machine description files are all in `src/m', and have 16names similar to, but not identical to, the machine names used in 17configuration names. The operating system files are all in `src/s', 18and are named similarly. See the `configure' script if you need to 19know which configuration names use which machine and operating system 20description files. 21 22If you add support for a new configuration, add a section to this 23file, and then edit the `configure' script to tell it which 24configuration name(s) should select your new machine description and 25system description files. 26 27 28Here are the configurations Emacs is intended to work with, with the 29corresponding configuration names. You can postpend version numbers 30to operating system names (i.e. sunos4.1) or architecture names (i.e. 31hppa1.1). If you leave out the version number, the `configure' script 32will configure Emacs for the latest version it knows about. 33 34Acorn RISCiX (arm-acorn-riscix1.2) 35 36 Emacs 19.29 has changes that ought to support RISCiX 1.2. 37 38 Due to a bug in the RISCiX C compiler (3.4.5), emacs must 39 be built with gcc (versions 2.5.8 onwards). 40 41 In addition, you will need GNU sed and GNU make, as the RISCiX release 42 versions of these utilities cannot cope with building emacs-19! 43 44 GNU sed should be configured with: 45 46 env 'DEFS=-Dgetopt=gnu_getopt -Dopterr=gnu_opterr -Doptind=gnu_optind \ 47 -Doptarg=gnu_optarg' ./configure 48 49 GNU make (3.72+) should be configured with: 50 51 env 'CFLAGS=-Dgetopt=gnu_getopt -Dopterr=gnu_opterr -Doptind=gnu_optind \ 52 -Doptarg=gnu_optarg' ./configure 53 54 Emacs may be configured to use the X toolkit, by adding --with-x-toolkit 55 to the configure command. If you do this, you will need to edit the line 56 in src/Makefile which defines LIBW (about line 59) to read: 57 58 LIBW= -lXaw_n 59 60 This ensures that the non-shared widget library is used. 61 62 It is unlikely that this version of emacs will work with RISCiX 1.1. 63 64Alliant (fx80-alliant-bsd): 65 66 18.52 worked on system version 4. Previous Emacs versions were 67 known to work on previous system versions. 68 69 If you are using older versions of their operating system, you may 70 need to edit `src/config.h' to use `m/alliant1.h' (on version 1) or 71 `m/alliant.h' (on versions 2 and 3). 72 73Alliant FX/2800 (i860-alliant-bsd) 74 75 Known to work with 19.26 and OS version 2.2, compiler version 1.3. 76 77Alpha (DEC) running OSF/1 or GNU/Linux (alpha-dec-osf1, alpha-dec-linux-gnu) 78 79 For OSF/1 (aka Digital Unix) version 4.0, update 386, 80 it is reported that you need to run configure this way: 81 82 configure --x-includes=/usr/include --x-libraries=/usr/shlib 83 84 DEC C compiler version 5.9 (DEC C V5.9-005 on Digital UNIX V4.0f) 85 is reported to produce bogus binaries of Emacs 21.2 when the 86 command-line switches "-O4 -arch ev6 -tune ev6" are used. Using 87 just -O4 produces a good executable. 88 89 For 4.0 revision 564, and 4.0A and 4.0B, Emacs 20 seems to work 90 with no special configuration options. However, if you use GCC as 91 your compiler, you will need version 2.8.1 or later, as older 92 versions fail to build with a message "Invalid dimension for the 93 charset-ID 160". 94 95 Note that the X11 libraries on GNU/Linux systems for the Alpha are 96 said to have bugs that prevent Emacs from working with X (as of 97 November 1995). Recent releases work (July 2000). 98 99Altos 3068 (m68k-altos-sysv) 100 101 18.52 was said to work, provided you don't compile unexec.c with -O. 102 103Amdahl UTS (580-amdahl-sysv) 104 105 Small changes for 18.38 were merged in 18.39. It is mostly 106 working, but at last report a bug sometimes causes Emacs to 107 grab very large amounts of memory. No fix or explanation 108 has yet been reported. It may be possible to find this bug 109 if you find which Emacs command it happens within and then 110 run that command with a breakpoint set at malloc. 111 112 The 5.2u370 compiler is so brain damaged that it is not 113 even worth trying to use it. Success was obtained with the 114 uts native C compiler on uts version 5.2.5. 115 116Apple Macintosh running Mac OS X 117 118 For installation on all versions of the Mac OS platform, see the file 119 mac/INSTALL. 120 121Apple PowerPC Macintosh running GNU/Linux 122 123 There are special considerations for a variety of this system which 124 is known as the ``Yellow Dog [GNU/]Linux'': Emacs may crash during 125 dumping. To solve this, edit the header file src/m/macppc.h in the 126 Emacs distribution, and remove the "#if 0" and "#endif" directives 127 which surround the following block near the end of the file: 128 129 #if 0 /* This breaks things on PPC GNU/Linux except for Yellowdog, 130 even with identical GCC, as, ld. Let's take it out until we 131 know what's really going on here. */ 132 /* GCC 2.95 and newer on GNU/Linux PPC changed the load address to 133 0x10000000. */ 134 #if defined __linux__ 135 #if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 95) 136 #define DATA_SEG_BITS 0x10000000 137 #endif 138 #endif 139 #endif /* 0 */ 140 141 After that, reconfigure and rebuild Emacs. It should now build 142 successfully. 143 144Apollo running X Windows (m68k-apollo-bsd) 145 146 Apollo version now supports dumping. It has been tested on SR10.3 and 147 SR10.4. It certainly requires at least SR10.0, and maybe SR10.2. Be sure 148 to build in the BSD environment. 149 150 By default, everything is compiled with the switch "-W0,-opt,2". Don't try 151 to change this to full optimization (-O). The full optimizer (in Domain CC 152 6.7, 6.8 and 6.9) generates some bad code in several modules which causes 153 the emacs window, under X, to be refreshed with each keystroke. 154 155 The configuration stuff should work for the most part. However, some Domain 156 installations may have to edit src/Makefile manually after it is created. 157 There are too many versions of both cc and X to automate this easily. 158 159 In `lib-src/Makefile', emacsclient compiles and works fine under CC 6.9. 160 It now probably works under other versions of the compiler, as well. 161 162 The Apollo Domain CC compiler will issue quite a few warning messages, 163 mostly complaining about incompatible pointers. In general, these are 164 harmless and can be ignored. If you discover otherwise, please submit a bug 165 report identifying the problem in detail. 166 167 When you try to dump emacs, you may get the message ".rwdi section needs 168 relocation." This means you are linking with some code that has compressed 169 data sections. In some cases this comes from linking with X libraries. Try 170 using shared X libraries instead. With some versions of Domain/OS this is 171 as simple as removing the "-lX11" from the LIBX line in src/Makefile. 172 173 When running the configure script, use the configuration name 174 "m68k-apollo-bsd". You will also need to use the "-with-gcc=no" and 175 "-with-x" options. Depending upon your site configuration, you may have to 176 use other configure options, as well. Examine the INSTALL file for other 177 configure options. 178 179 Check out the file 'lisp/x-apollo.el'. To use it, add 180 181 (load "x-apollo") 182 183 to your .emacs file. It provides useful default Apollo function key 184 bindings. 185 186AT&T 3b2, 3b5, 3b15, 3b20 (we32k-att-sysv) 187 188 Emacs will probably not work with certain kernel constants too small. 189 190 In param.h CDLIMIT should be at least (1L << 12) in order to allow 191 processes to write up to 2 Mbyte files. This parameter is configurable 192 by normal means in /etc/master.d/kernel; examine that file for the 193 symbol CDLIMIT or ULIMIT, and raise it by several powers of 2. Then 194 do normal kernel rebuild things via "cd /boot; mkboot -k KERNEL" and so 195 forth. 196 197 In seg.h NSEGP and STACKSEG should be at least 16 and 4 respectively 198 to allow processes with total size of up to 2Mbytes. 199 However, I'm told it is unlikely this would fail to be true. 200 201 The MAXMEM may also prevent Emacs from running. The file 202 3B-MAXMEM in this directory explains how to increase MAXMEM. 203 204 On some of these machines, you may need to define IN_SCCS_ID 205 in config.h to make Emacs work. Supposedly you can tell whether 206 this is necessary by checking something in /usr/include/sys/time.h; 207 we do not know precisely what. 208 209AT&T 7300 or 3b1 (m68k-att-sysv) 210 211 18.52 worked. If you have strange troubles with dumping 212 Emacs, delete the last few lines from `src/m/7300.h' and recompile. 213 These lines are supposed to produce a sharable executable. 214 215 `src/m/7300.h' defines SHORTNAMES because operating system versions 216 older than 3.5 did not support long symbol names. Version 3.5 does 217 support them, so you can remove the #define SHORTNAMES in that 218 version. 219 220Bull DPX/2 models 2nn or 3nn (m68k-bull-sysv3) 221 222 Minor fixes merged into 19.19, which should work with CC or GCC. 223 224 You should compile with all the POSIX stuff: undef _SYSV and define 225 _POSIX_SOURCE, _XOPEN_SOURCE and _BULL_SOURCE. 226 227 On bos2.00.45 there is a bug that makes the F_SETOWN fcntl 228 call enters in an infinite loop. F_SETOWN_BUG has been defined to avoid 229 calling it. 230 231Bull DPX/20 (rs6000-bull-bosx) 232 233 Version 19 works. 234 235Bull sps7 (m68k-bull-sysv2) 236 237 Changes partially merged in version 19, but some fixes are probably required. 238 239CCI 5/32, 6/32 240 241 See "Tahoe". 242 243Celerity (celerity-celerity-bsd4.2) 244 245 Version 18.49 worked. This configuration name is a hack, because we 246 don't know the processor used by Celerities. If someone 247 who uses a Celerity could get in touch with us, we can teach 248 config.sub a better name for the configuration. 249 250Clipper (clipper-???) 251 252 Version 19 has support for some brand of clipper system. If you 253 have successfully built Emacs 19 on some sort of clipper system, let 254 us know so we can flesh out this entry. 255 256 Note that the Orion 105 is also a clipper, but some system-related 257 parameters are different. 258 259Convex (c1-convex-bsd, c2-convex-bsd, c32-convex-bsd, c34-convex-bsd, 260 c38-convex-bsd) 261 262 Support updated and residual bugs fixed in 19.26. 263 264Cubix QBx/386 (i386-cubix-sysv) 265 266 Changes merged in 19.1. Systems before 2/A/0 may fail to compile etags.c 267 due to a compiler bug. 268 269Cydra 5 (cydra-cydrome-sysv) 270 271 18.51 worked in one version of their operating system but stopped 272 working in a newer version. This has not been fixed. 273 274Data General Aviion (m88k-dg-dgux) 275 276 19.23 works; however, the GCC provided with DGUX 5.4R3.00 fails to 277 compile src/emacs.c. GCC 2.5.8 does work. 278 The 19.26 pretest was reported to work; no word on which compiler. 279 System versions other than DGUX 5.4R3.00 have not been tested. 280 281 DGUX 5.4R3.10 works with 19.29 and 19.30. 282 283 DGUX R4.11 contains changes to the stdio internals and it doesn't work 284 with versions before 20.2 without patches. 20.2 works in interactive 285 mode but usually fails in batch mode. The problem is that using 286 stderr in the dumped emacs usually leads to a segmentation fault. 287 Only m88k has been tested. 288 289DECstation (mips-dec-ultrix or mips-dec-osf) 290 291 This machine is the older Mips-based DECstation. 292 Emacs should now work on the Alpha CPU. 293 294 19.25 works on Ultrix 4.2. The 19.26 pretest was reported to work 295 on Ultrix 4.2a and on 4.4. 296 297 One user reported 19.25 did not work at all with --with-x-toolkit 298 using X11R5 patch level 10, but worked ok with X11R5 pl26. 299 300 See under Ultrix for problems using X windows on Ultrix. 301 Note that this is a MIPS machine. 302 303 For Ultrix versions 4.1 or earlier, you may need to define 304 SYSTEM_MALLOC in `src/m/pmax.h', because XvmsAlloc.o in libX11.a seems 305 to insist on defining malloc itself. 306 307 For Ultrix versions prior to 4.0, you may need to delete 308 the definition of START_FILES from `src/m/pmax.h'. 309 310Motorola Delta 147 (m68k-motorola-sysv) 311 312 The EMacs 19.26 pretest was reported to work. 313 314 Motorola Delta boxes running System V/68 release 3. 315 Tested on 147 board with SVR3V7, no X and gcc. 316 Tested on 167 board with SVR3V7, no X, cc, gnucc and gcc. 317 Reports say it works with X too. 318 319 The installation script chooses the compiler itself. gnucc is 320 preferred. 321 322Motorola Delta 187 (m88k-motorola-sysv, 323 m88k-motorola-sysvr4, or 324 m88k-motorola-m88kbcs) 325 326 The 19.26 pretest was reported to run on SVR3. However, if you 327 use --with-x-toolkit on svr3, you will have problems compiling some 328 files because time.h and sys/time.h get included twice. 329 One fix is to edit those files to protect against multiple inclusion. 330 331 As of version 19.13, Emacs was reported to run under SYSVr3 and SYSVr4. 332 333Dual running System V (m68k-dual-sysv) 334 335 As of 17.46, this worked except for a few changes 336 needed in unexec.c. 337 338Dual running Uniplus (m68k-dual-uniplus) 339 340 Worked, as of 17.51. 341 342Elxsi 6400 (elxsi-elxsi-sysv) 343 344 Changes for 12.0 release are in 19.1. 345 Dumping should work now. 346 347Encore machine (ns16k-encore-bsd) 348 349 This machine bizarrely uses 4.2BSD modified to use the COFF format 350 for object files. Works (as of 18.40). For the APC processor you 351 must enable two lines at the end of `src/s/umax.h', which are commented 352 out in the file as distributed. 353 354 WARNING: If you compile Emacs with the "-O" compiler switch, you 355 must also use the "-q enter_exits" switch so that all functions have 356 stack frames. Otherwise routines that call `alloca' all lose. 357 358 A kernel bug in some system versions causes input characters to be lost 359 occasionally. 360 361Fujitsu DS/90 (sparc-fujitsu-sysv4) 362 363 Changes merged in 20.3. 364 365GEC 63 (local-gec63-usg5.2) 366 367 Changes are partially merged in version 18, but certainly require 368 more work. Let us know if you get this working, and we'll give it a 369 real configuration name. 370 371Gould Power Node (pn-gould-bsd4.2 or pn-gould-bsd4.3) 372 373 18.36 worked on versions 1.2 and 2.0 of the operating system. 374 375 On UTX/32 2.0, use pn-gould-bsd4.3. 376 377 On UTX/32 1.2 and UTX/32S 1.0, use pn-gould-bsd4.2 and note that 378 compiling `lib-src/sorted-doc' tickles a compiler bug: remove the -g 379 flag to cc in the makefile. 380 381 UTX/32 1.3 has a bug in the bcopy library routine. Fix it by 382 #undef BSTRING in `src/m/gould.h'. 383 384 Version 19 incorporates support for releases 2.1 and later of UTX/32. 385 A site running a pre-release of 2.1 should #define RELEASE2_1 in config.h. 386 387Gould NP1 (np1-gould-bsd) 388 389 Version 19 supposedly works. 390 391Harris Night Hawk (m68k-harris-cxux or m88k-harris-cxux) 392 393 This port was added in 19.23. The configuration actually tested was 394 a Night Hawk 4800 running CX/UX 7.0. 395 396 If you have GCC ported and want to build with it, you probably need to 397 change things (like compiler switches) defined in the s/cxux.h file. 398 399 If you have X11R6 installed in /usr/lib, configure will fail to find 400 it and may find X11R5 instead. To work around this problem, use 401 --x-libraries=/usr/lib when you run configure. 402 403 With CX/UX 7.0 and later releases, you need to build after setting the 404 SDE_TARGET environment variable to COFF (a port using ELF and shared 405 libraries has not yet been done). 406 407Harris Power PC (powerpc-harris-powerunix) 408 409 Patches have been merged in 19.31. 410 411Honeywell XPS100 (xps100-honeywell-sysv) 412 413 Config file added in version 19. 414 415Hewlett-Packard 9000 series 200 or 300 (m68k-hp-bsd or m68k-hp-hpux 416 or m68k-hp-netbsd) 417 418 These machines are 68000-series CPUs running HP/UX 419 (a derivative of sysV with some BSD features) or BSD 4.3 ported by Utah. 420 The operating system suffix determines which system Emacs is built for. 421 422 Series 200 HPUX runs Emacs only if it has the "HP/UX upgrade". 423 424 Version 19 works under BSD. The 19.26 pretest was reported 425 to work on HPUX 9. 19.31 works on HPUX 10.01, but there are 426 some problems on 10.10 which have not been resolved. Emacs 19.34 427 works on HPUX 10.20 provided you compile with GCC; with the HP C 428 compiler, subprocess commands do not work. 429 430 On HPUX 9, Emacs sometimes crashes with SIGBUS or SIGSEGV after you 431 delete a frame. We think this is due to a bug in the X libraries 432 provided by HP. With the alternative X libraries in 433 /usr/contrib/mitX11R5/lib, the problem does not happen. 434 435 If you are running HP/UX release 8.0 or later, you need the optional 436 "C/ANSI C" software in order to build Emacs (older releases of HP/UX 437 do not require any special software). If the file "/etc/filesets/C" 438 exists on your machine, you have this software, otherwise you do not. 439 440 Note that HP has used two incompatible assembler syntaxes, 441 and has recently changed the format of C function frames. 442 `src/crt0.c' and `src/alloca.s' have been conditionalised for the new 443 assembler and new function-entry sequence. You may need to define 444 OLD_HP_ASSEMBLER if you are using an older hpux version. If you 445 have an official (bought from HP) series 300 machine you have 446 the new assembler. Kernels that are 5.+ or later have new 447 assembler. A Series 200 that has been upgraded to a 68010 448 processor and a 5.+ kernel has the new compiler. 449 450 Define C_SWITCH_MACHINE to be +X to make a version of Emacs that 451 runs on both 68010 and 68020 based HP/UX's. 452 453 Define HPUX_68010 if you are using the new assembler, for 454 a system that has a 68010 without a 68881. This is to say, 455 a s200 (upgraded) or s310. 456 457 Define the symbol HPUX_NET if you have the optional network features 458 that include the `netunam' system call. This is referred to as 459 Network Services (NS/9000) in HP literature. 460 461HP 9000 series 500: not supported. 462 463 The series 500 has a seriously incompatible memory architecture 464 which relocates data in memory during execution of a program, 465 and support for it would be difficult to implement. 466 467HP 9000 series 700 or 800 (Spectrum) (hppa1.0-hp-hpux or hppa1.1-hp-hpux 468 or ...hpux9shr, or ...-nextstep) 469 470 Use hppa1.1 for the 700 series and hppa1.0 for the 800 471 series machines. (Emacs may not actually care which one you use.) 472 473 Support for NextSTEP was added in 19.31. 474 475 Emacs 20 may work on HPUX 10. You need patch PHSS_6202 to install 476 the Xaw and Xmu libraries. On HPUX 10.20 you may need to compile with GCC; 477 when Emacs was compiled with HP's C compiler, HP92453-01 A.10.32.03, 478 the subprocess features failed to work. 479 480 19.26 is believed to work on HPUX 9 provided you compile with GCC. 481 As of version 19.16, Emacs was reported to build (using GCC) and run 482 on HP 9000/700 series machines running HP/UX versions 8.07 and 9.01. 483 The HP compiler is known to fail on some versions if you use +O3, 484 but it may work with lower optimization levels. 485 486 Use hppa1.1-hp-hpux9shr to use shared libraries on HPUX version 9. 487 You may need to create the X libraries libXaw.a and libXmu.a from 488 the MIT X distribute, and you may need to edit src/Makefile's 489 definition of LIBXT to look like this: 490 491 LIBXT= $(LIBW) -lXmu -lXt $(LIBXTR6) -lXext 492 493 Some people report trouble using the GNU memory allocator under 494 HP/UX version 9. The problems often manifest as lots of ^@'s in the 495 buffer. 496 497 We are told that these problems go away if you obtain the latest 498 patches for the HP/UX C compiler. James J Dempsey 499 <jjd@spserv.bbn.com> says that this set of versions works for him: 500 /bin/cc: 501 HP92453-01 A.09.28 HP C Compiler 502 /lib/ccom: 503 HP92453-01 A.09.28 HP C Compiler 504 HP-UX SLLIC/OPTIMIZER HP-UX.09.00.23 02/18/93 505 Ucode Code Generator - HP-UX.09.00.23.5 (patch) 2/18/93 506 507 For 700 series machines, the HP-UX patch needed is known as 508 PHSS_2653. (Perhaps for 800 series machines as well; we don't 509 know.) If you are on the Internet, you should be able to obtain 510 this patch by using telnet to access the machine 511 support.mayfield.hp.com and logging in as "hpslreg" and following 512 the instructions there. Or you may be able to use this 513 web site: 514 515 HP Patch Server: http://support.mayfield.hp.com/patches/html/patches.html 516 HP Support Line: http://support.mayfield.hp.com 517 518 Please do not ask FSF for further support on this. If you have any 519 trouble obtaining the patch, contact HP Software Support. 520 521 If your buffer fills up with nulls (^@) at some point, it could well 522 be that problem. That problem does not happen when people use GCC 523 to compile Emacs. On the other hand, the HP compiler version 9.34 524 was reported to work for the 19.26 pretest. 9.65 was also reported to work. 525 526 If you turn on the DSUSP character (delayed suspend), 527 Emacs 19.26 does not know how to turn it off on HPUX. 528 You need to turn it off manually. 529 530 If you are running HP/UX release 8.0 or later, you need the optional 531 "C/ANSI C" software in order to build Emacs (older releases of HP/UX 532 do not require any special software). If the file "/etc/filesets/C" 533 exists on your machine, you have this software, otherwise you do not. 534 535High Level Hardware Orion (orion-highlevel-bsd) 536 537 This is the original microprogrammed hardware. 538 Machine description file ought to work. 539 540High Level Hardware Orion 1/05 (clipper-highlevel-bsd) 541 542 Changes merged in 18.52. This is the one with the Clipper cpu. 543 Note that systems which lack NFS need LOAD_AVE_TYPE changed to `double'. 544 545 C compiler has a bug; it loops compiling eval.c. 546 Compile it by hand without optimization. 547 548HITACHI SR2001/SR2201 series (hppa1.1-hitachi-hiuxwe2) 549 550 These machines are based on PA architecture running HI-UX/MPP 551 (based on OSF1. `MPP' stands for `Massively Parallel Processor'). 552 553 Emacs 19.34 is believed to work; its pretest was tested 554 both on SR2001 (output of `uname -rv' is `00-01-BB 0') and 555 SR2201 (`02-00 0'). 556 557 Emacs 20.7 was reported to build on a system whose `uname -rs' 558 output is `HI-UX/MPP 03-04'. 559 560 The machine description file is `src/m/sr2k.h' is based on 561 `src/m/hp800.h'. The system description file is `src/s/hiuxwe2.h' 562 based on `src/s/osf1.h'. Note that this system doesn't use COFF. 563 564IBM PS/2 (i386-ibm-aix1.1 or i386-ibm-aix1.2) 565 566 Changes merged in version 19. You may need to copy 567 /usr/lib/samples/hft/hftctl.c to the Emacs src directory. 568 569 i386-ibm-aix1.1 may not work with certain new X window managers, and 570 may be suboptimal. 571 572IBM RS/6000 (rs6000-ibm-aix*) 573 574 Emacs 19.26 is believed to work; its pretest was tested. 575 576 Compiling with the system's `cc' and CFLAGS containing `-O5' might 577 fail because libXbsd isn't found. This is a compiler bug; 578 re-configure Emacs so that it isn't compiled with `-O5'. 579 580 On AIX 4.3.x and 4.4, compiling with /bin/c89 fails because it 581 treats certain warnings as errors. Use `cc' instead. 582 583 At last report, Emacs didn't run well on terminals. Informed 584 persons say that the tty VMIN and VTIME settings have been 585 corrupted; if you have a fix, please send it to us. 586 587 Compiling with -O using the IBM compiler has been known 588 to make Emacs work incorrectly. It's reported that on 589 AIX 3.2.5 with an IBM compiler earlier than 1.03.00.14, 590 cc -O fails for some files. You need to install any 591 PTF containing APAR #IX42810 to bring the compiler to 592 the 1.03.00.14 level to allow optimized compiles. 593 594 There are reports that IBM compiler versions earlier than 1.03.00.02 595 fail even without -O. However, another report said that compiler 596 version 1.02.01.00 did work, on AIX 3.2.4, with Emacs 19.31. 597 598 As of 19.11, if you strip the Emacs executable, it ceases to work. 599 600 If you are using AIX 3.2.3, you may get a core dump when loading 601 ange-ftp. You may be able to fix the problem by defining LIBS_TERMCAP 602 as -ltermcap -lcurses. Please tell us if this fails to work. 603 604 If anyone can fix the above problems, or confirm that they don't happen 605 with certain versions of various programs, we would appreciate it. 606 607IBM RT/PC (romp-ibm-bsd or romp-ibm-aix) 608 609 Use romp-ibm-bsd for the 4.2-like system and romp-ibm-aix for AIX. 610 19.22 is reported to work under bsd. We don't know about AIX. 611 612 On BSD, if you have trouble, try compiling with a different compiler. 613 614 On AIX, the file /usr/lib/samples/hft/hftctl.c must be compiled into 615 hftctl.o, with this result left in the src directory (hftctl.c is 616 part of the standard AIX distribution). 617 618 window.c must not be compiled with -O on AIX. 619 620IBM System/390 running GNU/Linux (s390-*-linux-gnu) 621 622 As of Emacs 21.2, a 31-bit only version is supported on this 623 system. 624 625Integrated Solutions `Optimum V' (m68k-isi-bsd4.2 or -bsd4.3) 626 627 18.52 said to work on some sort of ISI machine. 628 Version 18.45 worked (running on a Optimum V (VME bus, 68020) 629 BSD 4.2 (3.05e) system). 18.42 is reported to work on 630 a Qbus 68010 system. Has not been tried on `WorkStation' `Cluster 631 Compute Node' `Cluster WorkStation' or `Server Node' (Love the 632 StudLYCaps) 633 634 Compilation with -O is rumored to break something. 635 636 On recent system versions, you may need to undefine the macro UMAX 637 in `lib-src/loadst.c' and `src/getpagesize.h'. They stupidly defined this 638 in a system header file, which confuses Emacs (which thinks that UMAX 639 indicates the Umax operating system). 640 641Intel 386 (i386-*-isc, i386-*-esix, i386-*-bsdi2, 642 i386-*-xenix, i386-*-freebsd, i386-*-linux-gnu, 643 i386-*-sol2.4, i386-*-sysv3, i386-intsys-sysv, 644 i386-*-sysv4, i386-*-sysv4.2, 645 i386-*-sysv5.3, i386-*-bsd4.2, i386-*-cygwin, 646 i386-*-sco3.2v4, i386-*-bsd386, i386-*-386bsd, 647 i386-*-msdos, i386-*-windowsnt. 648 i386... can be replaced with i486... or i586...) 649 650 In the above configurations, * means that the manufacturer's name 651 you specify does not matter, and you can use any name you like 652 (but it should not contain any dashes or stars). 653 654 When using the ISC configurations, be sure to specify the isc 655 version number - for example, if you're running ISC 3.0, use 656 i386-unknown-isc3.0 as your configuration name. 657 Use i386-*-esix for Esix; Emacs runs as of version 19.6. 658 Use i386-*-linux-gnu for GNU/Linux systems; Emacs runs as of version 19.26. 659 Use i386-*-cygwin for Cygwin; Emacs builds as of version 22.1, in both X11 660 and non-X11 modes. (The Cygwin site has source and binaries for 21.2.) 661 Use i386-intsys-sysv for Integrated Solutions 386 machines. 662 It may also be correct for Microport systems. 663 Use i386-*-sco3.2v4 for SCO 3.2v4; Emacs runs as of version 19.26. 664 665 On GNU/Linux systems, Emacs 19.23 was said to work properly with libc 666 version 4.5.21, but not with 4.5.19. If your system uses QMAGIC 667 for the executable format, you must edit config.h to define LINUX_QMAGIC. 668 669 On GNU/Linux, configure may fail to put these definitions in config.h: 670 671 #define HAVE_GETTIMEOFDAY 672 #define HAVE_MKDIR 673 #define HAVE_RMDIR 674 #define HAVE_XSCREENNUMBEROFSCREEN 675 676 To work around the problem, add those definitions by hand. 677 It is possible that this problem happens only with X11R6. 678 Newer system versions have fixed it. 679 680 The 19.26 pretest was reported to work on SVR4.3 and on Freebsd. 681 682 19.29 is reported to crash when using Motif on Solaris 2.5. 683 The reasons are not yet known. 684 685 Use i386-*-bsdiN for BSDI BSD/OS version N; Emacs runs as of version 19.23. 686 In some system versions, `make' is broken; use GNU make instead. 687 Shell bugs in version 1.0 of BSD/OS cause configure 688 to do the wrong thing with --with-x-toolkit; the workaround is to edit 689 configure to run another shell such as bash. 690 691 For System V release 3, use i386-*-sysv3. 692 For System V release 4, use i386-*-sysv4. 693 For System V release 4.2, use i386-*-sysv4.2. 694 695 If you are using Xenix, see notes at end under Xenix. 696 If you are using Esix, see notes at end under Esix. 697 If you are using SCO Unix, see notes at end under SCO. 698 699 On 386bsd, NetBSD and FreeBSD, at one time, it was necessary to use 700 GNU make, not the system's make. Assuming it's installed as gmake, 701 do `gmake install MAKE=gmake'. However, more recently it is 702 reported that using the system Make on NetBSD 1.3.1 works ok. 703 704 If you are using System V release 4.2, you may find that `cc -E' 705 puts spurious spaces in `src/xmakefile'. If that happens, 706 specify CPP=/lib/cpp as an option when you run make. 707 There is no problem if you compile with GCC. 708 709 Note that use of Linux with GCC 2.4 and the DLL 4.4 libraries 710 requires the experimental "net 2" network patches (no relation to 711 Berkeley Net 2). There is a report that (some version of) Linux 712 requires including `/usr/src/linux/include/linux' in buffer.c 713 but no coherent explanation of why that might be so. If it is so, 714 in current versions of Linux, something else should probably be changed. 715 716 Some sysV.3 systems seem to have bugs in `opendir'; 717 for them, alter `config.h' to define NONSYSTEM_DIR_LIBRARY 718 and undefine SYSV_SYSTEM_DIR. 719 720 If you use optimization on V.3, you may need the option -W2,'-y 0' 721 to prevent certain faulty optimization. 722 723 On 386/ix, to link with shared libraries, add #define USG_SHARED_LIBRARIES 724 to config.h. 725 726 On SCO, there are problems in regexp matching when Emacs is compiled 727 with the system compiler. The compiler version is "Microsoft C 728 version 6", SCO 4.2.0h Dev Sys Maintenance Supplement 01/06/93; 729 Quick C Compiler Version 1.00.46 (Beta). The solution is to compile 730 with GCC. 731 732 On ISC systems (2.02 and more recent), don't try to use the versions 733 of X that come with the system; use XFree86 instead. 734 735 There is no consistency in the handling of certain system header files 736 on V.3. 737 738 Some versions have sys/sioctl.h, and require it in sysdep.c. 739 But some versions do not have sys/sioctl.h. 740 For a given version of the system, this may depend on whether you have 741 X Windows or TCP/IP. Define or undefine NO_SIOCTL_H in config.h 742 according to whether you have the file. 743 744 Likewise, some versions have been known to need sys/ttold.h, sys/stream.h, 745 and sys/ptem.h included in sysdep.c. If your system has these files, 746 try defining NEED_PTEM_H in config.h if you have trouble without it. 747 748 You may find that adding -I/usr/X/include or -I/usr/netinclude or both 749 to CFLAGS avoids compilation errors on certain systems. 750 751 Some versions convince sysdep.c to try to use `struct tchars' 752 but define `struct tc' instead; add `#define tchars tc' 753 to config.h to solve this problem. 754 755Iris 2500 and Iris 2500 Turbo (m68k-sgi-iris3.5 or m68k-sgi-iris3.6) 756 757 Version 18 was said to work; use m68k-sgi-iris3.5 for system version 2.5 758 and m68k-sgi-iris3.6 for system version 3.6. 759 Note that the 3030 is the same as the Iris 2500 Turbo. 760 761Iris 4D (mips-sgi-irix[456].*) 762 763 Emacs 21.3 is reported to work on IRIX 6.5.x. 764 765 You can build a 64-bit executable (with larger maximum buffer size) 766 on Irix 6.5 by specifying the 64-bit ABI using the `-64' compiler 767 flag or otherwise (see cc(1)). This may work on earlier Irix 6 768 systems if you edit src/s/irix6-0.h following irix6-5.h. 769 770 If compiling with GCC on Irix 6 yields an error "conflicting types 771 for `initstate'", install GCC 2.95 or a newer version, and this 772 problem should go away. It is possible that this problem results 773 from upgrading the operating system without reinstalling GCC; so you 774 could also try reinstalling the same version of GCC, and telling us 775 whether that fixes the problem. 776 777Masscomp (m68k-masscomp-rtu) 778 779 18.36 worked on a 5500DP running RTU v3.1a and compiler version 3.2 780 with minor fixes that are included in 18.37. However, bizarre behavior 781 was reported for 18.36 on a Masscomp (model and version unknown but probably 782 a 68020 system). The report sounds like a compiler bug. 783 784 A compiler bug affecting statements like 785 unsigned char k; unsigned char *p;... x = p[k]; 786 has been reported for "C version 1.2 under RTU 3.1". We do not wish 787 to take the time to install the numerous workarounds required to 788 compensate for this bug. 789 790 For RTU version 3.1, define FIRST_PTY_LETTER to be 'p' in `src/s/rtu.h' 791 (or #undef and redefine it in config.h) so that ptys will be used. 792 793 GNU Emacs is said to have no chance of compiling on RTU versions 794 prior to v3.0. 795 796Megatest (m68k-megatest-bsd) 797 798 Emacs 15 worked; do not have any reports about Emacs 16 or 17 799 but any new bugs are probably not difficult. 800 801Mips (mips-mips-riscos, mips-mips-riscos4.0, or mips-mips-bsd) 802 803 The C compiler on Riscos 4.51 dumps core trying to optimize 804 parts of Emacs. Try without optimization or try GCC. 805 806 Meanwhile, the linker on that system returns success even if 807 there are undefined symbols; as a result, configure gets the 808 wrong answers to various questions. No work-around is known 809 except to edit src/config.h by hand to indicate which functions 810 don't exist. 811 812 Use mips-mips-riscos4.0 for RISCOS version 4. 813 Use mips-mips-bsd with the BSD world. 814 815 Note that the proper configuration names for DECstations are 816 mips-dec-ultrix and mips-dec-osf. 817 818 If you are compiling with GCC, then you must run fixincludes; 819 the alternative of using -traditional won't work because 820 the definition of SIGN_EXTEND_CHAR uses the keyword `signed'. 821 822 If the SYSV world is the default, then you probably need the following 823 line in etc/Makefile: 824 825 CFLAGS= -g -systype bsd43 826 827 Some operating systems on MIPS machines give SIGTRAP for division by 828 zero instead of the usual signals. The only real solution is to fix 829 the system to give a proper signal. 830 831 In the meantime, you can change init_data in data.c if you wish. 832 Change it to handle SIGTRAP as well as SIGFPE. But this will have a 833 great disadvantage: you will not be able to run Emacs under a 834 debugger. I think crashing on division by zero is a lesser problem. 835 836 dsg@mitre.org reported needing to use --x-libraries=/bsd43/usr/lib 837 on a riscos4bsd site. But it is not clear whether this is needed in 838 general or only because of quirks on a particular site. 839 840National Semiconductor 32000 (ns32k-ns-genix) 841 842 This is for a complete machine from National Semiconductor, 843 running Genix. Changes merged in version 19. 844 845NCR Tower 32 (m68k-ncr-sysv2 or m68k-ncr-sysv3) 846 847 If you are running System V release 2, use m68k-ncr-sysv2. 848 If you are running System V release 3, use m68k-ncr-sysv3. 849 850 These both worked as of 18.56. If you change `src/ymakefile' so that 851 CFLAGS includes C_OPTIMIZE_SWITCH rather than C_DEBUG_SWITCH, check 852 out the comments in `src/m/tower32.h' (for System V release 2) or 853 `src/m/tower32v3.h' (for System V release 3) about this. 854 855 There is a report that compilation with -O did not work with 18.54 856 under System V release 2. 857 858NCR Intel system (i386-ncr-sysv4.2) 859 860 This system works in 19.31, but if you don't link it with GNU ld, 861 you may need to set LD_RUN_PATH at link time to specify where 862 to find the X libraries. 863 864NEC EWS4800 (mips-nec-sysv4) 865 866 This system works in 20.4, but you should use the compiler 867 /usr/abiccs/bin/cc (MIPS ABI MODE). 868 869NeXT (m68k-next-nextstep) 870 871 Emacs 19 has not been tested extensively yet, but it seems to work 872 in a NeXTStep 3.0 terminal window, and under the X server called 873 co-Xist. You may need to specify -traditional when src/Makefile 874 builds xmakefile. 875 876 NeXT users might want to implement direct operation with NeXTStep, 877 but from the point of view of the GNU project, that is a 878 distraction. 879 880 Thanks to Thorsten Ohl for working on the NeXT port of Emacs 19. 881 882Nixdorf Targon 31 (m68k-nixdorf-sysv) 883 884 Machine description file for version 17 is included in 18 885 but whether it works is not known. 886 `src/unexec.c' bombs if compiled with -O. 887 Note that the "Targon 35" is really a Pyramid. 888 889Nu (TI or LMI) (m68k-nu-sysv) 890 891 Version 18 is believed to work. 892 893Paragon OSF/1 (i860-intel-osf1) 894 895 Changes merged in 19.29. 896 897 There is a bug in OSF/1 make which claims there is a syntax error 898 in the src/xmakefile. You can successfully build emacs with: 899 900 pmake MAKE=pmake 901 902Plexus (m68k-plexus-sysv) 903 904 Worked as of 17.56. 905 906Pmax (DEC Mips) (mips-dec-ultrix or mips-dec-osf1) 907 908 See under DECstation, above. 909 910Prime EXL (i386-prime-sysv) 911 912 Minor changes merged in 19.1. 913 914Pyramid (pyramid-pyramid-bsd) 915 916 The 19.26 pretest was observed to work on OSx 5.0, but it is necessary 917 to edit gmalloc.c. You must add #include <sys/types.h> at the top, 918 and delete the #define for size_t. 919 920 You need to build Emacs in the Berkeley universe with 921 the `ucb' command, as in `ucb make' or `ucb build-install'. 922 923 In OSx 4.0, it seems necessary to add the following two lines 924 to `src/m/pyramid.h': 925 #define _longjmp longjmp 926 #define _setjmp setjmp 927 928 In Pyramid system 2.5 there has been a compiler bug making 929 Emacs crash just after screen-splitting with Qnil containing 0. 930 A compiler that fixes this is Pyramid customer number 8494, 931 internal number 1923. 932 933 Some versions of the pyramid compiler get fatal 934 errors when the -gx compiler switch is used; if this 935 happens to you, change `src/m/pyramid.h' to define 936 C_DEBUG_SWITCH with an empty definition. 937 938 Some old system versions may require you to define PYRAMID_OLD 939 in when alloca.s is preprocessed, in order to define _longjmp and _setjmp. 940 941Sequent Balance (ns32k-sequent-bsd4.2 or ns32k-sequent-bsd4.3) 942 943 Emacs 18.51 worked on system version 3.0. 18.52 is said to work. 944 Delete some lines at the end of `src/m/sequent.h' for earlier system 945 versions. 946 947Sequent Symmetry (i386-sequent-bsd, i386-sequent-ptx, i386-sequent-ptx4) 948 949 19.33 has changes to support ptx 4 (a modified SVR4). 950 951 Emacs 19 should work on Dynix (BSD). However, if you compile with 952 the Sequent compiler, you may find Emacs does not restore the 953 terminal settings on exit. If this happens, compile with GCC. 954 955 Emacs 19.27 contains patches that should support 956 DYNIX/ptx 1.4 and 2.1 with the native cc compiler. 957 958 GCC can't compile src/process.c due to a non-standard Sequent asm 959 keyword extension supported by cc and used for the network byte/word 960 swapping functions in the PTX /usr/include/netinet/in.h file. GCC 961 2.5.8 includes the file <sys/byteorder.h> which can be included into 962 netinet/in.h to perform these byte/word swapping functions in the 963 same manner. Patches have been submitted to the FSF against GCC 964 2.6.0 to fix this problem and allow Emacs to be built with GCC. 965 966 If your machine does not have TCP/IP installed, you will have to edit the 967 src/s/ptx.h file and comment out #define TCPIP_INSTALLED. 968 969Siemens Nixdorf RM600 and RM400 (mips-siemens-sysv4) 970 971 Changes merged in 19.29. This configuration should also work for 972 Pyramid MIS Server running DC-OSX 1.x. The version configured with 973 `--with-x' works without any modifications, but `--with-x-toolkit' 974 works only if the Athena library and the Toolkit library are linked 975 statically. For this, edit `src/Makefile' after the `configure' run 976 and modify the lines with `-lXaw' and `-lXt' as follows: 977 978 LIBW= /usr/lib/libXaw.a 979 LIBXT= $(LIBW) -lXmu /usr/lib/libXt.a $(LIBXTR6) -lXext 980 981 In addition, `--with-x-toolkit=motif' works only 982 if the Motif library and the Toolkit library are linked statically. 983 To do this, edit `src/Makefile' after the `configure' run 984 and modify the lines with `-lXm' and `-lXt' as follows: 985 986 LIBW= /usr/lib/libXm.a /usr/ccs/lib/libgen.a 987 LIBXT= $(LIBW) -lXmu /usr/lib/libXt.a $(LIBXTR6) -lXext 988 989SONY News (m68k-sony-bsd4.2 or m68k-sony-bsd4.3) 990 991 18.52 worked. Use m68k-sony-bsd4.3 for system release 3. 992 993SONY News 3000 series (RISC NEWS) (mips-sony-bsd) 994 995 The 19.26 pretest is reported to work. 996 997 Some versions of the operating system give SIGTRAP for division by zero 998 instead of the usual signals. This causes division by zero 999 to make Emacs crash. The system should be fixed to give the proper signal. 1000 Changing Emacs is not a proper solution, because it would prevent 1001 Emacs from working under any debugger. But you can change init_data 1002 in data.c if you wish. 1003 1004Stardent i860 (i860-stardent-sysv4.0) 1005 1006 19.26 pretest reported to work. 1007 1008Stardent 1500 or 3000 1009 1010 See Titan. 1011 1012Stride (m68k-stride-sysv) 1013 1014 Works (most recent news for 18.30) on their release 2.0. 1015 For release 2.2, see the end of `src/m/stride.h'. 1016 It may be possible to run on their V.1 system but changes 1017 in the s- file would be needed. 1018 1019Sun 3, Sun 4 (sparc), Sun 386 (m68k-sun-sunos, sparc-sun-sunos, i386-sun-sunos, 1020 sparc-sun-sunos4.1.3noshr, sparc-sun-solaris2.*, 1021 i386-sun-solaris2.*, sparc*-*-linux-gnu) 1022 1023 To build a 32-bit Emacs (i.e. if you are having any sort of problem 1024 bootstrapping a 64-bit version), you can use the Sun Studio compiler 1025 and configure Emacs with: 1026 env CC="cc -xarch=v7" CFLAGS='' ./configure # on SPARC systems 1027 env CC="cc -xarch=386" CFLAGS='' ./configure # on x86 systems 1028 On Solaris 2.10, it is also possible to use /usr/sfw/bin/gcc to build 1029 a 32-bit version of Emacs. Just make sure you point ./configure to 1030 the right compiler: 1031 1032 env CC='/usr/sfw/bin/gcc -m32' ./configure 1033 1034 To build a 64-bit Emacs (with larger maximum buffer size and 1035 including large file support) on a Solaris system which supports 1036 64-bit executables, use the Sun compiler, configuring something like 1037 this (see the cc documentation for information on 64-bit 1038 compilation): 1039 1040 env CC="cc -xarch=v9" CFLAGS='' ./configure # on SPARC systems 1041 env CC="cc -xarch=amd64" CFLAGS='' ./configure # on x86 systems 1042 1043 As of version 2.95, GCC doesn't support the 64-bit ABI properly, but 1044 later releases may. 1045 1046 Some versions of Solaris 8 have a bug in their XIM (X Input Method) 1047 implementation which causes Emacs to dump core when one of several 1048 frames is closed. To avoid this, either install patch 108773-12 1049 (for Sparc) or 108874-12 (for x86), or configure Emacs with the 1050 `--with-xim=no' switch (you can use Leim input methods instead). 1051 1052 On Solaris 2.7, building Emacs with WorkShop Compilers 5.0 98/12/15 1053 C 5.0 failed, apparently with non-default CFLAGS, most probably due to 1054 compiler bugs. Using Sun Solaris 2.7 Sun WorkShop 6 update 1 C 1055 release was reported to work without problems. It worked OK on 1056 another system with Solaris 8 using apparently the same 5.0 compiler 1057 and the default CFLAGS. 1058 1059 Emacs 21.1 and 21.2 built with Sun's ProWorks PC3.0.1 compiler on 1060 Intel/Solaris 8 was reported to abort and dump core during startup. 1061 Using GCC or a newer SUN compiler (Sun WokShop 6 update 2 C 5.3 1062 2001/05/15) solves the problem. 1063 1064 Emacs 20.5 and later work on SPARC GNU/Linux with the 32-bit ABI. 1065 As of release 2.95, GCC doesn't work properly with the 64-bit ABI 1066 (applicable on UltraSPARC), but that isn't the default mode. 1067 1068 Emacs 20.3 fails to build on Solaris 2.5 if you use GCC 2.7.2.3. 1069 Installing GCC 2.8 fixes the problem. 1070 1071 19.32 works on Solaris 2.4 and 2.5. On Solaris 2.5 1072 you may need one of these patches to prevent Emacs from crashing 1073 when it starts up: 1074 103093-03: [README] SunOS 5.5: kernel patch (2140557 bytes) 1075 102832-01: [README] OpenWindows 3.5: Xview Jumbo Patch (4181613 bytes) 1076 103242-04: [README] SunOS 5.5: linker patch (595363 bytes) 1077 1078 There are reports that using SunSoft cc with -xO4 -xdepend produces 1079 bad code for some part of Emacs. 1080 1081 Emacs works ok Sunos 4.1.x 1082 provided you completely replace your C shared library 1083 using one of the SunOS 4.1.x jumbo replacement patches from Sun. 1084 Here are the patch numbers for Sunos 4.1.3: 1085 100890-10 SunOS 4.1.3: domestic libc jumbo patch 1086 100891-10 SunOS 4.1.3: international libc jumbo patch 1087 1088 Some people report that Emacs crashes immediately on startup when 1089 used with a non-X terminal, but we think this is due to compiling 1090 with GCC and failing to use GCC's "fixed" system header files. 1091 1092 Some Sun versions of X windows use the clipboard, not the selections, 1093 for transferring text between clients. The Cut, Paste and Copy items 1094 in the menu bar Edit menu work with the clipboard. 1095 1096 It's important to include the SunOS version number in the 1097 configuration name. For example, for SunOS release 4.0 on a Sun 3, 1098 use `m68k-sun-sunos4.0'; for SunOS release 4.1 on a Sparc, use 1099 `sparc-sun-sunos4.1'. For SunOS release 4.1.3 on a Sparc, use 1100 `sparc-sun-sunos4.1.3'. Note that shared libraries are now 1101 used by default on SunOS 4.1. 1102 1103 A user reported irreproducible segmentation faults when using 19.29 1104 on Solaris 2.3 and 2.4 after compiling it with the Sun compiler. 1105 The problem went away when GCC 2.7.0 was used instead. We do not know 1106 whether anything in Emacs is partly to blame for this. 1107 1108 X11R6 is set up to make shared libraries only, on Sunos 4. 1109 Therefore, in order to link Emacs, you need to create static X libraries. 1110 To do this, rebuild X11 after setting 1111 #define ForceNormalLib YES 1112 #define SeparateSharedCompile YES 1113 in site.def (after #ifdef AfterVendorCF). 1114 1115 Use `m68k' for the 68000-based Sun boxes, `sparc' for Sparcstations, 1116 and `i386' for Sun Roadrunners. i386 calls for Sunos4.0. 1117 1118 If you compile with Sun's ANSI compiler acc, you need additional options 1119 when linking temacs, such as 1120 /usr/lang/SC2.0.1/values-Xt.o -L/usr/lang/SC2.0.1/cg87 -L/usr/lang/SC2.0.1 1121 (those should be added just before the libraries) and you need to 1122 add -lansi just before -lc. The precise file names depend on the 1123 compiler version, so we cannot easily arrange to supply them. 1124 1125 On SunOS 4.1.1, do not use /usr/5bin/cc. You can use gcc or/usr/bin/cc. 1126 Make sure the environment variable LD_LIBRARY_PATH is not defined. 1127 1128 Some people report crashes on SunOS 4.1.3 if SYSTEM_MALLOC is defined. 1129 Others have reported that Emacs works if SYSTEM_MALLOC is defined, and not 1130 if it is undefined. So far we do not know why results vary in this way. 1131 The sources are set up so that SYSTEM_MALLOC is defined; if that crashes, 1132 or if you want the benefit of the relocating memory allocator, you can 1133 try enabling the #undef SYSTEM_MALLOC in src/s/sunos4-1-3.h. 1134 1135 On Solaris 2, you need to install patch 100947-02 to fix a system bug. 1136 Presumably this patch comes from Sun. You must alter the definition of 1137 LD_SWITCH_SYSTEM if your X11 libraries are not in /usr/openwin/lib. 1138 You must make sure that /usr/ucblib is not in your LD_LIBRARY_PATH. 1139 1140 On Solaris 2.2, with a multiprocessor SparcCenter 1000, Emacs 19.17 is 1141 reported to hang sometimes if it exits while it has one or more 1142 subprocesses (e.g. the `wakeup' subprocess used by `display-time'). 1143 Emacs and its subprocesses become zombies, and in their zombie state 1144 slow down their host and disable rlogin and telnet. This is most 1145 likely due to a bug in Solaris 2.2's multiprocessor support, 1146 rather than an Emacs bug. 1147 1148 On Solaris, do not use /usr/ucb/cc. Use /opt/SUNWspro/bin/cc. Make 1149 sure that /usr/ccs/bin and /opt/SUNWspro/bin are in your PATH before 1150 /usr/ucb. (Most free software packages have the same requirement on 1151 Solaris.) With this compiler, use `/opt/SUNWspro/bin/cc -E' as the 1152 preprocessor. If this inserts extra whitespace into its output (see 1153 the PROBLEMS file) then add the option `-Xs'. 1154 1155 If you have trouble using open-network-stream, get the distribution 1156 of `bind' (the BSD name-server), build libresolv.a, and link Emacs 1157 with -lresolv, by copying the #definition of LIBS_SYSTEM in 1158 src/s/sunos4-1.h to src/config.h. This problem is due to obsolete 1159 software in the nonshared standard library. 1160 1161 If you want to use SunWindows, define HAVE_SUN_WINDOWS 1162 in config.h to enable a special interface called `emacstool'. 1163 The definition must *precede* the #include "machine.h". 1164 System version 3.2 is required for this facility to work. 1165 1166 We recommend that you instead use the X window system, which 1167 has technical advantages, is an industry standard, and is also 1168 free software. The FSF does not support the SunWindows code; 1169 we installed it only on the understanding we would not let it 1170 divert our efforts from what we think is important. 1171 1172 If you are compiling for X windows, and the X window library was 1173 compiled to use the 68881, then you must edit config.h according 1174 the comments at the end of `src/m/sun3.h'. 1175 1176 Note that Emacs on a Sun is not really as big as it looks. 1177 As dumped, it includes around 200k of zeros between the 1178 original text section and the original data section 1179 (now remapped as part of the text). These are never 1180 swapped in. 1181 1182 To build a single Emacs that will run on Sun 2 and Sun 3 1183 HARDWARE, just build it on the Sun 2. 1184 1185 On Sunos 4.1.3, the word is that Emacs can loop infinitely 1186 on startup with X due perhaps to a bug in Sunos. Installing all of 1187 these Sun patches fixes the problem. We don't know which of them 1188 are really relevant. 1189 1190 100075-11 100224-06 100347-03 100482-05 100557-02 100623-03 100804-03 1191 101080-01 100103-12 100249-09 100496-02 100564-07 100630-02 100891-10 1192 101134-01 100170-09 100296-04 100377-09 100507-04 100567-04 100650-02 1193 101070-01 101145-01 100173-10 100305-15 100383-06 100513-04 100570-05 1194 100689-01 101071-03 101200-02 100178-09 100338-05 100421-03 100536-02 1195 100584-05 100784-01 101072-01 101207-01 1196 1197Tadpole 68K (m68k-tadpole-sysv) 1198 1199 Changes merged in 19.1. 1200 1201 You may need to edit Makefile to change the variables LIBDIR and 1202 BINDIR from /usr/local to /usr/contrib. 1203 1204 To give movemail access to /usr/mail, you may need to execute 1205 1206 chmod 2755 etc/movemail; chgrp mail etc/movemail 1207 1208Tahoe (tahoe-tahoe-bsd4.2 or tahoe-tahoe-bsd4.3) 1209 1210 18.52 was known to work on some Tahoes, but a compiler bug intervenes 1211 on others. Some Emacs versions have worked in Unisys 1r4 1212 (not in 1r3) and CCI I.21. 1213 1214 If you have trouble compiling `lib-src/loadst.c', turn off the definition 1215 of DKSTAT_HEADER_FILE in `src/m/tahoe.h'. 1216 1217Tandem Integrity S2 (mips-tandem-sysv) 1218 1219 Changes merged in 18.56 but subprocess support is turned off. 1220 You will probably want to see if you can make subprocesses work. 1221 1222 You must edit `lib-src/Makefile' to define LOADLIBES = -mld. 1223 1224Tektronix XD88 (m88k-tektronix-sysv3*) 1225 1226 The 19.26 pretest was reported to work. 1227 Minor changes merged in 19.19. 1228 1229Tektronix 16000 box (6130?) (ns16k-tektronix-bsd) 1230 1231 Emacs 17.61 worked. 1232 1233Tektronix 4300 (m68k-tektronix-bsd) 1234 1235 Emacs 19.26 pretest reported to work. 1236 1237Titan P2 or P3 (titan-titan-sysv) 1238 1239 Changes probably merged in version 19. 1240 1241Ustation E30 (SS5E) (m68k-unisys-unipl) 1242 1243 Changes merged in 18.52; don't know whether they work. 1244 1245Vaxen running Berkeley Unix (vax-dec-bsd4.1, vax-dec-bsd4.2, vax-dec-bsd4.3), 1246 Ultrix (vax-dec-ultrix), 1247 System V (vax-dec-sysv0, vax-dec-sysv2), or 1248 VMS (vax-dec-vms) 1249 1250 Works. 1251 1252 See under Ultrix for problems using X windows on Ultrix (vax-dec-ultrix). 1253 1254 18.27 worked on System V rel 2 (vax-dec-sysv2). 1255 1256 18.36 worked on System V rel 0 (vax-dec-sysv0). 1257 1258 Richard Levitte <levitte@e.kth.se> distributes a set of patches to 1259 Emacs 18.59 to make it work nicely under VMS. Emacs 19 probably 1260 won't work very well, or even compile. Levitte is working on a 1261 port, so these problems should be fixed in the near future. 1262 1263Whitechapel MG1 (ns16k-whitechapel-?) 1264 1265 May work. Supposedly no changes were needed except in `src/m/mg1.h' 1266 file. I do not know what Unix version runs on them. 1267 1268Wicat (m68k-wicat-sysv) 1269 1270 Changes merged as of 18.6; whether they work is unknown. 1271 See comments in `src/m/wicat.h' for things you should change 1272 depending on the system and compiler version you have. 1273 1274Here are notes about some of the systems supported: 1275 1276Berkeley 4.1 (bsd4.1) 1277 1278 Works on vaxes. 1279 1280Berkeley 4.2 (bsd4.2) 1281 1282 Works on several machines. 1283 1284Berkeley 4.3 (bsd4.3) 1285 1286 Works, on Vaxes at least. 1287 1288Esix 1289 1290 The following was written for Emacs 18.59 and has been 1291 slightly adapted for Emacs 19. It may need more change to be correct. 1292 1293 Use s/usg5-4.h for Esix System V 4.0.[34] systems if you also have 1294 XFree86. If you insist on using the Esix X Window libraries, good 1295 luck. s/esix5r4.h provides a starting point, but doesn't seem to 1296 work consistently. The basic problems involve the need to load 1297 -lX11 *last* in the link command, and even then some things break. 1298 You get best results by installing XFree86 and forgetting about the 1299 Esix stuff unless you want to run IXI xdt3, which really only needs 1300 the Esix X11 shared libraries. 1301 1302 To compile with XFree86, make sure that your LD_LIBRARY_PATH 1303 contains /usr/X386/lib. Be careful if you also have the Esix X 1304 Window libraries that /usr/X386/lib appears *first* in the 1305 LD_LIBRARY_PATH. Then define C_SWITCH_X_SYSTEM -I/usr/X386/include. 1306 1307Linux (actually GNU/Linux) 1308 1309 Most of the complete systems which use the Linux kernel are close 1310 enough to the GNU system to be considered variant GNU systems. We 1311 call them "Linux-based GNU systems," or GNU/Linux for short. 1312 1313 It is not coincidence that many of the other components used with 1314 Linux--including GNU Emacs--were developed specifically for the GNU 1315 project. The GNU project was launched in 1984 to develop a free 1316 complete Unix-like operating system. To reach this goal, we had to 1317 develop whatever system components were not available as freely 1318 redistributable software from some other source. 1319 1320 The GNU project wants users of GNU/Linux systems to be aware of how 1321 these systems relate to the GNU project, because that will help 1322 spread the GNU idea that software should be free--and thus encourage 1323 people to write more free software. See the file LINUX-GNU in this 1324 directory for more explanation. 1325 1326Microport 1327 1328 See under "Intel 386". 1329 1330MSDOS 1331 1332 For installation on MSDOS, see the file INSTALL (search for `MSDOG', 1333 near the end of the file). See the "MS-DOS" chapter of the manual 1334 for information about using Emacs on MSDOS. 1335 1336SCO Unix 1337 If you have TCP but not X, you need to edit src/s/sco4.h 1338 to define HAVE_SOCKETS. 1339 1340 If you are using MMDF instead of sendmail, you need to remove 1341 /usr/lib/sendmail or modify lisp/paths.el before compiling. 1342 lisp/paths.el (which is loaded during the build) will attempt to use 1343 sendmail if it exists. 1344 1345 If you are using SMAIL, you need to define the macro 1346 SMAIL in config.h. 1347 1348System V rel 0 (usg5.0) 1349 1350 Works, on Vaxes and 3bxxx's. 1351 There are some problems in 18.37 due to shortnames/cccp problems: 1352 use the emacs 17 cpp if you have it. 1353 1354System V rel 2 (usg5.2) 1355 1356 Works on various machines. 1357 On some (maybe all) machines the library -lPW exists and contains 1358 a version of `alloca'. On these machines, to use it, put 1359 #define HAVE_ALLOCA 1360 #define LIB_STANDARD -lPW -lc 1361 in the `src/m/MACHINENAME.h' file for the machine. 1362 1363 If you find that the character Meta-DEL makes Emacs crash, 1364 find where function init_sys_modes in sysdep.c sets sg.c_cc[VQUIT] 1365 and make it store 7 there. I have as yet no evidence of whether 1366 this problem, known in HP/UX, exists in other system V versions. 1367 1368System V rel 2.2 (usg5.2.2) 1369 1370 In 5.2.2 AT&T undid, incompatibly, their previous incompatible 1371 change to the way the nlist library is called. A different s- file 1372 is used to enable the other interface. 1373 1374 They call themselves the right choice--can't they choose? 1375 1376 Emacs version 18 unexec is currently not working properly 1377 on 5.2.2. Nobody knows why yet. A workaround is to define 1378 NO_REMAP. It is not yet known whether this applies to all 1379 machines running 5.2.2. 1380 1381System V rel 3 (usg5.3) 1382 1383 Some versions of this system support ptys and BSD-style sockets. 1384 On such systems, you should define HAVE_PTYS and HAVE_SOCKETS in config.h. 1385 1386 If you want to link Emacs with shared libraries, define 1387 USG_SHARED_LIBRARIES. 1388 1389 You may have to add ANSI idempotence #-lines to your sys/types.h 1390 file to get Emacs to compile correctly. This may be necessary on 1391 other pre-ANSI systems as well. 1392 1393 On an AT&T 6386WGS using System V Release 3.2 and X11R3, the X support 1394 cannot be made to work. Whether or not the GNU relocating malloc is 1395 used, the symptom is that the first call Emacs makes to sbrk(0) returns 1396 (char *)-1. Sorry, you're stuck with character-only mode. Try 1397 installing XFree86 to fix this. 1398 1399System V rel 4.0.3 and 4.0.4 (usg5.4) 1400 1401 Supported, including shared libraries for ELF, but ptys do not work 1402 because TIOCGPGRP fails to work on ptys (but Dell 2.2 seems to have 1403 fixed this). This failure is probably due to a misunderstanding of 1404 the consequences of the POSIX spec: many system designers mistakenly 1405 think that POSIX requires this feature to fail. This is untrue; 1406 ptys are an extension, and POSIX says that extensions *when used* 1407 may change the action of standard facilities in any fashion. 1408 1409 If you get compilation errors about wrong number of 1410 arguments to getpgrp, define GETPGRP_NO_ARG. 1411 1412 The standard C preprocessor may generate xmakefile incorrectly. However, 1413 /lib/cpp will work, so use `make CPP=/lib/cpp'. Standard cpp 1414 seems to work OK under Dell 2.2. 1415 1416 Some versions 3 and earlier of V.4, on the Intel 386 and 860, had 1417 problems in the X11 libraries. These prevent Emacs from working 1418 with X. You can use Emacs with X provided your copy of X is based 1419 on X11 release 4 or newer, or is Dell's 2.2 (which is a 4.0.3). 1420 Unfortunately, the only way you can tell whether your X11 library is 1421 new enough is to try compiling Emacs to use X. If emacs runs, your 1422 X11 library is new enough. 1423 1424 In this context, GSV4 and GSV4i are alternate names for X11R4. 1425 OL2.* is X11R3 based. OL3 is in between X11R3 and X11R4, and may or 1426 may not work, depending on who made the Unix system. If the library 1427 libXol is part of the X distribution, then you have X11R3 and Emacs 1428 won't work with X. 1429 1430 Most versions of V.4 support sockets. If `/usr/lib/libsocket.so' 1431 exists, your system supports them. If yours does not, you must add 1432 #undef HAVE_SOCKETS in config.h, after the inclusion of s-usg5-4.h. 1433 (Any system that supports Internet should implement sockets.) 1434 1435Ultrix (bsd4.3) 1436 1437 Recent versions of Ultrix appear to support the features of Berkeley 4.3. 1438 Ultrix was at the BSD 4.2 level for a long time after BSD 4.3 came out. 1439 1440 Ultrix 3.0 has incompatibilities in its X library if you have the 1441 Ultrix version of X (UWS version 2.0). To solve them, you need to 1442 prevent XvmsAlloc.o in Xlib from being used. Israel Pinkas says: 1443 1444 I added the following lines to config.h after the X defines: 1445 1446 #if defined(ultrix) && defined(X11) 1447 #define OBJECTS_SYSTEM calloc.o 1448 #endif 1449 1450 Then I ran the following: 1451 1452 ar x /usr/lib/libc.a calloc.o 1453 1454 The problem is said to be gone in UWS version 2.1. 1455 1456Uniplus 5.2 (unipl5.2) 1457 1458 Works, on Dual machines at least. 1459 1460VMS (vmsM.N) 1461 1462 Richard Levitte <levitte@e.kth.se> distributes a set of patches to 1463 Emacs 18.59 to make it work nicely under VMS. Emacs 19 probably 1464 won't work very well, or even compile. Levitte is working on a 1465 port, so these problems should be fixed in the near future. 1466 1467 Note that Emacs for VMS is usually distributed in a special VMS 1468 distribution. See the file ../vms/VMSINSTALL for info on moving 1469 Unix distributions to VMS, and other VMS-related topics. 1470 1471Windows NT/95/98/ME/2000 1472 1473 For installation on all versions of the MS-Windows platform, see the 1474 file nt/INSTALL. 1475 1476X86_64 GNU/Linux 1477 1478 No special procedures should be needed to build a 64-bit Emacs. To 1479 build a 32-bit Emacs, first ensure that the necessary 32-bit system 1480 libraries and include files are installed. Then use: 1481 1482 env CC="gcc -m32" ./configure --build=i386-linux-gnu \ 1483 --x-libraries=/usr/X11R6/lib 1484 1485 (using the location of the 32-bit X libraries on your system). 1486 1487Xenix (xenix) 1488 1489 Should work in 18.50, but you will need to edit the files 1490 `lib-src/Makefile' and `src/ymakefile' 1491 (see the comments that mention "Xenix" for what to change.) 1492 Compiling Emacs with -O is said not to work. 1493 1494 If you want Emacs to work with Smail (installed as /usr/bin/smail) 1495 then add the line #define SMAIL to config.h. 1496 1497 The file etc/XENIX suggests some useful things to do to Xenix 1498 to make the Emacs meta key work. 1499 1500Local variables: 1501mode: text 1502fill-prefix: " " 1503End: 1504 1505This file is part of GNU Emacs. 1506 1507GNU Emacs is free software; you can redistribute it and/or modify 1508it under the terms of the GNU General Public License as published by 1509the Free Software Foundation; either version 2, or (at your option) 1510any later version. 1511 1512GNU Emacs is distributed in the hope that it will be useful, 1513but WITHOUT ANY WARRANTY; without even the implied warranty of 1514MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 1515GNU General Public License for more details. 1516 1517You should have received a copy of the GNU General Public License 1518along with GNU Emacs; see the file COPYING. If not, write to the 1519Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, 1520Boston, MA 02110-1301, USA. 1521 1522arch-tag: 7d2e93c7-e982-40ec-9055-3cd064042473 1523