MirOS Manual: xsubpp(1)

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

     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

     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.



     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.

          Retains '::' in type names so that C++ hierachical
          types can be mapped.

          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)

          By default xsubpp will not automatically generate pro-
          totype code for all xsubs. This flag will enable proto-

          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.

          Prevents the inclusion of `#line' directives in the

          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.

          Disable recognition of "IN", "OUT_LIST" and
          "INOUT_LIST" declarations.

          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 2015-10-06 19:36:22 by $MirOS: src/scripts/roff2htm,v 1.80 2015/01/02 13:54:19 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–2015 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.