]> diplodocus.org Git - nmh/blob - MACHINES
Another pass at cleaning up (some of) the manpages.
[nmh] / MACHINES
1 #
2 # MACHINES -- operating system specific information
3 #
4
5 nmh is routinely built and tested on recent versions of the following
6 platforms:
7 Cygwin (32- and 64-bit)
8 FreeBSD 9
9 FreeBSD 10
10 Linux (Fedora, Ubuntu, and CentOS distributions)
11 Mac OS X 10.9
12 OpenBSD 5.4
13 Solaris 11
14
15 nmh was known in the distant past to compile on the following platforms (save
16 the exceptions noted below), using an ANSI C compiler, such as gcc:
17 AIX 4.1.5.0.01
18 IRIX 6.5
19 NetBSD 1.4.2
20 Solaris 7 and 8 (sparc,x86)
21 SunOS 4.1
22
23 On all platforms, the following programs are required to build nmh from a
24 snapshot of the source code repository:
25 autoconf 2.68 or later
26 automake 1.12 or later
27 flex 2.5.4 or later
28 bison 2.3 or later, Berkeley yacc 1.9 or later, or Solaris yacc 4.0
29 They are not required if building from an nmh distribution (.tar.gz) file.
30
31 Platform-specific notes follow.
32
33 ------------------------------------------------------------------------------
34 Linux
35 ------------------------------------------------------------------------------
36
37 Run-time package requirements:
38 ncurses-libs
39 gdbm, db4, or libdb (only needed for slocal(1))
40 readline (if you want readline support)
41 cyrus-sasl-lib / libsasl2 (if configured with --with-cyrus-sasl)
42 openssl-libs / libssl (if configured with --with-tls)
43
44 Additional build-time package requirements:
45 ncurses-devel / libncurses5-devel
46 gdbm-devel, db4-devel or libdb-devel/libdb-dev (only needed for slocal(1))
47 readline-devel (if you want readline support)
48 cyrus-sasl-devel / libsasl2-dev (if configuring with --with-cyrus-sasl)
49 openssl-devel / libssl-dev (if configuring with --with-tls)
50
51 Test suite package requirements:
52 ncurses (tput is needed to run test/format/test-curses)
53
54 ------------------------------------------------------------------------------
55 Mac OS X
56 ------------------------------------------------------------------------------
57
58 If configured with --with-tls on Mac OS 10.7 or later, there will be
59 compile warnings from mts/smtp/smtp.c about the deprecated OpenSSL
60 that is supplied with that system. nmh will build and run with that
61 OpenSSL, though it may be an old version. Alternatively, the OpenSSL
62 source code is available from http://www.openssl.org/source/. To
63 build 64-bit libraries, the OpenSSL configure command should start
64 with, e.g.,
65 ./Configure darwin64-x86_64-cc
66
67 To build nmh with those OpenSSL libraries, the CPPFLAGS and LDFLAGS
68 can be set by adding the following to the nmh configure command line,
69 or in the shell environment before calling configure or build_nmh:
70 CPPFLAGS='-D__arch64__ -IOpenSSL-include-path' LDFLAGS=-LOpenSSL-lib-path
71
72 ------------------------------------------------------------------------------
73 FreeBSD
74 ------------------------------------------------------------------------------
75
76 Additional build-time package requirements:
77 devel/autotools
78
79 ------------------------------------------------------------------------------
80 Cygwin
81 ------------------------------------------------------------------------------
82
83 Run-time package requirements:
84 file
85 libncurses10 or libncursesw10
86 libgdbm4 (only needed for slocal(1))
87 libiconv or libiconv2 (if you want iconv support)
88 libreadline7 (if you want readline support)
89 libsasl2_3 (if configured with --with-cyrus-sasl)
90 openssl (if configured with --with-tls)
91
92 Additional build-time package requirements:
93 libncurses-devel or libncursesw-devel
94 libgdbm4-devel (only needed for slocal(1))
95 libiconv-devel (if you want iconv support)
96 libreadline-devel (if you want readline support)
97 libsasl2-devel (if configuring with --with-cyrus-sasl)
98 openssl-devel (if configuring with --with-tls)
99
100 Older versions of libncurses-devel do not install /usr/include/curses.h,
101 /usr/include/term.h, and /usr/include/termcap.h. If yours does not,
102 either add symlinks in /usr/include/ to those files in its ncurses/
103 subdirectory, or build with:
104 make DEFAULT_INCLUDES='-I. -I/usr/include/ncurses'
105
106 Test suite package requirements:
107 ncurses (tput is needed to run test/format/test-curses)
108
109 Note that the -link switch to refile cannot be used on FAT32 and other
110 filesystems that do not support hard links.
111
112 ------------------------------------------------------------------------------
113 HPUX
114 ------------------------------------------------------------------------------
115
116 Lots of problems have been reported with using HPUX `cc'. In particular,
117 problems with `scan' giving incorrect dates (everything is 01/00). It is
118 highly recommended that you use `gcc' instead.
119
120 ------------------------------------------------------------------------------
121 Irix (SGI)
122 ------------------------------------------------------------------------------
123
124 Irix make is notoriously buggy. If you're using it, you should "touch
125 config.h.in" before configuring to prevent a problem where it tries to rebuild
126 targets that shouldn't be rebuilt. (Alternately, you can just use GNU make
127 instead of Irix make.)
128
129 ------------------------------------------------------------------------------
130 SunOS 4.1.1/4.1.3/4.1.4
131 ------------------------------------------------------------------------------
132
133 You can't use the C compiler that comes with SunOS 4 since it isn't ANSI C.
134 But nmh builds just fine with gcc.
135
136 ------------------------------------------------------------------------------
137
138 ----------
139 The nmh team
140 nmh-workers@nongnu.org