summary refs log tree commit diff
path: root/MACHINES
diff options
context:
space:
mode:
Diffstat (limited to 'MACHINES')
-rw-r--r--MACHINES239
1 files changed, 239 insertions, 0 deletions
diff --git a/MACHINES b/MACHINES
new file mode 100644
index 000000000..2f44f7629
--- /dev/null
+++ b/MACHINES
@@ -0,0 +1,239 @@
+-----------------------------
+ZSH ON SPECIFIC ARCHITECTURES
+-----------------------------
+
+These are the OSes that zsh has been tried on.  If you succeed in getting
+zsh to work on an OS not listed, let us know.  The information in this
+list may be out of date, as the developers do not have access to all
+machines.  In general, GNU/Linux distributions, Solaris and Cygwin are
+reasonably well covered.  Please let us have any recent information
+on other systems.  The information for systems not known to have been
+tested recently is marked as `out of date'.
+
+On all machines if you use gcc and upgrade your OS you must rebuild gcc
+after the OS upgrade.  A gcc left from a previous OS may seem to work
+but compiling more complex programs may fail mysteriously.
+
+The format of entries is thus:
+
+	Vendor: OS & version (hardware type) [zsh version tried]
+		information
+
+Machines
+--------
+
+Apple: MacOS X/Darwin 10.x
+	Should build `out-of-the-box'.
+
+	For dynamic loading to work on 10.1 and 10.2, you need to use the
+	dlcompat library.  It can be downloaded from:
+	    http://sourceforge.net/project/showfiles.php?group_id=17203
+
+	The zsh/zpty library is not working on 10.1 and 10.2, but is on
+	10.3.  This causes the tests starting `Y' in the Test directory to
+	fail, even though the features to be tested are working.
+
+Red Hat Inc.: Cygwin
+	Should build `out-of-the-box'.  The compilation directory should
+	be on a file system mounted as binary (the mount command shows
+	`binmode'). There are various issues with Cygwin versions before
+	1.3.2 - you are adviced to update to the latest release.
+
+	Dynamic loading works as of cygwin-1.1.3 and binutils-20000722-1.
+	It was not tested for earlier versions. This does not imply
+	that every module will work. New completion and in
+	particular zsh/zftp and zsh/mathfunc are known to work.
+
+	Some of the tests in the Test subdirectory are known to fail:
+	this is because the UNIX environment is not completely implemented.
+
+	Cygwin allows mount without existing mount point (e.g.
+	"mount //server/path /usr/src" where /usr/src does not exist).
+	Path completion will fail inside these mounts; make sure that
+	every mount point really exists.
+
+DEC: Ultrix (Alpha or DECstation)
+DEC: Mach 3.0 (DECstation 5000/25)
+DEC: OSF/1 1.2, 1.3, 2.0, 3.x, DEC Unix 4.x (Alpha)
+	[Out of date.]
+
+	In OSF/1 3.x, there is apparently a bug in the header file
+	/usr/include/rpcsvc/ypclnt.h; the prototype for yp_all() has a
+	struct ypall_callback as its final argument, which should be a
+	pointer (struct ypall_callback *).  This prevents compilation of
+	one of zsh' files (zle_tricky.c).  If you can't modify the header
+	file, create a directory called `rpcsvc' in zsh's Src subdirectory
+	and put a fixed version of the header file to it before compiling.
+
+	The strip coming with gcc-2.7.2 seems to create unusable binaries.
+	This problem is not related to zsh.  If you have such problems,
+	remove the bogus strip and use /bin/strip instead.
+
+	On Digital UNIX 4.0, compilation with gcc and with --enable-dynamic
+	apparently needs configuring with explicit flags when compiling
+	with debugging enabled:
+	 DLLD=gcc LDFLAGS='-g -rpath <path-to-.so-files>' ./configure ...
+
+FreeBSD: FreeBSD 2.2.7, 3.x, 4.x
+	Should build `out-of-the-box'.  On FreeBSD 2.2, dynamic	loading
+	does not work, but it does with 3.x and 4.x.
+
+HP: HP-UX 9, 10.20, 11.x (PA-RISC, Itanium)
+	Should build `out-of-the-box'.
+
+	Previous problems encountered on HP-UX 11.x:
+
+	  Some of the special keys on the keyboard (backspace, delete)
+	  have been found to stop functioning.  One suggested fix is
+	  to alter the way the curses library is linked in the Makefile.
+	  Replacing `-lcurses' with `-lHcurses -lcurses' in the libraries
+	  is reported to fix.  An attempt to fix this in configure
+	  is apparently ineffective; more information would be appreciated
+	  as the maintainers do not have access to an HP-UX system.
+	  Recent reports indicated this is not necessary on recent versions
+	  of HP-UX 11.
+
+	  Compiling with gcc 2.7.1 is known to fail with header file
+	  conflicts.  Use the HP ANSI C compiler.
+
+HP/Compaq: Tru64 4.x, 5.x
+	  Should build `out-of-the-box'.
+
+IBM: AIX 3.2, 4.x, 5.x
+	Should build `out-of-the-box'.
+
+	Certain features will not work, in particular --enable-cap
+	and --enable-zsh-mem.  (The feature enabled by --enable-cap
+	is apparently present, however.  Help getting this to work
+	would be appreciated.)
+
+	On 3.2, for 64-bit integer support you need to compile with gcc, as
+	the native compiler does not support ANSI simultaneously with
+	`long long'.  On 4.1, there appeared to be problems using
+	--enable-dynamic (the default) with gcc (version was 2.7.2.3),
+	though native cc works. More information about this problem
+	would be appreciated.
+
+	It was reported, that at least some 4.x versions have problem
+	with curses - variables boolcodes and some other are declared
+	in term.h but missing is libcurses.a. That makes native compiler
+	very unhappy (GCC 3.0 apparently does not mind). Zsh now defaults
+	to termcap on AIX; any info about this problem is appreciated.
+
+Linux: Linux 2.x (various 32-bit and 64-bit processors)
+	Should build `out-of-the-box'.
+
+	If you are using an early minor version of libc 5, then a bug
+	in the auto-configuration process may cause zsh to think that
+	your system doesn't support the lstat function.  If the configure
+	process reports that there is no lstat, edit config.h and change
+	HAVE_LSTAT to 1.  libc-5.2.18 or later does not have this problem.
+
+	Various problems have been reported when using optimisation
+	with the experimental GNU compiler, egcs.  In particular,
+	on Linux Alpha with egcs 1.0.3a and 1.1.1 using -O1 or greater,
+	the completion code is not correctly compiled.
+
+	Some versions of glibc2 have a conflict with <asm/resource.h>
+	which causes a redefinition warning on RLIM_INFINITY.  This
+	causes configure to decide that <sys/resource.h> is not present,
+	which can cause compilation errors in zsh's rlimit code.  The
+	best solution is to edit config.h after running configure and
+	#define HAS_SYS_RESOURCE_H.
+
+NetBSD: NetBSD 1.x
+	Should build `out-of-the-box'.
+
+OpenBSD: OpenBSD 2.x, 3.x
+	Should build `out-of-the-box'.
+
+SIEMENS: Reliant UNIX
+	[Out of date.]
+
+	Builds `out-of-the-box'. Dynamic loading is supported. 
+	Large Files and 64-bit integers are supported as of version 5.44
+	and CDS/CDS++ compiler.
+
+SIEMENS: SINIX
+	[Out of date.]
+
+	MX (Intel) platform: SINIX-L/M 5.41
+	Builds out-of-the-box with EGCS. Neither dynamic loading nor
+	64-bit integers are supported. Native compiler was not tried
+	mostly because GCC/EGCS builds out-of-the-box as well. If you 
+	succeed with native compiler, send a patch for this file
+	to zsh-workers.
+
+	RM (MIPS) platform: SINIX-N/Y 5.42
+	Should build out-of-the-box but it was not tested. Neither
+	dynamic loading nor 64-bit integers are supported.
+	Note, that this version is obsolete and users are expected to 
+	update to Reliant UNIX.
+
+SGI: IRIX 6.2, 6.3, 6.5
+	[Out of date.]
+
+	Should build `out-of-the-box'.
+
+	On 6.5.2, zsh malloc routines are reported not to work; also
+	full optimization (cc -O3 -OPT:Olimit=0) causes problems.
+
+	If using the SGI compiler, variable length arrays need to
+	be turned off.  configure can work this out for itself if it
+	is passed the option --enable-cflags='-LANG:vla=off -O' (combined
+	with other flags if necessary).
+
+	The zpty module is not currently supported.  This causes the
+	tests starting `Y' in the Test directory to fail, even though
+	the features to be tested are working.
+
+Sun: SunOS 4.1.x
+	[Out of date.]
+
+	Under 4.1.3 if yellow pages is used, username completion may cause
+	segmentation violation.  This is a bug in the shared library not
+	in zsh.  Some libc.so.1.9.* has this bug (it fails in yp_all).
+	Statically linked binaries will work if linked with libc.so.1.8.1
+	(which means that if you can get a statically linked binary
+	compiled under 4.1.2 that it will probably work).  An alternative
+	but untested solution may be to undefine HAVE_NIS in config.h.
+	This may work, but the first username completion will be _very_
+	slow (as slow as in tcsh).
+
+Sun: Solaris 2.x, 8, 9
+	The UCB versions of the routines for reading directories are not
+	usable (the struct definitions are incompatible with the ones
+	assumed by zsh).  The symptom of this is that globbed filenames in
+	the compiled version of zsh will be missing the first two letters.
+	To avoid this, make sure you compile zsh without any reference
+	to /usr/ucblib in your LD_LIBRARY_PATH.  You can easily do this
+	by just unsetting LD_LIBRARY_PATH before building zsh.
+
+	Problems were once reported using --enable-lfs (the default) to
+	enable large file system and integer support on Solaris 2 with gcc
+	before 2.95.2.  Recent versions of gcc appear to be unproblematic.
+
+Other machines
+--------------
+
+Zsh has previously been compiled on the following machines, but the
+developers do not have direct access to them and the reports may be out of
+date.  We would be glad to receive any reports of success or failure on
+these OS's --- and, of course, any others not mentioned in this file.
+
+Apple/NeXT OpenStep 4.2 for i386.
+	Reported to work at least with gcc 2.8.1 and gawk 2.15 patchlevel
+	6, but not with the bundled cc 2.7.2.1 and awk.
+
+Cray: Unicos (C90 and T90)
+	Should build `out-of-the-box'.
+
+Data General: DG/UX 5.4R3.10 MU01 (various AViiONs)
+	Should build `out-of-the-box'.
+
+Next: NextStep 3.*
+	Should build `out-of-the-box', but the zsh malloc routines are
+	not recommended.
+
+SCO: UnixWare 2.1.3
+	Builds `out-of-the-box'.