XSUBPP(1) Perl Programmers Reference Guide XSUBPP(1)
xsubpp - compiler to convert Perl XS code into C code
xsubpp [-v] [-C++] [-csuffix csuffix] [-except] [-s pattern]
[-prototypes] [-noversioncheck] [-nolinenumbers] [-nooptim-
ize] [-typemap typemap] ... file.xs
This compiler is typically run by the makefiles created by
ExtUtils::MakeMaker.
xsubpp will compile XS code into C code by embedding the
constructs necessary to let C functions manipulate Perl
values and creates the glue necessary to let Perl access
those functions. The compiler uses typemaps to determine
how to map C function parameters and variables to Perl
values.
The compiler will search for typemap files called typemap.
It will use the following search path to find default
typemaps, with the rightmost typemap taking precedence.
../../../typemap:../../typemap:../typemap:typemap
Note that the "XSOPT" MakeMaker option may be used to add
these options to any makefiles generated by MakeMaker.
-C++ Adds ``extern "C"'' to the C code.
-csuffix csuffix
Set the suffix used for the generated C or C++ code.
Defaults to '.c' (even with -C++), but some platforms
might want to have e.g. '.cpp'. Don't forget the '.'
from the front.
-hiertype
Retains '::' in type names so that C++ hierachical
types can be mapped.
-except
Adds exception handling stubs to the C code.
-typemap typemap
Indicates that a user-supplied typemap should take pre-
cedence over the default typemaps. This option may be
used multiple times, with the last typemap having the
highest precedence.
-v Prints the xsubpp version number to standard output,
then exits.
perl v5.8.8 2006-06-30 1
XSUBPP(1) Perl Programmers Reference Guide XSUBPP(1)
-prototypes
By default xsubpp will not automatically generate pro-
totype code for all xsubs. This flag will enable proto-
types.
-noversioncheck
Disables the run time test that determines if the
object file (derived from the ".xs" file) and the ".pm"
files have the same version number.
-nolinenumbers
Prevents the inclusion of `#line' directives in the
output.
-nooptimize
Disables certain optimizations. The only optimization
that is currently affected is the use of targets by the
output C code (see perlguts). This may significantly
slow down the generated code, but this is the way
xsubpp of 5.005 and earlier operated.
-noinout
Disable recognition of "IN", "OUT_LIST" and
"INOUT_LIST" declarations.
-noargtypes
Disable recognition of ANSI-like descriptions of func-
tion signature.
No environment variables are used.
Larry Wall
See the file changes.pod.
perl(1), perlxs(1), perlxstut(1)
perl v5.8.8 2006-06-30 2
Generated on 2013-04-27 00:20:00 by $MirOS: src/scripts/roff2htm,v 1.77 2013/01/01 20:49:09 tg Exp $
These manual pages and other documentation are copyrighted by their respective writers;
their source is available at our CVSweb,
AnonCVS, and other mirrors. The rest is Copyright © 2002‒2013 The MirOS Project, Germany.
This product includes material
provided by Thorsten Glaser.
This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.