| 1 | If you read this file _as_is_, just ignore the funny characters you
|
|---|
| 2 | see. It is written in the POD format (see pod/perlpod.pod) which is
|
|---|
| 3 | specially designed to be readable as is.
|
|---|
| 4 |
|
|---|
| 5 | =head1 NAME
|
|---|
| 6 |
|
|---|
| 7 | README.cygwin - Perl for Cygwin
|
|---|
| 8 |
|
|---|
| 9 | =head1 SYNOPSIS
|
|---|
| 10 |
|
|---|
| 11 | This document will help you configure, make, test and install Perl
|
|---|
| 12 | on Cygwin. This document also describes features of Cygwin that will
|
|---|
| 13 | affect how Perl behaves at runtime.
|
|---|
| 14 |
|
|---|
| 15 | B<NOTE:> There are pre-built Perl packages available for Cygwin and a
|
|---|
| 16 | version of Perl is provided in the normal Cygwin install. If you do
|
|---|
| 17 | not need to customize the configuration, consider using one of those
|
|---|
| 18 | packages.
|
|---|
| 19 |
|
|---|
| 20 |
|
|---|
| 21 | =head1 PREREQUISITES FOR COMPILING PERL ON CYGWIN
|
|---|
| 22 |
|
|---|
| 23 | =head2 Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
|
|---|
| 24 |
|
|---|
| 25 | The Cygwin tools are ports of the popular GNU development tools for Win32
|
|---|
| 26 | platforms. They run thanks to the Cygwin library which provides the UNIX
|
|---|
| 27 | system calls and environment these programs expect. More information
|
|---|
| 28 | about this project can be found at:
|
|---|
| 29 |
|
|---|
| 30 | http://www.cygwin.com/
|
|---|
| 31 |
|
|---|
| 32 | A recent net or commercial release of Cygwin is required.
|
|---|
| 33 |
|
|---|
| 34 | At the time this document was last updated, Cygwin 1.5.2 was current.
|
|---|
| 35 |
|
|---|
| 36 |
|
|---|
| 37 | =head2 Cygwin Configuration
|
|---|
| 38 |
|
|---|
| 39 | While building Perl some changes may be necessary to your Cygwin setup so
|
|---|
| 40 | that Perl builds cleanly. These changes are B<not> required for normal
|
|---|
| 41 | Perl usage.
|
|---|
| 42 |
|
|---|
| 43 | B<NOTE:> The binaries that are built will run on all Win32 versions.
|
|---|
| 44 | They do not depend on your host system (Win9x/WinME, WinNT/Win2K)
|
|---|
| 45 | or your Cygwin configuration (I<ntea>, I<ntsec>, binary/text mounts).
|
|---|
| 46 | The only dependencies come from hard-coded pathnames like C</usr/local>.
|
|---|
| 47 | However, your host system and Cygwin configuration will affect Perl's
|
|---|
| 48 | runtime behavior (see L</"TEST">).
|
|---|
| 49 |
|
|---|
| 50 | =over 4
|
|---|
| 51 |
|
|---|
| 52 | =item * C<PATH>
|
|---|
| 53 |
|
|---|
| 54 | Set the C<PATH> environment variable so that Configure finds the Cygwin
|
|---|
| 55 | versions of programs. Any Windows directories should be removed or
|
|---|
| 56 | moved to the end of your C<PATH>.
|
|---|
| 57 |
|
|---|
| 58 | =item * I<nroff>
|
|---|
| 59 |
|
|---|
| 60 | If you do not have I<nroff> (which is part of the I<groff> package),
|
|---|
| 61 | Configure will B<not> prompt you to install I<man> pages.
|
|---|
| 62 |
|
|---|
| 63 | =item * Permissions
|
|---|
| 64 |
|
|---|
| 65 | On WinNT with either the I<ntea> or I<ntsec> C<CYGWIN> settings, directory
|
|---|
| 66 | and file permissions may not be set correctly. Since the build process
|
|---|
| 67 | creates directories and files, to be safe you may want to run a
|
|---|
| 68 | C<chmod -R +w *> on the entire Perl source tree.
|
|---|
| 69 |
|
|---|
| 70 | Also, it is a well known WinNT "feature" that files created by a login
|
|---|
| 71 | that is a member of the I<Administrators> group will be owned by the
|
|---|
| 72 | I<Administrators> group. Depending on your umask, you may find that you
|
|---|
| 73 | can not write to files that you just created (because you are no longer
|
|---|
| 74 | the owner). When using the I<ntsec> C<CYGWIN> setting, this is not an
|
|---|
| 75 | issue because it "corrects" the ownership to what you would expect on
|
|---|
| 76 | a UNIX system.
|
|---|
| 77 |
|
|---|
| 78 | =back
|
|---|
| 79 |
|
|---|
| 80 | =head1 CONFIGURE PERL ON CYGWIN
|
|---|
| 81 |
|
|---|
| 82 | The default options gathered by Configure with the assistance of
|
|---|
| 83 | F<hints/cygwin.sh> will build a Perl that supports dynamic loading
|
|---|
| 84 | (which requires a shared F<libperl.dll>).
|
|---|
| 85 |
|
|---|
| 86 | This will run Configure and keep a record:
|
|---|
| 87 |
|
|---|
| 88 | ./Configure 2>&1 | tee log.configure
|
|---|
| 89 |
|
|---|
| 90 | If you are willing to accept all the defaults run Configure with B<-de>.
|
|---|
| 91 | However, several useful customizations are available.
|
|---|
| 92 |
|
|---|
| 93 | =head2 Stripping Perl Binaries on Cygwin
|
|---|
| 94 |
|
|---|
| 95 | It is possible to strip the EXEs and DLLs created by the build process.
|
|---|
| 96 | The resulting binaries will be significantly smaller. If you want the
|
|---|
| 97 | binaries to be stripped, you can either add a B<-s> option when Configure
|
|---|
| 98 | prompts you,
|
|---|
| 99 |
|
|---|
| 100 | Any additional ld flags (NOT including libraries)? [none] -s
|
|---|
| 101 | Any special flags to pass to gcc to use dynamic linking? [none] -s
|
|---|
| 102 | Any special flags to pass to ld2 to create a dynamically loaded library?
|
|---|
| 103 | [none] -s
|
|---|
| 104 |
|
|---|
| 105 | or you can edit F<hints/cygwin.sh> and uncomment the relevant variables
|
|---|
| 106 | near the end of the file.
|
|---|
| 107 |
|
|---|
| 108 | =head2 Optional Libraries for Perl on Cygwin
|
|---|
| 109 |
|
|---|
| 110 | Several Perl functions and modules depend on the existence of
|
|---|
| 111 | some optional libraries. Configure will find them if they are
|
|---|
| 112 | installed in one of the directories listed as being used for library
|
|---|
| 113 | searches. Pre-built packages for most of these are available from
|
|---|
| 114 | the Cygwin installer.
|
|---|
| 115 |
|
|---|
| 116 | =over 4
|
|---|
| 117 |
|
|---|
| 118 | =item * C<-lcrypt>
|
|---|
| 119 |
|
|---|
| 120 | The crypt package distributed with Cygwin is a Linux compatible 56-bit
|
|---|
| 121 | DES crypt port by Corinna Vinschen.
|
|---|
| 122 |
|
|---|
|
|---|
