Commit | Line | Data |
8736538c |
1 | If you read this file _as_is_, just ignore the funny characters you |
2 | see. It is written in the POD format (see pod/perlpod.pod) which is |
3 | specially designed to be readable as is. |
5aabfad6 |
4 | |
8736538c |
5 | =head1 NAME |
5aabfad6 |
6 | |
f8dbba82 |
7 | README.cygwin - Perl for Cygwin |
5aabfad6 |
8 | |
8736538c |
9 | =head1 SYNOPSIS |
5aabfad6 |
10 | |
f8dbba82 |
11 | This document will help you configure, make, test and install Perl |
12 | on Cygwin. This document also describes features of Cygwin that will |
13 | affect how Perl behaves at runtime. |
5aabfad6 |
14 | |
f8dbba82 |
15 | B<NOTE:> There are pre-built Perl packages available for Cygwin and a |
37a78d01 |
16 | version of Perl is provided in the normal Cygwin install. If you do |
17 | not need to customize the configuration, consider using one of those |
18 | packages. |
5aabfad6 |
19 | |
5aabfad6 |
20 | |
a83b6f46 |
21 | =head1 PREREQUISITES FOR COMPILING PERL ON CYGWIN |
8736538c |
22 | |
f8dbba82 |
23 | =head2 Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it) |
8736538c |
24 | |
f8dbba82 |
25 | The Cygwin tools are ports of the popular GNU development tools for Win32 |
26 | platforms. They run thanks to the Cygwin library which provides the UNIX |
27 | system calls and environment these programs expect. More information |
28 | about this project can be found at: |
8736538c |
29 | |
47dafe4d |
30 | http://www.cygwin.com/ |
1cab015a |
31 | |
f8dbba82 |
32 | A recent net or commercial release of Cygwin is required. |
8736538c |
33 | |
37a78d01 |
34 | At the time this document was last updated, Cygwin 1.3.5 was current. |
8736538c |
35 | |
1cab015a |
36 | |
f8dbba82 |
37 | =head2 Cygwin Configuration |
1cab015a |
38 | |
f8dbba82 |
39 | While building Perl some changes may be necessary to your Cygwin setup so |
40 | that Perl builds cleanly. These changes are B<not> required for normal |
41 | Perl usage. |
1cab015a |
42 | |
f8dbba82 |
43 | B<NOTE:> The binaries that are built will run on all Win32 versions. |
125a13ce |
44 | They do not depend on your host system (Win9x/WinME, WinNT/Win2K) |
45 | or your Cygwin configuration (I<ntea>, I<ntsec>, binary/text mounts). |
46 | The only dependencies come from hard-coded pathnames like C</usr/local>. |
47 | However, your host system and Cygwin configuration will affect Perl's |
48 | runtime behavior (see L</"TEST">). |
1cab015a |
49 | |
f8dbba82 |
50 | =over 4 |
1cab015a |
51 | |
f8dbba82 |
52 | =item * C<PATH> |
1cab015a |
53 | |
f8dbba82 |
54 | Set the C<PATH> environment variable so that Configure finds the Cygwin |
55 | versions of programs. Any Windows directories should be removed or |
56 | moved to the end of your C<PATH>. |
1cab015a |
57 | |
f8dbba82 |
58 | =item * I<nroff> |
1cab015a |
59 | |
f8dbba82 |
60 | If you do not have I<nroff> (which is part of the I<groff> package), |
b4bcd662 |
61 | Configure will B<not> prompt you to install I<man> pages. |
f8dbba82 |
62 | |
63 | =item * Permissions |
64 | |
65 | On WinNT with either the I<ntea> or I<ntsec> C<CYGWIN> settings, directory |
66 | and file permissions may not be set correctly. Since the build process |
125a13ce |
67 | creates directories and files, to be safe you may want to run a `C<chmod |
f8dbba82 |
68 | -R +w *>' on the entire Perl source tree. |
69 | |
70 | Also, it is a well known WinNT "feature" that files created by a login |
71 | that is a member of the I<Administrators> group will be owned by the |
72 | I<Administrators> group. Depending on your umask, you may find that you |
73 | can not write to files that you just created (because you are no longer |
74 | the owner). When using the I<ntsec> C<CYGWIN> setting, this is not an |
75 | issue because it "corrects" the ownership to what you would expect on |
76 | a UNIX system. |
1cab015a |
77 | |
8736538c |
78 | =back |
79 | |
a83b6f46 |
80 | =head1 CONFIGURE PERL ON CYGWIN |
8736538c |
81 | |
f8dbba82 |
82 | The default options gathered by Configure with the assistance of |
83 | F<hints/cygwin.sh> will build a Perl that supports dynamic loading |
84 | (which requires a shared F<libperl.dll>). |
f89d6eaa |
85 | |
f8dbba82 |
86 | This will run Configure and keep a record: |
8736538c |
87 | |
f8dbba82 |
88 | ./Configure 2>&1 | tee log.configure |
8736538c |
89 | |
b4bcd662 |
90 | If you are willing to accept all the defaults run Configure with B<-de>. |
f8dbba82 |
91 | However, several useful customizations are available. |
5aabfad6 |
92 | |
a83b6f46 |
93 | =head2 Stripping Perl Binaries on Cygwin |
5aabfad6 |
94 | |
f8dbba82 |
95 | It is possible to strip the EXEs and DLLs created by the build process. |
96 | The resulting binaries will be significantly smaller. If you want the |
97 | binaries to be stripped, you can either add a B<-s> option when Configure |
98 | prompts you, |
8736538c |
99 | |
f8dbba82 |
100 | Any additional ld flags (NOT including libraries)? [none] -s |
5db16f6a |
101 | Any special flags to pass to gcc to use dynamic linking? [none] -s |
f8dbba82 |
102 | Any special flags to pass to ld2 to create a dynamically loaded library? |
103 | [none] -s |
8736538c |
104 | |
f8dbba82 |
105 | or you can edit F<hints/cygwin.sh> and uncomment the relevant variables |
106 | near the end of the file. |
8736538c |
107 | |
a83b6f46 |
108 | =head2 Optional Libraries for Perl on Cygwin |
8736538c |
109 | |
f8dbba82 |
110 | Several Perl functions and modules depend on the existence of |
111 | some optional libraries. Configure will find them if they are |
112 | installed in one of the directories listed as being used for library |
37a78d01 |
113 | searches. Pre-built packages for most of these are available from |
114 | the Cygwin installer. |
8736538c |
115 | |
f8dbba82 |
116 | =over 4 |
8736538c |
117 | |
f8dbba82 |
118 | =item * C<-lcrypt> |
8736538c |
119 | |
125a13ce |
120 | The crypt package distributed with Cygwin is a Linux compatible 56-bit |
121 | DES crypt port by Corinna Vinschen. |
122 | |
123 | Alternatively, the crypt libraries in GNU libc have been ported to Cygwin. |
1cab015a |
124 | |
5db16f6a |
125 | The DES based Ultra Fast Crypt port was done by Alexey Truhan: |
1cab015a |
126 | |
b4bcd662 |
127 | ftp://ftp.franken.de/pub/win32/develop/gnuwin32/cygwin/porters/Okhapkin_Sergey/cw32crypt-dist-0.tgz |
f8dbba82 |
128 | |
129 | NOTE: There are various export restrictions on DES implementations, |
130 | see the glibc README for more details. |
1cab015a |
131 | |
f8dbba82 |
132 | The MD5 port was done by Andy Piper: |
1cab015a |
133 | |
b4bcd662 |
134 | ftp://ftp.franken.de/pub/win32/develop/gnuwin32/cygwin/porters/Okhapkin_Sergey/libcrypt.tgz |
1cab015a |
135 | |
f8dbba82 |
136 | =item * C<-lgdbm> (C<use GDBM_File>) |
1cab015a |
137 | |
f8dbba82 |
138 | GDBM is available for Cygwin. GDBM's ndbm/dbm compatibility feature |
139 | also makes C<NDBM_File> and C<ODBM_File> possible (although they add |
140 | little extra value). |
1cab015a |
141 | |
125a13ce |
142 | NOTE: The ndbm/dbm emulations only completely work on NTFS partitions. |
143 | |
f8dbba82 |
144 | =item * C<-ldb> (C<use DB_File>) |
1cab015a |
145 | |
f8dbba82 |
146 | BerkeleyDB is available for Cygwin. Some details can be found in |
147 | F<ext/DB_File/DB_File.pm>. |
1cab015a |
148 | |
125a13ce |
149 | NOTE: The BerkeleyDB library only completely works on NTFS partitions. |
150 | |
f8dbba82 |
151 | =item * C<-lcygipc> (C<use IPC::SysV>) |
152 | |
6b49d266 |
153 | A port of SysV IPC is available for Cygwin. |
154 | |
155 | NOTE: This has B<not> been extensively tested. In particular, |
b4bcd662 |
156 | C<d_semctl_semun> is undefined because it fails a Configure test |
157 | and on Win9x the I<shm*()> functions seem to hang. It also creates |
158 | a compile time dependency because F<perl.h> includes F<<sys/ipc.h>> |
159 | and F<<sys/sem.h>> (which will be required in the future when compiling |
160 | CPAN modules). |
1cab015a |
161 | |
162 | =back |
163 | |
a83b6f46 |
164 | =head2 Configure-time Options for Perl on Cygwin |
f8dbba82 |
165 | |
0a110db2 |
166 | The F<INSTALL> document describes several Configure-time options. Some of |
167 | these will work with Cygwin, others are not yet possible. Also, some of |
168 | these are experimental. You can either select an option when Configure |
169 | prompts you or you can define (undefine) symbols on the command line. |
f8dbba82 |
170 | |
171 | =over 4 |
172 | |
173 | =item * C<-Uusedl> |
174 | |
0a110db2 |
175 | Undefining this symbol forces Perl to be compiled statically. |
f8dbba82 |
176 | |
177 | =item * C<-Uusemymalloc> |
1cab015a |
178 | |
f8dbba82 |
179 | By default Perl uses the malloc() included with the Perl source. If you |
0a110db2 |
180 | want to force Perl to build with the system malloc() undefine this symbol. |
1cab015a |
181 | |
6b49d266 |
182 | =item * C<-Dusemultiplicity> |
1cab015a |
183 | |
f8dbba82 |
184 | Multiplicity is required when embedding Perl in a C program and using |
185 | more than one interpreter instance. This works with the Cygwin port. |
1cab015a |
186 | |
f8dbba82 |
187 | =item * C<-Duseperlio> |
1cab015a |
188 | |
f8dbba82 |
189 | The PerlIO abstraction works with the Cygwin port. |
1cab015a |
190 | |
0a110db2 |
191 | =item * C<-Duse64bitint> |
1cab015a |
192 | |
f8dbba82 |
193 | I<gcc> supports 64-bit integers. However, several additional long long |
5db16f6a |
194 | functions are necessary to use them within Perl (I<{strtol,strtoul}l>). |
f8dbba82 |
195 | These are B<not> yet available with Cygwin. |
1cab015a |
196 | |
f8dbba82 |
197 | =item * C<-Duselongdouble> |
1cab015a |
198 | |
f8dbba82 |
199 | I<gcc> supports long doubles (12 bytes). However, several additional |
200 | long double math functions are necessary to use them within Perl |
5d129265 |
201 | (I<{atan2,cos,exp,floor,fmod,frexp,isnan,log,modf,pow,sin,sqrt}l,strtold>). |
f8dbba82 |
202 | These are B<not> yet available with Cygwin. |
1cab015a |
203 | |
f8dbba82 |
204 | =item * C<-Dusethreads> |
1cab015a |
205 | |
f8dbba82 |
206 | POSIX threads are B<not> yet implemented in Cygwin. |
207 | |
208 | =item * C<-Duselargefiles> |
209 | |
0a110db2 |
210 | Although Win32 supports large files, Cygwin currently uses 32-bit integers |
5db16f6a |
211 | for internal size and position calculations. |
1cab015a |
212 | |
213 | =back |
214 | |
a83b6f46 |
215 | =head2 Suspicious Warnings on Cygwin |
1cab015a |
216 | |
f8dbba82 |
217 | You may see some messages during Configure that seem suspicious. |
8736538c |
218 | |
f8dbba82 |
219 | =over 4 |
8736538c |
220 | |
b4bcd662 |
221 | =item * I<dlsym()> |
0a110db2 |
222 | |
223 | I<ld2> is needed to build dynamic libraries, but it does not exist |
224 | when dlsym() checking occurs (it is not created until `C<make>' runs). |
225 | You will see the following message: |
226 | |
227 | Checking whether your dlsym() needs a leading underscore ... |
b4bcd662 |
228 | ld2: not found |
0a110db2 |
229 | I can't compile and run the test program. |
230 | I'm guessing that dlsym doesn't need a leading underscore. |
231 | |
232 | Since the guess is correct, this is not a problem. |
233 | |
b4bcd662 |
234 | =item * Win9x and C<d_eofnblk> |
5db16f6a |
235 | |
236 | Win9x does not correctly report C<EOF> with a non-blocking read on a |
237 | closed pipe. You will see the following messages: |
238 | |
239 | But it also returns -1 to signal EOF, so be careful! |
240 | WARNING: you can't distinguish between EOF and no data! |
241 | |
242 | *** WHOA THERE!!! *** |
243 | The recommended value for $d_eofnblk on this machine was "define"! |
244 | Keep the recommended value? [y] |
245 | |
246 | At least for consistency with WinNT, you should keep the recommended |
247 | value. |
248 | |
0a110db2 |
249 | =item * Compiler/Preprocessor defines |
250 | |
251 | The following error occurs because of the Cygwin C<#define> of |
252 | C<_LONG_DOUBLE>: |
253 | |
254 | Guessing which symbols your C compiler and preprocessor define... |
5d129265 |
255 | try.c:<line#>: parse error |
0a110db2 |
256 | |
257 | This failure does not seem to cause any problems. |
258 | |
5db16f6a |
259 | =back |
260 | |
a83b6f46 |
261 | =head1 MAKE ON CYGWIN |
5aabfad6 |
262 | |
b4bcd662 |
263 | Simply run I<make> and wait: |
f8dbba82 |
264 | |
265 | make 2>&1 | tee log.make |
266 | |
a83b6f46 |
267 | =head2 Warnings on Cygwin |
f8dbba82 |
268 | |
269 | Warnings like these are normal: |
270 | |
271 | warning: overriding commands for target <file> |
272 | warning: ignoring old commands for target <file> |
273 | |
125a13ce |
274 | dllwrap: no export definition file provided |
275 | dllwrap: creating one, but that may not be what you want |
f8dbba82 |
276 | |
a83b6f46 |
277 | =head2 ld2 on Cygwin |
f8dbba82 |
278 | |
279 | During `C<make>', I<ld2> will be created and installed in your $installbin |
280 | directory (where you said to put public executables). It does not |
281 | wait until the `C<make install>' process to install the I<ld2> script, |
282 | this is because the remainder of the `C<make>' refers to I<ld2> without |
283 | fully specifying its path and does this from multiple subdirectories. |
284 | The assumption is that $installbin is in your current C<PATH>. If this |
b4bcd662 |
285 | is not the case `C<make>' will fail at some point. If this happens, |
286 | just manually copy I<ld2> from the source directory to somewhere in |
287 | your C<PATH>. |
f8dbba82 |
288 | |
a83b6f46 |
289 | =head1 TEST ON CYGWIN |
f8dbba82 |
290 | |
291 | There are two steps to running the test suite: |
292 | |
293 | make test 2>&1 | tee log.make-test |
294 | |
295 | cd t;./perl harness 2>&1 | tee ../log.harness |
296 | |
297 | The same tests are run both times, but more information is provided when |
298 | running as `C<./perl harness>'. |
5aabfad6 |
299 | |
f8dbba82 |
300 | Test results vary depending on your host system and your Cygwin |
b4bcd662 |
301 | configuration. If a test can pass in some Cygwin setup, it is always |
302 | attempted and explainable test failures are documented. It is possible |
125a13ce |
303 | for Perl to pass all the tests, but it is more likely that some tests |
304 | will fail for one of the reasons listed below. |
1cab015a |
305 | |
a83b6f46 |
306 | =head2 File Permissions on Cygwin |
1cab015a |
307 | |
f8dbba82 |
308 | UNIX file permissions are based on sets of mode bits for |
b4bcd662 |
309 | {read,write,execute} for each {user,group,other}. By default Cygwin |
310 | only tracks the Win32 read-only attribute represented as the UNIX file |
311 | user write bit (files are always readable, files are executable if they |
312 | have a F<.{com,bat,exe}> extension or begin with C<#!>, directories are |
313 | always readable and executable). On WinNT with the I<ntea> C<CYGWIN> |
314 | setting, the additional mode bits are stored as extended file attributes. |
315 | On WinNT with the I<ntsec> C<CYGWIN> setting, permissions use the standard |
316 | WinNT security descriptors and access control lists. Without one of |
317 | these options, these tests will fail: |
1cab015a |
318 | |
f8dbba82 |
319 | Failed Test List of failed |
320 | ------------------------------------ |
321 | io/fs.t 5, 7, 9-10 |
322 | lib/anydbm.t 2 |
323 | lib/db-btree.t 20 |
324 | lib/db-hash.t 16 |
325 | lib/db-recno.t 18 |
326 | lib/gdbm.t 2 |
f8dbba82 |
327 | lib/ndbm.t 2 |
328 | lib/odbm.t 2 |
329 | lib/sdbm.t 2 |
330 | op/stat.t 9, 20 (.tmp not an executable extension) |
1cab015a |
331 | |
a83b6f46 |
332 | =head2 Hard Links on Cygwin |
1cab015a |
333 | |
f8dbba82 |
334 | FAT partitions do not support hard links (whereas NTFS does), in which |
497711e7 |
335 | case Cygwin implements link() by copying the file. On remote (network) |
336 | drives Cygwin's stat() always sets C<st_nlink> to 1, so the link count |
125a13ce |
337 | for remote directories and files is not available. In either case, |
497711e7 |
338 | these tests will fail: |
1cab015a |
339 | |
f8dbba82 |
340 | Failed Test List of failed |
341 | ------------------------------------ |
342 | io/fs.t 4 |
343 | op/stat.t 3 |
1cab015a |
344 | |
a83b6f46 |
345 | =head2 Filetime Granularity on Cygwin |
1cab015a |
346 | |
f8dbba82 |
347 | On FAT partitions the filetime granularity is 2 seconds. The following |
348 | test will fail: |
1cab015a |
349 | |
f8dbba82 |
350 | Failed Test List of failed |
351 | ------------------------------------ |
352 | io/fs.t 18 |
1cab015a |
353 | |
a83b6f46 |
354 | =head2 Tainting Checks on Cygwin |
1cab015a |
355 | |
f8dbba82 |
356 | When Perl is running in taint mode, C<$ENV{PATH}> is considered tainted |
357 | and not used, so DLLs not in the default system directories will not |
358 | be found. While the tests are running you will see warnings popup from |
359 | the system with messages like: |
1cab015a |
360 | |
f8dbba82 |
361 | Win9x |
362 | Error Starting Program |
363 | A required .DLL file, CYGWIN1.DLL, was not found |
1cab015a |
364 | |
f8dbba82 |
365 | WinNT |
125a13ce |
366 | perl.exe - Unable to Locate DLL |
f8dbba82 |
367 | The dynamic link library cygwin1.dll could not be found in the |
368 | specified path ... |
1cab015a |
369 | |
f8dbba82 |
370 | Just click OK and ignore them. When running `C<make test>', 2 popups |
371 | occur. During `C<./perl harness>', 4 popups occur. Also, these tests |
372 | will fail: |
1cab015a |
373 | |
f8dbba82 |
374 | Failed Test List of failed |
375 | ------------------------------------ |
376 | op/taint.t 1, 3, 31, 37 |
1cab015a |
377 | |
b4bcd662 |
378 | Alternatively, you can copy F<cygwin1.dll> into the directory where the |
379 | tests run: |
380 | |
125a13ce |
381 | cp /bin/cygwin1.dll t |
b4bcd662 |
382 | |
383 | or one of the Windows system directories (although, this is B<not> |
384 | recommended). |
1cab015a |
385 | |
a83b6f46 |
386 | =head2 /etc/group on Cygwin |
5aabfad6 |
387 | |
5db16f6a |
388 | Cygwin does not require F</etc/group>, in which case the F<op/grent.t> |
f8dbba82 |
389 | test will be skipped. The check performed by F<op/grent.t> expects to |
390 | see entries that use the members field, otherwise this test will fail: |
f89d6eaa |
391 | |
f8dbba82 |
392 | Failed Test List of failed |
393 | ------------------------------------ |
394 | op/grent.t 1 |
1cab015a |
395 | |
a83b6f46 |
396 | =head2 Script Portability on Cygwin |
1cab015a |
397 | |
b4bcd662 |
398 | Cygwin does an outstanding job of providing UNIX-like semantics on top of |
399 | Win32 systems. However, in addition to the items noted above, there are |
400 | some differences that you should know about. This is a very brief guide |
401 | to portability, more information can be found in the Cygwin documentation. |
1cab015a |
402 | |
f8dbba82 |
403 | =over 4 |
1cab015a |
404 | |
f8dbba82 |
405 | =item * Pathnames |
1cab015a |
406 | |
f8dbba82 |
407 | Cygwin pathnames can be separated by forward (F</>) or backward (F<\>) |
408 | slashes. They may also begin with drive letters (F<C:>) or Universal |
409 | Naming Codes (F<//UNC>). DOS device names (F<aux>, F<con>, F<prn>, |
b4bcd662 |
410 | F<com*>, F<lpt?>, F<nul>) are invalid as base filenames. However, they |
411 | can be used in extensions (e.g., F<hello.aux>). Names may contain all |
412 | printable characters except these: |
1cab015a |
413 | |
f8dbba82 |
414 | : * ? " < > | |
1cab015a |
415 | |
125a13ce |
416 | File names are case insensitive, but case preserving. A pathname that |
417 | contains a backslash or drive letter is a Win32 pathname (and not subject |
418 | to the translations applied to POSIX style pathnames). |
f8dbba82 |
419 | |
420 | =item * Text/Binary |
421 | |
422 | When a file is opened it is in either text or binary mode. In text mode |
5db16f6a |
423 | a file is subject to CR/LF/Ctrl-Z translations. With Cygwin, the default |
424 | mode for an open() is determined by the mode of the mount that underlies |
425 | the file. Perl provides a binmode() function to set binary mode on files |
426 | that otherwise would be treated as text. sysopen() with the C<O_TEXT> |
427 | flag sets text mode on files that otherwise would be treated as binary: |
428 | |
429 | sysopen(FOO, "bar", O_WRONLY|O_CREAT|O_TEXT) |
f8dbba82 |
430 | |
5db16f6a |
431 | lseek(), tell() and sysseek() only work with files opened in binary mode. |
432 | |
433 | The text/binary issue is covered at length in the Cygwin documentation. |
f8dbba82 |
434 | |
435 | =item * F<.exe> |
436 | |
497711e7 |
437 | The Cygwin stat(), lstat() and readlink() functions make the F<.exe> |
438 | extension transparent by looking for F<foo.exe> when you ask for F<foo> |
439 | (unless a F<foo> also exists). Cygwin does not require a F<.exe> |
440 | extension, but I<gcc> adds it automatically when building a program. |
441 | However, when accessing an executable as a normal file (e.g., I<cp> |
442 | in a makefile) the F<.exe> is not transparent. The I<install> included |
443 | with Cygwin automatically appends a F<.exe> when necessary. |
f8dbba82 |
444 | |
445 | =item * chown() |
446 | |
b4bcd662 |
447 | On WinNT chown() can change a file's user and group IDs. On Win9x chown() |
448 | is a no-op, although this is appropriate since there is no security model. |
f8dbba82 |
449 | |
450 | =item * Miscellaneous |
451 | |
452 | File locking using the C<F_GETLK> command to fcntl() is a stub that |
453 | returns C<ENOSYS>. |
454 | |
f8dbba82 |
455 | Win9x can not rename() an open file (although WinNT can). |
1cab015a |
456 | |
125a13ce |
457 | The Cygwin chroot() implementation has holes (it can not restrict file |
458 | access by native Win32 programs). |
459 | |
1cab015a |
460 | =back |
461 | |
a83b6f46 |
462 | =head1 INSTALL PERL ON CYGWIN |
f8dbba82 |
463 | |
b4bcd662 |
464 | This will install Perl, including I<man> pages. |
f8dbba82 |
465 | |
5db16f6a |
466 | make install | tee log.make-install |
467 | |
468 | NOTE: If C<STDERR> is redirected `C<make install>' will B<not> prompt |
469 | you to install I<perl> into F</usr/bin>. |
1cab015a |
470 | |
f8dbba82 |
471 | You may need to be I<Administrator> to run `C<make install>'. If you |
472 | are not, you must have write access to the directories in question. |
1cab015a |
473 | |
f8dbba82 |
474 | Information on installing the Perl documentation in HTML format can be |
475 | found in the F<INSTALL> document. |
1cab015a |
476 | |
a83b6f46 |
477 | =head1 MANIFEST ON CYGWIN |
1cab015a |
478 | |
f8dbba82 |
479 | These are the files in the Perl release that contain references to Cygwin. |
480 | These very brief notes attempt to explain the reason for all conditional |
481 | code. Hopefully, keeping this up to date will allow the Cygwin port to |
482 | be kept as clean as possible. |
1cab015a |
483 | |
f8dbba82 |
484 | =over 4 |
1cab015a |
485 | |
f8dbba82 |
486 | =item Documentation |
1cab015a |
487 | |
47dafe4d |
488 | INSTALL README.cygwin README.win32 MANIFEST |
5d129265 |
489 | Changes Changes5.005 Changes5.004 Changes5.6 |
47dafe4d |
490 | pod/perl.pod pod/perlport.pod pod/perlfaq3.pod |
491 | pod/perldelta.pod pod/perl5004delta.pod pod/perl56delta.pod |
492 | pod/perlhist.pod pod/perlmodlib.pod pod/buildtoc.PL pod/perltoc.pod |
1cab015a |
493 | |
f8dbba82 |
494 | =item Build, Configure, Make, Install |
1cab015a |
495 | |
f8dbba82 |
496 | cygwin/Makefile.SHs |
497 | cygwin/ld2.in |
498 | cygwin/perlld.in |
499 | ext/IPC/SysV/hints/cygwin.pl |
500 | ext/NDBM_File/hints/cygwin.pl |
501 | ext/ODBM_File/hints/cygwin.pl |
502 | hints/cygwin.sh |
f8dbba82 |
503 | Configure - help finding hints from uname, |
504 | shared libperl required for dynamic loading |
6b49d266 |
505 | Makefile.SH - linklibperl |
506 | Porting/patchls - cygwin in port list |
f8dbba82 |
507 | installman - man pages with :: translated to . |
5db16f6a |
508 | installperl - install dll/ld2/perlld, install to pods |
6b49d266 |
509 | makedepend.SH - uwinfix |
1cab015a |
510 | |
f8dbba82 |
511 | =item Tests |
1cab015a |
512 | |
f8dbba82 |
513 | t/io/tell.t - binmode |
5d129265 |
514 | t/lib/b.t - ignore Cwd from os_extras |
5db16f6a |
515 | t/lib/glob-basic.t - Win32 directory list access differs from read mode |
516 | t/op/magic.t - $^X/symlink WORKAROUND, s/.exe// |
517 | t/op/stat.t - no /dev, skip Win32 ftCreationTime quirk |
518 | (cache manager sometimes preserves ctime of file |
519 | previously created and deleted), no -u (setuid) |
f8dbba82 |
520 | |
521 | =item Compiled Perl Source |
522 | |
f8dbba82 |
523 | EXTERN.h - __declspec(dllimport) |
524 | XSUB.h - __declspec(dllexport) |
b4bcd662 |
525 | cygwin/cygwin.c - os_extras (getcwd, spawn) |
6b49d266 |
526 | perl.c - os_extras |
f8dbba82 |
527 | perl.h - binmode |
6b49d266 |
528 | doio.c - win9x can not rename a file when it is open |
b4bcd662 |
529 | pp_sys.c - do not define h_errno, pp_system with spawn |
47dafe4d |
530 | util.c - use setenv |
f8dbba82 |
531 | |
532 | =item Compiled Module Source |
533 | |
534 | ext/POSIX/POSIX.xs - tzname defined externally |
535 | ext/SDBM_File/sdbm/pair.c |
536 | - EXTCONST needs to be redefined from EXTERN.h |
537 | ext/SDBM_File/sdbm/sdbm.c |
538 | - binary open |
539 | |
540 | =item Perl Modules/Scripts |
541 | |
6b49d266 |
542 | lib/Cwd.pm - hook to internal Cwd::cwd |
f8dbba82 |
543 | lib/ExtUtils/MakeMaker.pm |
544 | - require MM_Cygwin.pm |
545 | lib/ExtUtils/MM_Cygwin.pm |
546 | - canonpath, cflags, manifypods, perl_archive |
497711e7 |
547 | lib/File/Find.pm - on remote drives stat() always sets st_nlink to 1 |
6b49d266 |
548 | lib/File/Spec/Unix.pm - preserve //unc |
5d129265 |
549 | lib/File/Temp.pm - no directory sticky bit |
6b49d266 |
550 | lib/perl5db.pl - use stdin not /dev/tty |
6b49d266 |
551 | utils/perldoc.PL - version comment |
1cab015a |
552 | |
553 | =back |
f89d6eaa |
554 | |
a83b6f46 |
555 | =head1 BUGS ON CYGWIN |
f8dbba82 |
556 | |
b4bcd662 |
557 | When I<make> starts, it warns about overriding commands for F<perlmain.o>. |
f8dbba82 |
558 | |
125a13ce |
559 | `C<make clean>' does not remove library F<.def> or F<.exe.stackdump> |
f8dbba82 |
560 | files. |
561 | |
562 | The I<ld2> script contains references to the source directory. You should |
b4bcd662 |
563 | change these to $installbin after `C<make install>'. |
f8dbba82 |
564 | |
125a13ce |
565 | Support for swapping real and effective user and group IDs is incomplete. |
566 | On WinNT Cygwin provides setuid(), seteuid(), setgid() and setegid(). |
567 | However, additional Cygwin calls for manipulating WinNT access tokens |
568 | and security contexts are required. |
569 | |
b53af0b8 |
570 | When building DLLs, `C<dllwrap --export-all-symbols>' is used to export |
571 | global symbols. It might be better to generate an explicit F<.def> file |
572 | (see F<makedef.pl>). Also, DLLs can now be build with `C<gcc -shared>'. |
573 | |
f8dbba82 |
574 | =head1 AUTHORS |
575 | |
b4bcd662 |
576 | Charles Wilson <cwilson@ece.gatech.edu>, |
47dafe4d |
577 | Eric Fifer <egf7@columbia.edu>, |
b4bcd662 |
578 | alexander smishlajev <als@turnhere.com>, |
579 | Steven Morlock <newspost@morlock.net>, |
580 | Sebastien Barre <Sebastien.Barre@utc.fr>, |
581 | Teun Burgers <burgers@ecn.nl>. |
f8dbba82 |
582 | |
583 | =head1 HISTORY |
584 | |
b53af0b8 |
585 | Last updated: 9 November 2000 |