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