This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
AIX long long probing requires LL suffix for
[perl5.git] / hints / machten.sh
CommitLineData
fec02dd3 1# machten.sh
a55e790a 2# This is for MachTen 4.0.3. It might work on other versions and variants too.
db90f03e 3#
a55e790a
DD
4# Users of earlier MachTen versions might need a fixed tr from ftp.tenon.com.
5# This should be described in the MachTen release notes.
db90f03e 6#
7# MachTen 2.x has its own hint file.
8#
9# This file has been put together by Andy Dougherty
10# <doughera@lafcol.lafayette.edu> based on comments from lots of
11# folks, especially
12# Mark Pease <peasem@primenet.com>
13# Martijn Koster <m.koster@webcrawler.com>
14# Richard Yeh <rcyeh@cco.caltech.edu>
baf67fda 15#
e060872b
DD
16# For now, explicitly disable dynamic loading -- MT 4.1.1 has it,
17# but these hints do not yet support it.
18# Define NOTEDEF_MACHTEN to undo gratuitous Tenon hack to signal.h.
19# -- Dominic Dunlop <domo@computer.org> 9800802
911efb05
DD
20# Completely disable SysV IPC pending more complete support from Tenon
21# -- Dominic Dunlop <domo@computer.org> 980712
38ac2dc8
DD
22# Use vfork and perl's malloc by default
23# -- Dominic Dunlop <domo@computer.org> 980630
83e898de
DD
24# Raise perl's stack size again; cut down reg_infty; document
25# -- Dominic Dunlop <domo@computer.org> 980619
2ff233fa 26# Use of semctl() can crash system: disable -- Dominic Dunlop 980506
da9788ee
DD
27# Raise stack size further; slight tweaks to accomodate MT 4.1
28# -- Dominic Dunlop <domo@computer.org> 980211
a55e790a 29# Raise perl's stack size -- Dominic Dunlop <domo@tcp.ip.lu> 970922
44a8e56a 30# Reinstate sigsetjmp iff version is 4.0.3 or greater; use nm
31# (assumes Configure change); prune libswanted -- Dominic Dunlop 970113
32# Warn about test failure due to old Berkeley db -- Dominic Dunlop 970105
55497cff 33# Do not use perl's malloc; SysV IPC OK -- Neil Cutcliffe, Tenon 961030
34# File::Find's use of link count disabled by Dominic Dunlop 960528
35# Perl's use of sigsetjmp etc. disabled by Dominic Dunlop 960521
db90f03e 36#
fec02dd3
AD
37# Comments, questions, and improvements welcome!
38#
e060872b 39# MachTen 4.1.1 does support dynamic loading, but perl doesn't
db90f03e 40# know how to use it yet.
e060872b
DD
41usedl=${usedl:-undef}
42
43# MachTen 4.1.1 may have an unhelpful hack in /usr/include/signal.h.
44# Undo it if so.
45if grep NOTDEF_MACHTEN /usr/include/signal.h > /dev/null
46then
47 ccflags="$ccflags -DNOTDEF_MACHTEN"
48fi
55497cff 49
50# Power MachTen is a real memory system and its standard malloc
51# has been optimized for this. Using this malloc instead of Perl's
38ac2dc8
DD
52# malloc may result in significant memory savings. In particular,
53# unlike most UNIX memory allocation subsystems, MachTen's free()
54# really does return unneeded process data memory to the system.
55# However, MachTen's malloc() is woefully slow -- maybe 100 times
56# slower than perl's own, so perl's own is usually the better
57# choice. In order to use perl's malloc(), the sbrk() system call
58# must be simulated using MachTen's malloc(). See malloc.c for
59# precise details of how this is achieved. Recent improvements
60# to perl's malloc() currently crash MachTen, and so are disabled
61# by -DPLAIN_MALLOC and -DNO_FANCY_MALLOC.
62usemymalloc=${usemymalloc:-y}
63
64# Do not wrap the following long line
65malloc_cflags='ccflags="$ccflags -DPLAIN_MALLOC -DNO_FANCY_MALLOC -DUSE_PERL_SBRK"'
66
38ac2dc8
DD
67# When MachTen does a fork(), it immediately copies the whole of
68# the parent process' data space for the child. This can be
69# expensive. Using vfork() where appropriate avoids this cost.
70d_vfork=${d_vfork:-define}
71
72# Specify a high level of optimization (-O3 wouldn't do much more)
73optimize=${optimize:--O2 -fomit-frame-pointer}
c07a80fd 74
44a8e56a 75# Make symbol table listings les voluminous
76nmopts=-gp
c07a80fd 77
83e898de
DD
78# Set reg_infty -- the maximum allowable number of repeats in regular
79# expressions such as /a{1,$max_repeats}/, and the maximum number of
80# times /a*/ will match. Setting this too high without having a stack
81# large enough to accommodate deep recursion in the regular expression
82# engine allows perl to crash your Mac due to stack overrun if it
83# encounters a pathological regular expression. The default is a
84# compromise between capability and required stack size (see below).
85# You may override the default value from the Configure command-line
86# like this:
87#
88# Configure -Dreg_infty=16368 ...
89
90reg_infty=${reg_infty:-2047}
91
92# If you want to have many perl processes active simultaneously --
93# processing CGI forms -- for example, you should opt for a small stack.
94# For safety, you should set reg_infty no larger than the corresponding
95# value given in this table:
96#
97# Stack size reg_infty value supported
98# ---------- -------------------------
99# 128k 2**8-1 (256)
100# 256k 2**9-1 (511)
101# 512k 2**10-1 (1023)
102# 1M 2**11-1 (2047)
103# ...
104# 16M 2**15-1 (32767) (perl's default value)
105
106# This script selects a safe stack size based on the value of reg_infty
107# specified above. However, you may choose to take a risk and set
108# stack size lower: pathological regular expressions are rare in real-world
109# programs. But be aware that, if perl does encounter one, it WILL
110# crash your system. Do not set stack size lower than 96k unless
111# you want perl's installation tests ( make test ) to crash your system.
112#
113# You may override the default value from the Configure command-line
114# by specifying the required size in kilobytes like this:
115#
116# Configure -Dstack_size=96
117
118if [ "X$stack_size" = 'X' ]
119then
120 stack_size=128
121 X=`expr $reg_infty / 256`
122
123 while [ $X -gt 0 ]
124 do
125 X=`expr $X / 2`
126 stack_size=`expr $stack_size \* 2`
127 done
38ac2dc8 128 X=`expr $stack_size \* 1024`
83e898de
DD
129fi
130
83e898de
DD
131ldflags="$ldflags -Xlstack=$X"
132ccflags="$ccflags -DREG_INFTY=$reg_infty"
a55e790a 133
55497cff 134# Install in /usr/local by default
135prefix='/usr/local'
136
db90f03e 137# At least on PowerMac, doubles must be aligned on 8 byte boundaries.
138# I don't know if this is true for all MachTen systems, or how to
139# determine this automatically.
140alignbytes=8
baf67fda 141
44a8e56a 142# 4.0.2 and earlier had a problem with perl's use of sigsetjmp and
baf67fda 143# friends. Use setjmp and friends instead.
44a8e56a 144expr "$osvers" \< "4.0.3" > /dev/null && d_sigsetjmp='undef'
145
911efb05
DD
146# System V IPC support in MachTen 4.1 is incomplete (missing msg function
147# prototypes, no ftok()), buggy (semctl(.., .., IPC_STATUS, ..) hangs
148# system), and undocumented. Claim it's not there until things improve.
149d_msg=${d_msg:-undef}
150d_sem=${d_sem:-undef}
151d_shm=${d_shm:-undef}
2ff233fa 152
44a8e56a 153# Get rid of some extra libs which it takes Configure a tediously
154# long time never to find on MachTen
155set `echo X "$libswanted "|sed -e 's/ net / /' -e 's/ socket / /' \
156 -e 's/ inet / /' -e 's/ nsl / /' -e 's/ nm / /' -e 's/ malloc / /' \
157 -e 's/ ld / /' -e 's/ sun / /' -e 's/ posix / /' \
158 -e 's/ cposix / /' -e 's/ crypt / /' \
159 -e 's/ ucb / /' -e 's/ bsd / /' -e 's/ BSD / /' -e 's/ PW / /'`
160shift
161libswanted="$*"
baf67fda 162
da9788ee
DD
163# While link counts on MachTen 4.1's fast file systems work correctly,
164# on Macintosh Heirarchical File Systems, (and on HFS+)
baf67fda 165# MachTen always reports ony two links to directories, even if they
166# contain subdirectories. Consequently, we use this variable to stop
167# File::Find using the link count to determine whether there are
168# subdirectories to be searched. This will generate a harmless message:
169# Hmm...You had some extra variables I don't know about...I'll try to keep 'em.
170# Propagating recommended variable dont_use_nlink
171dont_use_nlink=define
172
83e898de 173cat <<EOM >&4
baf67fda 174
2ff233fa
DD
175During Configure, you may see the message
176
177*** WHOA THERE!!! ***
911efb05 178 The recommended value for \$d_msg on this machine was "undef"!
2ff233fa
DD
179 Keep the recommended value? [y]
180
911efb05
DD
181as well as similar messages concerning \$d_sem and \$d_shm. Select the
182default answers: MachTen 4.1 appears to provide System V IPC support,
183but it is incomplete and buggy: perl should be built without it.
baf67fda 184
38ac2dc8
DD
185Similarly, when you see
186
187*** WHOA THERE!!! ***
188 The recommended value for \$d_vfork on this machine was "define"!
189 Keep the recommended value? [y]
190
191select the default answer: vfork() works, and avoids expensive data
192copying.
193
baf67fda 194At the end of Configure, you will see a harmless message
195
196Hmm...You had some extra variables I don't know about...I'll try to keep 'em.
197 Propagating recommended variable dont_use_nlink
44a8e56a 198 Propagating recommended variable nmopts
38ac2dc8 199 Propagating recommended variable malloc_cflags...
83e898de 200 Propagating recommended variable reg_infty
44a8e56a 201Read the File::Find documentation for more information about dont_use_nlink
baf67fda 202
83e898de
DD
203Your perl will be built with a stack size of ${stack_size}k and a regular
204expression repeat count limit of $reg_infty. If you want alternative
205values, see the file hints/machten.sh for advice on how to change them.
206
2ff233fa
DD
207Tests
208 io/fs test 4 and
209 op/stat test 3
210may fail since MachTen may not return a useful nlinks field to stat
211on directories.
212
baf67fda 213EOM
2ff233fa
DD
214expr "$osvers" \< "4.1" >/dev/null && test -r ./broken-db.msg && \
215 . ./broken-db.msg
83e898de
DD
216
217unset stack_size X