COMPILING 2.6 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768
  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 statfs to SUS statvfs
  29. * rfc2553 hostname resolution (methods/rfc*), shims to normal gethostbyname.
  30. The only completely non-shimed OS is Linux with glibc2.1
  31. Platform Notes
  32. ~~~~~~~~~~~~~~
  33. Debian GNU Linux 2.1 'slink'
  34. Debian GNU Linux 'potato'
  35. * All Archs
  36. - Works flawlessly
  37. - You will want to have debiandoc-sgml and yodl installed to get
  38. best results.
  39. - No IPv6 Support in glibc's < 2.1
  40. Sun Solaris
  41. SunOS cab101 5.7 Generic_106541-04 sun4u sparc
  42. - Works fine
  43. - Note, no IPv6 Support, OS lacks RFC 2553 hostname resolution
  44. HP-UX
  45. HP-UX nyquist B.10.20 C 9000/780 2016574337 32-user license
  46. - Evil OS, does not conform very well to SUS
  47. 1) snprintf exists but is not prototyped, ignore spurios warnings
  48. 2) No socklen_t
  49. 3) Requires -D_XOPEN_SOURCE_EXTENDED for h_errno
  50. Items 2 and 3 have to be fixed by hand. Insert this into
  51. build/include/netdb.h:
  52. #define _XOPEN_SOURCE_EXTENDED
  53. #define socklen_t size_t
  54. #include_next <netdb.h>
  55. A similar techinque can be used for snprintf/vsprintf if you dislike
  56. the warnings
  57. - Note, no IPv6 Support, OS lacks RFC 2553 hostname resolution