1# vim: syntax=pod 2 3If you read this file _as_is_, just ignore the funny characters you 4see. It is written in the POD format (see F<pod/perlpod.pod>) which is 5specially designed to be readable as is. 6 7=head1 NAME 8 9perlcygwin - Perl for Cygwin 10 11=head1 SYNOPSIS 12 13This document will help you configure, make, test and install Perl 14on Cygwin. This document also describes features of Cygwin that will 15affect how Perl behaves at runtime. 16 17B<NOTE:> There are pre-built Perl packages available for Cygwin and a 18version of Perl is provided in the normal Cygwin install. If you do 19not need to customize the configuration, consider using one of those 20packages. 21 22 23=head1 PREREQUISITES FOR COMPILING PERL ON CYGWIN 24 25=head2 Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it) 26 27The Cygwin tools are ports of the popular GNU development tools for Win32 28platforms. They run thanks to the Cygwin library which provides the UNIX 29system calls and environment these programs expect. More information 30about this project can be found at: 31 32L<https://www.cygwin.com/> 33 34A recent net or commercial release of Cygwin is required. 35 36At the time this document was last updated, Cygwin 3.0.7 was current. 37 38 39=head2 Cygwin Configuration 40 41While building Perl some changes may be necessary to your Cygwin setup so 42that Perl builds cleanly. These changes are B<not> required for normal 43Perl usage. 44 45B<NOTE:> The binaries that are built will run on all Win32 versions. 46They do not depend on your host system or your 47Cygwin configuration (binary/text mounts, cygserver). 48The only dependencies come from hard-coded pathnames like F</usr/local>. 49However, your host system and Cygwin configuration will affect Perl's 50runtime behavior (see L</"TEST">). 51 52=over 4 53 54=item * C<PATH> 55 56Set the C<PATH> environment variable so that Configure finds the Cygwin 57versions of programs. Any not-needed Windows directories should be removed or 58moved to the end of your C<PATH>. 59 60=item * I<nroff> 61 62If you do not have I<nroff> (which is part of the I<groff> package), 63Configure will B<not> prompt you to install I<man> pages. 64 65=back 66 67=head1 CONFIGURE PERL ON CYGWIN 68 69The default options gathered by Configure with the assistance of 70F<hints/cygwin.sh> will build a Perl that supports dynamic loading 71(which requires a shared F<cygperl5_16.dll>). 72 73This will run Configure and keep a record: 74 75 ./Configure 2>&1 | tee log.configure 76 77If you are willing to accept all the defaults run Configure with B<-de>. 78However, several useful customizations are available. 79 80=head2 Stripping Perl Binaries on Cygwin 81 82It is possible to strip the EXEs and DLLs created by the build process. 83The resulting binaries will be significantly smaller. If you want the 84binaries to be stripped, you can either add a B<-s> option when Configure 85prompts you, 86 87 Any additional ld flags (NOT including libraries)? [none] -s 88 Any special flags to pass to g++ to create a dynamically loaded 89 library? 90 [none] -s 91 Any special flags to pass to gcc to use dynamic linking? [none] -s 92 93or you can edit F<hints/cygwin.sh> and uncomment the relevant variables 94near the end of the file. 95 96=head2 Optional Libraries for Perl on Cygwin 97 98Several Perl functions and modules depend on the existence of 99some optional libraries. Configure will find them if they are 100installed in one of the directories listed as being used for library 101searches. Pre-built packages for most of these are available from 102the Cygwin installer. 103 104=over 4 105 106=item * C<-lcrypt> 107 108The crypt package distributed with Cygwin is a Linux compatible 56-bit 109DES crypt port by Corinna Vinschen. 110 111Alternatively, the crypt libraries in GNU libc have been ported to Cygwin. 112 113As of libcrypt 1.3 (March 2016), you will need to install the 114libcrypt-devel package for Configure to detect crypt(). 115 116=item * C<-lgdbm_compat> (C<use GDBM_File>) 117 118GDBM is available for Cygwin. 119 120NOTE: The GDBM library only works on NTFS partitions. 121 122=item * C<-ldb> (C<use DB_File>) 123 124BerkeleyDB is available for Cygwin. 125 126NOTE: The BerkeleyDB library only completely works on NTFS partitions. 127 128=item * C<cygserver> (C<use IPC::SysV>) 129 130A port of SysV IPC is available for Cygwin. 131 132NOTE: This has B<not> been extensively tested. In particular, 133C<d_semctl_semun> is undefined because it fails a Configure test. It 134also creates a compile time dependency because F<perl.h> includes 135F<<sys/ipc.h>> and F<<sys/sem.h>> (which will be required in the 136future when compiling CPAN modules). CURRENTLY NOT SUPPORTED! 137 138=item * C<-lutil> 139 140Included with the standard Cygwin netrelease is the inetutils package 141which includes libutil.a. 142 143=back 144 145=head2 Configure-time Options for Perl on Cygwin 146 147The F<INSTALL> document describes several Configure-time options. Some of 148these will work with Cygwin, others are not yet possible. Also, some of 149these are experimental. You can either select an option when Configure 150prompts you or you can define (undefine) symbols on the command line. 151 152=over 4 153 154=item * C<-Uusedl> 155 156Undefining this symbol forces Perl to be compiled statically. 157 158=item * C<-Dusemymalloc> 159 160By default Perl does not use the C<malloc()> included with the Perl source, 161because it was slower and not entirely thread-safe. If you want to force 162Perl to build with the old -Dusemymalloc define this. 163 164=item * C<-Uuseperlio> 165 166Undefining this symbol disables the PerlIO abstraction. PerlIO is now the 167default; it is not recommended to disable PerlIO. 168 169=item * C<-Dusemultiplicity> 170 171Multiplicity is required when embedding Perl in a C program and using 172more than one interpreter instance. This is only required when you build 173a not-threaded perl with C<-Uuseithreads>. 174 175=item * C<-Uuse64bitint> 176 177By default Perl uses 64 bit integers. If you want to use smaller 32 bit 178integers, define this symbol. 179 180=item * C<-Duselongdouble> 181 182I<gcc> supports long doubles (12 bytes). However, several additional 183long double math functions are necessary to use them within Perl 184(I<{atan2, cos, exp, floor, fmod, frexp, isnan, log, modf, pow, sin, sqrt}l, 185strtold>). 186These are B<not> yet available with newlib, the Cygwin libc. 187 188=item * C<-Uuseithreads> 189 190Define this symbol if you want not-threaded faster perl. 191 192=item * C<-Duselargefiles> 193 194Cygwin uses 64-bit integers for internal size and position calculations, 195this will be correctly detected and defined by Configure. 196 197=item * C<-Dmksymlinks> 198 199Use this to build perl outside of the source tree. Details can be 200found in the F<INSTALL> document. This is the recommended way to 201build perl from sources. 202 203=back 204 205=head1 MAKE ON CYGWIN 206 207Simply run I<make> and wait: 208 209 make -jn 2>&1 | tee log.make 210 211where I<n> is the maximum number of simultaneous compilations you want; 212omitting this parameter is the same as specifying C<-j1>. 213 214=head1 TEST ON CYGWIN 215 216There are two steps to running the test suite: 217 218 make test 2>&1 | tee log.make-test 219 220 cd t; ./perl harness 2>&1 | tee ../log.harness 221 222The same tests are run both times, but more information is provided when 223running as C<./perl harness>, and you can run the tests in parallel by 224instead specifying 225 226 cd t; TEST_JOBS=n ./perl harness 2>&1 | tee ../log.harness 227 228where I<n> is the maximum number of tests to run simulataneously. 229 230Test results vary depending on your host system and your Cygwin 231configuration. If a test can pass in some Cygwin setup, it is always 232attempted and explainable test failures are documented. It is possible 233for Perl to pass all the tests, but it is more likely that some tests 234will fail for one of the reasons listed below. 235 236=head2 File Permissions on Cygwin 237 238UNIX file permissions are based on sets of mode bits for 239{read,write,execute} for each {user,group,other}. By default Cygwin 240only tracks the Win32 read-only attribute represented as the UNIX file 241user write bit (files are always readable, files are executable if they 242have a F<.{com,bat,exe}> extension or begin with C<#!>, directories are 243always readable and executable). On WinNT with the I<ntea> C<CYGWIN> 244setting, the additional mode bits are stored as extended file attributes. 245On WinNT with the default I<ntsec> C<CYGWIN> setting, permissions use the 246standard WinNT security descriptors and access control lists. Without one of 247these options, these tests will fail (listing not updated yet): 248 249 Failed Test List of failed 250 ------------------------------------ 251 io/fs.t 5, 7, 9-10 252 lib/anydbm.t 2 253 lib/db-btree.t 20 254 lib/db-hash.t 16 255 lib/db-recno.t 18 256 lib/gdbm.t 2 257 lib/ndbm.t 2 258 lib/odbm.t 2 259 lib/sdbm.t 2 260 op/stat.t 9, 20 (.tmp not an executable extension) 261 262=head2 NDBM_File and ODBM_File do not work on FAT filesystems 263 264Do not use NDBM_File or ODBM_File on FAT filesystem. They can be 265built on a FAT filesystem, but many tests will fail: 266 267 ../ext/NDBM_File/ndbm.t 13 3328 71 59 83.10% 1-2 4 16-71 268 ../ext/ODBM_File/odbm.t 255 65280 ?? ?? % ?? 269 ../lib/AnyDBM_File.t 2 512 12 2 16.67% 1 4 270 ../lib/Memoize/t/errors.t 0 139 11 5 45.45% 7-11 271 ../lib/Memoize/t/tie_ndbm.t 13 3328 4 4 100.00% 1-4 272 run/fresh_perl.t 97 1 1.03% 91 273 274If you intend to run only on FAT (or if using AnyDBM_File on FAT), 275run Configure with the -Ui_ndbm and -Ui_dbm options to prevent 276NDBM_File and ODBM_File being built. 277 278With NTFS (and no CYGWIN=nontsec), there should be no problems even if 279perl was built on FAT. 280 281=head2 C<fork()> failures in io_* tests 282 283A C<fork()> failure may result in the following tests failing: 284 285 ext/IO/lib/IO/t/io_multihomed.t 286 ext/IO/lib/IO/t/io_sock.t 287 ext/IO/lib/IO/t/io_unix.t 288 289See comment on fork in L</Miscellaneous> below. 290 291=head1 Specific features of the Cygwin port 292 293=head2 Script Portability on Cygwin 294 295Cygwin does an outstanding job of providing UNIX-like semantics on top of 296Win32 systems. However, in addition to the items noted above, there are 297some differences that you should know about. This is a very brief guide 298to portability, more information can be found in the Cygwin documentation. 299 300=over 4 301 302=item * Pathnames 303 304Cygwin pathnames are separated by forward (F</>) slashes, Universal 305Naming Codes (F<//UNC>) are also supported. Since cygwin-1.7 non-POSIX 306pathnames should not be used. Names may contain all printable 307characters. 308 309File names are case insensitive, but case preserving. A pathname that 310contains a backslash or drive letter is a Win32 pathname, and not 311subject to the translations applied to POSIX style pathnames, but 312cygwin will warn you, so better convert them to POSIX. 313 314For conversion we have C<Cygwin::win_to_posix_path()> and 315C<Cygwin::posix_to_win_path()>. 316 317Since cygwin-1.7 pathnames are UTF-8 encoded. 318 319=item * Text/Binary 320 321Since cygwin-1.7 textmounts are deprecated and strongly discouraged. 322 323When a file is opened it is in either text or binary mode. In text mode 324a file is subject to CR/LF/Ctrl-Z translations. With Cygwin, the default 325mode for an C<open()> is determined by the mode of the mount that underlies 326the file. See L</Cygwin::is_binmount>(). Perl provides a C<binmode()> function 327to set binary mode on files that otherwise would be treated as text. 328C<sysopen()> with the C<O_TEXT> flag sets text mode on files that otherwise 329would be treated as binary: 330 331 sysopen(FOO, "bar", O_WRONLY|O_CREAT|O_TEXT) 332 333C<lseek()>, C<tell()> and C<sysseek()> only work with files opened in binary 334mode. 335 336The text/binary issue is covered at length in the Cygwin documentation. 337 338=item * PerlIO 339 340PerlIO overrides the default Cygwin Text/Binary behaviour. A file will 341always be treated as binary, regardless of the mode of the mount it lives 342on, just like it is in UNIX. So CR/LF translation needs to be requested in 343either the C<open()> call like this: 344 345 open(FH, ">:crlf", "out.txt"); 346 347which will do conversion from LF to CR/LF on the output, or in the 348environment settings (add this to your .bashrc): 349 350 export PERLIO=crlf 351 352which will pull in the crlf PerlIO layer which does LF -> CRLF conversion 353on every output generated by perl. 354 355=item * F<.exe> 356 357The Cygwin C<stat()>, C<lstat()> and C<readlink()> functions make the F<.exe> 358extension transparent by looking for F<foo.exe> when you ask for F<foo> 359(unless a F<foo> also exists). Cygwin does not require a F<.exe> 360extension, but I<gcc> adds it automatically when building a program. 361However, when accessing an executable as a normal file (e.g., I<cp> 362in a makefile) the F<.exe> is not transparent. The I<install> program 363included with Cygwin automatically appends a F<.exe> when necessary. 364 365=item * Cygwin vs. Windows process ids 366 367Cygwin processes have their own pid, which is different from the 368underlying windows pid. Most posix compliant Proc functions expect 369the cygwin pid, but several Win32::Process functions expect the 370winpid. E.g. C<$$> is the cygwin pid of F</usr/bin/perl>, which is not 371the winpid. Use C<Cygwin::pid_to_winpid()> and C<Cygwin::winpid_to_pid()> 372to translate between them. 373 374=item * Cygwin vs. Windows errors 375 376Under Cygwin, $^E is the same as $!. When using L<Win32 API Functions|Win32>, 377use C<Win32::GetLastError()> to get the last Windows error. 378 379=item * rebase errors on fork or system 380 381Using C<fork()> or C<system()> out to another perl after loading multiple dlls 382may result on a DLL baseaddress conflict. The internal cygwin error 383looks like like the following: 384 385 0 [main] perl 8916 child_info_fork::abort: data segment start: 386 parent (0xC1A000) != child(0xA6A000) 387 388or: 389 390 183 [main] perl 3588 C:\cygwin\bin\perl.exe: *** fatal error - 391 unable to remap C:\cygwin\bin\cygsvn_subr-1-0.dll to same address 392 as parent(0x6FB30000) != 0x6FE60000 46 [main] perl 3488 fork: child 393 3588 - died waiting for dll loading, errno11 394 395See L<https://cygwin.com/faq/faq.html#faq.using.fixing-fork-failures> 396It helps if not too many DLLs are loaded in memory so the available address space is larger, 397e.g. stopping the MS Internet Explorer might help. 398 399+Use the rebase utilities to resolve the conflicting dll addresses. 400The rebase package is included in the Cygwin setup. Use F<setup.exe> 401from L<https://cygwin.com/install.html> to install it. 402 4031. kill all perl processes and run 404 C<</bin/find <dir> -xdev -name \*.dll | /bin/rebase -OT ->> or 405 4062. kill all cygwin processes and services, and run setup.exe. 407 408=item * Miscellaneous 409 410File locking using the C<F_GETLK> command to C<fcntl()> is a stub that 411returns C<ENOSYS>. 412 413The Cygwin C<chroot()> implementation has holes (it can not restrict file 414access by native Win32 programs). 415 416Inplace editing C<perl -i> of files doesn't work without doing a backup 417of the file being edited C<perl -i.bak> because of windowish restrictions, 418therefore Perl adds the suffix C<.bak> automatically if you use C<perl -i> 419without specifying a backup extension. 420 421=back 422 423=head2 Prebuilt methods: 424 425=over 4 426 427=item C<Cwd::cwd> 428 429Returns the current working directory. 430 431=item C<Cygwin::pid_to_winpid> 432 433Translates a cygwin pid to the corresponding Windows pid (which may or 434may not be the same). 435 436=item C<Cygwin::winpid_to_pid> 437 438Translates a Windows pid to the corresponding cygwin pid (if any). 439 440=item C<Cygwin::win_to_posix_path> 441 442Translates a Windows path to the corresponding cygwin path respecting 443the current mount points. With a second non-null argument returns an 444absolute path. Double-byte characters will not be translated. 445 446=item C<Cygwin::posix_to_win_path> 447 448Translates a cygwin path to the corresponding cygwin path respecting 449the current mount points. With a second non-null argument returns an 450absolute path. Double-byte characters will not be translated. 451 452=item C<Cygwin::mount_table()> 453 454Returns an array of [mnt_dir, mnt_fsname, mnt_type, mnt_opts]. 455 456 perl -e 'for $i (Cygwin::mount_table) {print join(" ",@$i),"\n";}' 457 /bin c:\cygwin\bin system binmode,cygexec 458 /usr/bin c:\cygwin\bin system binmode 459 /usr/lib c:\cygwin\lib system binmode 460 / c:\cygwin system binmode 461 /cygdrive/c c: system binmode,noumount 462 /cygdrive/d d: system binmode,noumount 463 /cygdrive/e e: system binmode,noumount 464 465=item C<Cygwin::mount_flags> 466 467Returns the mount type and flags for a specified mount point. 468A comma-separated string of mntent->mnt_type (always 469"system" or "user"), then the mntent->mnt_opts, where 470the first is always "binmode" or "textmode". 471 472 system|user,binmode|textmode,exec,cygexec,cygdrive,mixed, 473 notexec,managed,nosuid,devfs,proc,noumount 474 475If the argument is "/cygdrive", then just the volume mount settings, 476and the cygdrive mount prefix are returned. 477 478User mounts override system mounts. 479 480 $ perl -e 'print Cygwin::mount_flags "/usr/bin"' 481 system,binmode,cygexec 482 $ perl -e 'print Cygwin::mount_flags "/cygdrive"' 483 binmode,cygdrive,/cygdrive 484 485=item C<Cygwin::is_binmount> 486 487Returns true if the given cygwin path is binary mounted, false if the 488path is mounted in textmode. 489 490=item C<Cygwin::sync_winenv> 491 492Cygwin does not initialize all original Win32 environment variables. 493See the bottom of this page L<https://cygwin.com/cygwin-ug-net/setup-env.html> 494for "Restricted Win32 environment". 495 496Certain Win32 programs called from cygwin programs might need some environment 497variable, such as e.g. ADODB needs %COMMONPROGRAMFILES%. 498Call Cygwin::sync_winenv() to copy all Win32 environment variables to your 499process and note that cygwin will warn on every encounter of non-POSIX paths. 500 501=back 502 503=head1 INSTALL PERL ON CYGWIN 504 505This will install Perl, including I<man> pages. 506 507 make install 2>&1 | tee log.make-install 508 509NOTE: If C<STDERR> is redirected C<make install> will B<not> prompt 510you to install I<perl> into F</usr/bin>. 511 512You may need to be I<Administrator> to run C<make install>. If you 513are not, you must have write access to the directories in question. 514 515Information on installing the Perl documentation in HTML format can be 516found in the F<INSTALL> document. 517 518=head1 MANIFEST ON CYGWIN 519 520These are the files in the Perl release that contain references to Cygwin. 521These very brief notes attempt to explain the reason for all conditional 522code. Hopefully, keeping this up to date will allow the Cygwin port to 523be kept as clean as possible. 524 525=over 4 526 527=item Documentation 528 529 INSTALL README.cygwin README.win32 MANIFEST 530 pod/perl.pod pod/perlport.pod pod/perlfaq3.pod 531 pod/perldelta.pod pod/perl5004delta.pod pod/perl56delta.pod 532 pod/perl561delta.pod pod/perl570delta.pod pod/perl572delta.pod 533 pod/perl573delta.pod pod/perl58delta.pod pod/perl581delta.pod 534 pod/perl590delta.pod pod/perlhist.pod pod/perlmodlib.pod 535 pod/perltoc.pod Porting/Glossary pod/perlgit.pod 536 Porting/updateAUTHORS.pl 537 dist/Cwd/Changes ext/Compress-Raw-Zlib/Changes 538 dist/Time-HiRes/Changes 539 ext/Compress-Raw-Zlib/README ext/Compress-Zlib/Changes 540 ext/DB_File/Changes ext/Encode/Changes ext/Sys-Syslog/Changes 541 ext/Win32API-File/Changes 542 lib/ExtUtils/CBuilder/Changes lib/ExtUtils/Changes 543 lib/ExtUtils/NOTES lib/ExtUtils/PATCHING lib/ExtUtils/README 544 lib/Net/Ping/Changes lib/Test/Harness/Changes 545 lib/Term/ANSIColor/ChangeLog lib/Term/ANSIColor/README 546 547=item Build, Configure, Make, Install 548 549 cygwin/Makefile.SHs 550 ext/IPC/SysV/hints/cygwin.pl 551 ext/NDBM_File/hints/cygwin.pl 552 ext/ODBM_File/hints/cygwin.pl 553 hints/cygwin.sh 554 Configure - help finding hints from uname, 555 shared libperl required for dynamic loading 556 Makefile.SH Cross/Makefile-cross-SH 557 - linklibperl 558 Porting/patchls - cygwin in port list 559 installman - man pages with :: translated to . 560 installperl - install dll, install to 'pods' 561 makedepend.SH - uwinfix 562 regen_lib.pl - file permissions 563 564 plan9/mkfile 565 vms/descrip_mms.template 566 win32/Makefile 567 568=item Tests 569 570 t/io/fs.t - no file mode checks if not ntsec 571 skip rename() check when not 572 check_case:relaxed 573 t/io/tell.t - binmode 574 t/lib/cygwin.t - builtin cygwin function tests 575 t/op/groups.t - basegroup has ID = 0 576 t/op/magic.t - $^X/symlink WORKAROUND, s/.exe// 577 t/op/stat.t - no /dev, skip Win32 ftCreationTime quirk 578 (cache manager sometimes preserves ctime of 579 file previously created and deleted), no -u 580 (setuid) 581 t/op/taint.t - can't use empty path under Cygwin Perl 582 t/op/time.t - no tzset() 583 584=item Compiled Perl Source 585 586 EXTERN.h - __declspec(dllimport) 587 XSUB.h - __declspec(dllexport) 588 cygwin/cygwin.c - os_extras (getcwd, spawn, and several 589 Cygwin:: functions) 590 perl.c - os_extras, -i.bak 591 perl.h - binmode 592 doio.c - win9x can not rename a file when it is open 593 pp_sys.c - do not define h_errno, init 594 _pwent_struct.pw_comment 595 util.c - use setenv 596 util.h - PERL_FILE_IS_ABSOLUTE macro 597 pp.c - Comment about Posix vs IEEE math under 598 Cygwin 599 perlio.c - CR/LF mode 600 perliol.c - Comment about EXTCONST under Cygwin 601 602=item Compiled Module Source 603 604 ext/Compress-Raw-Zlib/Makefile.PL 605 - Can't install via CPAN shell under Cygwin 606 ext/Compress-Raw-Zlib/zlib-src/zutil.h 607 - Cygwin is Unix-like and has vsnprintf 608 ext/Errno/Errno_pm.PL - Special handling for Win32 Perl under 609 Cygwin 610 ext/POSIX/POSIX.xs - tzname defined externally 611 ext/SDBM_File/sdbm/pair.c 612 - EXTCONST needs to be redefined from 613 EXTERN.h 614 ext/SDBM_File/sdbm/sdbm.c 615 - binary open 616 ext/Sys/Syslog/Syslog.xs 617 - Cygwin has syslog.h 618 ext/Sys/Syslog/win32/compile.pl 619 - Convert paths to Windows paths 620 ext/Time-HiRes/HiRes.xs 621 - Various timers not available 622 ext/Time-HiRes/Makefile.PL 623 - Find w32api/windows.h 624 ext/Win32/Makefile.PL - Use various libraries under Cygwin 625 ext/Win32/Win32.xs - Child dir and child env under Cygwin 626 ext/Win32API-File/File.xs 627 - _open_osfhandle not implemented under 628 Cygwin 629 ext/Win32CORE/Win32CORE.c 630 - __declspec(dllexport) 631 632=item Perl Modules/Scripts 633 634 ext/B/t/OptreeCheck.pm - Comment about stderr/stdout order under 635 Cygwin 636 ext/Digest-SHA/bin/shasum 637 - Use binary mode under Cygwin 638 ext/Sys/Syslog/win32/Win32.pm 639 - Convert paths to Windows paths 640 ext/Time-HiRes/HiRes.pm 641 - Comment about various timers not available 642 ext/Win32API-File/File.pm 643 - _open_osfhandle not implemented under 644 Cygwin 645 ext/Win32CORE/Win32CORE.pm 646 - History of Win32CORE under Cygwin 647 lib/Cwd.pm - hook to internal Cwd::cwd 648 lib/ExtUtils/CBuilder/Platform/cygwin.pm 649 - use gcc for ld, and link to libperl.dll.a 650 lib/ExtUtils/CBuilder.pm 651 - Cygwin is Unix-like 652 lib/ExtUtils/Install.pm - Install and rename issues under Cygwin 653 lib/ExtUtils/MM.pm - OS classifications 654 lib/ExtUtils/MM_Any.pm - Example for Cygwin 655 lib/ExtUtils/MakeMaker.pm 656 - require MM_Cygwin.pm 657 lib/ExtUtils/MM_Cygwin.pm 658 - canonpath, cflags, manifypods, perl_archive 659 lib/File/Fetch.pm - Comment about quotes using a Cygwin example 660 lib/File/Find.pm - on remote drives stat() always sets 661 st_nlink to 1 662 lib/File/Spec/Cygwin.pm - case_tolerant 663 lib/File/Spec/Unix.pm - preserve //unc 664 lib/File/Spec/Win32.pm - References a message on cygwin.com 665 lib/File/Spec.pm - Pulls in lib/File/Spec/Cygwin.pm 666 lib/File/Temp.pm - no directory sticky bit 667 lib/Module/CoreList.pm - List of all module files and versions 668 lib/Net/Domain.pm - No domainname command under Cygwin 669 lib/Net/Netrc.pm - Bypass using stat() under Cygwin 670 lib/Net/Ping.pm - ECONREFUSED is EAGAIN under Cygwin 671 lib/Pod/Find.pm - Set 'pods' dir 672 lib/Pod/Perldoc/ToMan.pm - '-c' switch for pod2man 673 lib/Pod/Perldoc.pm - Use 'less' pager, and use .exe extension 674 lib/Term/ANSIColor.pm - Cygwin terminal info 675 lib/perl5db.pl - use stdin not /dev/tty 676 utils/perlbug.PL - Add CYGWIN environment variable to report 677 678=item Perl Module Tests 679 680 dist/Cwd/t/cwd.t 681 ext/Compress-Zlib/t/14gzopen.t 682 ext/DB_File/t/db-btree.t 683 ext/DB_File/t/db-hash.t 684 ext/DB_File/t/db-recno.t 685 ext/DynaLoader/t/DynaLoader.t 686 ext/File-Glob/t/basic.t 687 ext/GDBM_File/t/gdbm.t 688 ext/POSIX/t/sysconf.t 689 ext/POSIX/t/time.t 690 ext/SDBM_File/t/sdbm.t 691 ext/Sys/Syslog/t/syslog.t 692 ext/Time-HiRes/t/HiRes.t 693 ext/Win32/t/Unicode.t 694 ext/Win32API-File/t/file.t 695 ext/Win32CORE/t/win32core.t 696 lib/AnyDBM_File.t 697 lib/Archive/Extract/t/01_Archive-Extract.t 698 lib/Archive/Tar/t/02_methods.t 699 lib/ExtUtils/t/Embed.t 700 lib/ExtUtils/t/eu_command.t 701 lib/ExtUtils/t/MM_Cygwin.t 702 lib/ExtUtils/t/MM_Unix.t 703 lib/File/Compare.t 704 lib/File/Copy.t 705 lib/File/Find/t/find.t 706 lib/File/Path.t 707 lib/File/Spec/t/crossplatform.t 708 lib/File/Spec/t/Spec.t 709 lib/Net/hostent.t 710 lib/Net/Ping/t/110_icmp_inst.t 711 lib/Net/Ping/t/500_ping_icmp.t 712 lib/Net/t/netrc.t 713 lib/Pod/Simple/t/perlcyg.pod 714 lib/Pod/Simple/t/perlcygo.txt 715 lib/Pod/Simple/t/perlfaq.pod 716 lib/Pod/Simple/t/perlfaqo.txt 717 lib/User/grent.t 718 lib/User/pwent.t 719 720=back 721 722=head1 BUGS ON CYGWIN 723 724Support for swapping real and effective user and group IDs is incomplete. 725On WinNT Cygwin provides C<setuid()>, C<seteuid()>, C<setgid()> and C<setegid()>. 726However, additional Cygwin calls for manipulating WinNT access tokens 727and security contexts are required. 728 729=head1 AUTHORS 730 731Charles Wilson <cwilson@ece.gatech.edu>, 732Eric Fifer <egf7@columbia.edu>, 733alexander smishlajev <als@turnhere.com>, 734Steven Morlock <newspost@morlock.net>, 735Sebastien Barre <Sebastien.Barre@utc.fr>, 736Teun Burgers <burgers@ecn.nl>, 737Gerrit P. Haase <gp@familiehaase.de>, 738Reini Urban <rurban@cpan.org>, 739Jan Dubois <jand@activestate.com>, 740Jerry D. Hedden <jdhedden@cpan.org>. 741 742=head1 HISTORY 743 744Last updated: 2019-11-14 745