X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=README.cygwin;h=8940ca6ed0e60f1949a7d0465000a811731729a4;hb=757754a6231584cc746ffd4510e6d8b8f2691824;hp=61b26010b3467f8001b8423e27672fcc34170ae9;hpb=538204d5c084ddeba9f54debc89d135829749520;p=p5sagit%2Fp5-mst-13.2.git diff --git a/README.cygwin b/README.cygwin index 61b2601..8940ca6 100644 --- a/README.cygwin +++ b/README.cygwin @@ -31,7 +31,7 @@ about this project can be found at: A recent net or commercial release of Cygwin is required. -At the time this document was last updated, Cygwin 1.3.22 was current. +At the time this document was last updated, Cygwin 1.5.2 was current. =head2 Cygwin Configuration @@ -64,8 +64,8 @@ Configure will B prompt you to install I pages. On WinNT with either the I or I C settings, directory and file permissions may not be set correctly. Since the build process -creates directories and files, to be safe you may want to run a `C' on the entire Perl source tree. +creates directories and files, to be safe you may want to run a +C on the entire Perl source tree. Also, it is a well known WinNT "feature" that files created by a login that is a member of the I group will be owned by the @@ -137,10 +137,11 @@ The MD5 port was done by Andy Piper: GDBM is available for Cygwin. +NOTE: The GDBM library only works on NTFS partitions. + =item * C<-ldb> (C) -BerkeleyDB is available for Cygwin. Some details can be found in -F. +BerkeleyDB is available for Cygwin. NOTE: The BerkeleyDB library only completely works on NTFS partitions. @@ -153,7 +154,7 @@ C is undefined because it fails a Configure test and on Win9x the I functions seem to hang. It also creates a compile time dependency because F includes F<> and F<> (which will be required in the future when compiling -CPAN modules). NO LONGER SUPPORTED! +CPAN modules). CURRENTLY NOT SUPPORTED! =item * C<-lutil> @@ -182,8 +183,8 @@ want to force Perl to build with the system C undefine this symbol. =item * C<-Uuseperlio> -Undefining this symbol disables the PerlIO abstraction, PerlIO is now the -default, it is not recommended to disable PerlIO. +Undefining this symbol disables the PerlIO abstraction. PerlIO is now the +default; it is not recommended to disable PerlIO. =item * C<-Dusemultiplicity> @@ -193,8 +194,7 @@ more than one interpreter instance. This works with the Cygwin port. =item * C<-Duse64bitint> By default Perl uses 32 bit integers. If you want to use larger 64 -bit integers, define this symbol. If there is trouble, check that -your Cygwin installation is up to date. +bit integers, define this symbol. =item * C<-Duselongdouble> @@ -207,19 +207,18 @@ These are B yet available with Cygwin. =item * C<-Dusethreads> POSIX threads are implemented in Cygwin, define this symbol if you want -a threaded perl. If there is trouble, check that your Cygwin installation -is up to date. +a threaded perl. =item * C<-Duselargefiles> -Although Win32 supports large files, Cygwin currently uses 32-bit integers -for internal size and position calculations. +Cygwin uses 64-bit integers for internal size and position calculations, +this will be correctly detected and defined by Configure. =item * C<-Dmksymlinks> Use this to build perl outside of the source tree. This works with Cygwin. Details can be found in the F document. This is the recommended -way to build perl form sources. +way to build perl from sources. =back @@ -232,7 +231,7 @@ You may see some messages during Configure that seem suspicious. =item * I I is needed to build dynamic libraries, but it does not exist -when C checking occurs (it is not created until `C' runs). +when C checking occurs (it is not created until C runs). You will see the following message: Checking whether your C needs a leading underscore ... @@ -277,18 +276,10 @@ Simply run I and wait: make 2>&1 | tee log.make -=head2 Warnings on Cygwin +=head2 Errors on Cygwin -Warnings like these are normal: +Errors like these are normal: - perl.c: In function `S_parse_body': - perl.c:1468: warning: implicit declaration of function `init_os_extras' - ... - pp_sys.c:289: warning: `S_emulate_eaccess' defined but not used - ... - perlio.c: In function `perlsio_binmode': - perlio.c:98: warning: implicit declaration of function `setmode' - perlio.c:98: warning: passing arg 1 of `Perl_PerlIO_fileno' from incompatible pointer type ... make: [extra.pods] Error 1 (ignored) ... @@ -296,13 +287,13 @@ Warnings like these are normal: =head2 ld2 on Cygwin -During `C', I will be created and installed in your $installbin +During C, I will be created and installed in your $installbin directory (where you said to put public executables). It does not -wait until the `C' process to install the I script, -this is because the remainder of the `C' refers to I without +wait until the C process to install the I script, +this is because the remainder of the C refers to I without fully specifying its path and does this from multiple subdirectories. The assumption is that $installbin is in your current C. If this -is not the case `C' will fail at some point. If this happens, +is not the case C will fail at some point. If this happens, just manually copy I from the source directory to somewhere in your C. @@ -315,7 +306,7 @@ There are two steps to running the test suite: cd t;./perl harness 2>&1 | tee ../log.harness The same tests are run both times, but more information is provided when -running as `C<./perl harness>'. +running as C<./perl harness>. Test results vary depending on your host system and your Cygwin configuration. If a test can pass in some Cygwin setup, it is always @@ -378,6 +369,8 @@ A C failure may result in the following tests failing: See comment on fork in L below. +=head1 Specific features of the Cygwin port + =head2 Script Portability on Cygwin Cygwin does an outstanding job of providing UNIX-like semantics on top of @@ -445,6 +438,15 @@ However, when accessing an executable as a normal file (e.g., I in a makefile) the F<.exe> is not transparent. The I included with Cygwin automatically appends a F<.exe> when necessary. +=item * cygwin vs. windows process ids + +Cygwin processes have their own pid, which is different from the +underlying windows pid. Most posix compliant Proc functions expect +the cygwin pid, but several Win32::Process functions expect the +winpid. E.g. C<$$> is the cygwin pid of F, which is not +the winpid. Use C and C +to translate between them. + =item * C On WinNT C can change a file's user and group IDs. On Win9x C @@ -479,16 +481,35 @@ F to install it and run rebaseall. =back +=head2 Prebuilt methods: + +=over 4 + +=item C + +Returns current working directory. + +=item C + +Translates a cygwin pid to the corresponding Windows pid (which may or +may not be the same). + +=item C + +Translates a Windows pid to the corresponding cygwin pid (if any). + +=back + =head1 INSTALL PERL ON CYGWIN This will install Perl, including I pages. make install 2>&1 | tee log.make-install -NOTE: If C is redirected `C' will B prompt +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 +You may need to be I to run C. If you are not, you must have write access to the directories in question. Information on installing the Perl documentation in HTML format can be @@ -509,7 +530,7 @@ be kept as clean as possible (listing not updated yet). Changes Changes5.005 Changes5.004 Changes5.6 pod/perl.pod pod/perlport.pod pod/perlfaq3.pod pod/perldelta.pod pod/perl5004delta.pod pod/perl56delta.pod - pod/perlhist.pod pod/perlmodlib.pod pod/buildtoc.PL pod/perltoc.pod + pod/perlhist.pod pod/perlmodlib.pod perl/buildtoc pod/perltoc.pod =item Build, Configure, Make, Install @@ -537,12 +558,14 @@ be kept as clean as possible (listing not updated yet). t/op/stat.t - no /dev, skip Win32 ftCreationTime quirk (cache manager sometimes preserves ctime of file previously created and deleted), no -u (setuid) + t/lib/cygwin.t - builtin cygwin function tests =item Compiled Perl Source EXTERN.h - __declspec(dllimport) XSUB.h - __declspec(dllexport) - cygwin/cygwin.c - os_extras (getcwd, spawn) + cygwin/cygwin.c - os_extras (getcwd, spawn, Cygwin::winpid_to_pid, + Cygwin::pid_to_winpid) perl.c - os_extras perl.h - binmode doio.c - win9x can not rename a file when it is open @@ -591,4 +614,4 @@ Gerrit P. Haase . =head1 HISTORY -Last updated: 2003-03-20 +Last updated: 2005-02-11