COMPILING 2.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172
  1. General Information
  2. ~~~~~~~~~~~~~~~~~~~
  3. To compile this you need a couple things
  4. - A working POSIX system with working POSIX gcc, g++, make (GNU),
  5. ar, sh, awk and sed in the path
  6. - GNU Make 3.74 or so, -- normal UNIX make will NOT work
  7. * Note 3.77 is broken.
  8. - A working ANSI C++ compiler, this is not g++ 2.7.*
  9. g++ 2.8 works OK and newer egcs work well also. Nobody has tried it
  10. on other compilers :< You will need a properly working STL as well.
  11. - A C library with the usual POSIX functions and a BSD socket layer.
  12. If you OS conforms to the Single User Spec then you are fine:
  13. http://www.opengroup.org/onlinepubs/7908799/index.html
  14. Guidelines
  15. ~~~~~~~~~~
  16. I am not interested in making 'ultra portable code'. I will accept patches
  17. to make the code that already exists conform more to SUS or POSIX, but
  18. I don't really care if your not-SUS OS doesn't work. It is simply too
  19. much work to maintain patches for dysfunctional OSs. I highly suggest you
  20. contact your vendor and express intrest in a conforming C library.
  21. That said, there are lots of finniky problems that must be delt with even
  22. between the supported OS's. Primarily the path I choose to take is to put
  23. a shim header file in build/include that transparently adds the required
  24. functionality. Patches to make autoconf detect these cases and generate the
  25. required shims are OK.
  26. Current shims:
  27. * C9x integer types 'inttypes.h'
  28. * sys/statvfs.h to convert from BSD/Linux statfs to SUS statvfs
  29. * rfc2553 hostname resolution (methods/rfc*), shims to normal gethostbyname.
  30. The more adventerous could steal the KAME IPv6 enabled resolvers for those
  31. OS's with IPv6 support but no rfc2553 (why?)
  32. * define _XOPEN_EXTENDES_SOURCE to bring in h_errno on HP-UX
  33. * socklen_t shim in netdb.h if the OS does not have socklen_t
  34. The only completely non-shimed OS is Linux with glibc2.1, glibc2.0 requires
  35. the first three shims.
  36. Platform Notes
  37. ~~~~~~~~~~~~~~
  38. Debian GNU Linux 2.1 'slink'
  39. Debian GNU Linux 'potato'
  40. * All Archs
  41. - Works flawlessly
  42. - You will want to have debiandoc-sgml and yodl installed to get
  43. best results.
  44. - No IPv6 Support in glibc's < 2.1.
  45. Sun Solaris
  46. SunOS cab101 5.7 Generic_106541-04 sun4u sparc
  47. - Works fine
  48. - Note, no IPv6 Support, OS lacks RFC 2553 hostname resolution
  49. OpenBSD
  50. OpenBSD gsb086 2.5 CMPUT#0 i386 unknown
  51. - Works fine
  52. - OS needs 'ranlib' to generate the symbol table after 'ar'.. (not using
  53. GNU ar with the gnu tool chain :<)
  54. - Note, no IPv6 Support, OS lacks RFC 2553 hostname resolution
  55. HP-UX
  56. HP-UX nyquist B.10.20 C 9000/780 2016574337 32-user license
  57. - Evil OS, does not conform very well to SUS
  58. 1) snprintf exists but is not prototyped, ignore spurios warnings
  59. 2) No socklen_t
  60. 3) Requires -D_XOPEN_SOURCE_EXTENDED for h_errno
  61. configure should fix the last two (see above)
  62. - Note, no IPv6 Support, OS lacks RFC 2553 hostname resolution