Subversion Repositories HelenOS

Rev

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

  1. /*
  2.  * Copyright (c) 2008 Jiri Svoboda
  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 genericipc
  30.  * @{
  31.  */
  32. /** @file
  33.  */
  34.  
  35. #include <synch/synch.h>
  36. #include <synch/spinlock.h>
  37. #include <synch/mutex.h>
  38. #include <ipc/ipc.h>
  39. #include <ipc/ipcrsc.h>
  40. #include <arch.h>
  41. #include <errno.h>
  42. #include <debug.h>
  43. #include <udebug/udebug_ipc.h>
  44. #include <ipc/kbox.h>
  45.  
  46. void ipc_kbox_cleanup(void)
  47. {
  48.     ipl_t ipl;
  49.     bool have_kb_thread;
  50.  
  51.     /* Only hold kb_cleanup_lock while setting kb_finished - this is enough */
  52.     mutex_lock(&TASK->kb_cleanup_lock);
  53.     TASK->kb_finished = true;
  54.     mutex_unlock(&TASK->kb_cleanup_lock);
  55.  
  56.     have_kb_thread = (TASK->kb_thread != NULL);
  57.  
  58.     /* From now on nobody will try to connect phones or attach kbox threads */
  59.  
  60.     /*
  61.      * Disconnect all phones connected to our kbox. Passing true for
  62.      * notify_box causes a HANGUP message to be inserted for each
  63.      * disconnected phone. This ensures the kbox thread is going to
  64.      * wake up and terminate.
  65.      */
  66.     ipc_answerbox_slam_phones(&TASK->kernel_box, have_kb_thread);
  67.  
  68.     /*
  69.      * If the task was being debugged, clean up debugging session.
  70.      * This is necessarry as slamming the phones won't force
  71.      * kbox thread to clean it up since sender != debugger.
  72.      */
  73.     ipl = interrupts_disable();
  74.     spinlock_lock(&TASK->lock);
  75.     udebug_task_cleanup(TASK);
  76.     spinlock_unlock(&TASK->lock);
  77.     interrupts_restore(ipl);
  78.    
  79.     if (have_kb_thread) {
  80.         LOG("join kb_thread..\n");
  81.         thread_join(TASK->kb_thread);
  82.         thread_detach(TASK->kb_thread);
  83.         LOG("join done\n");
  84.         TASK->kb_thread = NULL;
  85.     }
  86.  
  87.     /* Answer all messages in 'calls' and 'dispatched_calls' queues */
  88.     spinlock_lock(&TASK->kernel_box.lock);
  89.     ipc_cleanup_call_list(&TASK->kernel_box.dispatched_calls);
  90.     ipc_cleanup_call_list(&TASK->kernel_box.calls);
  91.     spinlock_unlock(&TASK->kernel_box.lock);
  92. }
  93.  
  94.  
  95. static void kbox_thread_proc(void *arg)
  96. {
  97.     call_t *call;
  98.     int method;
  99.     bool done;
  100.     ipl_t ipl;
  101.  
  102.     (void)arg;
  103.     LOG("kbox_thread_proc()\n");
  104.     done = false;
  105.  
  106.     while (!done) {
  107.         call = ipc_wait_for_call(&TASK->kernel_box, SYNCH_NO_TIMEOUT,
  108.             SYNCH_FLAGS_NONE);
  109.  
  110.         if (call != NULL) {
  111.             method = IPC_GET_METHOD(call->data);
  112.  
  113.             if (method == IPC_M_DEBUG_ALL) {
  114.                 udebug_call_receive(call);
  115.             }
  116.  
  117.             if (method == IPC_M_PHONE_HUNGUP) {
  118.                 LOG("kbox: handle hangup message\n");
  119.  
  120.                 /* Was it our debugger, who hung up? */
  121.                 if (call->sender == TASK->udebug.debugger) {
  122.                     /* Terminate debugging session (if any) */
  123.                     LOG("kbox: terminate debug session\n");
  124.                     ipl = interrupts_disable();
  125.                     spinlock_lock(&TASK->lock);
  126.                     udebug_task_cleanup(TASK);
  127.                     spinlock_unlock(&TASK->lock);
  128.                     interrupts_restore(ipl);
  129.                 } else {
  130.                     LOG("kbox: was not debugger\n");
  131.                 }
  132.  
  133.                 LOG("kbox: continue with hangup message\n");
  134.                 IPC_SET_RETVAL(call->data, 0);
  135.                 ipc_answer(&TASK->kernel_box, call);
  136.  
  137.                 ipl = interrupts_disable();
  138.                 spinlock_lock(&TASK->lock);
  139.                 spinlock_lock(&TASK->answerbox.lock);
  140.                 if (list_empty(&TASK->answerbox.connected_phones)) {
  141.                     /*
  142.                      * Last phone has been disconnected.
  143.                      * Detach this thread so it gets
  144.                      * freed and terminate.
  145.                      */
  146.  
  147.                     /* Only need to detach thread unless already terminating. */
  148.                     mutex_lock(&TASK->kb_cleanup_lock);
  149.                     if (&TASK->kb_finished == false) {
  150.                         /* Detach thread so it gets freed. */
  151.                         thread_detach(TASK->kb_thread);
  152.                         TASK->kb_thread = NULL;
  153.                     }
  154.                     mutex_unlock(&TASK->kb_cleanup_lock);
  155.                     done = true;
  156.                     LOG("phone list is empty\n");
  157.                 }
  158.                 spinlock_unlock(&TASK->answerbox.lock);
  159.                 spinlock_unlock(&TASK->lock);
  160.                 interrupts_restore(ipl);
  161.             }
  162.         }
  163.     }
  164.  
  165.     LOG("kbox: finished\n");
  166. }
  167.  
  168.  
  169. /**
  170.  * Connect phone to a task kernel-box specified by id.
  171.  *
  172.  * Note that this is not completely atomic. For optimisation reasons,
  173.  * The task might start cleaning up kbox after the phone has been connected
  174.  * and before a kbox thread has been created. This must be taken into account
  175.  * in the cleanup code.
  176.  *
  177.  * @return      Phone id on success, or negative error code.
  178.  */
  179. int ipc_connect_kbox(task_id_t taskid)
  180. {
  181.     int newphid;
  182.     task_t *ta;
  183.     thread_t *kb_thread;
  184.     ipl_t ipl;
  185.  
  186.     ipl = interrupts_disable();
  187.     spinlock_lock(&tasks_lock);
  188.  
  189.     ta = task_find_by_id(taskid);
  190.     if (ta == NULL) {
  191.         spinlock_unlock(&tasks_lock);
  192.         interrupts_restore(ipl);
  193.         return ENOENT;
  194.     }
  195.  
  196.     atomic_inc(&ta->refcount);
  197.  
  198.     spinlock_unlock(&tasks_lock);
  199.     interrupts_restore(ipl);
  200.  
  201.     mutex_lock(&ta->kb_cleanup_lock);
  202.  
  203.     if (atomic_predec(&ta->refcount) == 0) {
  204.         mutex_unlock(&ta->kb_cleanup_lock);
  205.         task_destroy(ta);
  206.         return ENOENT;
  207.     }
  208.  
  209.     if (ta->kb_finished != false) {
  210.         mutex_unlock(&ta->kb_cleanup_lock);
  211.         return EINVAL;
  212.     }
  213.  
  214.     newphid = phone_alloc();
  215.     if (newphid < 0) {
  216.         mutex_unlock(&ta->kb_cleanup_lock);
  217.         return ELIMIT;
  218.     }
  219.  
  220.     /* Connect the newly allocated phone to the kbox */
  221.     ipc_phone_connect(&TASK->phones[newphid], &ta->kernel_box);
  222.  
  223.     if (ta->kb_thread != NULL) {
  224.         mutex_unlock(&ta->kb_cleanup_lock);
  225.         return newphid;
  226.     }
  227.  
  228.     /* Create a kbox thread */
  229.     kb_thread = thread_create(kbox_thread_proc, NULL, ta, 0, "kbox", false);
  230.     if (!kb_thread) {
  231.         mutex_unlock(&ta->kb_cleanup_lock);
  232.         return ENOMEM;
  233.     }
  234.  
  235.     ta->kb_thread = kb_thread;
  236.     thread_ready(kb_thread);
  237.  
  238.     mutex_unlock(&ta->kb_cleanup_lock);
  239.  
  240.     return newphid;
  241. }
  242.  
  243. /** @}
  244.  */
  245.