while read cline; do
name=\`echo \$cline | $awk "\$awkprg" | $tr -d '"'\`
case "\$name" in
- *[/\\\\]\$wanted) echo "\$name"; exit 0;;
- *[\\\\/]\$wanted) echo "\$name"; exit 0;;
- *) name='';;
+ *[/\\\\]\$wanted) echo "\$name"; exit 1;;
+ *[\\\\/]\$wanted) echo "\$name"; exit 1;;
+ *) exit 2;;
esac;
done;
+#
+#status=0: grep returned 0 lines, case statement not executed
+#status=1: headerfile found
+#status=2: while loop executed, no headerfile found
+#
+status=\$?
$rm -f foo\$\$.c;
-case "\$name" in
-'') exit 1;;
-esac
+if test \$status -eq 1; then
+ exit 0;
+fi
+exit 1
EOF
chmod +x findhdr
+
: define an alternate in-header-list? function
inhdr='echo " "; td=$define; tu=$undef; yyy=$@;
cont=true; xxf="echo \"<\$1> found.\" >&4";
rhapsody*)
ldlibpth="DYLD_LIBRARY_PATH=`pwd`/Perl:$DYLD_LIBRARY_PATH"
;;
- cygwin*) ldlibpth="PATH=`pwd`:$PATH"
+ cygwin*) ldlibpth="PATH='`pwd`:$PATH'"
linklibperl="-lperl"
;;
os2*) # OS/2 doesn't need anything special for LD_LIBRARY_PATH.
=item Cygwin32
- The Cygwin tools are ports of the popular GNU development tools for
+The Cygwin tools are ports of the popular GNU development tools for
Windows NT, 95, and 98. They run thanks to the Cygwin library which
provides the UNIX system calls and environment these programs expect.
-More info about this project can be found at it's home page
+More info about this project can be found at its home page
http://sourceware.cygnus.com/cygwin/
=item libperl.dll
-These instructions and the default cygwin32 hints build a a shared
+These instructions and the default cygwin32 hints build a shared
libperl.dll Perl library and enables dynamically loaded extensions.
-
=back
=head1 BUILDING
To make life easier, you should download
ftp://ftp.franken.de/pub/win32/develop/gnuwin32/cygwin/porters/Humblet_Pierre_A/install-cygwin-b20.sh,
and use it as your install "executable." Just follow the instructions
-that are embedding as comments in the .sh file.
+that are embedded as comments in the .sh file.
+
+=item Windows NT notes
+
+You should execute a 'chmod -R +w *' on the entire perl source directory.
+The configuration process creates new files (and thus needs write access
+to the directory) and sometimes, especially if you make repeated builds
+in the same directory, overwrites old files. If you do not enable write
+access, you're just asking for trouble. Reminder for B20.1: unless 'ntea'
+is included in the CYGWIN environment variable settings, chmod has no
+effect. See "environment," below.
+
+It is best if you build, test, and install as a normal user, not as
+Administrator or as any member of the Administrators group. There is
+a well-known NT-ism that affects Cygwin: all files that are created
+by any member of the Administrators B<group> are B<NOT> owned by
+that member. The ownership of those files is assigned to the
+Administrators group, instead. If the default access mode for new files
+is -rw-r--r--, then the original creator of the file cannot overwrite
+it: he no longer owns the file, no B<user> does. It is owned by the
+group, but group members don't have write access to it. This causes
+any number of problems, including make test / perl harness failures,
+installation failures, etc.
+
+In some cases, however, it is necessary to install as Administrator. For
+instance, if normal users are not allowed write access to the install
+directory. My solution, in this case, was to transfer ownership of the
+install directory tree (/usr/local) to a single, normal user, and
+set permissions to -rw-r--r-- (drwxr-xr-x for directories, of course).
+If you read the preceeding paragraph carefully, you might suspect that
+changing the permissions on the entire tree to -rw-rw-r--, but allowing
+the Administrators group to keep ownership should solve the problem.
+However, newly created directories (and the perl install creates a lot
+of them) will not allow group write access. Setting umask will not
+fix this problem, because umask is a B<negation> operator; it only
+specifies the types of accesses that will NOT be allowed on new files.
+For instance, umask u=rwx,g=rwx,o=rx means that world ('B<o>thers') will
+never be allowed write access, but owner ('B<u>ser') and B<g>roup B<might>
+be allowed write access. Everybody (u, g, and o) B<might>be allowed
+read access.
+
+In any case, Corinna Vinschen's ntsec patches B<may> eventually
+alleviate this whole mess, and are included in the development
+snapshots as of 24 May 1999. You will need to include 'ntsec' as
+one of the items in the CYGWIN variable setting. However, initial
+tests indicate some incompatibility the 0524 snapshot and this perl
+build.
+
+=item environment
+
+I (csw) found the following steps necessary for a successful build:
+
+=over
+
+=item path
+
+I set my path so that none of the windows directories showed up -
+otherwise Configure found the wrong executables (find, grep, etc).
+It is, however, important that '.' be in the path, because otherwise
+the build process can't execute the ld2 script that is created.
+
+=item mounts
+
+I had to unmount my f: drive. I have cygwin installed under
+F:\cygnus\cygwin-b20\, which is mounted as \. I also ordinarily
+have F:\ mounted as /f (i.e. mounted onto the empty directory
+F:\cygnus\cygwin-b20\f\ ). However, this causes Configure to
+"locate" the awk, tr, sed, etc. programs at
+/f/cygnus/cygwin-b20/usr/bin instead of /usr/bin.
+This ended up causing problems.
+
+I built and tested perl using all binary mounts. However, Eric Fifer
+has built and tested it using text mounts, but reported more failures
+during make test and perl harness. Based on his findings, and experiments
+performed by Sebastien Barre with the static build of perl, I can
+report that these test failures are B<not> due to any differences in
+the perl executable. Most of the failures encountered during a make test
+on text mounts can be eliminated by remounting as binary, and re-running
+the tests using the same executable. These test failures are due to
+problems in the test scripts, not the executable. See Appendix.
+
+One observation from experience with the static build of perl is that
+it's a bad idea to a mix a perl executable that was compiled using binary
+mounts with modules compiled using text mounts, and vice versa. Make
+sure your mount environment matches. This observation has not been
+confirmed with respect to the dynamically linked build of perl.
+
+=item environment variables
+
+For NT users, the CYGWIN variable should include the 'ntea' setting.
+However, if you have FAT drives on your system, as opposed to NTFS,
+please read the Cygwin FAQ concerning ntea before including it in
+your system settings. If you do not use ntea, you will encounter a
+few extra make test and/or perl harness failures. These are not
+indicative of a faulty perl executable, but only that your system
+settings do not allow the types of file access and ownership checking
+that the test scripts are attempting to verify. See Appendix.
+
+I unset INCLUDE and LIB (these two variables are set by MSVC5, and
+inherited from my Windows environment by cygwin). I'm not sure this made
+a difference, but it has caused problems in the past...
+
+=back
=item crypt library
by Andy Piper. His home page can be found at
http://www.xemacs.freeserve.co.uk/
+=item hacks that should be revisited after the next cygwin release
+
+Some of the failures we encountered when running make test and/or perl harness
+are due to bugs in the cygwin b20.1 distribution. We sometimes found it
+necessary to use dirty little hacks to persuade make test and perl harness
+to play nicely. Since cygwin is in active development, many of these hacks
+may not be necessary in the future. These include:
+
+=over
+
+=item fix for pragma/locale
+
+the line '#undef MB_CUR_MAX' was added to ex/POSIX/POSIX.xs. This fixes
+a failure in the pragma/locale.t test, which before this fix resulted in a
+coredump. It appears that MB_CUR_MAX is #defined __mb_cur_max, and __mb_cur_max
+is declared 'extern' in Cygwin b20.1's stdlib.c, but is never defined. Thus,
+the error.
+
+=item fix for lib/io_sock
+
+there is a rather extensive patch to t/lib/io_sock.t which works around
+a failure related to fork() in the cygwin environment. Cygwin b20.1 does not
+properly remap manually loaded DLLs in the child after a fork.
+
+=item fix for lib/filehand
+
+during the make test/perl harness steps, a win32 popup complains about
+a "perl.exe Application Error - illegal memory access." This is due to to
+a test in t/lib/filehand.t, and is related to the fork + dll problem.
+
+=item fix for environ
+
+there are a number of changes to miniperlmain.c, util.c, and mg.c that
+are there to work around a Cygwin problem relating to environ.
+
+=item fix for lib/posix
+
+the following line was added to t/lib/posix.t to work around a Cygwin bug.
+
+=begin text
+
+kill 'CONT', $$ if($^O =~ /cygwin/); # XXX: Cygwin bug INT signal gets stuck
+
+=end text
+
+=back
+
=back
=head2 Configure
Check hints/cygwin32.sh for any system specific settings. In
-particular change libpth if Cygwin is installed somewhere other
-than /cygnus.
+particular change libpth to point to the correct location of
+...../i586-cygwin32/lib.
run "sh Configure".
=head2 make
-Run "make". After that, run "make test" to see how stable your system is.
-For me, at io/taint.t you may see several Win32 "Unable To Locate DLL"
-messages (just click Ok) that requires cygwin1.dll to be present in the
-build directory or somewhere in system path (/WINNT, /WINNT/System,
-/WINNT/System32). And, at lib/io_sock.t you may see several Win32
-"Application Error" messages (just click Ok) and the test waits for a
-died child that has to be killed manually. Other test scripts seem to
-be more or less harmless. The result of ./perl harness reads:
+Run "make". If you're really feeling adventurous, type
+"make 2>&1 | tee make-log.txt".
-=begin text
+=over
-Failed Test Status Wstat Total Fail Failed List of failed
--------------------------------------------------------------------------------
-lib/anydbm.t 2 512 12 8 66.67% 5-12
-lib/findbin.t 1 1 100.00% 1
-lib/io_sock.t 9 2304 5 4 80.00% 2-5
-lib/sdbm.t 2 512 18 15 83.33% 2, 5-18
-op/magic.t 35 2 5.71% 23, 29
-op/split.t 25 1 4.00% 11
-op/stat.t 58 2 3.45% 9, 26
-op/taint.t 149 3 2.01% 1, 3, 31
-pragma/locale.t 11 2816 102 4 3.92% 99-102
-9 tests skipped, plus 35 subtests skipped.
-Failed 9/190 test scripts, 95.26% okay. 40/6452 subtests failed, 99.38% okay.
+=item ld2
-=end text
+The make script will install ld2 into your $installbin directory (i.e.
+wherever you said to put the perl.exe) during the *make* process. It
+does not wait until the *make install* process to install the ld2 script.
+This is because the remainder of the make refers to ld2 without fully
+specifying its path, and does this from multiple subdirectories (so ./ld2
+won't work.) The assumption here is that $installbin is in your current
+$PATH. If this is not the case, or if you do not have an install
+executable, the make will fail at some point. Don't panic. Just manually
+copy ld2 from the source directory to someplace in your path.
+
+This cannot be done prior to make, because ld2 is created during the
+make process.
+
+=back
+
+=head2 make test
+
+Run "make test" to see how stable your system is. I (csw) got the
+following errors/warnings:
+
+=over
+
+=item op/taint
+
+Got two "missing cygwin1.dll" warning popups. This is because
+op/taint wants cygwin1.dll to be somewhere in the system path
+(\WINDOWS\SYSTEM, etc) or in the build directory. Can be ignored.
+
+=item lib/filehand
+
+Got an "Application Error - memory could not be read" popup. While
+this looks alarming, it can be ignored - just click OK. It is
+because Cygwin B20.1 doesn't properly remap manually loaded DLLs
+in the child after a fork.
+
+=item lib/io_sock
+
+Got an "Application Error - memory could not be read" popup. Again,
+just click OK and ignore it.
+
+=back
+
+=head2 perl harness
+
+Once you've run make test, then cd into the t/ subdirectory and
+execute './perl harness'. I (csw) got the following results:
+
+=over
+
+=item op/taint
+
+Got four "missing cygwin1.dll" warning popups. Click OK and
+ignore.
+
+=item lib/filehand
+
+Got an "Application Error - memory could not be read" popup. Again,
+click OK and ignore.
+
+=item lib/io_sock
+
+Got an "Application Error - memory could not be read" popup. Again,
+clock OK and ignore.
+
+=item final results
+
+After the ./perl harness, I got the following results summary.
+
+ Failed Test Status Wstat Total Fail Failed List of failed
+ -------------------------------------------------------------------------------
+ op/taint.t 149 3 2.01% 1, 3, 31
+ 9 tests skipped, plus 35 subtests skipped.
+ Failed 1/190 test scripts, 99.47% okay. 3/6452 subtests failed, 99.95% okay.
+
+=back
+
+=head2 make install
+
+Finally, run "make install". In my case, the install process was unable
+to copy the files from <SRCDIR>/pod/* to /usr/local/lib/perl5/5.00503/pod/.
+I (csw) just copied them by hand after the install finished. I believe
+this is because I'm using Sergey Okhapkin's coolview version of the
+cygwin1.dll, which provides case sensitivity. The directory is created
+as "/usr/local/lib/perl5/5.00503/Pod" but the copy is done into
+"/usr/local/lib/perl5/5.00503/pod". This fails -- but probably won't
+fail if you're using the default cygwin1.dll.
=head1 BUGS
Upon each start, make warns that a rule for perlmain.o is overrided.
Yes, it is. In order to use libperl.dll, perlmain needs to import
-symbols from there. I saw no better solution than adding an explicit
-define to the rule.
-
-The lib/io_sock.t failure seems to be a problem with a forked child
-not having its DLLs remapped.
+symbols from there. According to alex smishlajev, there seems to be
+no better solution than adding an explicit define to the rule.
make clean does not remove library .def and .exe.core files.
=head1 DISCLAIMER
-I am not going to maintain this document or this port. I only wanted
+I (alex) am not going to maintain this document or this port. I only wanted
to make perl porting a bit easier. If failed, I can't be helpful for you.
+Contact one of the others listed in the history section.
=head1 HISTORY
-17..25-apr-1999. perl 5.005_03. cygwin b20.1 egcs 1.1.2.
- far 1.60. nescafe classic.
+=over
+
+=item Release 1.4.1: 28-May-1999
+
+Charles Wilson - cwilson@ece.gatech.edu
+
+ Configure minor fix for spaces in $PATH
+ documentation updates
+
+=item Release 1.4: 26-May-1999
+
+Charles Wilson - cwilson@ece.gatech.edu
+
+ From Eric Fifer:
+ hints/cygwin32.sh -L. and --export-dynamic not needed
+ cygwin32/Makefile.SHs no value needed for -DUSEIMPORTLIB
+ t/lib/io_sock.t -I../lib so "make test" works
+ t/lib/posix.t workaround a Cygwin bug so test works
+ doio.c/perl.h cleanup gcc warning "doio.c:789: warning:
+ pointer/integer type mismatch in
+ conditional expression"
+ From Charles Wilson:
+ Configure changes to findhdr script
+ documentation updates
+ built binary kit for release
+
+=item Release 1.3: 26-May-1999
+
+Charles Wilson - cwilson@ece.gatech.edu
+
+ Changes to Cwd.pm to correct lib/findbin.t test failure from Eric Fifer
+ Changes to t/op/magic.t to correct a test failure from Eric Fifer
+ Changes to miniperlmain.c, util.c, and mg.c to correct t/op/magic.t #29
+ test failure, from Eric Fifer
+ more documentatino updates, patch merging, and a change to
+ cygwin/Makefile.SHs -- cw.
+ 99.95% okay!!!
+
+=item Release 1.2: 25-May-1999
+
+Charles Wilson - cwilson@ece.gatech.edu
+
+ fixes for lib/io_sock and pragma/locale from Eric Fifer
+ fixes for Configure, Makefile.SH, and cygwin32/Makefile.SHs from
+ alex smishlajev
+ documentation updates, and other fixes to the fixes from cw.
+ 99.91% okay!!!
+
+=item Release 1.1: 21-May-1999
+
+Charles Wilson - cwilson@ece.gatech.edu
+
+minor change to Configure script, reversed a few changes made by
+alexander's patch (made DOSISH #undefined again) and moved code
+by alexander from dosish.h to perl.h. Reversed a change in
+pp_hot.c
+
+=item Release 1.0: 16-May-1999
+
+Charles Wilson - cwilson@ece.gatech.edu
-efifer@sanwaint.com - Wed May 12 17:22:42 BST 1999
+Merged alexander's patch and Eric's patch into a single
+monolithic patch. Minor cleanup. Built binary for distribution.
+perl5.005_03-dynamic-patch-v1.0
- Removed all references to the impure_ptr hack since it is no longer
- needed. Some minor cleanup of Alexander's work and a few bug fixes.
+=item Pre-release 3: 12-May-1999
+
+Eric Fifer - efifer@sanwaint.com
+
+Removed all references to the impure_ptr hack since it is no longer
+needed. Some minor cleanup of alexander smishlajev's work and a few
+bug fixes.
+
+=item Pre-release 2 (initial dynamic build): 17..25-apr-1999
+
+alexander smishlajev - als@turnher.com
+
+perl 5.005_03. cygwin b20.1 egcs 1.1.2. far 1.60. nescafe classic.
+
+=item Pre-release 1 (static build): 5-Mar-1999
+
+Charles Wilson - cwilson@ece.gatech.edu
+
+Collected various patches that had been floating around the net, along
+with build instructions. Original authorship credit for those patches
+goes to:
+
+ Steven Morlock - newspost@morlock.net
+ Sebastien Barre - Sebastien.Barre@utc.fr
+ Teun Burgers - burgers@ecn.nl
+
+Created a monolithic patchkit (perl5.005_03-static-patch) and build
+instructions for cygwin (beta 20.1). Also created a binary distribution
+of the resulting static perl build.
+
+=back
+
+=head1 APPENDIX
+
+Perl harness results from Eric Fifer, under various environments. The same
+executable was used in all cases. The last item is a different executable
+on a different machine, built by Charles Wilson.
+
+There are a number of very good questions one could ask about anomalies
+in the test results presented below. "Why do the last two show different
+results?" "Why did op/stat.t #18 pass in the first two tests and fail in
+the third?" Short answer: I don't know. Long answer: I really have no
+idea.
+
+=over
+
+=item text mounts, no 'ntea'
+
+ Failed Test Status Wstat Total Fail Failed List of failed
+ ------------------------------------------------------------
+ lib/anydbm.t 2 512 12 8 66.67% 5-12
+ lib/sdbm.t 2 512 18 15 83.33% 2, 5-18
+ op/split.t 25 1 4.00% 11
+ op/stat.t 58 3 5.17% 9, 19, 26
+ op/taint.t 149 3 2.01% 1, 3, 31
+
+=item binary mounts, no 'ntea'
+
+ Failed Test Status Wstat Total Fail Failed List of failed
+ ------------------------------------------------------------
+ lib/sdbm.t 18 1 5.56% 2
+ op/stat.t 58 3 5.17% 9, 19, 26
+ op/taint.t 149 3 2.01% 1, 3, 31
+
+=item binary mounts, 'ntea'
+
+ Failed Test Status Wstat Total Fail Failed List of failed
+ ------------------------------------------------------------
+ op/stat.t 58 3 5.17% 18-19, 26
+ op/taint.t 149 3 2.01% 1, 3, 31
+
+=item binary mounts, ntea (csw build)
+
+ Failed Test Status Wstat Total Fail Failed List of failed
+ -------------------------------------------------------------------------------
+ op/taint.t 149 3 2.01% 1, 3, 31
+
+=back
=cut
ld2: $& Makefile perlld ${src}/cygwin32/ld2.in
@echo "extracting ld2 (with variable substitutions)"
@$sed s,@buildpath@,$addtopath,g <${src}/cygwin32/ld2.in >ld2
+ @echo "installing ld2 into $installbin"
+# install is included in Cygwin distributions, and we make a note of th
+# requirement in the README.cygwin32 file. However, let's give them
+# a warning.
+ @if test -n "`type $1 2>&1 | sed -n -e '/'$1'$/p'`" ; then \
+ install -c -m 755 ld2 ${installbin}/ld2 ; \
+ else \
+ echo "*************************************************" ; \
+ echo "Oh, no! You didn't read the README.cygwin32" ; \
+ echo "file, which stated that \"install\" was required." ; \
+ echo "Make will probably fail in a few more steps." ; \
+ echo "When it does, copy \"ld2\" to a directory in" ; \
+ echo "your path, other than \".\"." ; \
+ echo "\"/usr/local/bin\" or something similar will do." ; \
+ echo "Then restart make." ; \
+ echo "*************************************************" ; \
+ fi
+
!GROK!THIS!
$spitshell >>Makefile <<!GROK!THIS!
$spitshell >>Makefile <<!GROK!THIS!
LIBPERL = $libperl
LLIBPERL= $linklibperl
-LDLIBPTH= PATH=$addtopath:\${PATH}
CLDFLAGS= -L$addtopath $ldflags
CAT = $cat
AWK = $awk
# override default rule (NB: make croaks!) to force dll usage
perlmain$(OBJ_EXT): perlmain.c
- $(CCCMD) $(PLDLFLAGS) -DUSEIMPORTLIB=\"$(LIBPERL)$(LIB_EXT)\" $*.c
+ $(CCCMD) $(PLDLFLAGS) -DUSEIMPORTLIB $*.c
# library used to make statically linked executables
# miniperl is linked against it to avoid libperl.dll locking
+This document is obsolete. Refer to README.cygwin32. However, if you want
+to build a statically linked perl binary, then you applied the wrong patch.
+You want perl5.005_03-static-patch, which will build "Pre-release 1"
+according to the nomenclature in README.cygwin32.
+
The perl source distribution is available from
http://www.cpan.org/src/index.html
(2) prepare the source
(a) unpack perl source distribution in /usr/local/src
- (b) copy perl5.005_03.patch into /usr/local/src/perl5.005_03/
+ (b) copy perl5.005_03-static-patch into /usr/local/src/perl5.005_03/
(c) cd /usr/local/src/perl5.005_03
(d) chmod -R +w *
- (e) patch -p1 < perl5.005_03.patch
+ (e) patch -p1 < perl5.005_03-static-patch
(3) get ready to build
- (a) cp cygwin32/* .
- (b) cp gcc2 /usr/local/bin
- (c) cp ld2 /usr/local/bin
- (d) cp hints/cygwin32.sh config.sh
- (e) sh Configure -d
+ (a) cp cygwin32/cw32imp.h .
+ (b) cp cygwin32/gcc2 .
+ (c) cp cygwin32/ld2 .
+ (d) cp cygwin32/perlgcc .
+ (e) cp cygwin32/perlld .
+ (f) cp gcc2 /usr/local/bin
+ (g) cp ld2 /usr/local/bin
+ (h) cp hints/cygwin32.sh config.sh
+ (i) sh Configure -d
(automatically does a make depend)
(4) build and install
(c) make test
(d) make install
-To customize, look around in the patchfile or ignore the patch and follow the build-instructions.* directly. If you want to edit the paths in the patchfile to reflect your system, search for "/usr/" within the patchfile.
+To customize, look around in the patchfile or ignore the patch and
+follow the build-instructions.* directly. If you want to edit the paths
+in the patchfile to reflect your system, search for "/usr/" within the
+patchfile.
* MUST read.
-DATE: 2 April 99
+This document is obsolete. Refer to README.cygwin32.
-Here are a few hints for building perl with cygwin:
-
-(1) There have been some problems compiling with the default compiler installed with cygwin-b20.1. Some of the patches in perl5.005_03.patch attempt to correct this, but it would probably be a good idea to upgrade your compiler to egcs-1.1.1 (or better) from Mumit Khan's website -- http://www.xraylith.wisc.edu/~khan/software/gnu-win32/
-
-(2) To avoid some failures when doing a "make test", use CYGWIN=ntea while testing. However, see the Cygwin FAQ concerning the use of ntea with FAT partitions. The tests that fail are those that deal with file ownership and access.
-
-(3) Perl should build without trouble under text mounts or binary mounts. However, some tests ("make test") may fail when using text mounts. The tests that fail are those that involve using tie() to attach a hashtable variable to a file.
-
-(4) As of 3/8/98, building and linking new modules into the perl executable rus into problems when using binary mounts. We're still tracking this one down.
+DATE: 13 May 99
-(5) There have been a few hints that some tests may also fail depending on whether you're building, testing, and/or installing as a normal user, or as a member of the Administrators group (NT only). However, we're not sure about this one yet.
-
-(6) When compiling static modules for perl, don't mix modules compiled under text mounts and modules compiled under binary mounts.
-
-(7) The sourcefiles in the tarball extract as "-r--r--r--" by default, so you need to "chmod -R +w *' in order to patch successfully.
-
-(8) To make life easier, you should download ftp://ftp.franken.de/pub/win32/develop/gnuwin32/cygwin/porters/Humblet_Pierre_A/install-cygwin-b20.sh, and use it as your install "executable." Just follow the instructions that are embedding as comments in the .sh file.
-
-(9) There were a number of failed operations when installing. These were
- (a) trying to create man pages whose names had ":" in them -- i.e. man/man3/Tie::Array.3
- (b) for some reason, the installer had difficulty copying the SRCDIR/pod/*.pod files to /usr/local/lib/perl5/perl5.00503/pod/ directory. I did it by hand. It's not really that important - the pod files are converted to man pages, and the man pages are installed successfully. So you don't really need to keep the pod's around.
+Here are a few hints for building perl with cygwin:
+(1) There have been some problems compiling with the default compiler
+installed with cygwin-b20.1. If you're reading this file, then you've
+already applied perl5.005_03-static-patch. Some of the patches in
+perl5.005_03-static-patch attempt to correct these problems, but it
+would probably be a good idea to upgrade your compiler to egcs-1.1.1
+(or better) from Mumit Khan's website --
+http://www.xraylith.wisc.edu/~khan/software/gnu-win32/
+
+(2) To avoid some failures when doing a "make test", use CYGWIN=ntea
+while testing. However, see the Cygwin FAQ concerning the use of ntea
+with FAT partitions. The tests that fail are those that deal with file
+ownership and access.
+
+(3) Perl should build without trouble under text mounts or binary
+mounts. However, some tests ("make test") may fail when using text
+mounts. The tests that fail are those that involve using tie() to
+attach a hashtable variable to a file.
+
+(4) There have been a few hints that some tests may also fail depending
+on whether you're building, testing, and/or installing as a normal
+user, or as a member of the Administrators group (NT only). However,
+we're not sure about this one yet.
+
+(5) When compiling static modules for perl, don't mix modules compiled
+under text mounts and modules compiled under binary mounts.
+
+(6) The sourcefiles in the tarball extract as "-r--r--r--" by default.
+This may or may not cause problems, depending on your setup. To be safe,
+I executed "chmod -R +w *".
+
+(7) To make life easier, you should download install-cygwin-b20.sh from
+ftp://ftp.franken.de/pub/win32/develop/gnuwin32/cygwin/
+ porters/Humblet_Pierre_A/
+and use it as your install "executable." Just follow the instructions
+that are embedded as comments in that shell script.
+
+(8) There were a number of failed operations when installing. These
+occurred in two cases: first, when trying to create man pages whose
+names had ":" in them -- i.e. man/man3/Tie::Array.3, and second,
+when copying the pod files from SRCDIR/pod/*.pod to
+/usr/local/lib/perl5/perl5.00503/pod/. I'm not sure why, but I just
+completed that operation by hand afterwards.
RESULTS:
****************************************************
-I built and tested as a normal user (not Administrator and not a member of the Administrators group). However, I had to switch to Administrator to install because the permissions on my /usr/local/bin were wrong.
+I built and tested as a normal user (not Administrator and not a member
+of the Administrators group). However, I had to
+'chown -R cwilson /usr/local/*' in order to avoid various NTisms.
+(Previously, my /usr/local tree was owned by the Administrators GROUP,
+and since I was building as a normal user, I couldn't install
+completely. Why didn't I just switch to the Administrator account to
+install? Well, that has its own share of problems: basically, the
+Administrator couldn't write to those directories either - they were
+owned by the Admin group, not the Admin user. And the permissions were
+-rw-r--r-- (or -r--r--r--), so group members weren't allowed write
+access. Blame MS.)
RESULTS: make test
------------------
base/rs.............ok, 4/14 subtests skipped
op/groups...........skipping test on this platform
op/magic............FAILED test 23
- Failed 1/35 tests, 97.14% okay (-4 skipped tests: 30 okay, 85.71%)
+ Failed 1/35 tests, 97.14% okay (-4 skipped tests: 30 okay,
+85.71%)
op/stat.............ls: /dev: No such file or directory
FAILED tests 4, 35
Failed 2/58 tests, 96.55% okay
op/taint............FAILED tests 1, 3, 31
- Failed 3/149 tests, 97.99% okay (-12 skipped tests: 134 okay, 89.93%)
- (Also got the following popup message four times - "The dynamic link
+ Failed 3/149 tests, 97.99% okay (-12 skipped tests: 134 okay,
+89.93%)
+ (Also got the following popup message four times - "The dynamic
+link
library cygwin1.dll could not be found in the specified path
F:\cygnus\cygwin-b20\usr\local\src\perl5.005_03\t;.;
E:\WINNT\System32;E:\WINNT\system;E:\WINNT;..")
lib/findbin.........FAILED test 1
Failed 1/1 tests, 0.00% okay
+lib/db-btree........skipping test on this platform
+lib/db-hash.........skipping test on this platform
+lib/db-recno........skipping test on this platform
lib/gdbm............skipping test on this platform
lib/ipc_sysv........skipping test on this platform
lib/ndbm............skipping test on this platform
lib/thread..........skipping test on this platform
Failed Test Status Wstat Total Fail Failed List of failed
--------------------------------------------------------------------------------
+------------------------------------------------------------------------
+-------
lib/findbin.t 1 1 100.00% 1
op/magic.t 35 1 2.86% 23
op/stat.t 58 2 3.45% 4, 35
op/taint.t 149 3 2.01% 1, 3, 31
10 tests skipped, plus 20 subtests skipped.
-Failed 4/190 test scripts, 97.89% okay. 7/6430 subtests failed, 99.89% okay.
+Failed 4/190 test scripts, 97.89% okay. 7/6430 subtests failed, 99.89%
+okay.
-The included patch, perl5.005_02.patch, implements all of the suggestions below. Results in a static build, 93.85% successful test on NT.
+This document is obsolete. Refer to README.cygwin32.
+
+perl5.005_03-static-patch implements all of the
+suggestions below. Results in a static build, 93.85%
+successful test on NT.
**********************************
*) Edit the hints/cygwin32.sh file to reflect your paths.
-Here are also a couple of settings I found useful when performing automatic
+Here are also a couple of settings I found useful when performing
+automatic
build (copy hints/cygwin32.sh to config.sh, and do sh Configure -d)
usedl='n'
-From comp.lang.perl.misc. The included patch, perl5.005_02.patch, implements most of the suggestions below. My observations during the build process are commented within the body of Mr. Morlock's message, set off by ******CSW******
+This document is obsolete. Refer to README.cygwin32.
+
+From comp.lang.perl.misc. perl5.005_03-static-patch
+implements most of the suggestions below. My observations during the
+build process are commented within the body of Mr. Morlock's message,
+set off by ******CSW******
**************************************
get something out of my experience of building it.
An advantage of the versions Perl built with Cygwin32 is that Cygwin32
-has a POSIX compatible library including support for the fork() function.
+has a POSIX compatible library including support for the fork()
+function.
Steve
* Pre-build checklist:
- - I found that building Perl on a unmounted partition/drive other than the
- root will fail. It appears that the double forward slash that Cygwin32
- uses to reference drives other than the root drive (typically C:) gets
- converted to a single forward slash at several points in the build process.
- I have not tried, but expect it would work, to mount the non-root drive.
- This problem held true for both the drive where the perl source were and
- the drive where the Cygwin32 binaries where located. In the build
- described in these notes the Perl source and Cygwin32 binaries were located
- on the root drive.
+ - I found that building Perl on a unmounted partition/drive other
+ than the root will fail. It appears that the double forward slash
+ that Cygwin32 uses to reference drives other than the root drive
+ (typically C:) gets converted to a single forward slash at several
+ points in the build process. I have not tried, but expect it would
+ work, to mount the non-root drive. This problem held true for both
+ the drive where the perl source were and the drive where the
+ Cygwin32 binaries where located. In the build described in these
+ notes the Perl source and Cygwin32 binaries were located on the
+ root drive.
- Following the instructions in <PERL>/README.cygwin32:
*******CSW********
i_stdarg='define'
i_varargs='undef'
- This change allows us to pick up the right version of va_start().
- Cygwin32 has both a signal and double parameter versions floating
- around in their header files.
+ This change allows us to pick up the right version of
+ va_start(). Cygwin32 has both a signal and double parameter
+ versions floating around in their header files.
- + Remove support for dynamic linking. I found that all DynaLoader'd
- extensions crashed during the running of the test suite. Add or edit
- 'usedl' entry to read:
+ + Remove support for dynamic linking. I found that all
+ DynaLoader'd extensions crashed during the running of the
+ test suite. Add or edit 'usedl' entry to read:
*******CSW********
the patch does this
******************
If there is enough push I will try to sort out the problems with
dynamic loading. I have made several unsuccessful attempts at
- modifying <PERL>/perlld to fix this problem. If you are interested,
- write me.
+ modifying <PERL>/perlld to fix this problem. If you are
+ interested, write me.
+ Change the path to the Cygwin32 directories. This includes the
- entries for 'usrinc', 'libpth', 'lddlflags', 'libc' and 'usrinc'.
+ entries for 'usrinc', 'libpth', 'lddlflags', 'libc' and
+ 'usrinc'.
*******CSW********
the patch does this ^
******************
- Edit makedepend.SH. The original version of makedepend.SH produces
- dependencies that include double backslashes. This can not be processed
- by Cygwin32's 'make'. Apply the following modification to makedepend.SH
- to correct these unfortunate filenames:
+ dependencies that include double backslashes. This can not be
+ processed by Cygwin32's 'make'. Apply the following modification
+ to makedepend.SH to correct these unfortunate filenames:
*******CSW********
and this, as well \/
******************
- Edit config_h.SH. The original version of config_h.SH has an bogus
#include that gets propagated into the dependency list in Makefile
- create from the makedepend script. The Apply the following modification
- to config_h.SH to work around this unfortunate filename:
+ create from the makedepend script. The Apply the following
+ modification to config_h.SH to work around this unfortunate
+ filename:
*******CSW********
the patch does this, too
******************
#endif
The real source of the problem appears that the 'make depend' in the
- 'x2p' directory has problems. The following messages are generated by
- that 'make depend':
+ 'x2p' directory has problems. The following messages are generated
+ by that 'make depend':
Finding dependencies for hash.o.
gcc2: Can't open gcc2
... [similar messages to above]
- You don't seem to have a proper C preprocessor. Using grep instead.
+ You don't seem to have a proper C preprocessor. Using grep
+ instead.
Updating GNUmakefile...
So the grep is pulling the bogus #include from the file. The patch
turns the #include'd message into a comment.
- - Run the Configure in the <PERL> directory as described in the document
- <PERL>/README.cygwin32
+ - Run the Configure in the <PERL> directory as described in the
+ document <PERL>/README.cygwin32
- I receive the message "THIS PACKAGE SEEMS INCOMPLETE.". This does not
- appear to be a problem.
+ I receive the message "THIS PACKAGE SEEMS INCOMPLETE.". This does
+ not appear to be a problem.
When presented with the list of handy defaults, select 'cygwin32'
*******CSW********
I didn't see this problem \/
******************
- - I experience problems when building two files 'pp_sys.o' & 'doio.o'. The
- build process will crash with a Windows dialog during the build of these two
- files. The way I get by the problem is to control-C the make and issue
- the build commands for the two files by hand. In the Perl directory issue
- the following commands:
+ - I experience problems when building two files 'pp_sys.o' &
+ 'doio.o'. The build process will crash with a Windows dialog
+ during the build of these two files. The way I get by the problem
+ is to control-C the make and issue the build commands for the two
+ files by hand. In the Perl directory issue the following commands:
`sh cflags libperl.a pp_sys.o` pp_sys.c
`sh cflags libperl.a doio.o` doio.c
* Testing:
I found that the majority of the tests passed. There were no errors
- that I thought particularly scary. There were several unexpected results
- such as a couple 'A required .DLL file, CYGWIN1.DLL, was not found' dialogs
- and 'Perl perform an illegal operation' dialogs.
+ that I thought particularly scary. There were several unexpected
+ results such as a couple 'A required .DLL file, CYGWIN1.DLL, was not
+ found' dialogs and 'Perl perform an illegal operation' dialogs.
*******CSW********
saw the "missing dll" during one test
- Renamed or delete the file <PERL>/t/lib/io_sock.t so it will not be
executed. This test hangs the system. I have made no attempts to
- fix the problem. From the <PERL> directory issue the following command:
+ fix the problem. From the <PERL> directory issue the following
+ command:
*******CSW********
I didn't do this, and saw no problems.
* Installing:
- The install seems to work okay. There are problems when install the man
- pages, but we don't need any stinkin' man pages, right?
+ The install seems to work okay. There are problems when install the
+ man pages, but we don't need any stinkin' man pages, right?
*******CSW********
-the man pages that didn't install were those that had "::" in their filename.
+the man pages that didn't install were those that had "::" in their
+filename.
******************
- Issue the command 'make install' in the directory <PERL>.
-This is an addendum to Steven Morlock's original post. The patch, perl5.005_02.patch, contains the USEMYBINMODE correction described below.
+This document is obsolete. Refer to README.cygwin32.
+
+This is an addendum to Steven Morlock's original post.
+perl5.005_03-static-patch, contains the USEMYBINMODE correction described
+below.
*****************************
Subject: Re: HOWTO: Builiding Perl under Win95/98 using Cygwin32
There is a need to address the issue of end of lines being CR/NL or
NL on the Windows platform. Cygwin32 by default converts NL to CR/NL
during file I/O by non Cygwin32-savvy applications. This means that
-Perl, since it does not support 'binmode' for the Cygwin32 platform, will
-not be able to read & write untranslated/binary files. There are two
-methods of over coming this. The first is to mount the Cygwin32
+Perl, since it does not support 'binmode' for the Cygwin32 platform,
+will not be able to read & write untranslated/binary files. There are
+two methods of over coming this. The first is to mount the Cygwin32
partitions in binary mode. The second is to enable binmode support
in Perl. In the original post I had mounted the partition as binary
and neglected to include that fact in the post.
umount /
mount -b c:\\ /
- You must also get and install the gzip'd version of the Perl source code
- archive. The zip'd version of the archive has all NL converted to CR/NL
- pairs in all text files. So you should be downloading the files ending in
- '.gz', not '.zip'.
+ You must also get and install the gzip'd version of the Perl source
+ code archive. The zip'd version of the archive has all NL converted
+ to CR/NL pairs in all text files. So you should be downloading the
+ files ending in '.gz', not '.zip'.
* Patching Perl to add Cygwin32 binmode support:
+ */
+ #define USEMYBINMODE / **/
+ #define my_binmode(fp, iotype) \
-+ (PerlLIO_setmode(PerlIO_fileno(fp), O_BINARY) != -1 ? TRUE : NULL)
++ (PerlLIO_setmode(PerlIO_fileno(fp), O_BINARY) != -1 ?
+TRUE : NULL)
+ #endif
+
#include "regexp.h"
#endif
#else
#if defined(USEMYBINMODE)
- if (my_binmode(fp,iotype) != NULL)
+ if (my_binmode(fp,iotype) != FALSE)
return 1;
else
return 0;
# define PERL_SYS_INIT(c,v) Perl_win32_init(c,v)
# define BIT_BUCKET "nul"
# else
-# ifdef CYGWIN32
-# define PERL_SYS_INIT(c,v) \
- MALLOC_INIT;
-# define OP_BINARY O_BINARY
-# define BIT_BUCKET "nul"
-# define HAS_IOCTL
-# define HAS_UTIME
-# define HAS_KILL
-# define HAS_WAIT
-# define HAS_CHOWN
-# define HAS_GROUP
-# else
-# define PERL_SYS_INIT(c,v)
-# define BIT_BUCKET "\\dev\\nul" /* "wanna be like, umm, Newlined, or somethin?" */
-# endif
+# define PERL_SYS_INIT(c,v) Perl_my_setenv_init(&environ)
+# define BIT_BUCKET "\\dev\\nul" /* "wanna be like, umm, Newlined, or somethin?" */
# endif
#endif /* DJGPP */
use ExtUtils::MakeMaker;
WriteMakefile(
NAME => 'POSIX',
- ($^O eq 'MSWin32' ? () : ($^O =~ /cygwin/ ? (LIBS => ["-lmsvcrt"]) :
+ ($^O eq 'MSWin32' ? () : ($^O =~ /cygwin/ ? () :
(LIBS => ["-lm -lposix -lcposix"])
)),
MAN3PODS => {}, # Pods will be built by installman.
#else
#if defined (CYGWIN32)
# define tzname _tzname
+# undef MB_CUR_MAX /* XXX: bug in b20.1 */
#endif
#if defined (WIN32)
# undef mkfifo
archname='cygwin32'
cc='gcc'
-libpth='/cygnus/cygwin-b20/H-i586-cygwin32/i586-cygwin32/lib /usr/local/lib'
+libpth='/usr/i586-cygwin32/lib /usr/lib /usr/local/lib'
so='dll'
-libs='-lcygwin -lm -lc -lkernel32'
+libs='-lcygwin -lm -lkernel32'
#optimize='-g'
-ccflags='-DCYGWIN32'
-ldflags='-L. -L/usr/local/lib'
+ccflags='-DCYGWIN32 -I/usr/include -I/usr/local/include'
+ldflags='-L/usr/i586-cygwin32/lib -L/usr/lib -L/usr/local/lib'
usemymalloc='n'
dlsrc='dl_cygwin32.xs'
cccdlflags=' '
ld='ld2'
-lddlflags='--export-dynamic -L. -L/usr/local/lib'
+lddlflags='-L/usr/local/lib'
useshrplib='true'
libperl='libperl.a'
dlext='dll'
my $start = @_ ? shift : '.';
my($dotdots, $cwd, @pst, @cst, $dir, @tst);
- return cwd() if ( $^O =~ /cygwin/ );
-
unless (@cst = stat( $start ))
{
carp "stat($start): $!";
*abs_path = \&_qnx_abs_path;
*fast_abs_path = \&_qnx_abs_path;
}
+ elsif ($^O =~ /cygwin/) {
+ *getcwd = \&cwd;
+ *fastgetcwd = \&cwd;
+ *fastcwd = \&cwd;
+ *abs_path = \&fast_abs_path;
+ }
}
# package main; eval join('',<DATA>) || die $@; # quick test
=item perl_archive
points to libperl.a
+
+=back
+
+=cut
+
*/
/* define this once if either system, instead of cluttering up the src */
-#if defined(MSDOS) || defined(atarist) || defined(WIN32) || defined(CYGWIN32)
+#if defined(MSDOS) || defined(atarist) || defined(WIN32)
#define DOSISH 1
#endif
#define ARGSproto
#endif /* USE_THREADS */
+#if defined(CYGWIN32)
+/* USEMYBINMODE
+ * This symbol, if defined, indicates that the program should
+ * use the routine my_binmode(FILE *fp, char iotype) to insure
+ * that a file is in "binary" mode -- that is, that no translation
+ * of bytes occurs on read or write operations.
+ */
+#define USEMYBINMODE / **/
+#define my_binmode(fp, iotype) \
+ (PerlLIO_setmode(PerlIO_fileno(fp), O_BINARY) != -1 ? TRUE : FALSE)
+#endif
+
typedef I32 (*filter_t) (pTHXo_ int, SV *, int);
#define FILTER_READ(idx, sv, len) filter_read(idx, sv, len)
sv_setpv(tmpcmd, "/dev/dosglob/"); /* File System Extension */
sv_catsv(tmpcmd, tmpglob);
#else
-#ifdef CYGWIN32
- sv_setpv(tmpcmd, "for a in ");
- sv_catsv(tmpcmd, tmpglob);
- sv_catpv(tmpcmd, "; do echo -e \"$a\\0\\c\"; done |");
-#else
sv_setpv(tmpcmd, "perlglob ");
sv_catsv(tmpcmd, tmpglob);
sv_catpv(tmpcmd, " |");
-#endif /* !CYGWIN */
#endif /* !DJGPP */
#endif /* !OS2 */
#else /* !DOSISH */
$Is_MSWin32 = $^O eq 'MSWin32';
$Is_VMS = $^O eq 'VMS';
$Is_Dos = $^O eq 'dos';
+$Is_Cygwin = $^O =~ /cygwin/;
$PERL = ($Is_MSWin32 ? '.\perl' : './perl');
print "1..35\n";
if ($^O eq 'qnx') {
chomp($wd = `/usr/bin/fullpath -t`);
}
+ elsif($Is_Cygwin) {
+ # Cygwin turns the symlink into the real file
+ chomp($wd = `pwd`);
+ $wd =~ s#/t$##;
+ }
else {
$wd = '.';
}
ok 21, close(SCRIPT), $!;
ok 22, chmod(0755, $script), $!;
$_ = `$script`;
- s/\.exe//i if $Is_Dos;
+ s/\.exe//i if $Is_Dos or $Is_Cygwin;
s{\bminiperl\b}{perl}; # so that test doesn't fail with miniperl
s{is perl}{is $perl}; # for systems where $^X is only a basename
s{\\}{/}g;
#endif /* PERL_USE_SAFE_PUTENV */
}
+#else /* WIN32 || CYGWIN32 */
+#if defined(CYGWIN32)
+/*
+ * Save environ of perl.exe, currently Cygwin links in separate environ's
+ * for each exe/dll. Probably should be a member of impure_ptr.
+ */
+static char ***Perl_main_environ;
+
+EXTERN_C void
+Perl_my_setenv_init(char ***penviron)
+{
+ Perl_main_environ = penviron;
+}
+
+void
+my_setenv(char *nam, char *val)
+{
+ /* You can not directly manipulate the environ[] array because
+ * the routines do some additional work that syncs the Cygwin
+ * environment with the Windows environment.
+ */
+ char *oldstr = environ[setenv_getix(nam)];
+
+ if (!val) {
+ if (!oldstr)
+ return;
+ unsetenv(nam);
+ Safefree(oldstr);
+ return;
+ }
+ setenv(nam, val, 1);
+ environ = *Perl_main_environ; /* environ realloc can occur in setenv */
+ if(oldstr && environ[setenv_getix(nam)] != oldstr)
+ Safefree(oldstr);
+}
#else /* if WIN32 */
void
}
#endif /* WIN32 */
+#endif
I32
Perl_setenv_getix(pTHX_ char *nam)
projects / p5sagit/p5-mst-13.2.git / commitdiff