Changeset 8300c72 in mainline for uspace/lib/drv/generic/driver.c

Timestamp:

2025-03-03T22:58:05Z (13 hours ago)

Author:

Jiri Svoboda <jiri@…>

Branches:

master

Children:

77a0119

Parents:

f35749e

Message:

Quiesce devices before proceeding with shutdown.

Only implemented for e1k, uhci and xhci.

File:

• uspace/lib/drv/generic/driver.c (modified) (3 diffs)

uspace/lib/drv/generic/driver.c

@@ -237 +237 @@
 }
 
+static void driver_dev_quiesce(ipc_call_t *icall)
+{
+        devman_handle_t devh = ipc_get_arg1(icall);
+        ddf_fun_t *fun;
+        link_t *link;
+
+        fibril_mutex_lock(&devices_mutex);
+        ddf_dev_t *dev = driver_get_device(devh);
+        if (dev != NULL)
+                dev_add_ref(dev);
+        fibril_mutex_unlock(&devices_mutex);
+
+        if (dev == NULL) {
+                async_answer_0(icall, ENOENT);
+                return;
+        }
+
+        errno_t rc;
+
+        if (driver->driver_ops->dev_quiesce != NULL) {
+                rc = driver->driver_ops->dev_quiesce(dev);
+        } else {
+                /*
+                 * If the driver does not implement quiesce, we will
+                 * simply request all subordinate functions to quiesce.
+                 */
+                fibril_mutex_lock(&functions_mutex);
+                link = list_first(&functions);
+                while (link != NULL) {
+                        fun = list_get_instance(link, ddf_fun_t, link);
+                        if (fun->dev == dev)
+                                ddf_fun_quiesce(fun);
+                        link = list_next(link, &functions);
+                }
+                fibril_mutex_unlock(&functions_mutex);
+                rc = EOK;
+        }
+
+        dev_del_ref(dev);
+        async_answer_0(icall, rc);
+}
+
 static void driver_fun_online(ipc_call_t *icall)
 {
@@ -357 +399 @@
                 case DRIVER_DEV_GONE:
                         driver_dev_gone(&call);
+                        break;
+                case DRIVER_DEV_QUIESCE:
+                        driver_dev_quiesce(&call);
                         break;
                 case DRIVER_FUN_ONLINE:
@@ -903 +948 @@
 }
 
+/** Quiesce function.
+ *
+ * @param fun Function to quiesce
+ *
+ * @return EOK on success or an error code
+ *
+ */
+errno_t ddf_fun_quiesce(ddf_fun_t *fun)
+{
+        assert(fun->bound == true);
+
+        errno_t res = devman_drv_fun_quiesce(fun->handle);
+        if (res != EOK)
+                return res;
+
+        return EOK;
+}
+
 /** Add single match ID to inner function.
  *