[m-dev.] diff: update README.OSF1

[Fergus Henderson]

Estimated hours taken: 0.5

README.OSF1:
	Document some more problems with OSF1 that
	affect the use of Mercury.

Workspace: /home/mercury0/fjh/mercury
Index: README.OSF1
===================================================================
RCS file: /home/mercury1/repository/mercury/README.OSF1,v
retrieving revision 1.1
diff -u -d -r1.1 README.OSF1
--- README.OSF1	1999/11/10 01:43:25	1.1
+++ README.OSF1	1999/11/23 03:17:58
@@ -3,5 +3,31 @@
 message such as:
 "sed: There are too many commands for the
 	s%@READLINE_LIBRARIES@%-lreadline -ltermcap%g function."
-
 The work-around is to install GNU sed.
+
+The dynamic loader supplied with DEC OSF/1 V3.2 has a fixed limit which
+causes dynamically linked executables to fail with a segmentation
+violation before main() is entered, if the shared library path is too
+long.  The work-around is to ensure that you do not specify a long
+directory name in the `--prefix' option to `configure' when installing
+Mercury (up to 24 characters long is OK, but more than that may
+cause the fixed limit to be exceeded), or to upgrade to a more
+recent version of the OS.
+
+The dynamic loader supplied with DEC OSF/1 V3.2 fails to conform to the
+semantics mandated by the ANSI/ISO C standard, and this breaks the
+Mercury profiler.  The symptom is that the profiler will abort with a
+message such as "Software Error: map__lookup failed".  The work-around
+is to link the program that is being profiled statically, or to run the
+program with the environment variable LD_BIND_NOW set to a non-null
+value.
+
+For certain (rare) combinations of program and compilation options, the
+dynamic loader supplied with DEC OSF/1 V3.2 will abort execution of the
+compiled program with a message such as "/sbin/loader: Fatal Error:
+lazy_text_resolve: symbol _entry_mercury__io__write_string_3_0 should
+not have any relocation entry".  We don't know the exact cause of this,
+but we suspect that it is a bug in the dynamic loader.  The work-around
+is to link the program in question statically, or to run the program
+with the environment variable LD_BIND_NOW set to a non-null value.
+

-- 
Fergus Henderson <fjh at cs.mu.oz.au>  |  "I have always known that the pursuit
WWW: <http://www.cs.mu.oz.au/~fjh>  |  of excellence is a lethal habit"
PGP: finger fjh at 128.250.37.3        |     -- the last words of T. S. Garp.
--------------------------------------------------------------------------
mercury-developers mailing list
Post messages to:       mercury-developers at cs.mu.oz.au
Administrative Queries: owner-mercury-developers at cs.mu.oz.au
Subscriptions:          mercury-developers-request at cs.mu.oz.au
--------------------------------------------------------------------------