File:  [gforth] / gforth / code.fs
Revision 1.20: download - view: text, annotated - select for diffs
Sat Apr 10 14:36:34 2010 UTC (13 years, 11 months ago) by dvdkhlng
Branches: MAIN
CVS tags: HEAD
- updated documentation of ARM assembler
- added documentation for ABI-CODE

    1: \ ASSEMBLER, CODE etc.
    2: 
    3: \ Copyright (C) 1995,1996,1997,1999,2003,2007 Free Software Foundation, Inc.
    4: 
    5: \ This file is part of Gforth.
    6: 
    7: \ Gforth is free software; you can redistribute it and/or
    8: \ modify it under the terms of the GNU General Public License
    9: \ as published by the Free Software Foundation, either version 3
   10: \ of the License, or (at your option) any later version.
   11: 
   12: \ This program is distributed in the hope that it will be useful,
   13: \ but WITHOUT ANY WARRANTY; without even the implied warranty of
   14: \ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   15: \ GNU General Public License for more details.
   16: 
   17: \ You should have received a copy of the GNU General Public License
   18: \ along with this program. If not, see http://www.gnu.org/licenses/.
   19: 
   20: \ does not include the actual assembler (which is machine-dependent),
   21: \ only words like CODE that are implementation-dependent, but can be
   22: \ defined for all machines.
   23: 
   24: vocabulary assembler ( -- ) \ tools-ext
   25: 
   26: : init-asm ( -- ) \ gforth
   27:     also assembler ;
   28: 
   29: : code ( "name" -- colon-sys )	\ tools-ext
   30:     \G start a native code definition
   31:     header
   32:     here >body cfa,
   33:     defstart init-asm ;
   34: 
   35: [ifdef] doabicode:
   36: : abi-code ( "name" -- colon-sys )	\ gforth	abi_code
   37:    \G Start a native code definition that is called using the platform's
   38:    \G ABI conventions corresponding to the C-prototype:
   39:    \G @example
   40:    \G struct@{Cell*sp;double*fp;@} function (Cell *sp, double *fp);
   41:    \G @end example
   42:     header  
   43:     doabicode: cfa,
   44:     defstart init-asm ;
   45: [endif]
   46: 
   47: : (;code) ( -- ) \ gforth
   48:     \ execution semantics of @code{;code}
   49:     r> latestxt code-address! ;
   50: 
   51: :noname ( -- colon-sys )
   52:     align here latestxt code-address!
   53:     defstart init-asm ;
   54: :noname ( colon-sys1 -- colon-sys2 )	\ tools-ext	semicolon-code
   55:     ( create the [;code] part of a low level defining word )
   56:     ;-hook postpone (;code) basic-block-end finish-code ?struc postpone [
   57:     defstart init-asm ;
   58: interpret/compile: ;code ( compilation. colon-sys1 -- colon-sys2 )	\ tools-ext	semicolon-code
   59: 
   60: : end-code ( colon-sys -- )	\ gforth	end_code
   61:     \G end a code definition 
   62:     latestxt here over - flush-icache
   63:     previous ?struc reveal ;
   64: 

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>