Subversion Repositories HelenOS

Rev

Rev 2211 | Rev 4055 | Go to most recent revision | Blame | Compare with Previous | Last modification | View Log | Download | RSS feed

  1. /*
  2.  * Copyright (c) 2001-2004 Jakub Jermar
  3.  * All rights reserved.
  4.  *
  5.  * Redistribution and use in source and binary forms, with or without
  6.  * modification, are permitted provided that the following conditions
  7.  * are met:
  8.  *
  9.  * - Redistributions of source code must retain the above copyright
  10.  *   notice, this list of conditions and the following disclaimer.
  11.  * - Redistributions in binary form must reproduce the above copyright
  12.  *   notice, this list of conditions and the following disclaimer in the
  13.  *   documentation and/or other materials provided with the distribution.
  14.  * - The name of the author may not be used to endorse or promote products
  15.  *   derived from this software without specific prior written permission.
  16.  *
  17.  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  18.  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  19.  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  20.  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  21.  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  22.  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  23.  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  24.  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  25.  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  26.  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  27.  */
  28.  
  29. /** @addtogroup sync
  30.  * @{
  31.  */
  32.  
  33. /**
  34.  * @file
  35.  * @brief   Spinlocks.
  36.  */
  37.  
  38. #include <synch/spinlock.h>
  39. #include <atomic.h>
  40. #include <arch/barrier.h>
  41. #include <arch.h>
  42. #include <preemption.h>
  43. #include <print.h>
  44. #include <debug.h>
  45. #include <symtab.h>
  46.  
  47. #ifdef CONFIG_FB
  48. #include <genarch/fb/fb.h>
  49. #endif
  50.  
  51. #ifdef CONFIG_SMP
  52.  
  53. /** Initialize spinlock
  54.  *
  55.  * Initialize spinlock.
  56.  *
  57.  * @param sl Pointer to spinlock_t structure.
  58.  */
  59. void spinlock_initialize(spinlock_t *sl, char *name)
  60. {
  61.     atomic_set(&sl->val, 0);
  62. #ifdef CONFIG_DEBUG_SPINLOCK
  63.     sl->name = name;
  64. #endif 
  65. }
  66.  
  67. /** Lock spinlock
  68.  *
  69.  * Lock spinlock.
  70.  * This version has limitted ability to report
  71.  * possible occurence of deadlock.
  72.  *
  73.  * @param sl Pointer to spinlock_t structure.
  74.  */
  75. #ifdef CONFIG_DEBUG_SPINLOCK
  76. void spinlock_lock_debug(spinlock_t *sl)
  77. {
  78.     count_t i = 0;
  79.     char *symbol;
  80.     bool deadlock_reported = false;
  81.  
  82.     preemption_disable();
  83.     while (test_and_set(&sl->val)) {
  84.  
  85.         /*
  86.          * We need to be careful about printf_lock and fb_lock.
  87.          * Both of them are used to report deadlocks via
  88.          * printf() and fb_putchar().
  89.          *
  90.          * We trust our code that there is no possible deadlock
  91.          * caused by these two locks (except when an exception
  92.          * is triggered for instance by printf() or fb_putchar()).
  93.          * However, we encountered false positives caused by very
  94.          * slow VESA framebuffer interaction (especially when
  95.          * run in a simulator) that caused problems with both
  96.          * printf_lock and fb_lock.
  97.          *
  98.          * Possible deadlocks on both printf_lock and fb_lock
  99.          * are therefore not reported as they would cause an
  100.          * infinite recursion.
  101.          */
  102.         if (sl == &printf_lock)
  103.             continue;
  104. #ifdef CONFIG_FB
  105.         if (sl == &fb_lock)
  106.             continue;
  107. #endif
  108.         if (i++ > DEADLOCK_THRESHOLD) {
  109.             printf("cpu%d: looping on spinlock %.*p:%s, "
  110.                 "caller=%.*p", CPU->id, sizeof(uintptr_t) * 2, sl,
  111.                 sl->name, sizeof(uintptr_t) * 2, CALLER);
  112.             symbol = get_symtab_entry(CALLER);
  113.             if (symbol)
  114.                 printf("(%s)", symbol);
  115.             printf("\n");
  116.             i = 0;
  117.             deadlock_reported = true;
  118.         }
  119.     }
  120.  
  121.     if (deadlock_reported)
  122.         printf("cpu%d: not deadlocked\n", CPU->id);
  123.  
  124.     /*
  125.      * Prevent critical section code from bleeding out this way up.
  126.      */
  127.     CS_ENTER_BARRIER();
  128. }
  129. #endif
  130.  
  131. /** Lock spinlock conditionally
  132.  *
  133.  * Lock spinlock conditionally.
  134.  * If the spinlock is not available at the moment,
  135.  * signal failure.
  136.  *
  137.  * @param sl Pointer to spinlock_t structure.
  138.  *
  139.  * @return Zero on failure, non-zero otherwise.
  140.  */
  141. int spinlock_trylock(spinlock_t *sl)
  142. {
  143.     int rc;
  144.    
  145.     preemption_disable();
  146.     rc = !test_and_set(&sl->val);
  147.  
  148.     /*
  149.      * Prevent critical section code from bleeding out this way up.
  150.      */
  151.     CS_ENTER_BARRIER();
  152.  
  153.     if (!rc)
  154.         preemption_enable();
  155.    
  156.     return rc;
  157. }
  158.  
  159. #endif
  160.  
  161. /** @}
  162.  */
  163.