1# 2# Copyright 2005 Sun Microsystems, Inc. All rights reserved. 3# Use is subject to license terms. 4# 5# CDDL HEADER START 6# 7# The contents of this file are subject to the terms of the 8# Common Development and Distribution License, Version 1.0 only 9# (the "License"). You may not use this file except in compliance 10# with the License. 11# 12# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 13# or http://www.opensolaris.org/os/licensing. 14# See the License for the specific language governing permissions 15# and limitations under the License. 16# 17# When distributing Covered Code, include this CDDL HEADER in each 18# file and include the License file at usr/src/OPENSOLARIS.LICENSE. 19# If applicable, add the following below this CDDL HEADER, with the 20# fields enclosed by brackets "[]" replaced with your own identifying 21# information: Portions Copyright [yyyy] [name of copyright owner] 22# 23# CDDL HEADER END 24# 25#ident "%Z%%M% %I% %E% SMI" 26# 27 28=head1 NAME 29 30perlgcc - Compile perl modules using gcc. 31 32=head1 SYNOPSIS 33 34 perlgcc Makefile.PL; make 35 36=head1 DESCRIPTION 37 38When perl is built it saves the name of the compiler and any compiler flags 39in its configuration files, and then uses these saved settings when any 40additional modules are built. The perl shipped with Solaris is built with the 41Forte compilers rather than gcc. 42 43If add-on modules are built with the Forte compilers, everyting works as 44expected. However, if gcc is used to build add-on modules, the saved 45configuration is incorrect as it assumes that the Forte compiler will be 46present. 47 48This command provides a set of perl configuration files that are configured to 49use gcc as the compiler rather than the Forte compiler. The default 50configuration files are not modified, instead a replacement set of files are 51transparently substituted for the duration of the perlgcc command. 52 53Instead of invoking C<perl Makefile.PL> to generate the makefile needed 54to compile a module, C<perlgcc Makefile.PL> should be used instead. 55All command-line arguments to perlgcc are passed unmodified to C<perl>. 56 57If you use the CPAN.pm module, instead of invoking C<perl -MCPAN -e shell>, 58you should use C<perlgcc -MCPAN -e shell> instead, and use as normal. 59 60=head1 ENVIRONMENT VARIABLES 61 62PERL5LIB 63 64This is modified to point to the location of the replacement perl configuration 65files. 66 67=head2 ATTRIBUTES 68 69See C<attributes(5)> for descriptions of the following attributes: 70 71 ___________________________________________________________ 72 | ATTRIBUTE TYPE | ATTRIBUTE VALUE | 73 |_____________________________|_____________________________| 74 | Availability | CPAN (http://www.cpan.org) | 75 |_____________________________|_____________________________| 76 | Interface Stability | Evolving | 77 |_____________________________|_____________________________| 78 79=head1 SEE ALSO 80 81C<perl(1)>, C<perlrun(1)>, C<perlsolaris(1)>. 82