gforth/fflib.fs - view

File: [gforth] / gforth / fflib.fs
Revision 1.20: download - view: text, annotated - select for diffs
Mon Apr 28 08:42:59 2008 UTC (15 years, 11 months ago) by anton
Branches: MAIN
CVS tags: HEAD

added CLEAR-LIB ADD-LIB (libcc.fs), documented them,
  and used them in libffi.fs and fflib.fs
OPEN-LIB no longer guesses library extensions (lt_dladvise_ext())

1: \ lib.fs shared library support package 16aug03py 2: 3: \ Copyright (C) 1995,1996,1997,1998,2000,2003,2005,2006,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: \ replacements for former primitives 21: require libcc.fs 22: 23: clear-libs 24: s" avcall" add-lib 25: s" callback" add-lib 26: 27: \c #include <avcall.h> 28: \c #include <callback.h> 29: \c static av_alist alist; 30: \c static va_alist gforth_clist; 31: \c static float frv; 32: \c static int irv; 33: \c static double drv; 34: \c static long long llrv; 35: \c static void * prv; 36: \c static Cell *gforth_RP; 37: \c static char *gforth_LP; 38: \c typedef void *Label; 39: \c typedef Label *Xt; 40: \c Label *gforth_engine(Xt *ip, Cell *sp, Cell *rp0, Float *fp, char *lp); 41: \c 42: \c void gforth_callback_ffcall(Xt* fcall, void * alist) 43: \c { 44: \c /* save global valiables */ 45: \c Cell *rp = gforth_RP; 46: \c Cell *sp = gforth_SP; 47: \c Float *fp = gforth_FP; 48: \c char *lp = gforth_LP; 49: \c va_alist clist = gforth_clist; 50: \c 51: \c gforth_clist = (va_alist)alist; 52: \c 53: \c gforth_engine(fcall, sp, rp, fp, lp); 54: \c 55: \c /* restore global variables */ 56: \c gforth_RP = rp; 57: \c gforth_SP = sp; 58: \c gforth_FP = fp; 59: \c gforth_LP = lp; 60: \c gforth_clist = clist; 61: \c } 62: 63: \c #define av_start_void1(c_addr) av_start_void(alist, c_addr) 64: c-function av-start-void av_start_void1 a -- void 65: \c #define av_start_int1(c_addr) av_start_int(alist, c_addr, &irv) 66: c-function av-start-int av_start_int1 a -- void 67: \c #define av_start_float1(c_addr) av_start_float(alist, c_addr, &frv) 68: c-function av-start-float av_start_float1 a -- void 69: \c #define av_start_double1(c_addr) av_start_double(alist, c_addr, &drv) 70: c-function av-start-double av_start_double1 a -- void 71: \c #define av_start_longlong1(c_addr) av_start_longlong(alist, c_addr, &llrv) 72: c-function av-start-longlong av_start_longlong1 a -- void 73: \c #define av_start_ptr1(c_addr) av_start_ptr(alist, c_addr, void *, &prv) 74: c-function av-start-ptr av_start_ptr1 a -- void 75: \c #define av_int1(w) av_int(alist,w) 76: c-function av-int av_int1 n -- void 77: \c #define av_float1(r) av_float(alist,r) 78: c-function av-float av_float1 r -- void 79: \c #define av_double1(r) av_double(alist,r) 80: c-function av-double av_double1 r -- void 81: \c #define av_longlong1(d) av_longlong(alist,d) 82: c-function av-longlong av_longlong1 d -- void 83: \c #define av_ptr1(a) av_ptr(alist, void *, a) 84: c-function av-ptr av_ptr1 a -- void 85: \c #define av_call_void() av_call(alist) 86: c-function av-call-void av_call_void -- void 87: \c #define av_call_int() (av_call(alist), irv) 88: c-function av-call-int av_call_int -- n 89: \c #define av_call_float() (av_call(alist), frv) 90: c-function av-call-float av_call_float -- r 91: \c #define av_call_double() (av_call(alist), drv) 92: c-function av-call-double av_call_double -- r 93: \c #define av_call_longlong() (av_call(alist), llrv) 94: c-function av-call-longlong av_call_longlong -- d 95: \c #define av_call_ptr() (av_call(alist), prv) 96: c-function av-call-ptr av_call_ptr -- a 97: \c #define alloc_callback1(a_ip) alloc_callback(gforth_callback_ffcall, (Xt *)a_ip) 98: c-function alloc-callback alloc_callback1 a -- a 99: \c #define va_start_void1() va_start_void(gforth_clist) 100: c-function va-start-void va_start_void1 -- void 101: \c #define va_start_int1() va_start_int(gforth_clist) 102: c-function va-start-int va_start_int1 -- void 103: \c #define va_start_longlong1() va_start_longlong(gforth_clist) 104: c-function va-start-longlong va_start_longlong1 -- void 105: \c #define va_start_ptr1() va_start_ptr(gforth_clist, (char *)) 106: c-function va-start-ptr va_start_ptr1 -- void 107: \c #define va_start_float1() va_start_float(gforth_clist) 108: c-function va-start-float va_start_float1 -- void 109: \c #define va_start_double1() va_start_double(gforth_clist) 110: c-function va-start-double va_start_double1 -- void 111: \c #define va_arg_int1() va_arg_int(gforth_clist) 112: c-function va-arg-int va_arg_int1 -- n 113: \c #define va_arg_longlong1() va_arg_longlong(gforth_clist) 114: c-function va-arg-longlong va_arg_longlong1 -- d 115: \c #define va_arg_ptr1() va_arg_ptr(gforth_clist, char *) 116: c-function va-arg-ptr va_arg_ptr1 -- a 117: \c #define va_arg_float1() va_arg_float(gforth_clist) 118: c-function va-arg-float va_arg_float1 -- r 119: \c #define va_arg_double1() va_arg_double(gforth_clist) 120: c-function va-arg-double va_arg_double1 -- r 121: \c #define va_return_void1() va_return_void(gforth_clist) 122: c-function va-return-void1 va_return_void1 -- void 123: \c #define va_return_int1(w) va_return_int(gforth_clist,w) 124: c-function va-return-int1 va_return_int1 n -- void 125: \c #define va_return_ptr1(w) va_return_ptr(gforth_clist, void *, w) 126: c-function va-return-ptr1 va_return_ptr1 a -- void 127: \c #define va_return_longlong1(d) va_return_longlong(gforth_clist,d) 128: c-function va-return-longlong1 va_return_longlong1 d -- void 129: \c #define va_return_float1(r) va_return_float(gforth_clist,r) 130: c-function va-return-float1 va_return_float1 r -- void 131: \c #define va_return_double1(r) va_return_double(gforth_clist,r) 132: c-function va-return-double1 va_return_double1 r -- void 133: 134: : av-int-r 2r> >r av-int ; 135: : av-float-r f@local0 lp+ av-float ; 136: : av-double-r f@local0 lp+ av-double ; 137: : av-longlong-r r> 2r> rot >r av-longlong ; 138: : av-ptr-r 2r> >r av-ptr ; 139: : va-return-void va-return-void1 0 (bye) ; 140: : va-return-int va-return-int1 0 (bye) ; 141: : va-return-ptr va-return-ptr1 0 (bye) ; 142: : va-return-longlong va-return-longlong1 0 (bye) ; 143: : va-return-float va-return-float1 0 (bye) ; 144: : va-return-double va-return-double1 0 (bye) ; 145: 146: \ start of fflib proper 147: 148: Variable libs 0 libs ! 149: \ links between libraries 150: Variable thisproc 151: Variable thislib 152: 153: Variable revdec revdec off 154: \ turn revdec on to compile bigFORTH libraries 155: Variable revarg revarg off 156: \ turn revarg on to compile declarations with reverse arguments 157: Variable legacy legacy off 158: \ turn legacy on to compile bigFORTH legacy libraries 159: 160: Vocabulary c-decl 161: Vocabulary cb-decl 162: 163: : @lib ( lib -- ) 164: \G obtains library handle 165: cell+ dup 2 cells + count open-lib 166: dup 0= abort" Library not found" swap ! ; 167: 168: : @proc ( lib addr -- ) 169: \G obtains symbol address 170: cell+ tuck cell+ @ count rot cell+ @ 171: lib-sym dup 0= abort" Proc not found!" swap ! ; 172: 173: : proc, ( lib -- ) 174: \G allocates and initializes proc stub 175: \G stub format: 176: \G linked list in library 177: \G address of proc 178: \G ptr to OS name of symbol as counted string 179: \G threaded code for invocation 180: here dup thisproc ! 181: swap 2 cells + dup @ A, ! 182: 0 , 0 A, ; 183: 184: Defer legacy-proc ' noop IS legacy-proc 185: 186: : proc: ( lib "name" -- ) 187: \G Creates a named proc stub 188: Create proc, 0 also c-decl 189: legacy @ IF legacy-proc THEN 190: DOES> ( x1 .. xn -- r ) 191: dup cell+ @ swap 3 cells + >r ; 192: 193: Variable ind-call ind-call off 194: : fptr ( "name" -- ) 195: Create here thisproc ! 0 , 0 , 0 , 0 also c-decl ind-call on 196: DOES> 3 cells + >r ; 197: 198: : library ( "name" "file" -- ) 199: \G loads library "file" and creates a proc defining word "name" 200: \G library format: 201: \G linked list of libraries 202: \G library handle 203: \G linked list of library's procs 204: \G OS name of library as counted string 205: Create here libs @ A, dup libs ! 206: 0 , 0 A, parse-name string, @lib 207: DOES> ( -- ) dup thislib ! proc: ; 208: 209: : init-shared-libs ( -- ) 210: defers 'cold 211: 0 libs BEGIN 212: @ dup WHILE 213: dup REPEAT 214: drop BEGIN 215: dup WHILE 216: >r 217: r@ @lib 218: r@ 2 cells + BEGIN 219: @ dup WHILE 220: r@ over @proc REPEAT 221: drop rdrop 222: REPEAT 223: drop ; 224: 225: ' init-shared-libs IS 'cold 226: 227: : argtype ( revxt pushxt fwxt "name" -- ) 228: Create , , , ; 229: 230: : arg@ ( arg -- argxt pushxt ) 231: revarg @ IF 2 cells + @ ['] noop swap ELSE 2@ THEN ; 232: 233: : arg, ( xt -- ) 234: dup ['] noop = IF drop EXIT THEN compile, ; 235: 236: : decl, ( 0 arg1 .. argn call start -- ) 237: 2@ compile, >r 238: revdec @ IF 0 >r 239: BEGIN dup WHILE >r REPEAT 240: BEGIN r> dup WHILE arg@ arg, REPEAT drop 241: BEGIN dup WHILE arg, REPEAT drop 242: ELSE 0 >r 243: BEGIN dup WHILE arg@ arg, >r REPEAT drop 244: BEGIN r> dup WHILE arg, REPEAT drop 245: THEN 246: r> compile, postpone EXIT ; 247: 248: : symbol, ( "c-symbol" -- ) 249: here thisproc @ 2 cells + ! parse-name s, 250: thislib @ thisproc @ @proc ; 251: 252: : rettype ( endxt startxt "name" -- ) 253: Create 2, 254: DOES> decl, ind-call @ 0= IF symbol, THEN 255: previous revarg off ind-call off ; 256: 257: also c-decl definitions 258: 259: : <rev> revarg on ; 260: 261: ' av-int ' av-int-r ' >r argtype int 262: ' av-float ' av-float-r ' f>l argtype sf 263: ' av-double ' av-double-r ' f>l argtype df 264: ' av-longlong ' av-longlong-r ' 2>r argtype dlong 265: ' av-ptr ' av-ptr-r ' >r argtype ptr 266: 267: ' av-call-void ' av-start-void rettype (void) 268: ' av-call-int ' av-start-int rettype (int) 269: ' av-call-float ' av-start-float rettype (sf) 270: ' av-call-double ' av-start-double rettype (fp) 271: ' av-call-longlong ' av-start-longlong rettype (dlong) 272: ' av-call-ptr ' av-start-ptr rettype (ptr) 273: 274: : (addr) postpone EXIT drop symbol, previous revarg off ; 275: 276: previous definitions 277: 278: \ legacy support for old library interfaces 279: \ interface to old vararg stuff not implemented yet 280: 281: also c-decl 282: 283: :noname ( n 0 -- 0 int1 .. intn ) 284: legacy @ 0< revarg ! 285: swap 0 ?DO int LOOP (int) 286: ; IS legacy-proc 287: 288: : (int) ( n -- ) 289: >r ' execute r> 0 ?DO int LOOP (int) ; 290: : (void) ( n -- ) 291: >r ' execute r> 0 ?DO int LOOP (void) ; 292: : (float) ( n -- ) 293: >r ' execute r> 0 ?DO df LOOP (fp) ; 294: 295: previous 296: 297: \ callback stuff 298: 299: Variable callbacks 300: \G link between callbacks 301: 302: : callback ( -- ) 303: Create 0 ] postpone >r also cb-decl 304: DOES> 305: Create here >r 0 , callbacks @ A, r@ callbacks ! 306: swap postpone Literal postpone call , postpone EXIT 307: r> dup cell+ cell+ alloc-callback swap ! 308: DOES> @ ; 309: 310: : callback; ( 0 xt1 .. xtn -- ) 311: BEGIN over WHILE compile, REPEAT 312: postpone r> postpone execute compile, drop 313: postpone EXIT postpone [ previous ; immediate 314: 315: : va-ret ( xt xt -- ) 316: Create A, A, immediate 317: DOES> 2@ compile, ; 318: 319: : init-callbacks ( -- ) 320: defers 'cold callbacks 1 cells - 321: BEGIN cell+ @ dup WHILE dup cell+ cell+ alloc-callback over ! 322: REPEAT drop ; 323: 324: ' init-callbacks IS 'cold 325: 326: also cb-decl definitions 327: 328: \ arguments 329: 330: ' va-arg-int Alias int 331: ' va-arg-float Alias sf 332: ' va-arg-double Alias df 333: ' va-arg-longlong Alias dlong 334: ' va-arg-ptr Alias ptr 335: 336: ' va-return-void ' va-start-void va-ret (void) 337: ' va-return-int ' va-start-int va-ret (int) 338: ' va-return-float ' va-start-float va-ret (sf) 339: ' va-return-double ' va-start-double va-ret (fp) 340: ' va-return-longlong ' va-start-longlong va-ret (dlong) 341: ' va-return-ptr ' va-start-ptr va-ret (ptr) 342: 343: previous definitions 344: clear-libs