apiv1/impl-ecl.lisp

   1 ;;;; -*- indent-tabs-mode: nil -*-
   2
   3 #|
   4 Copyright 2006, 2007 Greg Pfeil
   5
   6 Distributed under the MIT license (see LICENSE file)
   7 |#
   8
   9 (in-package #:bordeaux-threads)
  10
  11 ;;; documentation on the ECL Multiprocessing interface can be found at
  12 ;;; http://ecls.sourceforge.net/cgi-bin/view/Main/MultiProcessing
  13
  14 (deftype thread ()
  15   'mp:process)
  16
  17 ;;; Thread Creation
  18
  19 (defun %make-thread (function name)
  20   (mp:process-run-function name function))
  21
  22 (defun current-thread ()
  23   mp::*current-process*)
  24
  25 (defun threadp (object)
  26   (typep object 'mp:process))
  27
  28 (defun thread-name (thread)
  29   (mp:process-name thread))
  30
  31 ;;; Resource contention: locks and recursive locks
  32
  33 (deftype lock () 'mp:lock)
  34
  35 (deftype recursive-lock ()
  36   '(and mp:lock (satisfies mp:recursive-lock-p)))
  37
  38 (defun lock-p (object)
  39   (typep object 'mp:lock))
  40
  41 (defun recursive-lock-p (object)
  42   (and (typep object 'mp:lock)
  43        (mp:recursive-lock-p object)))
  44
  45 (defun make-lock (&optional name)
  46   (mp:make-lock :name (or name "Anonymous lock")))
  47
  48 (defun acquire-lock (lock &optional (wait-p t))
  49   (mp:get-lock lock wait-p))
  50
  51 (defun release-lock (lock)
  52   (mp:giveup-lock lock))
  53
  54 (defmacro with-lock-held ((place) &body body)
  55   `(mp:with-lock (,place) ,@body))
  56
  57 (defun make-recursive-lock (&optional name)
  58   (mp:make-lock :name (or name "Anonymous recursive lock") :recursive t))
  59
  60 (defun acquire-recursive-lock (lock &optional (wait-p t))
  61   (mp:get-lock lock wait-p))
  62
  63 (defun release-recursive-lock (lock)
  64   (mp:giveup-lock lock))
  65
  66 (defmacro with-recursive-lock-held ((place) &body body)
  67   `(mp:with-lock (,place) ,@body))
  68
  69 ;;; Resource contention: condition variables
  70
  71 (defun make-condition-variable (&key name)
  72   (declare (ignore name))
  73   (mp:make-condition-variable))
  74
  75 (defun condition-wait (condition-variable lock &key timeout)
  76   (if timeout
  77       (handler-case (with-timeout (timeout)
  78                       (mp:condition-variable-wait condition-variable lock))
  79         (timeout ()
  80           (acquire-lock lock)
  81           nil))
  82       (mp:condition-variable-wait condition-variable lock)))
  83
  84 (defun condition-notify (condition-variable)
  85   (mp:condition-variable-signal condition-variable))
  86
  87 (defun thread-yield ()
  88   (mp:process-yield))
  89
  90 ;;; Introspection/debugging
  91
  92 (defun all-threads ()
  93   (mp:all-processes))
  94
  95 (defun interrupt-thread (thread function &rest args)
  96   (flet ((apply-function ()
  97            (if args
  98                (named-lambda %interrupt-thread-wrapper ()
  99                  (apply function args))
 100                function)))
 101     (declare (dynamic-extent #'apply-function))
 102     (mp:interrupt-process thread (apply-function))))
 103
 104 (defun destroy-thread (thread)
 105   (signal-error-if-current-thread thread)
 106   (mp:process-kill thread))
 107
 108 (defun thread-alive-p (thread)
 109   (mp:process-active-p thread))
 110
 111 (defun join-thread (thread)
 112   (mp:process-join thread))
 113
 114 (mark-supported)