1PERLCYGWIN(1)          Perl Programmers Reference Guide          PERLCYGWIN(1)
2
3
4

NAME

6       perlcygwin - Perl for Cygwin
7

SYNOPSIS

9       This document will help you configure, make, test and install Perl on
10       Cygwin.  This document also describes features of Cygwin that will
11       affect how Perl behaves at runtime.
12
13       NOTE: There are pre-built Perl packages available for Cygwin and a
14       version of Perl is provided in the normal Cygwin install.  If you do
15       not need to customize the configuration, consider using one of those
16       packages.
17

PREREQUISITES FOR COMPILING PERL ON CYGWIN

19   Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
20       The Cygwin tools are ports of the popular GNU development tools for
21       Win32 platforms.  They run thanks to the Cygwin library which provides
22       the UNIX system calls and environment these programs expect.  More
23       information about this project can be found at:
24
25       <http://www.cygwin.com/>
26
27       A recent net or commercial release of Cygwin is required.
28
29       At the time this document was last updated, Cygwin 1.7.16 was current.
30
31   Cygwin Configuration
32       While building Perl some changes may be necessary to your Cygwin setup
33       so that Perl builds cleanly.  These changes are not required for normal
34       Perl usage.
35
36       NOTE: The binaries that are built will run on all Win32 versions.  They
37       do not depend on your host system (WinXP/Win2K/Win7) or your Cygwin
38       configuration (binary/text mounts, cvgserver).  The only dependencies
39       come from hard-coded pathnames like /usr/local.  However, your host
40       system and Cygwin configuration will affect Perl's runtime behavior
41       (see "TEST").
42
43       ·   "PATH"
44
45           Set the "PATH" environment variable so that Configure finds the
46           Cygwin versions of programs. Any not-needed Windows directories
47           should be removed or moved to the end of your "PATH".
48
49       ·   nroff
50
51           If you do not have nroff (which is part of the groff package),
52           Configure will not prompt you to install man pages.
53

CONFIGURE PERL ON CYGWIN

55       The default options gathered by Configure with the assistance of
56       hints/cygwin.sh will build a Perl that supports dynamic loading (which
57       requires a shared cygperl5_16.dll).
58
59       This will run Configure and keep a record:
60
61         ./Configure 2>&1 | tee log.configure
62
63       If you are willing to accept all the defaults run Configure with -de.
64       However, several useful customizations are available.
65
66   Stripping Perl Binaries on Cygwin
67       It is possible to strip the EXEs and DLLs created by the build process.
68       The resulting binaries will be significantly smaller.  If you want the
69       binaries to be stripped, you can either add a -s option when Configure
70       prompts you,
71
72         Any additional ld flags (NOT including libraries)? [none] -s
73         Any special flags to pass to g++ to create a dynamically loaded
74         library?
75         [none] -s
76         Any special flags to pass to gcc to use dynamic linking? [none] -s
77
78       or you can edit hints/cygwin.sh and uncomment the relevant variables
79       near the end of the file.
80
81   Optional Libraries for Perl on Cygwin
82       Several Perl functions and modules depend on the existence of some
83       optional libraries.  Configure will find them if they are installed in
84       one of the directories listed as being used for library searches.  Pre-
85       built packages for most of these are available from the Cygwin
86       installer.
87
88       ·   "-lcrypt"
89
90           The crypt package distributed with Cygwin is a Linux compatible
91           56-bit DES crypt port by Corinna Vinschen.
92
93           Alternatively, the crypt libraries in GNU libc have been ported to
94           Cygwin.
95
96           As of libcrypt 1.3 (March 2016), you will need to install the
97           libcrypt-devel package for Configure to detect crypt().
98
99       ·   "-lgdbm_compat" ("use GDBM_File")
100
101           GDBM is available for Cygwin.
102
103           NOTE: The GDBM library only works on NTFS partitions.
104
105       ·   "-ldb" ("use DB_File")
106
107           BerkeleyDB is available for Cygwin.
108
109           NOTE: The BerkeleyDB library only completely works on NTFS
110           partitions.
111
112       ·   "cygserver" ("use IPC::SysV")
113
114           A port of SysV IPC is available for Cygwin.
115
116           NOTE: This has not been extensively tested.  In particular,
117           "d_semctl_semun" is undefined because it fails a Configure test and
118           on Win9x the shm*() functions seem to hang.  It also creates a
119           compile time dependency because perl.h includes <sys/ipc.h> and
120           <sys/sem.h> (which will be required in the future when compiling
121           CPAN modules). CURRENTLY NOT SUPPORTED!
122
123       ·   "-lutil"
124
125           Included with the standard Cygwin netrelease is the inetutils
126           package which includes libutil.a.
127
128   Configure-time Options for Perl on Cygwin
129       The INSTALL document describes several Configure-time options.  Some of
130       these will work with Cygwin, others are not yet possible.  Also, some
131       of these are experimental.  You can either select an option when
132       Configure prompts you or you can define (undefine) symbols on the
133       command line.
134
135       ·   "-Uusedl"
136
137           Undefining this symbol forces Perl to be compiled statically.
138
139       ·   "-Dusemymalloc"
140
141           By default Perl does not use the "malloc()" included with the Perl
142           source, because it was slower and not entirely thread-safe.  If you
143           want to force Perl to build with the old -Dusemymalloc define this.
144
145       ·   "-Uuseperlio"
146
147           Undefining this symbol disables the PerlIO abstraction.  PerlIO is
148           now the default; it is not recommended to disable PerlIO.
149
150       ·   "-Dusemultiplicity"
151
152           Multiplicity is required when embedding Perl in a C program and
153           using more than one interpreter instance.  This is only required
154           when you build a not-threaded perl with "-Uuseithreads".
155
156       ·   "-Uuse64bitint"
157
158           By default Perl uses 64 bit integers.  If you want to use smaller
159           32 bit integers, define this symbol.
160
161       ·   "-Duselongdouble"
162
163           gcc supports long doubles (12 bytes).  However, several additional
164           long double math functions are necessary to use them within Perl
165           ({atan2, cos, exp, floor, fmod, frexp, isnan, log, modf, pow, sin,
166           sqrt}l, strtold).  These are not yet available with newlib, the
167           Cygwin libc.
168
169       ·   "-Uuseithreads"
170
171           Define this symbol if you want not-threaded faster perl.
172
173       ·   "-Duselargefiles"
174
175           Cygwin uses 64-bit integers for internal size and position
176           calculations, this will be correctly detected and defined by
177           Configure.
178
179       ·   "-Dmksymlinks"
180
181           Use this to build perl outside of the source tree.  Details can be
182           found in the INSTALL document.  This is the recommended way to
183           build perl from sources.
184
185   Suspicious Warnings on Cygwin
186       You may see some messages during Configure that seem suspicious.
187
188       ·   Win9x and "d_eofnblk"
189
190           Win9x does not correctly report "EOF" with a non-blocking read on a
191           closed pipe.  You will see the following messages:
192
193            But it also returns -1 to signal EOF, so be careful!
194            WARNING: you can't distinguish between EOF and no data!
195
196            *** WHOA THERE!!! ***
197                The recommended value for $d_eofnblk on this machine was
198                "define"!
199                Keep the recommended value? [y]
200
201           At least for consistency with WinNT, you should keep the
202           recommended value.
203
204       ·   Compiler/Preprocessor defines
205
206           The following error occurs because of the Cygwin "#define" of
207           "_LONG_DOUBLE":
208
209             Guessing which symbols your C compiler and preprocessor define...
210             try.c:<line#>: missing binary operator
211
212           This failure does not seem to cause any problems.  With older gcc
213           versions, "parse error" is reported instead of "missing binary
214           operator".
215

MAKE ON CYGWIN

217       Simply run make and wait:
218
219         make 2>&1 | tee log.make
220

TEST ON CYGWIN

222       There are two steps to running the test suite:
223
224         make test 2>&1 | tee log.make-test
225
226         cd t; ./perl harness 2>&1 | tee ../log.harness
227
228       The same tests are run both times, but more information is provided
229       when running as "./perl harness".
230
231       Test results vary depending on your host system and your Cygwin
232       configuration.  If a test can pass in some Cygwin setup, it is always
233       attempted and explainable test failures are documented.  It is possible
234       for Perl to pass all the tests, but it is more likely that some tests
235       will fail for one of the reasons listed below.
236
237   File Permissions on Cygwin
238       UNIX file permissions are based on sets of mode bits for
239       {read,write,execute} for each {user,group,other}.  By default Cygwin
240       only tracks the Win32 read-only attribute represented as the UNIX file
241       user write bit (files are always readable, files are executable if they
242       have a .{com,bat,exe} extension or begin with "#!", directories are
243       always readable and executable).  On WinNT with the ntea "CYGWIN"
244       setting, the additional mode bits are stored as extended file
245       attributes.  On WinNT with the default ntsec "CYGWIN" setting,
246       permissions use the standard WinNT security descriptors and access
247       control lists. Without one of these options, these tests will fail
248       (listing not updated yet):
249
250         Failed Test           List of failed
251         ------------------------------------
252         io/fs.t               5, 7, 9-10
253         lib/anydbm.t          2
254         lib/db-btree.t        20
255         lib/db-hash.t         16
256         lib/db-recno.t        18
257         lib/gdbm.t            2
258         lib/ndbm.t            2
259         lib/odbm.t            2
260         lib/sdbm.t            2
261         op/stat.t             9, 20 (.tmp not an executable extension)
262
263   NDBM_File and ODBM_File do not work on FAT filesystems
264       Do not use NDBM_File or ODBM_File on FAT filesystem.  They can be built
265       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
274       If you intend to run only on FAT (or if using AnyDBM_File on FAT), run
275       Configure with the -Ui_ndbm and -Ui_dbm options to prevent NDBM_File
276       and ODBM_File being built.
277
278       With NTFS (and no CYGWIN=nontsec), there should be no problems even if
279       perl was built on FAT.
280
281   "fork()" failures in io_* tests
282       A "fork()" failure may result in the following tests failing:
283
284         ext/IO/lib/IO/t/io_multihomed.t
285         ext/IO/lib/IO/t/io_sock.t
286         ext/IO/lib/IO/t/io_unix.t
287
288       See comment on fork in "Miscellaneous" below.
289

Specific features of the Cygwin port

291   Script Portability on Cygwin
292       Cygwin does an outstanding job of providing UNIX-like semantics on top
293       of Win32 systems.  However, in addition to the items noted above, there
294       are some differences that you should know about.  This is a very brief
295       guide to portability, more information can be found in the Cygwin
296       documentation.
297
298       ·   Pathnames
299
300           Cygwin pathnames are separated by forward (/) slashes, Universal
301           Naming Codes (//UNC) are also supported Since cygwin-1.7 non-POSIX
302           pathnames are discouraged.  Names may contain all printable
303           characters.
304
305           File names are case insensitive, but case preserving.  A pathname
306           that contains a backslash or drive letter is a Win32 pathname, and
307           not subject to the translations applied to POSIX style pathnames,
308           but cygwin will warn you, so better convert them to POSIX.
309
310           For conversion we have "Cygwin::win_to_posix_path()" and
311           "Cygwin::posix_to_win_path()".
312
313           Since cygwin-1.7 pathnames are UTF-8 encoded.
314
315       ·   Text/Binary
316
317           Since cygwin-1.7 textmounts are deprecated and strongly
318           discouraged.
319
320           When a file is opened it is in either text or binary mode.  In text
321           mode a file is subject to CR/LF/Ctrl-Z translations.  With Cygwin,
322           the default mode for an "open()" is determined by the mode of the
323           mount that underlies the file. See "Cygwin::is_binmount"(). Perl
324           provides a "binmode()" function to set binary mode on files that
325           otherwise would be treated as text.  "sysopen()" with the "O_TEXT"
326           flag sets text mode on files that otherwise would be treated as
327           binary:
328
329               sysopen(FOO, "bar", O_WRONLY|O_CREAT|O_TEXT)
330
331           "lseek()", "tell()" and "sysseek()" only work with files opened in
332           binary mode.
333
334           The text/binary issue is covered at length in the Cygwin
335           documentation.
336
337       ·   PerlIO
338
339           PerlIO overrides the default Cygwin Text/Binary behaviour.  A file
340           will always be treated as binary, regardless of the mode of the
341           mount it lives on, just like it is in UNIX.  So CR/LF translation
342           needs to be requested in either the "open()" call like this:
343
344             open(FH, ">:crlf", "out.txt");
345
346           which will do conversion from LF to CR/LF on the output, or in the
347           environment settings (add this to your .bashrc):
348
349             export PERLIO=crlf
350
351           which will pull in the crlf PerlIO layer which does LF -> CRLF
352           conversion on every output generated by perl.
353
354       ·   .exe
355
356           The Cygwin "stat()", "lstat()" and "readlink()" functions make the
357           .exe extension transparent by looking for foo.exe when you ask for
358           foo (unless a foo also exists).  Cygwin does not require a .exe
359           extension, but gcc adds it automatically when building a program.
360           However, when accessing an executable as a normal file (e.g., cp in
361           a makefile) the .exe is not transparent.  The install program
362           included with Cygwin automatically appends a .exe when necessary.
363
364       ·   Cygwin vs. Windows process ids
365
366           Cygwin processes have their own pid, which is different from the
367           underlying windows pid.  Most posix compliant Proc functions expect
368           the cygwin pid, but several Win32::Process functions expect the
369           winpid. E.g. $$ is the cygwin pid of /usr/bin/perl, which is not
370           the winpid.  Use "Cygwin::pid_to_winpid()" and
371           "Cygwin::winpid_to_pid()" to translate between them.
372
373       ·   Cygwin vs. Windows errors
374
375           Under Cygwin, $^E is the same as $!.  When using Win32 API
376           Functions, use "Win32::GetLastError()" to get the last Windows
377           error.
378
379       ·   rebase errors on fork or system
380
381           Using "fork()" or "system()" out to another perl after loading
382           multiple dlls may result on a DLL baseaddress conflict. The
383           internal cygwin error looks like like the following:
384
385            0 [main] perl 8916 child_info_fork::abort: data segment start:
386            parent (0xC1A000) != child(0xA6A000)
387
388           or:
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
395           See
396           <http://cygwin.com/faq/faq-nochunks.html#faq.using.fixing-fork-failures>
397           It helps if not too many DLLs are loaded in memory so the available
398           address space is larger, e.g. stopping the MS Internet Explorer
399           might help.
400
401           Use the perlrebase or rebase utilities to resolve the conflicting
402           dll addresses.  The rebase package is included in the Cygwin setup.
403           Use setup.exe from <http://www.cygwin.com/setup.exe> to install it.
404
405           1. kill all perl processes and run "perlrebase" or
406
407           2. kill all cygwin processes and services, start dash from cmd.exe
408           and run "rebaseall".
409
410       ·   "chown()"
411
412           On WinNT "chown()" can change a file's user and group IDs.  On
413           Win9x "chown()" is a no-op, although this is appropriate since
414           there is no security model.
415
416       ·   Miscellaneous
417
418           File locking using the "F_GETLK" command to "fcntl()" is a stub
419           that returns "ENOSYS".
420
421           Win9x can not "rename()" an open file (although WinNT can).
422
423           The Cygwin "chroot()" implementation has holes (it can not restrict
424           file access by native Win32 programs).
425
426           Inplace editing "perl -i" of files doesn't work without doing a
427           backup of the file being edited "perl -i.bak" because of windowish
428           restrictions, therefore Perl adds the suffix ".bak" automatically
429           if you use "perl -i" without specifying a backup extension.
430
431   Prebuilt methods:
432       "Cwd::cwd"
433           Returns the current working directory.
434
435       "Cygwin::pid_to_winpid"
436           Translates a cygwin pid to the corresponding Windows pid (which may
437           or may not be the same).
438
439       "Cygwin::winpid_to_pid"
440           Translates a Windows pid to the corresponding cygwin pid (if any).
441
442       "Cygwin::win_to_posix_path"
443           Translates a Windows path to the corresponding cygwin path
444           respecting the current mount points. With a second non-null
445           argument returns an absolute path. Double-byte characters will not
446           be translated.
447
448       "Cygwin::posix_to_win_path"
449           Translates a cygwin path to the corresponding cygwin path
450           respecting the current mount points. With a second non-null
451           argument returns an absolute path. Double-byte characters will not
452           be translated.
453
454       "Cygwin::mount_table()"
455           Returns an array of [mnt_dir, mnt_fsname, mnt_type, mnt_opts].
456
457             perl -e 'for $i (Cygwin::mount_table) {print join(" ",@$i),"\n";}'
458             /bin c:\cygwin\bin system binmode,cygexec
459             /usr/bin c:\cygwin\bin system binmode
460             /usr/lib c:\cygwin\lib system binmode
461             / c:\cygwin system binmode
462             /cygdrive/c c: system binmode,noumount
463             /cygdrive/d d: system binmode,noumount
464             /cygdrive/e e: system binmode,noumount
465
466       "Cygwin::mount_flags"
467           Returns the mount type and flags for a specified mount point.  A
468           comma-separated string of mntent->mnt_type (always "system" or
469           "user"), then the mntent->mnt_opts, where the first is always
470           "binmode" or "textmode".
471
472             system|user,binmode|textmode,exec,cygexec,cygdrive,mixed,
473             notexec,managed,nosuid,devfs,proc,noumount
474
475           If the argument is "/cygdrive", then just the volume mount
476           settings, and the cygdrive mount prefix are returned.
477
478           User 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       "Cygwin::is_binmount"
486           Returns true if the given cygwin path is binary mounted, false if
487           the path is mounted in textmode.
488
489       "Cygwin::sync_winenv"
490           Cygwin does not initialize all original Win32 environment
491           variables.  See the bottom of this page
492           <http://cygwin.com/cygwin-ug-net/setup-env.html> for "Restricted
493           Win32 environment".
494
495           Certain Win32 programs called from cygwin programs might need some
496           environment variable, such as e.g. ADODB needs
497           %COMMONPROGRAMFILES%.  Call Cygwin::sync_winenv() to copy all Win32
498           environment variables to your process and note that cygwin will
499           warn on every encounter of non-POSIX paths.
500

INSTALL PERL ON CYGWIN

502       This will install Perl, including man pages.
503
504         make install 2>&1 | tee log.make-install
505
506       NOTE: If "STDERR" is redirected "make install" will not prompt you to
507       install perl into /usr/bin.
508
509       You may need to be Administrator to run "make install".  If you are
510       not, you must have write access to the directories in question.
511
512       Information on installing the Perl documentation in HTML format can be
513       found in the INSTALL document.
514

MANIFEST ON CYGWIN

516       These are the files in the Perl release that contain references to
517       Cygwin.  These very brief notes attempt to explain the reason for all
518       conditional code.  Hopefully, keeping this up to date will allow the
519       Cygwin port to be kept as clean as possible.
520
521       Documentation
522            INSTALL README.cygwin README.win32 MANIFEST
523            pod/perl.pod pod/perlport.pod pod/perlfaq3.pod
524            pod/perldelta.pod pod/perl5004delta.pod pod/perl56delta.pod
525            pod/perl561delta.pod pod/perl570delta.pod pod/perl572delta.pod
526            pod/perl573delta.pod pod/perl58delta.pod pod/perl581delta.pod
527            pod/perl590delta.pod pod/perlhist.pod pod/perlmodlib.pod
528            pod/perltoc.pod Porting/Glossary pod/perlgit.pod
529            Porting/checkAUTHORS.pl
530            dist/Cwd/Changes ext/Compress-Raw-Zlib/Changes
531            dist/Time-HiRes/Changes
532            ext/Compress-Raw-Zlib/README ext/Compress-Zlib/Changes
533            ext/DB_File/Changes ext/Encode/Changes ext/Sys-Syslog/Changes
534            ext/Win32API-File/Changes
535            lib/ExtUtils/CBuilder/Changes lib/ExtUtils/Changes
536            lib/ExtUtils/NOTES lib/ExtUtils/PATCHING lib/ExtUtils/README
537            lib/Net/Ping/Changes lib/Test/Harness/Changes
538            lib/Term/ANSIColor/ChangeLog lib/Term/ANSIColor/README
539            README.symbian symbian/TODO
540
541       Build, Configure, Make, Install
542            cygwin/Makefile.SHs
543            ext/IPC/SysV/hints/cygwin.pl
544            ext/NDBM_File/hints/cygwin.pl
545            ext/ODBM_File/hints/cygwin.pl
546            hints/cygwin.sh
547            Configure             - help finding hints from uname,
548                                    shared libperl required for dynamic loading
549            Makefile.SH Cross/Makefile-cross-SH
550                                  - linklibperl
551            Porting/patchls       - cygwin in port list
552            installman            - man pages with :: translated to .
553            installperl           - install dll, install to 'pods'
554            makedepend.SH         - uwinfix
555            regen_lib.pl          - file permissions
556
557            NetWare/Makefile
558            plan9/mkfile
559            symbian/sanity.pl symbian/sisify.pl
560            hints/uwin.sh
561            vms/descrip_mms.template
562            win32/Makefile win32/makefile.mk
563
564       Tests
565            t/io/fs.t             - no file mode checks if not ntsec
566                                    skip rename() check when not
567                                    check_case:relaxed
568            t/io/tell.t           - binmode
569            t/lib/cygwin.t        - builtin cygwin function tests
570            t/op/groups.t         - basegroup has ID = 0
571            t/op/magic.t          - $^X/symlink WORKAROUND, s/.exe//
572            t/op/stat.t           - no /dev, skip Win32 ftCreationTime quirk
573                                    (cache manager sometimes preserves ctime of
574                                    file previously created and deleted), no -u
575                                    (setuid)
576            t/op/taint.t          - can't use empty path under Cygwin Perl
577            t/op/time.t           - no tzset()
578
579       Compiled Perl Source
580            EXTERN.h              - __declspec(dllimport)
581            XSUB.h                - __declspec(dllexport)
582            cygwin/cygwin.c       - os_extras (getcwd, spawn, and several
583                                    Cygwin:: functions)
584            perl.c                - os_extras, -i.bak
585            perl.h                - binmode
586            doio.c                - win9x can not rename a file when it is open
587            pp_sys.c              - do not define h_errno, init
588                                    _pwent_struct.pw_comment
589            util.c                - use setenv
590            util.h                - PERL_FILE_IS_ABSOLUTE macro
591            pp.c                  - Comment about Posix vs IEEE math under
592                                    Cygwin
593            perlio.c              - CR/LF mode
594            perliol.c             - Comment about EXTCONST under Cygwin
595
596       Compiled Module Source
597            ext/Compress-Raw-Zlib/Makefile.PL
598                                  - Can't install via CPAN shell under Cygwin
599            ext/Compress-Raw-Zlib/zlib-src/zutil.h
600                                  - Cygwin is Unix-like and has vsnprintf
601            ext/Errno/Errno_pm.PL - Special handling for Win32 Perl under
602                                    Cygwin
603            ext/POSIX/POSIX.xs    - tzname defined externally
604            ext/SDBM_File/sdbm/pair.c
605                                  - EXTCONST needs to be redefined from
606                                    EXTERN.h
607            ext/SDBM_File/sdbm/sdbm.c
608                                  - binary open
609            ext/Sys/Syslog/Syslog.xs
610                                  - Cygwin has syslog.h
611            ext/Sys/Syslog/win32/compile.pl
612                                  - Convert paths to Windows paths
613            ext/Time-HiRes/HiRes.xs
614                                  - Various timers not available
615            ext/Time-HiRes/Makefile.PL
616                                  - Find w32api/windows.h
617            ext/Win32/Makefile.PL - Use various libraries under Cygwin
618            ext/Win32/Win32.xs    - Child dir and child env under Cygwin
619            ext/Win32API-File/File.xs
620                                  - _open_osfhandle not implemented under
621                                    Cygwin
622            ext/Win32CORE/Win32CORE.c
623                                  - __declspec(dllexport)
624
625       Perl Modules/Scripts
626            ext/B/t/OptreeCheck.pm - Comment about stderr/stdout order under
627                                     Cygwin
628            ext/Digest-SHA/bin/shasum
629                                  - Use binary mode under Cygwin
630            ext/Sys/Syslog/win32/Win32.pm
631                                  - Convert paths to Windows paths
632            ext/Time-HiRes/HiRes.pm
633                                  - Comment about various timers not available
634            ext/Win32API-File/File.pm
635                                  - _open_osfhandle not implemented under
636                                    Cygwin
637            ext/Win32CORE/Win32CORE.pm
638                                  - History of Win32CORE under Cygwin
639            lib/Cwd.pm            - hook to internal Cwd::cwd
640            lib/ExtUtils/CBuilder/Platform/cygwin.pm
641                                  - use gcc for ld, and link to libperl.dll.a
642            lib/ExtUtils/CBuilder.pm
643                                  - Cygwin is Unix-like
644            lib/ExtUtils/Install.pm - Install and rename issues under Cygwin
645            lib/ExtUtils/MM.pm    - OS classifications
646            lib/ExtUtils/MM_Any.pm - Example for Cygwin
647            lib/ExtUtils/MakeMaker.pm
648                                  - require MM_Cygwin.pm
649            lib/ExtUtils/MM_Cygwin.pm
650                                  - canonpath, cflags, manifypods, perl_archive
651            lib/File/Fetch.pm     - Comment about quotes using a Cygwin example
652            lib/File/Find.pm      - on remote drives stat() always sets
653                                    st_nlink to 1
654            lib/File/Spec/Cygwin.pm - case_tolerant
655            lib/File/Spec/Unix.pm - preserve //unc
656            lib/File/Spec/Win32.pm - References a message on cygwin.com
657            lib/File/Spec.pm      - Pulls in lib/File/Spec/Cygwin.pm
658            lib/File/Temp.pm      - no directory sticky bit
659            lib/Module/CoreList.pm - List of all module files and versions
660            lib/Net/Domain.pm     - No domainname command under Cygwin
661            lib/Net/Netrc.pm      - Bypass using stat() under Cygwin
662            lib/Net/Ping.pm       - ECONREFUSED is EAGAIN under Cygwin
663            lib/Pod/Find.pm       - Set 'pods' dir
664            lib/Pod/Perldoc/ToMan.pm - '-c' switch for pod2man
665            lib/Pod/Perldoc.pm    - Use 'less' pager, and use .exe extension
666            lib/Term/ANSIColor.pm - Cygwin terminal info
667            lib/perl5db.pl        - use stdin not /dev/tty
668            utils/perlbug.PL      - Add CYGWIN environment variable to report
669
670       Perl Module Tests
671            dist/Cwd/t/cwd.t
672            ext/Compress-Zlib/t/14gzopen.t
673            ext/DB_File/t/db-btree.t
674            ext/DB_File/t/db-hash.t
675            ext/DB_File/t/db-recno.t
676            ext/DynaLoader/t/DynaLoader.t
677            ext/File-Glob/t/basic.t
678            ext/GDBM_File/t/gdbm.t
679            ext/POSIX/t/sysconf.t
680            ext/POSIX/t/time.t
681            ext/SDBM_File/t/sdbm.t
682            ext/Sys/Syslog/t/syslog.t
683            ext/Time-HiRes/t/HiRes.t
684            ext/Win32/t/Unicode.t
685            ext/Win32API-File/t/file.t
686            ext/Win32CORE/t/win32core.t
687            lib/AnyDBM_File.t
688            lib/Archive/Extract/t/01_Archive-Extract.t
689            lib/Archive/Tar/t/02_methods.t
690            lib/ExtUtils/t/Embed.t
691            lib/ExtUtils/t/eu_command.t
692            lib/ExtUtils/t/MM_Cygwin.t
693            lib/ExtUtils/t/MM_Unix.t
694            lib/File/Compare.t
695            lib/File/Copy.t
696            lib/File/Find/t/find.t
697            lib/File/Path.t
698            lib/File/Spec/t/crossplatform.t
699            lib/File/Spec/t/Spec.t
700            lib/Net/hostent.t
701            lib/Net/Ping/t/110_icmp_inst.t
702            lib/Net/Ping/t/500_ping_icmp.t
703            lib/Net/t/netrc.t
704            lib/Pod/Simple/t/perlcyg.pod
705            lib/Pod/Simple/t/perlcygo.txt
706            lib/Pod/Simple/t/perlfaq.pod
707            lib/Pod/Simple/t/perlfaqo.txt
708            lib/User/grent.t
709            lib/User/pwent.t
710

BUGS ON CYGWIN

712       Support for swapping real and effective user and group IDs is
713       incomplete.  On WinNT Cygwin provides "setuid()", "seteuid()",
714       "setgid()" and "setegid()".  However, additional Cygwin calls for
715       manipulating WinNT access tokens and security contexts are required.
716

AUTHORS

718       Charles Wilson <cwilson@ece.gatech.edu>, Eric Fifer
719       <egf7@columbia.edu>, alexander smishlajev <als@turnhere.com>, Steven
720       Morlock <newspost@morlock.net>, Sebastien Barre
721       <Sebastien.Barre@utc.fr>, Teun Burgers <burgers@ecn.nl>, Gerrit P.
722       Haase <gp@familiehaase.de>, Reini Urban <rurban@cpan.org>, Jan Dubois
723       <jand@activestate.com>, Jerry D. Hedden <jdhedden@cpan.org>.
724

HISTORY

726       Last updated: 2012-02-08
727
728
729
730perl v5.28.2                      2018-03-01                     PERLCYGWIN(1)
Impressum