iio: Rename iio_trigger_poll_chained and add kernel-doc
authorMehdi Djait <mehdi.djait.k@gmail.com>
Thu, 2 Mar 2023 13:04:36 +0000 (14:04 +0100)
committerJonathan Cameron <Jonathan.Cameron@huawei.com>
Sat, 11 Mar 2023 12:18:29 +0000 (12:18 +0000)
Rename the function to iio_trigger_poll_nested. Add kernel-doc with
a note on the context where the function is expected to be called.

Signed-off-by: Mehdi Djait <mehdi.djait.k@gmail.com>
Link: https://lore.kernel.org/r/841b533cba28ca25a8e87280c44e45979166e8e2.1677761379.git.mehdi.djait.k@gmail.com
Signed-off-by: Jonathan Cameron <Jonathan.Cameron@huawei.com>
22 files changed:
drivers/iio/accel/bma400_core.c
drivers/iio/accel/kionix-kx022a.c
drivers/iio/accel/mma8452.c
drivers/iio/accel/msa311.c
drivers/iio/adc/ad7606.c
drivers/iio/adc/at91-sama5d2_adc.c
drivers/iio/adc/max11410.c
drivers/iio/common/st_sensors/st_sensors_trigger.c
drivers/iio/gyro/fxas21002c_core.c
drivers/iio/gyro/mpu3050-core.c
drivers/iio/humidity/hts221_buffer.c
drivers/iio/industrialio-trigger.c
drivers/iio/light/acpi-als.c
drivers/iio/light/rpr0521.c
drivers/iio/light/st_uvis25_core.c
drivers/iio/light/vcnl4000.c
drivers/iio/light/vcnl4035.c
drivers/iio/potentiostat/lmp91000.c
drivers/iio/pressure/zpa2326.c
drivers/iio/proximity/as3935.c
drivers/iio/trigger/iio-trig-loop.c
include/linux/iio/trigger.h

index 623f37c..a68b845 100644 (file)
@@ -1688,7 +1688,7 @@ static irqreturn_t bma400_interrupt(int irq, void *private)
 
        if (FIELD_GET(BMA400_INT_DRDY_MSK, le16_to_cpu(data->status))) {
                mutex_unlock(&data->mutex);
-               iio_trigger_poll_chained(data->trig);
+               iio_trigger_poll_nested(data->trig);
                return IRQ_HANDLED;
        }
 
index 9f8c763..8dac033 100644 (file)
@@ -899,7 +899,7 @@ static irqreturn_t kx022a_irq_thread_handler(int irq, void *private)
        mutex_lock(&data->mutex);
 
        if (data->trigger_enabled) {
-               iio_trigger_poll_chained(data->trig);
+               iio_trigger_poll_nested(data->trig);
                ret = IRQ_HANDLED;
        }
 
index f97fb68..ea14e3a 100644 (file)
@@ -1067,7 +1067,7 @@ static irqreturn_t mma8452_interrupt(int irq, void *p)
                return IRQ_NONE;
 
        if (src & MMA8452_INT_DRDY) {
-               iio_trigger_poll_chained(indio_dev->trig);
+               iio_trigger_poll_nested(indio_dev->trig);
                ret = IRQ_HANDLED;
        }
 
index af94d3a..6690fa3 100644 (file)
@@ -951,7 +951,7 @@ static irqreturn_t msa311_irq_thread(int irq, void *p)
        }
 
        if (new_data_int_enabled)
-               iio_trigger_poll_chained(msa311->new_data_trig);
+               iio_trigger_poll_nested(msa311->new_data_trig);
 
        return IRQ_HANDLED;
 }
index dd6b603..1928d9a 100644 (file)
@@ -477,7 +477,7 @@ static irqreturn_t ad7606_interrupt(int irq, void *dev_id)
 
        if (iio_buffer_enabled(indio_dev)) {
                gpiod_set_value(st->gpio_convst, 0);
-               iio_trigger_poll_chained(st->trig);
+               iio_trigger_poll_nested(st->trig);
        } else {
                complete(&st->completion);
        }
index 50d02e5..b5d0c9e 100644 (file)
@@ -1194,7 +1194,7 @@ static void at91_dma_buffer_done(void *data)
 {
        struct iio_dev *indio_dev = data;
 
-       iio_trigger_poll_chained(indio_dev->trig);
+       iio_trigger_poll_nested(indio_dev->trig);
 }
 
 static int at91_adc_dma_start(struct iio_dev *indio_dev)
index b74b689..237b2ce 100644 (file)
@@ -678,7 +678,7 @@ static irqreturn_t max11410_interrupt(int irq, void *dev_id)
        struct max11410_state *st = iio_priv(indio_dev);
 
        if (iio_buffer_enabled(indio_dev))
-               iio_trigger_poll_chained(st->trig);
+               iio_trigger_poll_nested(st->trig);
        else
                complete(&st->completion);
 
index 899b640..a0df925 100644 (file)
@@ -85,7 +85,7 @@ static irqreturn_t st_sensors_irq_thread(int irq, void *p)
         */
        if (sdata->hw_irq_trigger &&
            st_sensors_new_samples_available(indio_dev, sdata)) {
-               iio_trigger_poll_chained(p);
+               iio_trigger_poll_nested(p);
        } else {
                dev_dbg(indio_dev->dev.parent, "spurious IRQ\n");
                return IRQ_NONE;
@@ -110,7 +110,7 @@ static irqreturn_t st_sensors_irq_thread(int irq, void *p)
                dev_dbg(indio_dev->dev.parent,
                        "more samples came in during polling\n");
                sdata->hw_timestamp = iio_get_time_ns(indio_dev);
-               iio_trigger_poll_chained(p);
+               iio_trigger_poll_nested(p);
        }
 
        return IRQ_HANDLED;
index 3ea1d46..c28d17c 100644 (file)
@@ -813,7 +813,7 @@ static irqreturn_t fxas21002c_data_rdy_thread(int irq, void *private)
        if (!data_ready)
                return IRQ_NONE;
 
-       iio_trigger_poll_chained(data->dready_trig);
+       iio_trigger_poll_nested(data->dready_trig);
 
        return IRQ_HANDLED;
 }
index 6a6d84a..a791ba3 100644 (file)
@@ -939,7 +939,7 @@ static irqreturn_t mpu3050_irq_thread(int irq, void *p)
        if (!(val & MPU3050_INT_STATUS_RAW_RDY))
                return IRQ_NONE;
 
-       iio_trigger_poll_chained(p);
+       iio_trigger_poll_nested(p);
 
        return IRQ_HANDLED;
 }
index 2a4107a..11ef389 100644 (file)
@@ -68,7 +68,7 @@ static irqreturn_t hts221_trigger_handler_thread(int irq, void *private)
        if (!(status & HTS221_RH_DRDY_MASK))
                return IRQ_NONE;
 
-       iio_trigger_poll_chained(hw->trig);
+       iio_trigger_poll_nested(hw->trig);
 
        return IRQ_HANDLED;
 }
index 270ec0a..784dc1e 100644 (file)
@@ -222,7 +222,14 @@ irqreturn_t iio_trigger_generic_data_rdy_poll(int irq, void *private)
 }
 EXPORT_SYMBOL(iio_trigger_generic_data_rdy_poll);
 
-void iio_trigger_poll_chained(struct iio_trigger *trig)
+/**
+ * iio_trigger_poll_nested() - Call the threaded trigger handler of the
+ * consumers
+ * @trig: trigger which occurred
+ *
+ * This function should only be called from a kernel thread context.
+ */
+void iio_trigger_poll_nested(struct iio_trigger *trig)
 {
        int i;
 
@@ -237,7 +244,7 @@ void iio_trigger_poll_chained(struct iio_trigger *trig)
                }
        }
 }
-EXPORT_SYMBOL(iio_trigger_poll_chained);
+EXPORT_SYMBOL(iio_trigger_poll_nested);
 
 void iio_trigger_notify_done(struct iio_trigger *trig)
 {
index e1ff6f5..2d91caf 100644 (file)
@@ -108,7 +108,7 @@ static void acpi_als_notify(struct acpi_device *device, u32 event)
        if (iio_buffer_enabled(indio_dev) && iio_trigger_using_own(indio_dev)) {
                switch (event) {
                case ACPI_ALS_NOTIFY_ILLUMINANCE:
-                       iio_trigger_poll_chained(als->trig);
+                       iio_trigger_poll_nested(als->trig);
                        break;
                default:
                        /* Unhandled event */
index 668e444..9d0218b 100644 (file)
@@ -431,7 +431,7 @@ static irqreturn_t rpr0521_drdy_irq_thread(int irq, void *private)
        struct rpr0521_data *data = iio_priv(indio_dev);
 
        if (rpr0521_is_triggered(data)) {
-               iio_trigger_poll_chained(data->drdy_trigger0);
+               iio_trigger_poll_nested(data->drdy_trigger0);
                return IRQ_HANDLED;
        }
 
index c737d3e..50f95c5 100644 (file)
@@ -161,7 +161,7 @@ static irqreturn_t st_uvis25_trigger_handler_thread(int irq, void *private)
        if (!(status & ST_UVIS25_REG_UV_DA_MASK))
                return IRQ_NONE;
 
-       iio_trigger_poll_chained(hw->trig);
+       iio_trigger_poll_nested(hw->trig);
 
        return IRQ_HANDLED;
 }
index 6bdfce9..b9460c1 100644 (file)
@@ -1078,7 +1078,7 @@ static irqreturn_t vcnl4010_irq_thread(int irq, void *p)
        }
 
        if (isr & VCNL4010_INT_DRDY && iio_buffer_enabled(indio_dev))
-               iio_trigger_poll_chained(indio_dev->trig);
+               iio_trigger_poll_nested(indio_dev->trig);
 
 end:
        return IRQ_HANDLED;
index 84148b9..14e2933 100644 (file)
@@ -89,7 +89,7 @@ static irqreturn_t vcnl4035_drdy_irq_thread(int irq, void *private)
                                                        IIO_EV_TYPE_THRESH,
                                                        IIO_EV_DIR_EITHER),
                                iio_get_time_ns(indio_dev));
-               iio_trigger_poll_chained(data->drdy_trigger0);
+               iio_trigger_poll_nested(data->drdy_trigger0);
                return IRQ_HANDLED;
        }
 
index b82f093..0083e85 100644 (file)
@@ -118,7 +118,7 @@ static int lmp91000_read(struct lmp91000_data *data, int channel, int *val)
 
        data->chan_select = channel != LMP91000_REG_MODECN_3LEAD;
 
-       iio_trigger_poll_chained(data->trig);
+       iio_trigger_poll_nested(data->trig);
 
        ret = wait_for_completion_timeout(&data->completion, HZ);
        reinit_completion(&data->completion);
index 67119a9..421e059 100644 (file)
@@ -829,7 +829,7 @@ static irqreturn_t zpa2326_handle_threaded_irq(int irq, void *data)
        }
 
        /* New sample available: dispatch internal trigger consumers. */
-       iio_trigger_poll_chained(priv->trigger);
+       iio_trigger_poll_nested(priv->trigger);
 
        if (cont)
                /*
index ebc95cf..96fa974 100644 (file)
@@ -257,7 +257,7 @@ static void as3935_event_work(struct work_struct *work)
 
        switch (val) {
        case AS3935_EVENT_INT:
-               iio_trigger_poll_chained(st->trig);
+               iio_trigger_poll_nested(st->trig);
                break;
        case AS3935_DISTURB_INT:
        case AS3935_NOISE_INT:
index 96ec06b..7aaed06 100644 (file)
@@ -46,7 +46,7 @@ static int iio_loop_thread(void *data)
        set_freezable();
 
        do {
-               iio_trigger_poll_chained(trig);
+               iio_trigger_poll_nested(trig);
        } while (likely(!kthread_freezable_should_stop(NULL)));
 
        return 0;
index 42da55d..51f52c5 100644 (file)
@@ -152,7 +152,7 @@ void iio_trigger_unregister(struct iio_trigger *trig_info);
 int iio_trigger_set_immutable(struct iio_dev *indio_dev, struct iio_trigger *trig);
 
 void iio_trigger_poll(struct iio_trigger *trig);
-void iio_trigger_poll_chained(struct iio_trigger *trig);
+void iio_trigger_poll_nested(struct iio_trigger *trig);
 
 irqreturn_t iio_trigger_generic_data_rdy_poll(int irq, void *private);