This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
op.h: Move some flag bits down
[perl5.git] / README.cygwin
index 388dc1a..5885ac5 100644 (file)
@@ -27,7 +27,7 @@ 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:
 
-L<http://www.cygwin.com/>
+L<https://www.cygwin.com/>
 
 A recent net or commercial release of Cygwin is required.
 
@@ -83,7 +83,8 @@ 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 g++ 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
 
@@ -107,6 +108,9 @@ DES crypt port by Corinna Vinschen.
 
 Alternatively, the crypt libraries in GNU libc have been ported to Cygwin.
 
+As of libcrypt 1.3 (March 2016), you will need to install the
+libcrypt-devel package for Configure to detect crypt().
+
 =item * C<-lgdbm_compat> (C<use GDBM_File>)
 
 GDBM is available for Cygwin.
@@ -208,12 +212,13 @@ You may see some messages during Configure that seem suspicious.
 Win9x does not correctly report C<EOF> 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.
@@ -404,22 +409,23 @@ Using C<fork()> or C<system()> 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)
+ 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
+ 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<http://cygwin.com/faq/faq-nochunks.html#faq.using.fixing-fork-failures>
+See L<https://cygwin.com/faq/faq-nochunks.html#faq.using.fixing-fork-failures>
 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<setup.exe>
-from L<http://www.cygwin.com/setup.exe> to install it.
+from L<https://cygwin.com/install.html> to install it.
 
 1. kill all perl processes and run C<perlrebase> or
 
@@ -517,7 +523,7 @@ path is mounted in textmode.
 =item C<Cygwin::sync_winenv>
 
 Cygwin does not initialize all original Win32 environment variables.
-See the bottom of this page L<http://cygwin.com/cygwin-ug-net/setup-env.html>
+See the bottom of this page L<https://cygwin.com/cygwin-ug-net/setup-env.html>
 for "Restricted Win32 environment".
 
 Certain Win32 programs called from cygwin programs might need some environment
@@ -562,14 +568,15 @@ be kept as clean as possible.
  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/Time-HiRes/Changes ext/Win32API-File/Changes
- lib/ExtUtils/CBuilder/Changes lib/ExtUtils/Changes lib/ExtUtils/NOTES
- lib/ExtUtils/PATCHING lib/ExtUtils/README
+ 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
+ lib/Term/ANSIColor/ChangeLog lib/Term/ANSIColor/README
README.symbian symbian/TODO
 
 =item Build, Configure, Make, Install
 
@@ -598,14 +605,16 @@ be kept as clean as possible.
 =item Tests
 
  t/io/fs.t             - no file mode checks if not ntsec
-                         skip rename() check when not check_case:relaxed
+                         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)
+                         (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()
 
@@ -613,14 +622,17 @@ be kept as clean as possible.
 
  EXTERN.h              - __declspec(dllimport)
  XSUB.h                - __declspec(dllexport)
- cygwin/cygwin.c       - os_extras (getcwd, spawn, and several Cygwin:: functions)
+ 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
+ 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
+ pp.c                  - Comment about Posix vs IEEE math under
+                         Cygwin
  perlio.c              - CR/LF mode
  perliol.c             - Comment about EXTCONST under Cygwin
 
@@ -630,10 +642,12 @@ be kept as clean as possible.
                        - 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/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
+                       - EXTCONST needs to be redefined from
+                         EXTERN.h
  ext/SDBM_File/sdbm/sdbm.c
                        - binary open
  ext/Sys/Syslog/Syslog.xs
@@ -647,13 +661,15 @@ be kept as clean as possible.
  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
+                       - _open_osfhandle not implemented under
+                         Cygwin
  ext/Win32CORE/Win32CORE.c
                        - __declspec(dllexport)
 
 =item Perl Modules/Scripts
 
- ext/B/t/OptreeCheck.pm - Comment about stderr/stdout order under Cygwin
+ 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
@@ -661,7 +677,8 @@ be kept as clean as possible.
  ext/Time-HiRes/HiRes.pm
                        - Comment about various timers not available
  ext/Win32API-File/File.pm
-                       - _open_osfhandle not implemented under Cygwin
+                       - _open_osfhandle not implemented under
+                         Cygwin
  ext/Win32CORE/Win32CORE.pm
                        - History of Win32CORE under Cygwin
  lib/Cwd.pm            - hook to internal Cwd::cwd
@@ -677,7 +694,8 @@ be kept as clean as possible.
  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/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