Newer
Older
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
;;;; -*- Mode: Lisp; Syntax: Common-Lisp; Package: SYSTEM -*-
;;;;
;;;; Copyright (c) 2001, Juan Jose Garcia-Ripoll
;;;; Copyright (c) 2012, Jean-Claude Beaudoin.
;;;;
;;;; This program is free software; you can redistribute it and/or
;;;; modify it under the terms of the GNU Lesser General Public
;;;; License as published by the Free Software Foundation; either
;;;; version 3 of the License, or (at your option) any later version.
;;;;
;;;; See file '../../Copyright' for full details.
;;;; FFI Symbols used in the foreign function interface. Basically, UFFI plus some extensions.
(defpackage "FFI"
(:nicknames "UFFI")
(:export "CLINES" "DEFENTRY" "DEFLA" "DEFCBODY" "DEFINLINE" "C-INLINE" ;; extension to UFFI
"DEFCALLBACK" "CALLBACK" ;; extension to UFFI
;; The UFFI Protocol
"DEF-CONSTANT" "DEF-FOREIGN-TYPE" "DEF-ENUM" "DEF-STRUCT"
"DEF-ARRAY-POINTER" "DEF-FUNCTION" "DEF-UNION" "DEF-ARRAY"
"ALLOCATE-FOREIGN-OBJECT" "FREE-FOREIGN-OBJECT" "MAKE-NULL-POINTER"
"GET-SLOT-VALUE" "GET-SLOT-POINTER" "DEREF-ARRAY" "DEREF-POINTER"
"POINTER-ADDRESS" "SIZE-OF-FOREIGN-TYPE" "DEF-FOREIGN-VAR"
"NULL-CHAR-P" "ENSURE-CHAR-CHARACTER" "ENSURE-CHAR-INTEGER"
"NULL-POINTER-P" "+NULL-CSTRING-POINTER+" "WITH-FOREIGN-OBJECTS"
"MAKE-POINTER" "CHAR-ARRAY-TO-POINTER" "CONVERT-TO-FOREIGN-STRING"
"CONVERT-FROM-FOREIGN-STRING" "ALLOCATE-FOREIGN-STRING"
"WITH-FOREIGN-STRING" "WITH-FOREIGN-STRINGS"
"FOREIGN-STRING-LENGTH" "WITH-FOREIGN-OBJECT"
"FIND-FOREIGN-LIBRARY" "LOAD-FOREIGN-LIBRARY"
"ENSURE-CHAR-STORABLE" "DEF-TYPE"
"WITH-CSTRING" "CONVERT-TO-CSTRING" "CONVERT-FROM-CSTRING" "FREE-CSTRING"
"WITH-CAST-POINTER" "WITH-CSTRINGS"
)
(:import-from "SYS" "NULL-POINTER-P"))
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
(in-package "FFI")
#-mkcl-min
(clines "#include <string.h>")
(defmacro def-constant (name value &key (export nil))
"Macro to define a constant and to export it"
`(eval-when (:compile-toplevel :load-toplevel :execute)
(defconstant ,name ,value)
,(when export (list 'export `(quote ,name)))
',name))
;;;----------------------------------------------------------------------
;;; FOREIGN TYPES
;;;
(defvar *ffi-types* (make-hash-table :size 128))
(defun foreign-elt-type-p (name)
(and (symbolp name)
(member name '(:byte :unsigned-byte :short :unsigned-short
:int :unsigned-int :char :unsigned-char
:long :unsigned-long
:long-long
:unsigned-long-long
:pointer-void :object
:float :double :cstring
:long-double
:int16-t :unit16-t :int32-t :uint32-t :int64-t :uint64-t
)
:test 'eq)))
(defmacro def-foreign-type (name definition)
`(eval-when (:compile-toplevel :load-toplevel :execute)
(setf (gethash ',name ffi::*ffi-types*) ',definition)))
(defmacro def-type (name definition)
(declare (ignore definition))
`(deftype ,name () t))
(defun %convert-to-ffi-type (type &optional context)
(if (atom type)
(if (member type context)
type
(multiple-value-bind (value present-p) (gethash type *ffi-types* type)
(if present-p
(%convert-to-ffi-type value (cons type context))
value)))
(cons (%convert-to-ffi-type (first type) context)
(%convert-to-ffi-type (rest type) context))))
(defmacro %align-data (data align)
`(setf ,data (* (ceiling (/ ,data ,align)) ,align)))
(defun size-of-foreign-type (name)
(let* ((size 0) align
(type (%convert-to-ffi-type name)))
(unless type
(error "Incomplete or unknown foreign type ~A" name))
(cond ((symbolp type)
(setf size (si::size-of-foreign-elt-type type)))
((atom type)
(error "~A is not a valid foreign type identifier" name))
((eq (setf name (first type)) :struct)
(setf size (slot-position type nil))
(setf align
(apply #'max
(mapcar
#'(lambda (field)
(multiple-value-bind (field-size field-align)
(size-of-foreign-type (second field))
(declare (ignore field-size))
field-align))
(rest type))))
(%align-data size align))
((eq name :array)
(unless (and (setf size (third type)) (realp size))
(error "Incomplete foreign type: ~S" type))
(multiple-value-bind (elt-size elt-align)
(size-of-foreign-type (second type))
(setf size (* size elt-size))
(setf align elt-align)))
((eq name :union)
(dolist (field (rest type))
(multiple-value-bind (field-size field-align)
(size-of-foreign-type (second field))
(when (> field-size size)
(setf size field-size))
(when (or (null align) (> field-align align))
(setf align field-align)))))
((eq name '*)
(setf size (si::size-of-foreign-elt-type :pointer-void)))
((eq name 'quote)
(size-of-foreign-type (second type)))
(t
(error "~A does not denote a foreign type" name)))
(unless align
(setf align size))
(values size
#+x86 (min align
#+unix 4
#+windows 8) ;; Good only for default /Zp option
#+x86-64 align
)
))
(defun allocate-foreign-object (type &optional (size 0 size-flag))
(declare (fixnum size))
(let ((type-size (size-of-foreign-type type)))
(cond ((null size-flag)
(si::allocate-foreign-data type type-size))
((>= size 0)
(let ((bytes (* size type-size)))
(si::allocate-foreign-data `(:array ,type ,size) bytes)))
(t
(error "~A is not a valid array dimension size" size)))))
(defun free-foreign-object (ptr)
(si::free-foreign-data ptr))
;;;----------------------------------------------------------------------
;;; ENUMERATION TYPES
;;;
(defmacro def-enum (name values-list &key (separator-string "#"))
(let ((constants '())
(value -1)
field
forms)
(setf separator-string (string separator-string))
(dolist (item values-list)
(cond ((symbolp item)
(setf field item)
(incf value))
((and (consp item)
(symbolp (setf field (first item)))
(integerp (setf value (second item)))
(endp (cddr item))))
(t
(error "Not a valid argument to DEF-ENUM~%~a" values-list)))
(setf field (concatenate 'string
(symbol-name name)
separator-string
(string field)))
(push `(defconstant ,(intern field (symbol-package name))
',value)
forms))
`(progn
(def-foreign-type ,name :int)
,@forms)))
;;;----------------------------------------------------------------------
;;; STRUCTURE TYPES
;;;
;;; The structure type is represented by the following list:
;;;
;;; (STRUCT (SLOT-NAME1 . SLOT-TYPE1)*)
;;;
;;; FIXME! We do not care about slot alignment!
;;;
(defmacro def-struct (name &rest slots)
(let ((struct-type (list :struct))
field
type)
(dolist (item (subst `(* ,name) :pointer-self slots))
(if (and (consp item)
(= (length item) 2)
(symbolp (setf field (first item))))
(setf type (second item))
(error "Not a valid DEF-STRUCT slot ~A" item))
(push (list field type) struct-type))
`(def-foreign-type ,name ,(nreverse struct-type))))
(defun slot-position (type field)
(setf type (%convert-to-ffi-type type))
(let ((ndx 0)
(is-union nil))
(cond ((atom type)
(error "~A is not a foreign STRUCT or UNION type" type))
((eq (first type) :struct))
((eq (first type) :union)
(setf is-union t))
(t
(error "~A is not a foreign STRUCT or UNION type" type)))
(dolist (slot (rest type))
(let* ((slot-name (car slot))
(slot-type (cadr slot)))
(multiple-value-bind (slot-size slot-align)
(size-of-foreign-type slot-type)
(%align-data ndx slot-align)
(when (eq slot-name field)
(return-from slot-position (values ndx slot-type slot-size))) ;; Normal return.
(unless is-union
(incf ndx slot-size)))))
(values ndx nil nil))) ;; Pathological return where ndx is the size of the agregate type.
;; It is also silent on the fact that "field" was not found in the set of fields of the agregate!
(defun get-slot-value (object struct-type field)
(multiple-value-bind (slot-ndx slot-type slot-size)
(slot-position struct-type field)
(unless slot-size
(error "~A is not a field of the type ~A" field struct-type))
(%foreign-ref object slot-ndx slot-type slot-size)))
(defun (setf get-slot-value) (value object struct-type field)
(multiple-value-bind (slot-ndx slot-type slot-size)
(slot-position struct-type field)
(unless slot-size
(error "~A is not a field of the type ~A" field struct-type))
(%foreign-set object slot-ndx slot-type value)))
(defun get-slot-pointer (object struct-type field)
(multiple-value-bind (slot-ndx slot-type slot-size)
(slot-position struct-type field)
(unless slot-size
(error "~A is not a field of the type ~A" field struct-type))
(si::foreign-indexed object slot-ndx slot-size slot-type)))
;;;----------------------------------------------------------------------
;;; ARRAYS
;;;
(defmacro def-array-pointer (name element-type)
`(def-foreign-type ,name (* ,element-type)))
(defun deref-array (array array-type position)
(setf array-type (%convert-to-ffi-type array-type))
(let* ((element-type (second array-type))
(element-size (size-of-foreign-type element-type))
(ndx (* position element-size))
(length (or (third array-type) '*)))
(unless (or (eq length '*)
(> length position -1))
(error "Out of bounds when accessing array ~A." array))
(%foreign-data-ref (si::foreign-recast array (+ ndx element-size) array-type) ndx element-type element-size)))
(defun (setf deref-array) (value array array-type position)
(setf array-type (%convert-to-ffi-type array-type))
(let* ((element-type (second array-type))
(element-size (size-of-foreign-type element-type))
(ndx (* position element-size))
(length (or (third array-type) '*)))
(unless (or (eq length '*)
(> length position -1))
(error "Out of bounds when accessing array ~A." array))
(%foreign-data-set (si::foreign-recast array (+ ndx element-size) array-type) ndx element-type value)))
(defun %foreign-data-set (obj ndx type value)
(cond ((foreign-elt-type-p type)
(si::foreign-set-elt obj ndx type value))
((atom type)
(error "Unknown foreign primitive type: ~A" type))
((eq (first type) '*)
(si::foreign-set-elt obj ndx :pointer-void value))
(t
(si::foreign-set obj ndx value))))
(defun %foreign-data-ref (obj ndx type &optional (size 0 size-p))
(cond ((foreign-elt-type-p type) ;; primitive types.
(si::foreign-ref-elt obj ndx type))
((atom type)
(error "Unknown foreign primitive type: ~A" type))
((eq (first type) '*) ;; pointer types
(si::foreign-recast (si::foreign-ref-elt obj ndx :pointer-void)
(size-of-foreign-type (second type))
type))
(t ;; agregate types (:struct :union :array)
(si::foreign-ref obj ndx (if size-p size (size-of-foreign-type type)) type))))
;;;----------------------------------------------------------------------
;;; UNIONS
;;;
(defmacro def-union (name &rest slots)
(let ((struct-type (list :union))
field
type)
(dolist (item (subst `(* ,struct-type) :pointer-self slots))
(unless (and (consp item)
(= (length item) 2)
(symbolp (setf field (first item))))
(error "Not a valid DEF-UNION slot ~A" item))
(setf type (second item))
(push (list field type) struct-type))
`(def-foreign-type ,name ,(nreverse struct-type))))
;;;----------------------------------------------------------------------
;;; POINTERS
;;;
;(defvar +null-cstring-pointer+ (si:allocate-foreign-data :cstring 0))
(defvar +null-cstring-pointer+ (si:make-foreign-null-pointer))
(defun pointer-address (ptr)
(si::foreign-address ptr))
(defun deref-pointer (ptr type)
;; FIXME! No checking!
(setf type (%convert-to-ffi-type type))
(cond ((foreign-elt-type-p type)
(si::foreign-ref-elt ptr 0 type))
((atom type)
(error "Unknown foreign primitive type: ~A" type))
((eq (first type) '*)
(si::foreign-recast (si::foreign-ref-elt ptr 0 :pointer-void)
(size-of-foreign-type (second type))
(second type)))
(t
(error "Cannot dereference pointer to foreign data, ~A" ptr))
))
(defun (setf deref-pointer) (value ptr type)
;; FIXME! No checking!
(setf type (%convert-to-ffi-type type))
(if (foreign-elt-type-p type)
(si::foreign-set-elt ptr 0 type value)
(si::foreign-set ptr 0 value)))
(defun make-null-pointer (type)
;;(si::allocate-foreign-data type 0)
(let ((null-ptr (si::make-foreign-null-pointer)))
(if (eq type :void)
null-ptr
(si::foreign-recast null-ptr 0 type))))
(defun make-pointer (addr type)
(c-inline (type (size-of-foreign-type type) addr)
#-(and windows x86-64) (:object :unsigned-long :unsigned-long)
#+(and windows x86-64) (:object :unsigned-long-long :unsigned-long-long)
:object
"mkcl_make_foreign(env, #0, #1, (void*)#2)"
:side-effects t
:one-liner t))
;;;----------------------------------------------------------------------
;;; CHARACTERS AND STRINGS
;;;
;;; MKCL always returns characters when dereferencing (:array * :char)
;;;
(defun null-char-p (char)
(eq char #.(code-char 0)))
(defun ensure-char-character (char)
(cond ((characterp char) char)
((integerp char) (code-char char))
(t (error "~a cannot be coerced to type CHARACTER" char))))
(defun ensure-char-integer (char)
(cond ((characterp char) (char-code char))
((integerp char) char)
(t (error "~a cannot be coerced to type INTEGER" char))))
(defun ensure-char-storable (char)
char)
(defun char-array-to-pointer (obj)
(si::foreign-indexed obj 0 1 '(* :unsigned-char)))
(defmacro convert-from-cstring (object)
object)
(defmacro convert-to-cstring (object)
;; This enforces that the string contains only as many characters as the
;; fill-pointer determines Since MKCL always sets a 0 character after the
;; last element of a string, this way, the string is always zero-terminated
`(si:copy-to-simple-base-string ,object))
(defmacro free-cstring (object)
object)
(defmacro with-cstring ((cstring string) &body body)
`(let ((,cstring (convert-to-cstring ,string))) ,@body))
(defmacro with-cstrings (bindings &rest body)
(if bindings
`(with-cstring ,(car bindings)
(with-cstrings ,(cdr bindings)
,@body))
`(progn ,@body)))
(defun foreign-string-length (foreign-string)
(c-inline (foreign-string) (t) :int
"strlen((#0)->foreign.data)"
:side-effects nil
:one-liner t))
(defun convert-from-foreign-string (foreign-string
&key length (null-terminated-p t))
(cond ((and (not length) null-terminated-p)
(setf length (foreign-string-length foreign-string)))
((not (integerp length))
(error "~A is not a valid string length" length)))
(c-inline (foreign-string length) (t fixnum) string
"{
mkcl_index length = #1;
mkcl_object output = mkcl_alloc_simple_base_string(env, length);
memcpy(output->base_string.self, (#0)->foreign.data, length);
@(return) = output;
}"
:one-liner nil
:side-effects t))
(defun convert-to-foreign-string (string-designator)
(let ((lisp-string (string string-designator))) ;; FIXME: There is no guarantee that this is going to be a base-string! JCB
(c-inline (lisp-string) (t) t
"{
mkcl_object lisp_string = #0;
mkcl_index size = lisp_string->base_string.fillp;
mkcl_object output = mkcl_allocate_foreign_data(env, @(* :char), size+1);
memcpy(output->foreign.data, lisp_string->base_string.self, size);
output->foreign.data[size] = '\\0';
@(return) = output;
}"
:one-liner nil
:side-effects t)
))
(defun allocate-foreign-string (size &key unsigned)
(si::allocate-foreign-data `(* ,(if unsigned :unsigned-char :char)) (1+ size)))
(defmacro with-foreign-string ((foreign-string lisp-string) &rest body)
(let ((result (gensym)))
`(let* ((,foreign-string (convert-to-foreign-string ,lisp-string))
(,result (progn ,@body)))
(free-foreign-object ,foreign-string)
,result)))
(defmacro with-foreign-strings (bindings &rest body)
(if bindings
`(with-foreign-string ,(car bindings)
(with-foreign-strings ,(cdr bindings)
,@body))
`(progn ,@body)))
;;;----------------------------------------------------------------------
;;; MACROLOGY
;;;
(defmacro with-foreign-object ((var type) &body body)
`(let ((,var (allocate-foreign-object ,type)))
(unwind-protect
(progn ,@body)
(free-foreign-object ,var))))
(defmacro with-foreign-objects (bindings &rest body)
(if bindings
`(with-foreign-object ,(car bindings)
(with-foreign-objects ,(cdr bindings)
,@body))
`(progn ,@body)))
(defmacro with-cast-pointer (bind &body body)
(let (binding-name ptr type)
(case (length bind)
(2 (setf binding-name (first bind)
ptr binding-name
type (second bind)))
(3 (setf binding-name (first bind)
ptr (second bind)
type (third bind)))
(otherwise (error "Arguments missing in WITH-CAST-POINTER")))
;;; This was doing the pointer recasting twice. JCB
;; `(let ((,binding-name (si::foreign-indexed (si::foreign-recast ,ptr (size-of-foreign-type ',type) :void) 0
;; (size-of-foreign-type ',type)
;; ',type)))
`(let ((,binding-name (si::foreign-recast ,ptr (size-of-foreign-type ',type) ',type)))
,@body)))
;;;----------------------------------------------------------------------
;;; INTERFACE TO C FUNCTIONS AND VARIABLES
;;;
(defun map-name-from-c-to-lisp (name)
(cond ((or (stringp name)
(symbolp name))
(values name (intern (string-upcase (substitute #\- #\_ (string name))))))
((and (consp name)
(= (length name) 2))
(values (first name) (second name)))))
(defun %convert-to-arg-type (type)
(let ((type (%convert-to-ffi-type type)))
(cond ((atom type) type)
((eq (first type) '*) :pointer-void)
((eq (first type) :array) :pointer-void)
(t (error "Unsupported argument type: ~A" type))
)))
(defun %convert-to-return-type (type)
(let ((type (%convert-to-ffi-type type)))
(cond ((atom type) type)
((eq (first type) '*) (second type)) ;; This one looks suspicious! JCB
(t type))))
(defun produce-function-call (c-name nargs) ;; Isn't there here a limit on the number of arguments that goes unchecked? JCB
(format nil "~a(~a)" c-name ;; Well, it goes somewhat checked by subseq but the error message is cryptic! JCB
(subseq "#0,#1,#2,#3,#4,#5,#6,#7,#8,#9,#a,#b,#c,#d,#e,#f,#g,#h,#i,#j,#k,#l,#m,#n,#o,#p,#q,#r,#s,#t,#u,#v,#w,#x,#y,#z"
0 (max 0 (1- (* nargs 3)))))) ;; There is 3 characters per argument specifier. JCB
;;; FIXME! We should turn this into a closure generator that produces no code.
(defmacro def-lib-function (name args &key returning module (call :cdecl))
(multiple-value-bind (c-name lisp-name) (map-name-from-c-to-lisp name)
(let* ((return-type (ffi::%convert-to-return-type returning))
(return-required (not (eq return-type :void)))
(argtypes (mapcar #'(lambda (a) (ffi::%convert-to-arg-type (second a))) args)))
`(let ((c-fun (si::find-foreign-symbol ',c-name ,module :pointer-void 0)))
(defun ,lisp-name ,(mapcar #'first args)
(si::call-cfun c-fun ',return-type ',argtypes (list ,@(mapcar #'first args)) ,call))))))
(defmacro def-function (name args &key module (returning :void) (call :cdecl))
(when module
(return-from def-function
`(def-lib-function ,name ,args :returning ,returning :module ,module :call ,call)))
(multiple-value-bind (c-name lisp-name)
(map-name-from-c-to-lisp name)
(let* ((arguments (mapcar #'first args))
(arg-types (mapcar #'(lambda (type) (%convert-to-arg-type (second type))) args))
(return-type (%convert-to-return-type returning))
(nargs (length arguments))
(c-string (produce-function-call c-name nargs))
(casting-required (not (or (member return-type '(:void :cstring))
(foreign-elt-type-p return-type))))
(inline-form `(c-inline ,arguments ,arg-types
,(if casting-required :pointer-void return-type)
,c-string
:one-liner t
:side-effects t)))
(when casting-required
(setf inline-form
`(si::foreign-recast ,inline-form
(size-of-foreign-type ',return-type)
',return-type)))
(when (> nargs 36)
(error "FFI can only handle C functions with up to 36 arguments"))
`(defun ,lisp-name (,@arguments)
,inline-form)
)))
(defmacro def-foreign-var (name type module)
(multiple-value-bind (c-name lisp-name)
(map-name-from-c-to-lisp name)
(let* ((ffi-type (%convert-to-ffi-type type))
(can-deref (or (foreign-elt-type-p ffi-type)
(and (consp ffi-type)
(member (first ffi-type) '(* :array)))))
(inline-form (cond (module
`(si::find-foreign-symbol ,c-name ,module ',type ,(size-of-foreign-type type)))
(t
`(c-inline () () :object
,(format nil "mkcl_make_foreign(env, @~S, ~A, &~A)"
type (size-of-foreign-type type) c-name)
:side-effects t :one-liner t)))))
(if can-deref
`(progn
(si::put-sysprop ',lisp-name 'ffi-foreign-var ,inline-form)
(eval-when (:compile-toplevel :load-toplevel :execute)
(define-symbol-macro ,lisp-name
(ffi:deref-pointer (si::get-sysprop ',lisp-name 'ffi-foreign-var) ',type)
)))
`(defvar ,lisp-name ,inline-form))
)))
(defun find-foreign-library (names directories &key drive-letters types)
(unless (listp names)
(setq names (list names)))
(unless (listp directories)
(setq directories (list directories)))
(unless types
(setq types #+windows '("lib")
#+unix '("so" "a")))
(unless (listp types)
(setq types (list types)))
(unless (listp drive-letters)
(setq drive-letters (list drive-letters)))
#-msvc
(setq drive-letters '(nil))
#+msvc
(unless drive-letters
(setq drive-letters '(nil)))
(dolist (d drive-letters)
(dolist (p directories)
(dolist (n names)
(dolist (e types)
(let ((full-path (probe-file (make-pathname
:device d
:directory (etypecase p
(pathname (pathname-directory p))
(string (pathname-directory (parse-namestring p)))
(list p))
:name n
:type e))))
(when full-path
(return-from find-foreign-library full-path))
)))))
nil)
#|
;; This code, here commented out, is useful only for the UFFI interface and only on
;; MS-Windows were the linker demands to have access to the linkee function object code
;; at link time. JCB
;; This whole facility is in deep need of a redesign anyway, so it is decommissoned for now.
;; Use CFFI instead. JCB
(defvar +loaded-libraries+ nil)
(defun do-load-foreign-library (tmp &optional system-library) ;; What is the use of this? JCB
(let* ((path (cond ((pathnamep tmp) tmp)
((mkcl:probe-file-p (setf tmp (pathname (string tmp)))) tmp)
(t (compile-file-pathname tmp :type #+msvc :lib #-msvc :dll))))
(filename (namestring path))
(pack (find-package "COMPILER"))
(flag (if system-library
(concatenate 'string "-l" tmp)
filename)))
(unless (find filename ffi::+loaded-libraries+ :test #'string-equal)
(setf (symbol-value (intern "*LD-FLAGS*" pack))
(concatenate 'string (symbol-value (intern "*LD-FLAGS*" pack)) " " flag))
(setf (symbol-value (intern "*BUNDLE-LD-FLAGS*" pack))
(concatenate 'string (symbol-value (intern "*BUNDLE-LD-FLAGS*" pack))
(setf (symbol-value (intern "*SHARED-LD-FLAGS*" pack))
(concatenate 'string (symbol-value (intern "*SHARED-LD-FLAGS*" pack))
" " flag))
(push filename ffi::+loaded-libraries+))
t))
(defmacro load-foreign-library (filename &key module supporting-libraries force-load
system-library)
(declare (ignore module force-load supporting-libraries))
(let (#|(compile-form (and (constantp filename)
`((eval-when (:compile-toplevel)
(do-load-foreign-library ,filename
,system-library)))))|#
(dyn-form (unless system-library
`((si:load-foreign-module ,filename)))))
;;(declare (ignore compile-form)) ;; JCB
`(progn #|,@compile-form|# ,@dyn-form)))
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
;;;----------------------------------------------------------------------
;;; CALLBACKS
;;;
(defmacro defcallback (name ret-type arg-desc &body body)
(multiple-value-bind (name call-type) (if (consp name)
(values-list name)
(values name :cdecl))
;;(format t "~&Expanding macro defcallback on ~S.~%" name)
(let ((arg-types (mapcar #'second arg-desc))
(arg-names (mapcar #'first arg-desc)))
`(si::make-dynamic-callback
#'(si::lambda-block ,name ,arg-names ,@body)
',name ',ret-type ',arg-types ,call-type))))
(defun callback (name)
(let ((x (si::get-sysprop name :callback)))
(unless x
(error "There is no callback with name ~a" name))
(first x)))
;;;----------------------------------------------------------------------
;;; COMPATIBILITY WITH OLDER FFI
;;;
(defun clines (&rest args)
(error "The special form clines cannot be used in the interpreter: ~A"
args))
(eval-when (:load-toplevel :execute)
(defmacro c-inline (args arg-types ret-type &rest others)
`(error "The special form c-inline cannot be used in the interpreter: ~A"
(list (list ,@args) ',arg-types ',ret-type ,@others))))
(defmacro definline (fun arg-types type code)
"Syntax: (definline symbol ({arg-type}*) value-type body)" "
DEFINLINE behaves like a DEFCBODY (see), but also instructs the LISP compiler
to expand inline any call to function SYMBOL into code corresponding
to the C language expression BODY, whenever it can determine that
the actual arguments are of the specified type."
`(eval-when (:compile-toplevel :load-toplevel :execute)
;; defCbody must go first, because it clears symbol-plist of fun
(defCbody ,fun ,arg-types ,type ,code)
(declaim (ftype (function ,arg-types ,type) ,fun))
(def-inline ,fun :always ,arg-types ,type ,code)))
(defmacro defla (&rest body)
"Syntax: (defla name lambda-list {decl | doc}* {form}*)" "
Used to DEFine Lisp Alternative. For the interpreter, DEFLA is equivalent to
DEFUN, but the compiler ignores this form."
`(eval-when (:execute)
(defun ,@body)))
(defmacro defcbody (name arg-types result-type C-expr)
"Syntax: (defcbody symbol ({arg-type}*) value-type body)" "
The compiler defines a Lisp function named by SYMBOL whose body consists of the
C code of the string BODY. In the BODY one can reference the arguments of the
function as \"#0\", \"#1\", etc.
The interpreter ignores this form. ARG-TYPEs are argument types of the
defined Lisp function and VALUE-TYPE is its the return type."
(let ((args (mapcar #'(lambda (x) (gensym)) arg-types)))
`(defun ,name ,args
(c-inline ,args ,arg-types ,result-type
,C-expr :one-liner t))))
(defmacro defentry (name arg-types c-name &key no-interrupts)
"Syntax: (defentry symbol ({arg-type}*) (value-type function-name))
The compiler defines a Lisp function named by SYMBOL whose body consists of a
calling sequence to the C language function named by FUNCTION-NAME. The
interpreter ignores this form. ARG-TYPEs are argument types of the C function
and VALUE-TYPE is the return type of the C function. Symbols OBJECT, INT,
CHAR, CHAR*, FLOAT, DOUBLE are allowed for these types."
(let ((output-type :object)
(args (mapcar #'(lambda (x) (gensym)) arg-types)))
(if (consp c-name)
(setf output-type (first c-name)
c-name (second c-name)))
(let* ((call (produce-function-call (string c-name) (length arg-types)))
(full-text (if no-interrupts
#-(and)
(concatenate 'string
"mkcl_disable_interrupts(env);@(return)="
call
";mkcl_enable_interrupts(env);")
#+(and)
(concatenate 'string "MKCL_NO_INTR(env, (@(return)=" call "));")
call)))
`(defun ,name ,args
(c-inline ,args ,arg-types ,output-type
,full-text
:one-liner ,(not no-interrupts))))))