XSUBPP(1)							     XSUBPP(1)

NAME    [Toc]    [Back]

     xsubpp - compiler to convert Perl XS code into C code

SYNOPSIS    [Toc]    [Back]

     xsubpp [-v] [-C++]	[-except] [-s pattern] [-prototypes] [-noversioncheck]
     [-nolinenumbers] [-typemap	typemap]... file.xs

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

     -C++ Adds ``extern	"C"'' to the C code.

     -except
	  Adds exception handling stubs	to the C code.

     -typemap typemap
	  Indicates that a user-supplied typemap should	take precedence	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.

     -prototypes
	  By default xsubpp will not automatically generate prototype code for
	  all xsubs. This flag will enable prototypes.

     -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.

ENVIRONMENT    [Toc]    [Back]

     No	environment variables are used.







									Page 1






XSUBPP(1)							     XSUBPP(1)



AUTHOR
     Larry Wall

MODIFICATION HISTORY    [Toc]    [Back]

     See the file changes.pod.

SEE ALSO    [Toc]    [Back]

     perl(1), perlxs(1), perlxstut(1)


									PPPPaaaaggggeeee 2222