X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=README.cygwin;h=514e01328e66266535052583553678049df10ea6;hb=765e9edb2de192ef033766d867f9bd290e9935e9;hp=ab60a58a0abadbae7424d23fdf4b5d35c2a0e176;hpb=f8dbba82d8d4daa10a152121c099318e33dde811;p=p5sagit%2Fp5-mst-13.2.git diff --git a/README.cygwin b/README.cygwin index ab60a58..514e013 100644 --- a/README.cygwin +++ b/README.cygwin @@ -134,7 +134,7 @@ 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 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 @@ -155,7 +155,7 @@ C. 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 @@ -183,37 +183,33 @@ F. =item * C<-lcygipc> (C) -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 been extensively tested. In particular, +C is undefined because it fails a configure test and on +Win9x the shm*() functions seem to hang. =back =head2 Configure-time Options -The F 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 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. @@ -222,17 +218,17 @@ 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 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 yet available with Cygwin. =item * C<-Duselongdouble> I 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 yet available with Cygwin. =item * C<-Dusethreads> @@ -241,8 +237,8 @@ POSIX threads are B yet implemented in Cygwin. =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 @@ -265,6 +261,33 @@ hint file. You should keep the recommended value. +=item * dlsym + +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 ... + 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 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: @@ -273,6 +296,18 @@ 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: @@ -313,8 +348,8 @@ The same tests are run both times, but more information is provided when 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 @@ -337,7 +372,6 @@ options, these tests will fail: 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 @@ -391,7 +425,7 @@ directories (although, this is B recommended). =head2 /etc/group -Cygwin does not need F, in which case the F +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: @@ -401,18 +435,17 @@ 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 @@ -439,15 +472,17 @@ F provided by Sergey Okhapkin at: =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 +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> @@ -458,8 +493,8 @@ automatically when building a program. However, when accessing an executable as a normal file (e.g., I or I in a makefile) the F<.exe> is not transparent. -NOTE: There is a version of I that understands F<.exe>, it can -be found at: +NOTE: There is a version of I that understands the F<.exe> +semantics, it can be found at: ftp://ftp.franken.de/pub/win32/develop/gnuwin32/cygwin/porters/Humblet_Pierre_A/ @@ -474,8 +509,6 @@ although this is appropriate on Win9x since there is no security model. File locking using the C command to fcntl() is a stub that returns C. -Win32 can not unlink() an open file (but this is emulated by Cygwin). - Win9x can not rename() an open file (although WinNT can). =back @@ -484,7 +517,10 @@ Win9x can not rename() an open file (although WinNT can). This will install Perl, including man pages. - make install 2>&1 | tee log.make-install + make install | tee log.make-install + +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 are not, you must have write access to the directories in question. @@ -503,10 +539,9 @@ be kept as clean as possible. =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 @@ -519,29 +554,35 @@ be kept as clean as possible. 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 @@ -553,15 +594,15 @@ be kept as clean as possible. =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 @@ -587,4 +628,4 @@ Teun Burgers Eburgers@ecn.nlE. =head1 HISTORY -Last updated: 28 January 2000 +Last updated: 1 March 2000