1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
|
If you read this file _as_is_, just ignore the funny characters you
see. It is written in the POD format (see pod/perlpod.pod) which is
specially designed to be readable as is.
=head1 NAME
README.cygwin32 - notes about porting Perl to Cygwin32
=head1 SYNOPSIS
=over
=item Cygwin32
The Cygwin tools are ports of the popular GNU development tools for
Windows NT, 95, and 98. They run thanks to the Cygwin library which
provides the UNIX system calls and environment these programs expect.
More info about this project can be found at it's home page
http://sourceware.cygnus.com/cygwin/
Cygnus Solutions also made the first set of notes and tools for
building perl under Cygwin32 beta17.
=item als
no, i am not hunting the patch pumpkin. i just wanted to have working
non-ActiveState perl binaries for Windows NT that can load dynamic
extensions. after several days of internet searching i went to conclusion
that the most promising way is to build it myself. i was wrong.
=back
=head1 BUILDING
=head2 Prerequisites
=over
=item Cygwin b20.1
since you are willing to build things yourself, you are supposed to use
not-so-archaic tools. the latest stable Cygwin suite is beta20.1. it may be
downloaded from ftp://go.cygnus.com/pub/sourceware.cygnus.com/cygwin/latest/
or many mirror sites around the world.
=item egcs-1.1.2
i've tried to build with egcs-1.1 that comes with cygwin b20.1, and
had no luck. maybe, if a week ago i was as experienced as now,
things would go different... maybe. but this port was built with
egcs-1.1.2 downloaded from
ftp://ftp.xraylith.wisc.edu/pub/khan/gnu-win32/cygwin/egcs-1.1.2/
=item my patches
if you are reading this, those are probably applied already.
=item crypt library
you do not want to see messages about excessive paranoia, do you?
well, http://miracle.geol.msu.ru/sos/ points to two different crypt
libraries ported to cygwin. i used libcrypt.tgz by Andy Piper.
his home page can be found at http://www.xemacs.freeserve.co.uk/
=item environment
the locations of cygwin instllation are, well, a little unusual.
Configure will run smoother if you make more common aliases for cygwin
directories. it can be made either by C<mount>ing or by creating
directory symlinks like this:
ln -s /cygnus/cygwin-b20/H-i586-cygwin32/bin/ $prefix/bin
ln -s /cygnus/cygwin-b20/H-i586-cygwin32/i586-cygwin32/include/ \
$prefix/include
ln -s /cygnus/cygwin-b20/H-i586-cygwin32/i586-cygwin32/lib/ $prefix/lib
$prefix may be empty (root), /usr, or /usr/local, as you preffer.
i used /usr. futhermore, t/io/taint.t requires cygwin1.dll to be
present in build directory or somewhere in system path (/WINNT,
/WINNT/System, /WINNT/System32).
=back
=head2 Configure
run "sh Configure".
When confronted with this prompt:
=begin text
First time through, eh? I have some defaults handy for the
following systems:
.
.
.
Which of these apply, if any?
=end text
guess what system do you have. (hint: select "cygwin32").
i do not use malloc that comes with perl, but haven't put this setting
to hints file. perl defaults to use own malloc.
Configure proposes additional -fpic flag for shared library module
compilation. say "none" because gcc complains that -fpic is useless.
i hope that further defaults are ok. please double-chek it.
=head2 make
run "make". after that, run "make test" to see how unstable your system is.
for me, lib/io_sock.t waits for died child that has to be killed manually.
other test scripts seem to be more or less harmless. the result of
./perl harness reads:
=begin text
Failed Test Status Wstat Total Fail Failed List of failed
-------------------------------------------------------------------------------
lib/anydbm.t 2 512 12 8 66.67% 5-12
lib/findbin.t 1 1 100.00% 1
lib/io_sock.t 1 256 5 4 80.00% 2-5
lib/sdbm.t 2 512 18 15 83.33% 2, 5-18
op/magic.t 35 3 8.57% 1, 23, 30
op/stat.t 58 3 5.17% 2, 9, 26
pragma/locale.t 11 2816 102 4 3.92% 99-102
8 tests skipped, plus 35 subtests skipped.
Failed 7/190 test scripts, 96.32% okay. 38/6454 subtests failed, 99.41% okay.
=end text
=head1 BUGS
a lot of warnings about incompatible pointer types and comparison
lacking a cast. this is because of __declspec(dllimport).
upon each start, make warns that a rule for perlmain.o is overrided.
yes, it is. in order to use libperl.dll, perlmain needs to import
symbols from there. i saw no better solution than adding an explicit
define to the rule.
as said above, IO::Socket generates access violation. don't know why.
don't need IO::Socket for now.
make clean does not remove library .def and .exe.core files
ld2 script is installed with reference to source directory. you should
change this to /usr/local/bin (or whatever) after install.
.bat wrappers for installed utility scripts are not made during installation.
library man pages are not installed correctly due to file system limitations.
use perldoc script to read about things like foo::bar.
=head1 AUTHOR
alexander smishlajev <als@turnhere.com>
=head1 DISCLAIMER
i am not going to maintain this document or this port. i only wanted
to make perl porting a bit easier. if failed, i can't be helpful for you.
=head1 HISTORY
17..25-apr-1999. perl 5.005_03. cygwin b20.1 egcs 1.1.2.
far 1.60. nescafe classic.
=cut
|
