prompts you,
Any additional ld flags (NOT including libraries)? [none] -s
- Any special flags to pass to gcc to use dynamic loading? [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?
[none] -s
The crypt libraries in GNU libc have been ported to Cygwin.
-The DES based Ultra Fast Crypt port was done by Alexey Truhan
+The DES based Ultra Fast Crypt port was done by Alexey Truhan:
http://dome.weeg.uiowa.edu/pub/domestic/sos/cw32crypt-dist-0.tgz
=item * C<-lcygipc> (C<use IPC::SysV>)
-A port of SysV IPC is available for Cygwin:
+A port of SysV IPC is available for Cygwin.
- http://www.multione.capgemini.fr/tools/pack_ipc/
-
-The 1.3 release does not include ftok(), but code for ftok() can be
-borrowed from glibc.
+NOTE: This has B<not> been extensively tested. In particular,
+C<d_semctl_semun> is undefined because it fails a configure test and on
+Win9x the shm*() functions seem to hang.
=back
=head2 Configure-time Options
-The F<INSTALL> document describes several Configure-time options.
-Some of these will work with Cygwin, others are not yet possible. Also,
-some of these are experimental.
+The F<INSTALL> document describes several Configure-time options. Some of
+these will work with Cygwin, others are not yet possible. Also, some of
+these are experimental. You can either select an option when Configure
+prompts you or you can define (undefine) symbols on the command line.
=over 4
=item * C<-Uusedl>
-If you want to force Perl to be compiled statically, you can either
-choose this when Configure prompts you or you can use the Configure
-command line option.
+Undefining this symbol forces Perl to be compiled statically.
=item * C<-Uusemymalloc>
By default Perl uses the malloc() included with the Perl source. If you
-want to force Perl to build with the system malloc(), you can either
-choose this when Configure prompts you or you can use the Configure
-command line option.
+want to force Perl to build with the system malloc() undefine this symbol.
-=item * C<-Dusemultiplicty>
+=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.
The PerlIO abstraction works with the Cygwin port.
-=item * C<-Duse64bits -Duselonglong>
+=item * C<-Duse64bitint>
I<gcc> supports 64-bit integers. However, several additional long long
-functions are necessary to use them within Perl (I<{atol,strtoul}l>).
+functions are necessary to use them within Perl (I<{strtol,strtoul}l>).
These are B<not> yet available with Cygwin.
=item * C<-Duselongdouble>
I<gcc> supports long doubles (12 bytes). However, several additional
long double math functions are necessary to use them within Perl
-(I<{sqrt,pow,atan2,exp,fmod,log,cos,frexp,sin,floor,modf,atof}l>).
+(I<{atan2,cos,exp,floor,fmod,frexp,log,modf,pow,sin,sqrt}l,strtold>).
These are B<not> yet available with Cygwin.
=item * C<-Dusethreads>
=item * C<-Duselargefiles>
-Although Win32 supports large files, Cygwin currently uses 32-bit ints
-for internal size and positional calculations.
+Although Win32 supports large files, Cygwin currently uses 32-bit integers
+for internal size and position calculations.
=back
You should keep the recommended value.
+=item * dlsym
+
+I<ld2> is needed to build dynamic libraries, but it does not exist
+when dlsym() checking occurs (it is not created until `C<make>' runs).
+You will see the following message:
+
+ Checking whether your dlsym() needs a leading underscore ...
+ 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 d_eofnblk
+
+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!
+
+ *** 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.
+
=item * Checking how std your stdio is...
Configure reports:
This is correct.
+=item * Compiler/Preprocessor defines
+
+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:3847: parse error
+
+This failure does not seem to cause any problems.
+
+=back
+
=head1 MAKE
Simply run make and wait:
running as `C<./perl harness>'.
Test results vary depending on your host system and your Cygwin
-configuration. It is possible that Cygwin will pass all the tests, but it
-is more likely that some tests will fail for one of the the reasons below.
+configuration. It is possible that Cygwin will pass all the tests,
+but it is more likely that some tests will fail for one of these reasons.
=head2 File Permissions
lib/db-hash.t 16
lib/db-recno.t 18
lib/gdbm.t 2
- lib/glob-basic.t 9 (directory always readable)
lib/ndbm.t 2
lib/odbm.t 2
lib/sdbm.t 2
=head2 /etc/group
-Cygwin does not need F</etc/group>, in which case the F<op/grent.t>
+Cygwin does not require F</etc/group>, in which case the F<op/grent.t>
test will be skipped. The check performed by F<op/grent.t> expects to
see entries that use the members field, otherwise this test will fail:
=head2 Unexplained Failures
-Any additional tests that fail are likely due to bugs in Cygwin. It is
-expected that by the time of the next net release most of these will
-be solved so they are not described here. None of the current bugs are
-serious enough that workarounds are needed.
+Any additional tests that fail are likely due to bugs in Cygwin or the
+optional libraries. It is expected that by the time of the next net
+release most of these will be solved so they are not described here.
=head2 Script Portability
-Cygwin does an outstanding job of providing UNIX-like semantics on top
-of Win32 systems. However, in addition to the items noted above, there
-are some differences that you should know about. This is only a very
-brief guide to portability, more information about Cygwin can be found
-in the Cygwin documentation.
+Cygwin does an outstanding job of providing UNIX-like semantics on
+top of Win32 systems. However, in addition to the items noted above,
+there are some differences that you should know about. This is only a
+very brief guide to portability, more information can be found in the
+Cygwin documentation.
=over 4
=item * Text/Binary
When a file is opened it is in either text or binary mode. In text mode
-it is subject to CR/LF/Ctrl-Z translations. Perl provides a binmode()
-function to force binary mode on files that otherwise would be treated
-as text. With Cygwin, the default mode for an open() is determined by the
-mode of the mount that underlies a file. For binmode() to be effective,
-the underlying mount must be text. There is no way to force text mode
-on a file underneath a binary mount. The text/binary issue is covered
-at length in the Cygwin documentation.
+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<O_TEXT>
+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.
-lseek() only works with files opened in binary mode.
+The text/binary issue is covered at length in the Cygwin documentation.
=item * F<.exe>
executable as a normal file (e.g., I<install> or I<cp> in a makefile)
the F<.exe> is not transparent.
-NOTE: There is a version of I<install> that understands F<.exe>, it can
-be found at:
+NOTE: There is a version of I<install> that understands the F<.exe>
+semantics, it can be found at:
ftp://ftp.franken.de/pub/win32/develop/gnuwin32/cygwin/porters/Humblet_Pierre_A/
File locking using the C<F_GETLK> command to fcntl() is a stub that
returns C<ENOSYS>.
-Win32 can not unlink() an open file (but this is emulated by Cygwin).
-
Win9x can not rename() an open file (although WinNT can).
=back
This will install Perl, including man pages.
- make install 2>&1 | tee log.make-install
+ make install | tee log.make-install
+
+NOTE: If C<STDERR> is redirected `C<make install>' will B<not> prompt
+you to install I<perl> into F</usr/bin>.
You may need to be I<Administrator> to run `C<make install>'. If you
are not, you must have write access to the directories in question.
=item Documentation
- INSTALL
+ INSTALL README.cygwin
Changes Changes5.005 Changes5.004
- AUTHORS MAINTAIN MANIFEST
- README.cygwin README.win32
+ AUTHORS MAINTAIN MANIFEST README.win32
pod/perl.pod pod/perlfaq3.pod pod/perlhist.pod pod/perlmodlib.pod
pod/perlport.pod pod/perltoc.pod pod/perl5004delta.pod
ext/NDBM_File/hints/cygwin.pl
ext/ODBM_File/hints/cygwin.pl
hints/cygwin.sh
- Porting/patchls - cygwin in port list
- Makefile.SH - linklibperl, cygwin/Makefile.SHs
- makedepend.SH - uwinfix
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, install to pods
+ installperl - install dll/ld2/perlld, install to pods
+ makedepend.SH - uwinfix
=item Tests
t/io/tell.t - binmode
- t/op/magic.t - $^X WORKAROUND, s/.exe//
- t/op/stat.t - no /dev, no -u (setuid)
+ 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)
=item Compiled Perl Source
- doio.c - win9x can not rename a file when it is open
EXTERN.h - __declspec(dllimport)
XSUB.h - __declspec(dllexport)
+ cygwin/cygwin.c - os_extras (getcwd)
+ 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
mg.c - environ WORKAROUND
- util.c - environ WORKAROUND
unixish.h - environ WORKAROUND
+ util.c - environ WORKAROUND
=item Compiled Module Source
=item Perl Modules/Scripts
- lib/perl5db.pl - use stdin not /dev/tty
- utils/perlcc.PL - DynaLoader.a in compile, -DUSEIMPORTLIB
- utils/perldoc.PL - version comment
- lib/File/Spec/Unix.pm - preserve //unc
+ 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/Cwd.pm - `pwd`
+ lib/File/Spec/Unix.pm - preserve //unc
+ lib/perl5db.pl - use stdin not /dev/tty
+ utils/perlcc.PL - DynaLoader.a in compile, -DUSEIMPORTLIB
+ utils/perldoc.PL - version comment
=back
=head1 HISTORY
-Last updated: 28 January 2000
+Last updated: 1 March 2000