Inline-ASM - README

INTRODUCTION

Inline::ASM - Write Perl subroutines in assembler.

Inline::ASM is an Inline Language Support Module (ILSM) for assembler.

Example

use Inline ASM => <<'END', PROTOTYPES => {JAxH=>'SV(char)'};

            BITS 32
            GLOBAL JAxH
            EXTERN Perl_newSVpvf

            SECTION .text

; prototype: SV* JAxH(char *x);
JAxH push ebp

            mov ebp,esp
            mov eax,[ebp+8]
            push dword eax
            push dword jaxhstr
            call Perl_newSVpvf
            mov esp,ebp
            pop ebp
            ret

SECTION .data

jaxhstr db "Just Another %s Hacker", 0 END

print JAxH('Perl');

When run, this complete program prints:

Just Another Inline Hacker

FEATURES:

Inline::ASM is an ALPHA release. It does not have any test scripts defined because no test script can be guaranteed to work with every version of Perl, different assembler syntaxes, and different platforms. There are several example scripts in the examples directory.

INSTALLATION:

This module requires Inline.pm and Inline::C.pm version 0.42 or higher to be installed.

To install Inline::ASM do this:

perl Makefile.PL
make
make test
make install

(On ActivePerl for MSWin32, use nmake instead of make.)

You have to 'make install' before you can run it successfully.

INFORMATION:

For more infor on Inline, see 'perldoc Inline' and 'perldoc Inline-Support'
For information about Inline::, see 'perldoc Inline::C' and 'perldoc Inline::C-Cookbook'
For information on writing your own Inline extension see 'perldoc Inline-API'
For information about the Perl5 internal C API, see 'perldoc perlapi' or try http://www.perldoc.com/perl5.6/pod/perlapi.html

The Inline.pm mailing list is inline@perl.org. Send email to inline-subscribe@perl.org to subscribe.

Please send questions and comments to "Neil Watkiss" <NEILW@cpan.org>