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