X-Git-Url: https://perl5.git.perl.org/perl5.git/blobdiff_plain/33bf3ba1e1da6ddc16507aa7bf0f707475d581e1..382450a68fa9cdd5206e8c46383bd92e63aeb392:/README.cygwin diff --git a/README.cygwin b/README.cygwin index 89e386a..90fb14b 100644 --- a/README.cygwin +++ b/README.cygwin @@ -1,10 +1,10 @@ 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 +see. It is written in the POD format (see F) which is specially designed to be readable as is. =head1 NAME -README.cygwin - Perl for Cygwin +perlcygwin - Perl for Cygwin =head1 SYNOPSIS @@ -27,11 +27,11 @@ platforms. They run thanks to the Cygwin library which provides the UNIX system calls and environment these programs expect. More information about this project can be found at: - http://www.cygwin.com/ +L A recent net or commercial release of Cygwin is required. -At the time this document was last updated, Cygwin 1.3.5 was current. +At the time this document was last updated, Cygwin 1.7.16 was current. =head2 Cygwin Configuration @@ -41,9 +41,9 @@ that Perl builds cleanly. These changes are B required for normal Perl usage. B The binaries that are built will run on all Win32 versions. -They do not depend on your host system (Win9x/WinME, WinNT/Win2K) -or your Cygwin configuration (I, I, binary/text mounts). -The only dependencies come from hard-coded pathnames like C. +They do not depend on your host system (WinXP/Win2K/Win7) or your +Cygwin configuration (binary/text mounts, cvgserver). +The only dependencies come from hard-coded pathnames like F. However, your host system and Cygwin configuration will affect Perl's runtime behavior (see L). @@ -52,7 +52,7 @@ runtime behavior (see L). =item * C Set the C environment variable so that Configure finds the Cygwin -versions of programs. Any Windows directories should be removed or +versions of programs. Any not-needed Windows directories should be removed or moved to the end of your C. =item * I @@ -60,28 +60,13 @@ moved to the end of your C. If you do not have I (which is part of the I package), Configure will B prompt you to install I pages. -=item * Permissions - -On WinNT with either the I or I C settings, directory -and file permissions may not be set correctly. Since the build process -creates directories and files, to be safe you may want to run a `C' on the entire Perl source tree. - -Also, it is a well known WinNT "feature" that files created by a login -that is a member of the I group will be owned by the -I group. Depending on your umask, you may find that you -can not write to files that you just created (because you are no longer -the owner). When using the I C setting, this is not an -issue because it "corrects" the ownership to what you would expect on -a UNIX system. - =back =head1 CONFIGURE PERL ON CYGWIN The default options gathered by Configure with the assistance of F will build a Perl that supports dynamic loading -(which requires a shared F). +(which requires a shared F). This will run Configure and keep a record: @@ -98,9 +83,10 @@ binaries to be stripped, you can either add a B<-s> option when Configure prompts you, Any additional ld flags (NOT including libraries)? [none] -s - Any special flags to pass to gcc to use dynamic linking? [none] -s - Any special flags to pass to ld2 to create a dynamically loaded library? + Any special flags to pass to g++ to create a dynamically loaded + library? [none] -s + Any special flags to pass to gcc to use dynamic linking? [none] -s or you can edit F and uncomment the relevant variables near the end of the file. @@ -122,33 +108,22 @@ DES crypt port by Corinna Vinschen. Alternatively, the crypt libraries in GNU libc have been ported to Cygwin. -The DES based Ultra Fast Crypt port was done by Alexey Truhan: - - ftp://ftp.franken.de/pub/win32/develop/gnuwin32/cygwin/porters/Okhapkin_Sergey/cw32crypt-dist-0.tgz +As of libcrypt 1.3 (March 2016), you will need to install the +libcrypt-devel package for Configure to detect crypt(). -NOTE: There are various export restrictions on DES implementations, -see the glibc README for more details. +=item * C<-lgdbm_compat> (C) -The MD5 port was done by Andy Piper: +GDBM is available for Cygwin. - ftp://ftp.franken.de/pub/win32/develop/gnuwin32/cygwin/porters/Okhapkin_Sergey/libcrypt.tgz - -=item * C<-lgdbm> (C) - -GDBM is available for Cygwin. GDBM's ndbm/dbm compatibility feature -also makes C and C possible (although they add -little extra value). - -NOTE: The ndbm/dbm emulations only completely work on NTFS partitions. +NOTE: The GDBM library only works on NTFS partitions. =item * C<-ldb> (C) -BerkeleyDB is available for Cygwin. Some details can be found in -F. +BerkeleyDB is available for Cygwin. NOTE: The BerkeleyDB library only completely works on NTFS partitions. -=item * C<-lcygipc> (C) +=item * C (C) A port of SysV IPC is available for Cygwin. @@ -157,7 +132,12 @@ C is undefined because it fails a Configure test and on Win9x the I functions seem to hang. It also creates a compile time dependency because F includes F<> and F<> (which will be required in the future when compiling -CPAN modules). +CPAN modules). CURRENTLY NOT SUPPORTED! + +=item * C<-lutil> + +Included with the standard Cygwin netrelease is the inetutils package +which includes libutil.a. =back @@ -174,42 +154,50 @@ prompts you or you can define (undefine) symbols on the command line. Undefining this symbol forces Perl to be compiled statically. -=item * C<-Uusemymalloc> +=item * C<-Dusemymalloc> -By default Perl uses the malloc() included with the Perl source. If you -want to force Perl to build with the system malloc() undefine this symbol. +By default Perl does not use the C included with the Perl source, +because it was slower and not entirely thread-safe. If you want to force +Perl to build with the old -Dusemymalloc define this. =item * C<-Uuseperlio> -Undefining this symbol disables the PerlIO abstraction, which is now the -default. +Undefining this symbol disables the PerlIO abstraction. PerlIO is now the +default; it is not recommended to disable PerlIO. =item * C<-Dusemultiplicity> Multiplicity is required when embedding Perl in a C program and using -more than one interpreter instance. This works with the Cygwin port. +more than one interpreter instance. This is only required when you build +a not-threaded perl with C<-Uuseithreads>. -=item * C<-Duse64bitint> +=item * C<-Uuse64bitint> -I supports 64-bit integers. However, several additional long long -functions are necessary to use them within Perl (I<{strtol,strtoul}l>). -These are B yet available with Cygwin. +By default Perl uses 64 bit integers. If you want to use smaller 32 bit +integers, define this symbol. =item * C<-Duselongdouble> I supports long doubles (12 bytes). However, several additional long double math functions are necessary to use them within Perl -(I<{atan2,cos,exp,floor,fmod,frexp,isnan,log,modf,pow,sin,sqrt}l,strtold>). -These are B yet available with Cygwin. +(I<{atan2, cos, exp, floor, fmod, frexp, isnan, log, modf, pow, sin, sqrt}l, +strtold>). +These are B yet available with newlib, the Cygwin libc. -=item * C<-Dusethreads> +=item * C<-Uuseithreads> -POSIX threads are B yet implemented in Cygwin. +Define this symbol if you want not-threaded faster perl. =item * C<-Duselargefiles> -Although Win32 supports large files, Cygwin currently uses 32-bit integers -for internal size and position calculations. +Cygwin uses 64-bit integers for internal size and position calculations, +this will be correctly detected and defined by Configure. + +=item * C<-Dmksymlinks> + +Use this to build perl outside of the source tree. Details can be +found in the F document. This is the recommended way to +build perl from sources. =back @@ -219,30 +207,18 @@ You may see some messages during Configure that seem suspicious. =over 4 -=item * I - -I is needed to build dynamic libraries, but it does not exist -when dlsym() checking occurs (it is not created until `C' runs). -You will see the following message: - - Checking whether your dlsym() needs a leading underscore ... - ld2: not found - I can't compile and run the test program. - I'm guessing that dlsym doesn't need a leading underscore. - -Since the guess is correct, this is not a problem. - =item * Win9x and C Win9x does not correctly report C with a non-blocking read on a closed pipe. You will see the following messages: - But it also returns -1 to signal EOF, so be careful! - WARNING: you can't distinguish between EOF and no data! + But it also returns -1 to signal EOF, so be careful! + WARNING: you can't distinguish between EOF and no data! - *** WHOA THERE!!! *** - The recommended value for $d_eofnblk on this machine was "define"! - Keep the recommended value? [y] + *** WHOA THERE!!! *** + The recommended value for $d_eofnblk on this machine was + "define"! + Keep the recommended value? [y] At least for consistency with WinNT, you should keep the recommended value. @@ -253,9 +229,11 @@ The following error occurs because of the Cygwin C<#define> of C<_LONG_DOUBLE>: Guessing which symbols your C compiler and preprocessor define... - try.c:: parse error + try.c:: missing binary operator -This failure does not seem to cause any problems. +This failure does not seem to cause any problems. With older gcc +versions, "parse error" is reported instead of "missing binary +operator". =back @@ -265,38 +243,16 @@ Simply run I and wait: make 2>&1 | tee log.make -=head2 Warnings on Cygwin - -Warnings like these are normal: - - warning: overriding commands for target - warning: ignoring old commands for target - - dllwrap: no export definition file provided - dllwrap: creating one, but that may not be what you want - -=head2 ld2 on Cygwin - -During `C', I will be created and installed in your $installbin -directory (where you said to put public executables). It does not -wait until the `C' process to install the I script, -this is because the remainder of the `C' refers to I without -fully specifying its path and does this from multiple subdirectories. -The assumption is that $installbin is in your current C. If this -is not the case `C' will fail at some point. If this happens, -just manually copy I from the source directory to somewhere in -your C. - =head1 TEST ON CYGWIN There are two steps to running the test suite: make test 2>&1 | tee log.make-test - cd t;./perl harness 2>&1 | tee ../log.harness + cd t; ./perl harness 2>&1 | tee ../log.harness The same tests are run both times, but more information is provided when -running as `C<./perl harness>'. +running as C<./perl harness>. Test results vary depending on your host system and your Cygwin configuration. If a test can pass in some Cygwin setup, it is always @@ -313,9 +269,9 @@ user write bit (files are always readable, files are executable if they have a F<.{com,bat,exe}> extension or begin with C<#!>, directories are always readable and executable). On WinNT with the I C setting, the additional mode bits are stored as extended file attributes. -On WinNT with the I C setting, permissions use the standard -WinNT security descriptors and access control lists. Without one of -these options, these tests will fail: +On WinNT with the default I C setting, permissions use the +standard WinNT security descriptors and access control lists. Without one of +these options, these tests will fail (listing not updated yet): Failed Test List of failed ------------------------------------ @@ -330,69 +286,36 @@ these options, these tests will fail: lib/sdbm.t 2 op/stat.t 9, 20 (.tmp not an executable extension) -=head2 Hard Links on Cygwin - -FAT partitions do not support hard links (whereas NTFS does), in which -case Cygwin implements link() by copying the file. On remote (network) -drives Cygwin's stat() always sets C to 1, so the link count -for remote directories and files is not available. In either case, -these tests will fail: +=head2 NDBM_File and ODBM_File do not work on FAT filesystems - Failed Test List of failed - ------------------------------------ - io/fs.t 4 - op/stat.t 3 - -=head2 Filetime Granularity on Cygwin - -On FAT partitions the filetime granularity is 2 seconds. The following -test will fail: - - Failed Test List of failed - ------------------------------------ - io/fs.t 18 - -=head2 Tainting Checks on Cygwin - -When Perl is running in taint mode, C<$ENV{PATH}> is considered tainted -and not used, so DLLs not in the default system directories will not -be found. While the tests are running you will see warnings popup from -the system with messages like: +Do not use NDBM_File or ODBM_File on FAT filesystem. They can be +built on a FAT filesystem, but many tests will fail: - Win9x - Error Starting Program - A required .DLL file, CYGWIN1.DLL, was not found + ../ext/NDBM_File/ndbm.t 13 3328 71 59 83.10% 1-2 4 16-71 + ../ext/ODBM_File/odbm.t 255 65280 ?? ?? % ?? + ../lib/AnyDBM_File.t 2 512 12 2 16.67% 1 4 + ../lib/Memoize/t/errors.t 0 139 11 5 45.45% 7-11 + ../lib/Memoize/t/tie_ndbm.t 13 3328 4 4 100.00% 1-4 + run/fresh_perl.t 97 1 1.03% 91 - WinNT - perl.exe - Unable to Locate DLL - The dynamic link library cygwin1.dll could not be found in the - specified path ... - -Just click OK and ignore them. When running `C', 2 popups -occur. During `C<./perl harness>', 4 popups occur. Also, these tests -will fail: - - Failed Test List of failed - ------------------------------------ - op/taint.t 1, 3, 31, 37 +If you intend to run only on FAT (or if using AnyDBM_File on FAT), +run Configure with the -Ui_ndbm and -Ui_dbm options to prevent +NDBM_File and ODBM_File being built. -Alternatively, you can copy F into the directory where the -tests run: +With NTFS (and no CYGWIN=nontsec), there should be no problems even if +perl was built on FAT. - cp /bin/cygwin1.dll t +=head2 C failures in io_* tests -or one of the Windows system directories (although, this is B -recommended). +A C failure may result in the following tests failing: -=head2 /etc/group on Cygwin + ext/IO/lib/IO/t/io_multihomed.t + ext/IO/lib/IO/t/io_sock.t + ext/IO/lib/IO/t/io_unix.t -Cygwin does not require F, in which case the F -test will be skipped. The check performed by F expects to -see entries that use the members field, otherwise this test will fail: +See comment on fork in L below. - Failed Test List of failed - ------------------------------------ - op/grent.t 1 +=head1 Specific features of the Cygwin port =head2 Script Portability on Cygwin @@ -405,71 +328,221 @@ to portability, more information can be found in the Cygwin documentation. =item * Pathnames -Cygwin pathnames can be separated by forward (F) or backward (F<\>) -slashes. They may also begin with drive letters (F) or Universal -Naming Codes (F). DOS device names (F, F, F, -F, F, F) are invalid as base filenames. However, they -can be used in extensions (e.g., F). Names may contain all -printable characters except these: - - : * ? " < > | +Cygwin pathnames are separated by forward (F) slashes, Universal +Naming Codes (F) are also supported Since cygwin-1.7 non-POSIX +pathnames are discouraged. Names may contain all printable +characters. File names are case insensitive, but case preserving. A pathname that -contains a backslash or drive letter is a Win32 pathname (and not subject -to the translations applied to POSIX style pathnames). +contains a backslash or drive letter is a Win32 pathname, and not +subject to the translations applied to POSIX style pathnames, but +cygwin will warn you, so better convert them to POSIX. + +For conversion we have C and +C. + +Since cygwin-1.7 pathnames are UTF-8 encoded. =item * Text/Binary +Since cygwin-1.7 textmounts are deprecated and strongly discouraged. + When a file is opened it is in either text or binary mode. In text mode a file is subject to CR/LF/Ctrl-Z translations. With Cygwin, the default -mode for an open() is determined by the mode of the mount that underlies -the file. Perl provides a binmode() function to set binary mode on files -that otherwise would be treated as text. sysopen() with the C -flag sets text mode on files that otherwise would be treated as binary: +mode for an C is determined by the mode of the mount that underlies +the file. See L(). Perl provides a C function +to set binary mode on files that otherwise would be treated as text. +C with the C flag sets text mode on files that otherwise +would be treated as binary: sysopen(FOO, "bar", O_WRONLY|O_CREAT|O_TEXT) -lseek(), tell() and sysseek() only work with files opened in binary mode. +C, C and C only work with files opened in binary +mode. The text/binary issue is covered at length in the Cygwin documentation. +=item * PerlIO + +PerlIO overrides the default Cygwin Text/Binary behaviour. A file will +always be treated as binary, regardless of the mode of the mount it lives +on, just like it is in UNIX. So CR/LF translation needs to be requested in +either the C call like this: + + open(FH, ">:crlf", "out.txt"); + +which will do conversion from LF to CR/LF on the output, or in the +environment settings (add this to your .bashrc): + + export PERLIO=crlf + +which will pull in the crlf PerlIO layer which does LF -> CRLF conversion +on every output generated by perl. + =item * F<.exe> -The Cygwin stat(), lstat() and readlink() functions make the F<.exe> +The Cygwin C, C and C functions make the F<.exe> extension transparent by looking for F when you ask for F (unless a F also exists). Cygwin does not require a F<.exe> extension, but I adds it automatically when building a program. However, when accessing an executable as a normal file (e.g., I -in a makefile) the F<.exe> is not transparent. The I included -with Cygwin automatically appends a F<.exe> when necessary. +in a makefile) the F<.exe> is not transparent. The I program +included with Cygwin automatically appends a F<.exe> when necessary. + +=item * Cygwin vs. Windows process ids + +Cygwin processes have their own pid, which is different from the +underlying windows pid. Most posix compliant Proc functions expect +the cygwin pid, but several Win32::Process functions expect the +winpid. E.g. C<$$> is the cygwin pid of F, which is not +the winpid. Use C and C +to translate between them. + +=item * Cygwin vs. Windows errors + +Under Cygwin, $^E is the same as $!. When using L, +use C to get the last Windows error. + +=item * rebase errors on fork or system + +Using C or C out to another perl after loading multiple dlls +may result on a DLL baseaddress conflict. The internal cygwin error +looks like like the following: + + 0 [main] perl 8916 child_info_fork::abort: data segment start: + parent (0xC1A000) != child(0xA6A000) + +or: + + 183 [main] perl 3588 C:\cygwin\bin\perl.exe: *** fatal error - + unable to remap C:\cygwin\bin\cygsvn_subr-1-0.dll to same address + as parent(0x6FB30000) != 0x6FE60000 46 [main] perl 3488 fork: child + 3588 - died waiting for dll loading, errno11 + +See L +It helps if not too many DLLs are loaded in memory so the available address space is larger, +e.g. stopping the MS Internet Explorer might help. + +Use the perlrebase or rebase utilities to resolve the conflicting dll addresses. +The rebase package is included in the Cygwin setup. Use F +from L to install it. -=item * chown() +1. kill all perl processes and run C or -On WinNT chown() can change a file's user and group IDs. On Win9x chown() +2. kill all cygwin processes and services, start dash from cmd.exe and run C. + +=item * C + +On WinNT C can change a file's user and group IDs. On Win9x C is a no-op, although this is appropriate since there is no security model. =item * Miscellaneous -File locking using the C command to fcntl() is a stub that +File locking using the C command to C is a stub that returns C. -Win9x can not rename() an open file (although WinNT can). +Win9x can not C an open file (although WinNT can). -The Cygwin chroot() implementation has holes (it can not restrict file +The Cygwin C implementation has holes (it can not restrict file access by native Win32 programs). +Inplace editing C of files doesn't work without doing a backup +of the file being edited C because of windowish restrictions, +therefore Perl adds the suffix C<.bak> automatically if you use C +without specifying a backup extension. + +=back + +=head2 Prebuilt methods: + +=over 4 + +=item C + +Returns the current working directory. + +=item C + +Translates a cygwin pid to the corresponding Windows pid (which may or +may not be the same). + +=item C + +Translates a Windows pid to the corresponding cygwin pid (if any). + +=item C + +Translates a Windows path to the corresponding cygwin path respecting +the current mount points. With a second non-null argument returns an +absolute path. Double-byte characters will not be translated. + +=item C + +Translates a cygwin path to the corresponding cygwin path respecting +the current mount points. With a second non-null argument returns an +absolute path. Double-byte characters will not be translated. + +=item C + +Returns an array of [mnt_dir, mnt_fsname, mnt_type, mnt_opts]. + + perl -e 'for $i (Cygwin::mount_table) {print join(" ",@$i),"\n";}' + /bin c:\cygwin\bin system binmode,cygexec + /usr/bin c:\cygwin\bin system binmode + /usr/lib c:\cygwin\lib system binmode + / c:\cygwin system binmode + /cygdrive/c c: system binmode,noumount + /cygdrive/d d: system binmode,noumount + /cygdrive/e e: system binmode,noumount + +=item C + +Returns the mount type and flags for a specified mount point. +A comma-separated string of mntent->mnt_type (always +"system" or "user"), then the mntent->mnt_opts, where +the first is always "binmode" or "textmode". + + system|user,binmode|textmode,exec,cygexec,cygdrive,mixed, + notexec,managed,nosuid,devfs,proc,noumount + +If the argument is "/cygdrive", then just the volume mount settings, +and the cygdrive mount prefix are returned. + +User mounts override system mounts. + + $ perl -e 'print Cygwin::mount_flags "/usr/bin"' + system,binmode,cygexec + $ perl -e 'print Cygwin::mount_flags "/cygdrive"' + binmode,cygdrive,/cygdrive + +=item C + +Returns true if the given cygwin path is binary mounted, false if the +path is mounted in textmode. + +=item C + +Cygwin does not initialize all original Win32 environment variables. +See the bottom of this page L +for "Restricted Win32 environment". + +Certain Win32 programs called from cygwin programs might need some environment +variable, such as e.g. ADODB needs %COMMONPROGRAMFILES%. +Call Cygwin::sync_winenv() to copy all Win32 environment variables to your +process and note that cygwin will warn on every encounter of non-POSIX paths. + =back =head1 INSTALL PERL ON CYGWIN This will install Perl, including I pages. - make install | tee log.make-install + make install 2>&1 | tee log.make-install -NOTE: If C is redirected `C' will B prompt +NOTE: If C is redirected C will B prompt you to install I into F. -You may need to be I to run `C'. If you +You may need to be I to run C. If you are not, you must have write access to the directories in question. Information on installing the Perl documentation in HTML format can be @@ -486,92 +559,210 @@ be kept as clean as possible. =item Documentation - INSTALL README.cygwin README.win32 MANIFEST - Changes Changes5.005 Changes5.004 Changes5.6 - pod/perl.pod pod/perlport.pod pod/perlfaq3.pod - pod/perldelta.pod pod/perl5004delta.pod pod/perl56delta.pod - pod/perlhist.pod pod/perlmodlib.pod pod/buildtoc.PL pod/perltoc.pod + INSTALL README.cygwin README.win32 MANIFEST + pod/perl.pod pod/perlport.pod pod/perlfaq3.pod + pod/perldelta.pod pod/perl5004delta.pod pod/perl56delta.pod + pod/perl561delta.pod pod/perl570delta.pod pod/perl572delta.pod + pod/perl573delta.pod pod/perl58delta.pod pod/perl581delta.pod + pod/perl590delta.pod pod/perlhist.pod pod/perlmodlib.pod + pod/perltoc.pod Porting/Glossary pod/perlgit.pod + Porting/checkAUTHORS.pl + dist/Cwd/Changes ext/Compress-Raw-Zlib/Changes + dist/Time-HiRes/Changes + ext/Compress-Raw-Zlib/README ext/Compress-Zlib/Changes + ext/DB_File/Changes ext/Encode/Changes ext/Sys-Syslog/Changes + ext/Win32API-File/Changes + lib/ExtUtils/CBuilder/Changes lib/ExtUtils/Changes + lib/ExtUtils/NOTES lib/ExtUtils/PATCHING lib/ExtUtils/README + lib/Net/Ping/Changes lib/Test/Harness/Changes + lib/Term/ANSIColor/ChangeLog lib/Term/ANSIColor/README + README.symbian symbian/TODO =item Build, Configure, Make, Install - cygwin/Makefile.SHs - cygwin/ld2.in - cygwin/perlld.in - ext/IPC/SysV/hints/cygwin.pl - ext/NDBM_File/hints/cygwin.pl - ext/ODBM_File/hints/cygwin.pl - hints/cygwin.sh - Configure - help finding hints from uname, - shared libperl required for dynamic loading - Makefile.SH - linklibperl - Porting/patchls - cygwin in port list - installman - man pages with :: translated to . - installperl - install dll/ld2/perlld, install to pods - makedepend.SH - uwinfix + cygwin/Makefile.SHs + ext/IPC/SysV/hints/cygwin.pl + ext/NDBM_File/hints/cygwin.pl + ext/ODBM_File/hints/cygwin.pl + hints/cygwin.sh + Configure - help finding hints from uname, + shared libperl required for dynamic loading + Makefile.SH Cross/Makefile-cross-SH + - linklibperl + Porting/patchls - cygwin in port list + installman - man pages with :: translated to . + installperl - install dll, install to 'pods' + makedepend.SH - uwinfix + regen_lib.pl - file permissions + + NetWare/Makefile + plan9/mkfile + symbian/sanity.pl symbian/sisify.pl + hints/uwin.sh + vms/descrip_mms.template + win32/Makefile win32/makefile.mk =item Tests - t/io/tell.t - binmode - t/lib/b.t - ignore Cwd from os_extras - t/lib/glob-basic.t - Win32 directory list access differs from read mode - t/op/magic.t - $^X/symlink WORKAROUND, s/.exe// - t/op/stat.t - no /dev, skip Win32 ftCreationTime quirk - (cache manager sometimes preserves ctime of file - previously created and deleted), no -u (setuid) + t/io/fs.t - no file mode checks if not ntsec + skip rename() check when not + check_case:relaxed + t/io/tell.t - binmode + t/lib/cygwin.t - builtin cygwin function tests + t/op/groups.t - basegroup has ID = 0 + t/op/magic.t - $^X/symlink WORKAROUND, s/.exe// + t/op/stat.t - no /dev, skip Win32 ftCreationTime quirk + (cache manager sometimes preserves ctime of + file previously created and deleted), no -u + (setuid) + t/op/taint.t - can't use empty path under Cygwin Perl + t/op/time.t - no tzset() =item Compiled Perl Source - EXTERN.h - __declspec(dllimport) - XSUB.h - __declspec(dllexport) - cygwin/cygwin.c - os_extras (getcwd, spawn) - perl.c - os_extras - perl.h - binmode - doio.c - win9x can not rename a file when it is open - pp_sys.c - do not define h_errno, pp_system with spawn - util.c - use setenv + EXTERN.h - __declspec(dllimport) + XSUB.h - __declspec(dllexport) + cygwin/cygwin.c - os_extras (getcwd, spawn, and several + Cygwin:: functions) + perl.c - os_extras, -i.bak + perl.h - binmode + doio.c - win9x can not rename a file when it is open + pp_sys.c - do not define h_errno, init + _pwent_struct.pw_comment + util.c - use setenv + util.h - PERL_FILE_IS_ABSOLUTE macro + pp.c - Comment about Posix vs IEEE math under + Cygwin + perlio.c - CR/LF mode + perliol.c - Comment about EXTCONST under Cygwin =item Compiled Module Source - ext/POSIX/POSIX.xs - tzname defined externally - ext/SDBM_File/sdbm/pair.c - - EXTCONST needs to be redefined from EXTERN.h - ext/SDBM_File/sdbm/sdbm.c - - binary open + ext/Compress-Raw-Zlib/Makefile.PL + - Can't install via CPAN shell under Cygwin + ext/Compress-Raw-Zlib/zlib-src/zutil.h + - Cygwin is Unix-like and has vsnprintf + ext/Errno/Errno_pm.PL - Special handling for Win32 Perl under + Cygwin + ext/POSIX/POSIX.xs - tzname defined externally + ext/SDBM_File/sdbm/pair.c + - EXTCONST needs to be redefined from + EXTERN.h + ext/SDBM_File/sdbm/sdbm.c + - binary open + ext/Sys/Syslog/Syslog.xs + - Cygwin has syslog.h + ext/Sys/Syslog/win32/compile.pl + - Convert paths to Windows paths + ext/Time-HiRes/HiRes.xs + - Various timers not available + ext/Time-HiRes/Makefile.PL + - Find w32api/windows.h + ext/Win32/Makefile.PL - Use various libraries under Cygwin + ext/Win32/Win32.xs - Child dir and child env under Cygwin + ext/Win32API-File/File.xs + - _open_osfhandle not implemented under + Cygwin + ext/Win32CORE/Win32CORE.c + - __declspec(dllexport) =item Perl Modules/Scripts - lib/Cwd.pm - hook to internal Cwd::cwd - lib/ExtUtils/MakeMaker.pm - - require MM_Cygwin.pm - lib/ExtUtils/MM_Cygwin.pm - - canonpath, cflags, manifypods, perl_archive - lib/File/Find.pm - on remote drives stat() always sets st_nlink to 1 - lib/File/Spec/Unix.pm - preserve //unc - lib/File/Temp.pm - no directory sticky bit - lib/perl5db.pl - use stdin not /dev/tty - utils/perldoc.PL - version comment + ext/B/t/OptreeCheck.pm - Comment about stderr/stdout order under + Cygwin + ext/Digest-SHA/bin/shasum + - Use binary mode under Cygwin + ext/Sys/Syslog/win32/Win32.pm + - Convert paths to Windows paths + ext/Time-HiRes/HiRes.pm + - Comment about various timers not available + ext/Win32API-File/File.pm + - _open_osfhandle not implemented under + Cygwin + ext/Win32CORE/Win32CORE.pm + - History of Win32CORE under Cygwin + lib/Cwd.pm - hook to internal Cwd::cwd + lib/ExtUtils/CBuilder/Platform/cygwin.pm + - use gcc for ld, and link to libperl.dll.a + lib/ExtUtils/CBuilder.pm + - Cygwin is Unix-like + lib/ExtUtils/Install.pm - Install and rename issues under Cygwin + lib/ExtUtils/MM.pm - OS classifications + lib/ExtUtils/MM_Any.pm - Example for Cygwin + lib/ExtUtils/MakeMaker.pm + - require MM_Cygwin.pm + lib/ExtUtils/MM_Cygwin.pm + - canonpath, cflags, manifypods, perl_archive + lib/File/Fetch.pm - Comment about quotes using a Cygwin example + lib/File/Find.pm - on remote drives stat() always sets + st_nlink to 1 + lib/File/Spec/Cygwin.pm - case_tolerant + lib/File/Spec/Unix.pm - preserve //unc + lib/File/Spec/Win32.pm - References a message on cygwin.com + lib/File/Spec.pm - Pulls in lib/File/Spec/Cygwin.pm + lib/File/Temp.pm - no directory sticky bit + lib/Module/CoreList.pm - List of all module files and versions + lib/Net/Domain.pm - No domainname command under Cygwin + lib/Net/Netrc.pm - Bypass using stat() under Cygwin + lib/Net/Ping.pm - ECONREFUSED is EAGAIN under Cygwin + lib/Pod/Find.pm - Set 'pods' dir + lib/Pod/Perldoc/ToMan.pm - '-c' switch for pod2man + lib/Pod/Perldoc.pm - Use 'less' pager, and use .exe extension + lib/Term/ANSIColor.pm - Cygwin terminal info + lib/perl5db.pl - use stdin not /dev/tty + utils/perlbug.PL - Add CYGWIN environment variable to report + +=item Perl Module Tests + + dist/Cwd/t/cwd.t + ext/Compress-Zlib/t/14gzopen.t + ext/DB_File/t/db-btree.t + ext/DB_File/t/db-hash.t + ext/DB_File/t/db-recno.t + ext/DynaLoader/t/DynaLoader.t + ext/File-Glob/t/basic.t + ext/GDBM_File/t/gdbm.t + ext/POSIX/t/sysconf.t + ext/POSIX/t/time.t + ext/SDBM_File/t/sdbm.t + ext/Sys/Syslog/t/syslog.t + ext/Time-HiRes/t/HiRes.t + ext/Win32/t/Unicode.t + ext/Win32API-File/t/file.t + ext/Win32CORE/t/win32core.t + lib/AnyDBM_File.t + lib/Archive/Extract/t/01_Archive-Extract.t + lib/Archive/Tar/t/02_methods.t + lib/ExtUtils/t/Embed.t + lib/ExtUtils/t/eu_command.t + lib/ExtUtils/t/MM_Cygwin.t + lib/ExtUtils/t/MM_Unix.t + lib/File/Compare.t + lib/File/Copy.t + lib/File/Find/t/find.t + lib/File/Path.t + lib/File/Spec/t/crossplatform.t + lib/File/Spec/t/Spec.t + lib/Net/hostent.t + lib/Net/Ping/t/110_icmp_inst.t + lib/Net/Ping/t/500_ping_icmp.t + lib/Net/t/netrc.t + lib/Pod/Simple/t/perlcyg.pod + lib/Pod/Simple/t/perlcygo.txt + lib/Pod/Simple/t/perlfaq.pod + lib/Pod/Simple/t/perlfaqo.txt + lib/User/grent.t + lib/User/pwent.t =back =head1 BUGS ON CYGWIN -When I starts, it warns about overriding commands for F. - -`C' does not remove library F<.def> or F<.exe.stackdump> -files. - -The I script contains references to the source directory. You should -change these to $installbin after `C'. - Support for swapping real and effective user and group IDs is incomplete. -On WinNT Cygwin provides setuid(), seteuid(), setgid() and setegid(). +On WinNT Cygwin provides C, C, C and C. However, additional Cygwin calls for manipulating WinNT access tokens and security contexts are required. -When building DLLs, `C' is used to export -global symbols. It might be better to generate an explicit F<.def> file -(see F). Also, DLLs can now be build with `C'. - =head1 AUTHORS Charles Wilson , @@ -579,8 +770,12 @@ Eric Fifer , alexander smishlajev , Steven Morlock , Sebastien Barre , -Teun Burgers . +Teun Burgers , +Gerrit P. Haase , +Reini Urban , +Jan Dubois , +Jerry D. Hedden . =head1 HISTORY -Last updated: 9 November 2000 +Last updated: 2012-02-08