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       <https://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 3.0.7 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 or your Cygwin configuration
38       (binary/text mounts, cygserver).  The only dependencies come from hard-
39       coded pathnames like /usr/local.  However, your host system and Cygwin
40       configuration will affect Perl's runtime behavior (see "TEST").
41
42       •   "PATH"
43
44           Set the "PATH" environment variable so that Configure finds the
45           Cygwin versions of programs. Any not-needed Windows directories
46           should be removed or moved to the end of your "PATH".
47
48nroff
49
50           If you do not have nroff (which is part of the groff package),
51           Configure will not prompt you to install man pages.
52

CONFIGURE PERL ON CYGWIN

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

MAKE ON CYGWIN

184       Simply run make and wait:
185
186         make -jn 2>&1 | tee log.make
187
188       where n is the maximum number of simultaneous compilations you want;
189       omitting this parameter is the same as specifying "-j1".
190

TEST ON CYGWIN

192       There are two steps to running the test suite:
193
194         make test 2>&1 | tee log.make-test
195
196         cd t; ./perl harness 2>&1 | tee ../log.harness
197
198       The same tests are run both times, but more information is provided
199       when running as "./perl harness", and you can run the tests in parallel
200       by instead specifying
201
202         cd t; TEST_JOBS=n ./perl harness 2>&1 | tee ../log.harness
203
204       where n is the maximum number of tests to run simulataneously.
205
206       Test results vary depending on your host system and your Cygwin
207       configuration.  If a test can pass in some Cygwin setup, it is always
208       attempted and explainable test failures are documented.  It is possible
209       for Perl to pass all the tests, but it is more likely that some tests
210       will fail for one of the reasons listed below.
211
212   File Permissions on Cygwin
213       UNIX file permissions are based on sets of mode bits for
214       {read,write,execute} for each {user,group,other}.  By default Cygwin
215       only tracks the Win32 read-only attribute represented as the UNIX file
216       user write bit (files are always readable, files are executable if they
217       have a .{com,bat,exe} extension or begin with "#!", directories are
218       always readable and executable).  On WinNT with the ntea "CYGWIN"
219       setting, the additional mode bits are stored as extended file
220       attributes.  On WinNT with the default ntsec "CYGWIN" setting,
221       permissions use the standard WinNT security descriptors and access
222       control lists. Without one of these options, these tests will fail
223       (listing not updated yet):
224
225         Failed Test           List of failed
226         ------------------------------------
227         io/fs.t               5, 7, 9-10
228         lib/anydbm.t          2
229         lib/db-btree.t        20
230         lib/db-hash.t         16
231         lib/db-recno.t        18
232         lib/gdbm.t            2
233         lib/ndbm.t            2
234         lib/odbm.t            2
235         lib/sdbm.t            2
236         op/stat.t             9, 20 (.tmp not an executable extension)
237
238   NDBM_File and ODBM_File do not work on FAT filesystems
239       Do not use NDBM_File or ODBM_File on FAT filesystem.  They can be built
240       on a FAT filesystem, but many tests will fail:
241
242        ../ext/NDBM_File/ndbm.t       13  3328    71   59  83.10%  1-2 4 16-71
243        ../ext/ODBM_File/odbm.t      255 65280    ??   ??       %  ??
244        ../lib/AnyDBM_File.t           2   512    12    2  16.67%  1 4
245        ../lib/Memoize/t/errors.t      0   139    11    5  45.45%  7-11
246        ../lib/Memoize/t/tie_ndbm.t   13  3328     4    4 100.00%  1-4
247        run/fresh_perl.t                          97    1   1.03%  91
248
249       If you intend to run only on FAT (or if using AnyDBM_File on FAT), run
250       Configure with the -Ui_ndbm and -Ui_dbm options to prevent NDBM_File
251       and ODBM_File being built.
252
253       With NTFS (and no CYGWIN=nontsec), there should be no problems even if
254       perl was built on FAT.
255
256   fork() failures in io_* tests
257       A fork() failure may result in the following tests failing:
258
259         ext/IO/lib/IO/t/io_multihomed.t
260         ext/IO/lib/IO/t/io_sock.t
261         ext/IO/lib/IO/t/io_unix.t
262
263       See comment on fork in "Miscellaneous" below.
264

Specific features of the Cygwin port

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

INSTALL PERL ON CYGWIN

468       This will install Perl, including man pages.
469
470         make install 2>&1 | tee log.make-install
471
472       NOTE: If "STDERR" is redirected "make install" will not prompt you to
473       install perl into /usr/bin.
474
475       You may need to be Administrator to run "make install".  If you are
476       not, you must have write access to the directories in question.
477
478       Information on installing the Perl documentation in HTML format can be
479       found in the INSTALL document.
480

MANIFEST ON CYGWIN

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

BUGS ON CYGWIN

674       Support for swapping real and effective user and group IDs is
675       incomplete.  On WinNT Cygwin provides setuid(), seteuid(), setgid() and
676       setegid().  However, additional Cygwin calls for manipulating WinNT
677       access tokens and security contexts are required.
678

AUTHORS

680       Charles Wilson <cwilson@ece.gatech.edu>, Eric Fifer
681       <egf7@columbia.edu>, alexander smishlajev <als@turnhere.com>, Steven
682       Morlock <newspost@morlock.net>, Sebastien Barre
683       <Sebastien.Barre@utc.fr>, Teun Burgers <burgers@ecn.nl>, Gerrit P.
684       Haase <gp@familiehaase.de>, Reini Urban <rurban@cpan.org>, Jan Dubois
685       <jand@activestate.com>, Jerry D. Hedden <jdhedden@cpan.org>.
686

HISTORY

688       Last updated: 2019-11-14
689
690
691
692perl v5.38.2                      2023-11-30                     PERLCYGWIN(1)
Impressum