]> git.saurik.com Git - apt.git/blob - COMPILING
apt-helper: cat-file: Add -C/--compress option
[apt.git] / COMPILING
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 your OS conforms to the Single Unix Spec then you are fine:
13 http://www.opengroup.org/onlinepubs/7908799/index.html
14 - Refer to the Build-Depends information in debian/control for
15 additional requirements (some of which are Debian-specific)
16
17 ** NOTICE **
18 The C++ global constructors do not link correctly when using non-shared
19 libraries. This is probably the correct behavior of the linker, but I have
20 not yet had time to devise a work around for it. The correct thing to
21 do is add a reference to debSystem in apt-pkg/init.cc,
22 assert(&debSystem == 0) would be fine for instance.
23
24 Guidelines
25 ~~~~~~~~~~
26 I am not interested in making 'ultra portable code'. I will accept patches
27 to make the code that already exists conform more to SUS or POSIX, but
28 I don't really care if your not-SUS OS doesn't work. It is simply too
29 much work to maintain patches for dysfunctional OSs. I highly suggest you
30 contact your vendor and express interest in a conforming C library.
31
32 That said, there are lots of finicky problems that must be dealt with even
33 between the supported OS's. Primarily the path I choose to take is to put
34 a shim header file in build/include that transparently adds the required
35 functionality. Patches to make autoconf detect these cases and generate the
36 required shims are OK.
37
38 Current shims:
39 * sys/statvfs.h to convert from BSD/old-glibc statfs to SUS statvfs
40 * rfc2553 hostname resolution (methods/rfc*), shims to normal gethostbyname.
41 The more adventurous could steal the KAME IPv6 enabled resolvers for those
42 OS's with IPv6 support but no rfc2553 (why?)
43 * define _XOPEN_EXTENDED_SOURCE to bring in h_errno on HP-UX
44 * socklen_t shim in netdb.h if the OS does not have socklen_t
45
46 The only completely non-shimmed OS is Linux with glibc2.1, glibc2.0 requires
47 the first three shims.
48
49 Platform Notes
50 ~~~~~~~~~~~~~~
51 Debian GNU Linux 2.1 'slink'
52 Debian GNU Linux 'potato'
53 Debian GNU Linux 'woody'
54 * All Archs
55 - Works flawlessly
56 - You will want to have docbook-xml and docbook2man installed to get
57 best results.
58 - No IPv6 Support in glibc's < 2.1.
59
60 Sun Solaris
61 SunOS cab101 5.7 Generic_106541-04 sun4u sparc
62 SunOS csu201 5.8 Generic_108528-04 sun4u sparc
63 - Works fine
64 - Note, no IPv6 Support, OS lacks RFC 2553 hostname resolution
65
66 OpenBSD
67 OpenBSD gsb086 2.5 CMPUT#0 i386 unknown
68 OpenBSD csu101 2.7 CMPUT#1 i386 unknown
69 - OS needs 'ranlib' to generate the symbol table after 'ar'.. (not using
70 GNU ar with the gnu tool chain :<)
71 - '2.5' does not have RFC 2553 hostname resolution, but '2.7' does
72 - Testing on '2.7' suggests the OS has a bug in its handling of
73 ftruncate on files that have been written via mmap. It fills the page
74 that crosses the truncation boundary with 0's.
75
76 HP-UX
77 HP-UX nyquist B.10.20 C 9000/780 2016574337 32-user license
78 - Evil OS, does not conform very well to SUS
79 1) snprintf exists but is not prototyped, ignore spurious warnings
80 2) No socklen_t
81 3) Requires -D_XOPEN_SOURCE_EXTENDED for h_errno
82 configure should fix the last two (see above)
83 - Note, no IPv6 Support, OS lacks RFC 2553 hostname resolution
84