Added first cut of lists of operating systems that have various sorts

of bugs in the operating system that causes problems with building or
runing Kerberos 5.

git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@4585 dc483132-0cff-0310-8789-dd5450dbe970

1 files changed, 73 insertions, 0 deletions

diff --git a/doc/OS-notes b/doc/OS-notes
new file mode 100644
index 000000000..a328c9640
--- /dev/null
+++ b/doc/OS-notes
@@ -0,0 +1,73 @@
+Operating systems notes.... this file contains notes about various
+different operating systems and some quirks that you have to be aware
+of when compiling for them.
+
+--------------------------------------------------------------------------
+Alpha OSF/1 V2.0
+
+md4.c can not be compiled with the optimizer on.  (Could it possibly
+be the same bug as the Dec Ultrix bug?  The bug report makes it sound
+identical!)
+
+(Reported by Marc Kenig)
+
+--------------------------------------------------------------------------
+
+BSDI 
+
+BSDI reportedly has a bad sed which causes it to go into an infinite
+loop during the build.  The workaround is to get a sed from somewhere
+else, such as GNU.
+
+------------------------------------------------------------------------
+Solaris versions 2.0 through 2.3:
+
+The gethostbyname() routine is broken; it does not return a fully
+qualified domain name, even if you are using the DNS.  Since Kerberos
+V5 uses the fully qualified domain name as the second component of a
+service principal (i.e, "host/tsx-11.mit.edu@ATHENA.MIT.EDU), this
+causes problems for servers who try to figure out their own fully
+qualified domain name.  (It turns out clients win because Kerberos
+calls gethostbyname() and then calls gethostbyaddr() on the address,
+and SunSoft didn't screw up gethostbyaddr() except when it is your own
+local hostname!)
+
+Workarounds:  
+
+1)  Supply your own resolver library.
+
+2)  Upgrade to Solaris 2.4
+
+3)  Make sure your /etc/nsswitch.conf has the line:
+
+	hosts:      files dns
+
+and then in /etc/hosts, make sure there is a line with your
+workstation's IP address and hostname, with the fully qualified domain
+name first.  Example:
+
+	18.172.1.4      dcl.mit.edu dcl
+
+--------------------------------------------------------------------------
+
+Solaris 2.X:
+
+You *must* compile Kerberos V5 *without* the UCB compatibility libraries.  
+
+This means that /usr/ucblib must *not* be in the LD_LIBRARY_PATH
+environment variable when you compile it.  
+
+Alternatively you can place the -i option on the cc line.  So you can
+put --with-ccopts=-i on the configure line.  (Thanks to Dan Nessett
+for this suggestion.
+
+--------------------------------------------------------------------------
+
+Ultrix 4.2/3 (Decstation Mips)
+
+md4.c and md5.c can not be compiled with the optimizer set at level 1.
+(Either -O or -g will work; leaving ccopts blank won't.)  The
+optimizer isn't hung; it just takes a long time, due to an exponential
+time bug.  Calculations estimate around something like 4 billion
+years.  :-)
+