XSUBPP(1) Perl Programmers Reference Guide XSUBPP(1)NAMExsubpp - compiler to convert Perl XS code into C code
SYNOPSISxsubpp [-v] [-C++] [-csuffix csuffix] [-except] [-s pattern]
[-prototypes] [-noversioncheck] [-nolinenumbers] [-nooptim-
ize] [-typemap typemap] ... file.xs
DESCRIPTION
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
OPTIONS
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.
ENVIRONMENT
No environment variables are used.
AUTHOR
Larry Wall
MODIFICATION HISTORY
See the file changes.pod.
SEE ALSOperl(1), perlxs(1), perlxstut(1)perl v5.8.8 2006-06-30 2