The comments in OS/Makefile-Default with regard to the IPv6 settings
[users/jgh/exim.git] / src / OS / Makefile-Default
1 # $Cambridge: exim/src/OS/Makefile-Default,v 1.2 2006/02/10 14:33:26 ph10 Exp $
2
3 ##################################################
4 #          The Exim mail transport agent         #
5 ##################################################
6
7 # Generic default make file containing settings that relate to the OS or
8 # to selectable features within the OS. The configuration options for Exim
9 # itself live in Local/Makefile, which is constructed by editing src/EDITME.
10
11 # These settings are basic defaults which may be overridden, either by the
12 # generic OS-specific files, or by site-specific files. Do not edit this file.
13 # Instead, edit or create suitable OS-specific and/or site specific files.
14 # See the manual for details.
15
16
17 # MAKE_SHELL contains the name of the shell to be used for executing commands
18 # from the make files. Normally /bin/sh should be used.
19
20 MAKE_SHELL=/bin/sh
21
22
23 # BASENAME_COMMAND contains the path to the "basename" command, which varies
24 # from OS to OS. This is used when building the Exim monitor script only. (See
25 # also HOSTNAME_COMMAND.) If BASENAME_COMMAND is set to "look_for_it" then the
26 # script checks for /usr/bin/basename and /bin/basename, and if neither is
27 # found, it uses /usr/ucb/basename. This copes with Solaris 2 and Linux, both
28 # of which come in different versions.
29
30 BASENAME_COMMAND=/usr/bin/basename
31
32
33 # If you set STRIP_COMMAND to the path of the "strip" command, it will be run
34 # on every binary that is built. It is left unset by default, which leaves
35 # the binaries unstripped.
36
37 # STRIP_COMMAND=/usr/bin/strip
38
39
40 # Some of the following commands live in different places in different OS. We
41 # include them all here for generality.
42
43 CHOWN_COMMAND=/usr/bin/chown
44 CHGRP_COMMAND=/usr/bin/chgrp
45 MV_COMMAND=/bin/mv
46 RM_COMMAND=/bin/rm
47
48
49 # Some operating systems have different ways of building libraries of
50 # functions. This macro defines the command to do this, defaulting to
51 # the "ar" command with options "cq".
52
53 AR=ar cq
54
55
56 # Not all operating systems have the iconv() function. Those that do have
57 #
58 # HAVE_ICONV=yes
59 #
60 # in their OS-specific Makefiles. On those that don't it is possible to
61 # install an independent implementation of iconv(). If you've done this,
62 # add "HAVE_ICONV=yes" to your Local/Makefile.
63
64
65 # Perl is not necessary for running Exim itself, except when EXIM_PERL
66 # is set to cause Perl embedding. However, some Perl utilities are provided
67 # for processing the logs. Perl 5 is assumed.
68
69 PERL_COMMAND=/usr/bin/perl
70
71
72 # CC contains the name of the C compiler to be used.
73
74 CC=gcc
75
76
77 # CFLAGS contains flags to be passed to the compiler. Nothing is defaulted
78 # here; instead each OS-dependent Makefile contains a default setting.
79
80 # CFLAGS=-O
81
82
83 # LFLAGS contains flags to be passed to the link editor. Nothing is defaulted
84 # here; instead each OS-dependent Makefile contains a default setting if one
85 # is needed.
86
87 # LFLAGS=
88
89
90 # LIBS and EXTRALIBS contain library settings that are used on linking
91 # commands to build binaries. The OS-dependent Makefile may contain a default
92 # setting for LIBS, leaving EXTRALIBS available for adding further libraries
93 # that are required for optional extras.
94
95 # LIBS=
96 # EXTRALIBS=
97
98
99 # LIBS_EXIM and EXTRALIBS_EXIM contain library settings that are used
100 # only when linking the Exim binary. They are not used for other binaries.
101 # One possible use is for the TCP wrappers library.
102
103 # LIBS_EXIM=
104 # EXTRALIBS_EXIM=
105
106
107 # LIBS_EXIMON and EXTRALIBS_EXIMON contain library settings that are
108 # used only when linking the Exim monitor binary. They are not used for
109 # other binaries.
110
111 # LIBS_EXIMON=
112 # EXTRALIBS_EXIMON=
113
114
115 # PCRE_CFLAGS contains flags to be passed to the CFLAGS parameter of the
116 # makefile for building the PCRE regular expression library, in addition
117 # to CFLAGS. Typical use is to set -DUSE_BCOPY on legacy systems that lack
118 # the memmove() function but do have bcopy().
119
120 # PCRE_CFLAGS=
121
122
123 # The error name for quota exceeded varies among operating systems, and
124 # even, unfortunately, in different versions of the same operating system.
125 # EDQUOT was not in Sys V, but is in SPEC 1170, apparently. It was used
126 # in SunOS4, but got taken out for SunOS5, where ENOSPC was given if a quota
127 # was exceeded. However, it got put back into SunOS5 with a patch to 5.4 in
128 # order to comply with SPEC 1170. Thus even different patch levels of the same
129 # system (SunOS5) may use different numbers.
130 #
131 # If you don't have quotas or are not interested in handling quota errors
132 # specially, just set this variable to 0. If it is not set, it defaults to
133 # EDQUOT if that is defined for the OS; otherwise it defaults to ENOSPC.
134
135 # ERRNO_QUOTA=EDQUOT
136
137
138 # The exiwhat utility script finds all the processes running Exim, and sends
139 # them a SIGUSR1 signal to get them to write their status to a file. There are
140 # two ways in which this can be done:
141 #
142 # (1) If the OS has a command to find processes and signal them, that can be
143 # used. Linux has "killall"; Solaris has "pkill". (Note: "killall" on Solaris
144 # does something very different - and disastrous.) The following are set in the
145 # OS-specific Makefiles for those OS where this can be done:
146
147 # EXIWHAT_MULTIKILL_CMD=
148 # EXIWHAT_MULTIKILL_ARG=
149
150 # (2) For other operating systems, exiwhat calls the ps command and egreps the
151 # output in order to find all the processes running Exim. The arguments for the
152 # various commands needed to do this vary from OS to OS. These defaults work on
153 # Solaris 2, HPUX, and IRIX. The OS-specific Makefiles have different versions
154 # for other systems, and you can override with your own requirements in your
155 # private Makefiles in the Local directory. The most commonly found
156 # alternatives are -ax instead of -e for the ps argument, and / instead of a
157 # blank before the name exim for the egrep argument on systems whose ps output
158 # shows the full path name. The quotes for the egrep argument are specified
159 # here so that leading white space can be used. This value should always be
160 # given in single quotes.
161
162 EXIWHAT_PS_CMD=/bin/ps
163 EXIWHAT_PS_ARG=-e
164 EXIWHAT_EGREP_ARG=' exim( |$$|-)'
165
166 # For both kinds of exiwhat usage, the next setting specifies the signal that
167 # is sent.
168
169 EXIWHAT_KILL_SIGNAL=-USR1
170
171
172 # IPv6 is gradually spreading more and more widely. Most operating systems seem
173 # to support it nowadays. If you set this option, IPv6 support will be included
174 # in the Exim binary. As well as the basic enabling option, there are
175 # parameters for include and library directories that may be needed for IPv6 on
176 # some systems, where the support is not yet in the standard library.
177
178 # HAVE_IPV6=YES
179 # IPV6_INCLUDE=-I /usr/ipv6/include
180 # IPV6_LIBS=-L/usr/ipv6/libs -linet6
181
182 # Exim uses the function getaddrinfo() for converting IPv6 addresses in text
183 # form to binary. Apparently some operating systems do not support this, or not
184 # correctly, and require the use of the function inet_pton() instead. The
185 # following setting enables this. Note, however, the inet_pton() has reduced
186 # functionality compared with getaddrinfo(). In particular, it does not
187 # recognize the percent convention for identifying scopes (interfaces) that is
188 # used by some operating systems.
189
190 # IPV6_USE_INET_PTON=yes
191
192 # Setting the next option brings in support for A6 DNS records for IPV6. These
193 # were at one time expected to supplant AAAA records, but were eventually
194 # rejected. The code remains in Exim, but has not been compiled or tested for
195 # quite some time. Do not set this unless you know what you are doing.
196
197 # SUPPORT_A6=yes
198
199
200 # HOSTNAME_COMMAND contains the path to the "hostname" command, which varies
201 # from OS to OS. This is used when building the Exim monitor script only. (See
202 # also BASENAME_COMMAND.) If HOSTNAME_COMMAND is set to "look_for_it" then the
203 # script checks for /usr/bin/hostname and /bin/hostname, and if neither is
204 # found, it uses /usr/ucb/basename. This copes with Solaris 2, which comes in
205 # different versions.
206
207 HOSTNAME_COMMAND=/bin/hostname
208
209
210 # INCLUDE contains arbitrary include parameters that you may need to use
211 # when building exim. It is added to every compile command.
212
213 # INCLUDE=-I /some/special/include-directory
214
215
216 # Some OS require a separate library to be quoted when linking programs that
217 # call name resolver functions. This can be set in LIBRESOLV, which is left
218 # unset here, but is set is some of the OS-specific Makefiles.
219
220 # LIBRESOLV=
221
222
223 # Additional libraries and include directories may be required for some
224 # lookup styles, e.g. LDAP or SQL. LOOKUP_LIBS is included only on the
225 # command for linking Exim itself, not on any auxiliary programs. You
226 # don't need to set LOOKUP_INCLUDE if the relevant directories are already
227 # specified in INCLUDE.
228
229 # LOOKUP_INCLUDE=-I /usr/local/ldap/include -I /usr/local/sql/include
230 # LOOKUP_LIBS=-L/usr/local/lib -lldap -llber
231
232
233 # RANLIB should be set to something that does nothing on systems that do not
234 # have the ranlib command or do not need to run it on library files.
235
236 RANLIB=ranlib
237
238
239 # EXIM_CHMOD is available to specify a command that is automatically applied
240 # to the Exim binary immediately it is compiled. (I find this useful when
241 # building test versions.)
242
243 EXIM_CHMOD=@true
244
245
246 # LOCAL_SCAN_SOURCE defines the file in which the function local_scan() is
247 # defined. This provides the administrator with a hook for including C code
248 # for scanning incoming mails. The path that is defined must be relative to
249 # the Exim distribution directory. For example
250
251 # LOCAL_SCAN_SOURCE=Local/local_scan.c
252
253 # The default setting points to a template function that doesn't actually do
254 # any scanning, but just accepts the message.
255
256 LOCAL_SCAN_SOURCE=src/local_scan.c
257
258 # If you want to specify options for your local_scan() that can be set from
259 # the main Exim configuration file, you need to uncomment the following line,
260 # and then provide a table of options in your local_scan() source, as described
261 # in the reference manual.
262
263 # LOCAL_SCAN_HAS_OPTIONS=yes
264
265
266 #############################################################################
267 # The following are all concerned with configuring the way Exim handles its
268 # database (hints) and other dbm files.
269
270 # Some systems require a separate library to be supplied when linking programs
271 # that make use of DBM library calls. This can be set in DBMLIB, which is unset
272 # by default, but is set in some of the OS-specific Makefiles. Setting it in
273 # your Local/Makefile will override any other setting.
274
275 # DBMLIB=
276
277
278 # When Exim is attempting to lock one of its database (hints) files, it
279 # applies a timeout which can be altered here.
280
281 # EXIMDB_LOCK_TIMEOUT=60
282
283
284 # By default, Exim uses traditional ndbm function calls to handle its indexed
285 # hints databases. On systems that have Berkeley db installed, this still
286 # works via the compatibility interface. However, by defining USE_DB you can
287 # make it use native db function calls.
288
289 # USE_DB=YES
290
291 # Similarly, if you are using gdbm, Exim will by default use the ndbm
292 # compatibility interface. However, by defining USE_GDBM you can make it
293 # use the native gdbm function calls.
294
295 # USE_GDBM=YES
296
297
298 #############################################################################
299 # The following definitions are relevant only when compiling the Exim monitor
300 # program, which requires an X11 display. See the varible EXIM_MONITOR in
301 # src/EDITME for how to suppress this compilation.
302
303 # X11 contains the location of the X11 libraries and include files.
304
305 X11=/usr/X11R6
306
307 # XINCLUDE contains options for header inclusion when compiling functions
308 # that call X11 functions.
309
310 XINCLUDE=-I$(X11)/include
311
312 # XLFLAGS contains flags to be passed to the linker when linking the monitor.
313
314 XLFLAGS=-L$(X11)/lib
315
316 # X11_LD_LIB contains the name of the X11 library that is to be added to
317 # LD_LIBRARY_PATH when running the monitor program.
318
319 X11_LD_LIB=$(X11)/lib
320
321 # A modified version of the Athena TextPop module is supplied with Exim. The
322 # modification is to remove the "replace" part of the "search and replace"
323 # operation because it isn't wanted. TextPop is only one of a number of
324 # modules that make up the Text widget. Some antique link editors cannot handle
325 # the case of a replacement module for one of a set of modules. To allow
326 # the monitor to be linked in such cases, set the value of EXIMON_TEXTPOP
327 # to be empty. The search operations will then contain a useless "replace"
328 # option, which is untidy, but does no harm.
329
330 EXIMON_TEXTPOP=em_TextPop.o
331
332 # End