LinuxLists.cc - [PATCH v3] iio: Use octal permissions and DEVICE_ATTR

2022-06-01 21:34:09

Subject: [PATCH v3] iio: Use octal permissions and DEVICE_ATTR_{RO,RW}.

As reported by checkpatch.pl. Where possible use DEVICE_ATTR_RO(),
DEVICE_ATTR_RW(), and __ATTR_RO(). Change function names to be
<var>_show() for read and <var>_store() for write.

Suggested-by: Joe Perches <[email protected]>
Suggested-by: Andy Shevchenko <[email protected]>
Signed-off-by: Joe Simmons-Talbott <[email protected]>
---

Changes in v3:
- Use __ATTR_RO() and add parens to DEVICE_ATTR_{RW,RO} in description
as suggested by Andy Shevchenko <[email protected]>

Changes in v2:
- Use DEVICE_ATTR_RO() and DEVICE_ATTR_RW() rather than octal permissions
where applicable. Rename functions to <var>-show() and
<var>-store(). Based on review by Joe Perches <[email protected]>

drivers/iio/industrialio-buffer.c | 64 ++++++++++++++----------------
drivers/iio/industrialio-core.c | 35 ++++++++--------
drivers/iio/industrialio-trigger.c | 32 +++++++--------
3 files changed, 61 insertions(+), 70 deletions(-)

diff --git a/drivers/iio/industrialio-buffer.c b/drivers/iio/industrialio-buffer.c
index b078eb2f3c9d..80121b1ac554 100644
--- a/drivers/iio/industrialio-buffer.c
+++ b/drivers/iio/industrialio-buffer.c
@@ -630,18 +630,18 @@ static int iio_buffer_add_channel_sysfs(struct iio_dev *indio_dev,
return ret;
}

-static ssize_t iio_buffer_read_length(struct device *dev,
- struct device_attribute *attr,
- char *buf)
+static ssize_t length_show(struct device *dev,
+ struct device_attribute *attr,
+ char *buf)
{
struct iio_buffer *buffer = to_iio_dev_attr(attr)->buffer;

return sysfs_emit(buf, "%d\n", buffer->length);
}

-static ssize_t iio_buffer_write_length(struct device *dev,
- struct device_attribute *attr,
- const char *buf, size_t len)
+static ssize_t length_store(struct device *dev,
+ struct device_attribute *attr,
+ const char *buf, size_t len)
{
struct iio_dev *indio_dev = dev_to_iio_dev(dev);
struct iio_buffer *buffer = to_iio_dev_attr(attr)->buffer;
@@ -672,9 +672,9 @@ static ssize_t iio_buffer_write_length(struct device *dev,
return ret ? ret : len;
}

-static ssize_t iio_buffer_show_enable(struct device *dev,
- struct device_attribute *attr,
- char *buf)
+static ssize_t enable_show(struct device *dev,
+ struct device_attribute *attr,
+ char *buf)
{
struct iio_buffer *buffer = to_iio_dev_attr(attr)->buffer;

@@ -1289,10 +1289,10 @@ void iio_disable_all_buffers(struct iio_dev *indio_dev)
iio_buffer_deactivate_all(indio_dev);
}

-static ssize_t iio_buffer_store_enable(struct device *dev,
- struct device_attribute *attr,
- const char *buf,
- size_t len)
+static ssize_t enable_store(struct device *dev,
+ struct device_attribute *attr,
+ const char *buf,
+ size_t len)
{
int ret;
bool requested_state;
@@ -1322,19 +1322,19 @@ static ssize_t iio_buffer_store_enable(struct device *dev,
return (ret < 0) ? ret : len;
}

-static ssize_t iio_buffer_show_watermark(struct device *dev,
- struct device_attribute *attr,
- char *buf)
+static ssize_t watermark_show(struct device *dev,
+ struct device_attribute *attr,
+ char *buf)
{
struct iio_buffer *buffer = to_iio_dev_attr(attr)->buffer;

return sysfs_emit(buf, "%u\n", buffer->watermark);
}

-static ssize_t iio_buffer_store_watermark(struct device *dev,
- struct device_attribute *attr,
- const char *buf,
- size_t len)
+static ssize_t watermark_store(struct device *dev,
+ struct device_attribute *attr,
+ const char *buf,
+ size_t len)
{
struct iio_dev *indio_dev = dev_to_iio_dev(dev);
struct iio_buffer *buffer = to_iio_dev_attr(attr)->buffer;
@@ -1366,9 +1366,9 @@ static ssize_t iio_buffer_store_watermark(struct device *dev,
return ret ? ret : len;
}

-static ssize_t iio_dma_show_data_available(struct device *dev,
- struct device_attribute *attr,
- char *buf)
+static ssize_t data_available_show(struct device *dev,
+ struct device_attribute *attr,
+ char *buf)
{
struct iio_buffer *buffer = to_iio_dev_attr(attr)->buffer;

@@ -1391,18 +1391,12 @@ static ssize_t direction_show(struct device *dev,
}
}

-static DEVICE_ATTR(length, S_IRUGO | S_IWUSR, iio_buffer_read_length,
- iio_buffer_write_length);
-static struct device_attribute dev_attr_length_ro = __ATTR(length,
- S_IRUGO, iio_buffer_read_length, NULL);
-static DEVICE_ATTR(enable, S_IRUGO | S_IWUSR,
- iio_buffer_show_enable, iio_buffer_store_enable);
-static DEVICE_ATTR(watermark, S_IRUGO | S_IWUSR,
- iio_buffer_show_watermark, iio_buffer_store_watermark);
-static struct device_attribute dev_attr_watermark_ro = __ATTR(watermark,
- S_IRUGO, iio_buffer_show_watermark, NULL);
-static DEVICE_ATTR(data_available, S_IRUGO,
- iio_dma_show_data_available, NULL);
+static DEVICE_ATTR_RW(length);
+static struct device_attribute dev_attr_length_ro = __ATTR_RO(length);
+static DEVICE_ATTR_RW(enable);
+static DEVICE_ATTR_RW(watermark);
+static struct device_attribute dev_attr_watermark_ro = __ATTR_RO(watermark);
+static DEVICE_ATTR_RO(data_available);
static DEVICE_ATTR_RO(direction);

/*
diff --git a/drivers/iio/industrialio-core.c b/drivers/iio/industrialio-core.c
index e1ed44dec2ab..bb1dd00b99ac 100644
--- a/drivers/iio/industrialio-core.c
+++ b/drivers/iio/industrialio-core.c
@@ -1114,12 +1114,12 @@ int __iio_device_attr_init(struct device_attribute *dev_attr,
dev_attr->attr.name = name;

if (readfunc) {
- dev_attr->attr.mode |= S_IRUGO;
+ dev_attr->attr.mode |= 0444;
dev_attr->show = readfunc;
}

if (writefunc) {
- dev_attr->attr.mode |= S_IWUSR;
+ dev_attr->attr.mode |= 0200;
dev_attr->store = writefunc;
}

@@ -1393,29 +1393,29 @@ void iio_free_chan_devattr_list(struct list_head *attr_list)
}
}

-static ssize_t iio_show_dev_name(struct device *dev,
- struct device_attribute *attr,
- char *buf)
+static ssize_t name_show(struct device *dev,
+ struct device_attribute *attr,
+ char *buf)
{
struct iio_dev *indio_dev = dev_to_iio_dev(dev);
return sysfs_emit(buf, "%s\n", indio_dev->name);
}

-static DEVICE_ATTR(name, S_IRUGO, iio_show_dev_name, NULL);
+static DEVICE_ATTR_RO(name);

-static ssize_t iio_show_dev_label(struct device *dev,
- struct device_attribute *attr,
- char *buf)
+static ssize_t label_show(struct device *dev,
+ struct device_attribute *attr,
+ char *buf)
{
struct iio_dev *indio_dev = dev_to_iio_dev(dev);
return sysfs_emit(buf, "%s\n", indio_dev->label);
}

-static DEVICE_ATTR(label, S_IRUGO, iio_show_dev_label, NULL);
+static DEVICE_ATTR_RO(label);

-static ssize_t iio_show_timestamp_clock(struct device *dev,
- struct device_attribute *attr,
- char *buf)
+static ssize_t current_timestamp_clock_show(struct device *dev,
+ struct device_attribute *attr,
+ char *buf)
{
const struct iio_dev *indio_dev = dev_to_iio_dev(dev);
const clockid_t clk = iio_device_get_clock(indio_dev);
@@ -1459,9 +1459,9 @@ static ssize_t iio_show_timestamp_clock(struct device *dev,
return sz;
}

-static ssize_t iio_store_timestamp_clock(struct device *dev,
- struct device_attribute *attr,
- const char *buf, size_t len)
+static ssize_t current_timestamp_clock_store(struct device *dev,
+ struct device_attribute *attr,
+ const char *buf, size_t len)
{
clockid_t clk;
int ret;
@@ -1509,8 +1509,7 @@ int iio_device_register_sysfs_group(struct iio_dev *indio_dev,
return 0;
}

-static DEVICE_ATTR(current_timestamp_clock, S_IRUGO | S_IWUSR,
- iio_show_timestamp_clock, iio_store_timestamp_clock);
+static DEVICE_ATTR_RW(current_timestamp_clock);

static int iio_device_register_sysfs(struct iio_dev *indio_dev)
{
diff --git a/drivers/iio/industrialio-trigger.c b/drivers/iio/industrialio-trigger.c
index f504ed351b3e..21f113c0ee96 100644
--- a/drivers/iio/industrialio-trigger.c
+++ b/drivers/iio/industrialio-trigger.c
@@ -37,7 +37,7 @@ static LIST_HEAD(iio_trigger_list);
static DEFINE_MUTEX(iio_trigger_list_lock);

/**
- * iio_trigger_read_name() - retrieve useful identifying name
+ * name_show() - retrieve useful identifying name
* @dev: device associated with the iio_trigger
* @attr: pointer to the device_attribute structure that is
* being processed
@@ -46,15 +46,15 @@ static DEFINE_MUTEX(iio_trigger_list_lock);
* Return: a negative number on failure or the number of written
* characters on success.
*/
-static ssize_t iio_trigger_read_name(struct device *dev,
- struct device_attribute *attr,
- char *buf)
+static ssize_t name_show(struct device *dev,
+ struct device_attribute *attr,
+ char *buf)
{
struct iio_trigger *trig = to_iio_trigger(dev);
return sysfs_emit(buf, "%s\n", trig->name);
}

-static DEVICE_ATTR(name, S_IRUGO, iio_trigger_read_name, NULL);
+static DEVICE_ATTR_RO(name);

static struct attribute *iio_trig_dev_attrs[] = {
&dev_attr_name.attr,
@@ -395,7 +395,7 @@ void iio_dealloc_pollfunc(struct iio_poll_func *pf)
EXPORT_SYMBOL_GPL(iio_dealloc_pollfunc);

/**
- * iio_trigger_read_current() - trigger consumer sysfs query current trigger
+ * current_trigger_show() - trigger consumer sysfs query current trigger
* @dev: device associated with an industrial I/O device
* @attr: pointer to the device_attribute structure that
* is being processed
@@ -407,9 +407,9 @@ EXPORT_SYMBOL_GPL(iio_dealloc_pollfunc);
* Return: a negative number on failure, the number of characters written
* on success or 0 if no trigger is available
*/
-static ssize_t iio_trigger_read_current(struct device *dev,
- struct device_attribute *attr,
- char *buf)
+static ssize_t current_trigger_show(struct device *dev,
+ struct device_attribute *attr,
+ char *buf)
{
struct iio_dev *indio_dev = dev_to_iio_dev(dev);

@@ -419,7 +419,7 @@ static ssize_t iio_trigger_read_current(struct device *dev,
}

/**
- * iio_trigger_write_current() - trigger consumer sysfs set current trigger
+ * current_trigger_store() - trigger consumer sysfs set current trigger
* @dev: device associated with an industrial I/O device
* @attr: device attribute that is being processed
* @buf: string buffer that holds the name of the trigger
@@ -432,10 +432,10 @@ static ssize_t iio_trigger_read_current(struct device *dev,
* Return: negative error code on failure or length of the buffer
* on success
*/
-static ssize_t iio_trigger_write_current(struct device *dev,
- struct device_attribute *attr,
- const char *buf,
- size_t len)
+static ssize_t current_trigger_store(struct device *dev,
+ struct device_attribute *attr,
+ const char *buf,
+ size_t len)
{
struct iio_dev *indio_dev = dev_to_iio_dev(dev);
struct iio_dev_opaque *iio_dev_opaque = to_iio_dev_opaque(indio_dev);
@@ -494,9 +494,7 @@ static ssize_t iio_trigger_write_current(struct device *dev,
return ret;
}

-static DEVICE_ATTR(current_trigger, S_IRUGO | S_IWUSR,
- iio_trigger_read_current,
- iio_trigger_write_current);
+static DEVICE_ATTR_RW(current_trigger);

static struct attribute *iio_trigger_consumer_attrs[] = {
&dev_attr_current_trigger.attr,
--
2.35.3

2022-06-01 21:51:27

by Andy Shevchenko

[permalink] [raw]

Subject: Re: [PATCH v3] iio: Use octal permissions and DEVICE_ATTR_{RO,RW}.

On Wed, Jun 1, 2022 at 8:54 PM Joe Simmons-Talbott <[email protected]> wrote:
>
> As reported by checkpatch.pl. Where possible use DEVICE_ATTR_RO(),
> DEVICE_ATTR_RW(), and __ATTR_RO(). Change function names to be
> <var>_show() for read and <var>_store() for write.

Thank you for an update!
I have a few nit-picks, but no need to resend, I believe Jonathan may
(or may not :) modify when applying.
Reviewed-by: Andy Shevchenko <[email protected]>

> Suggested-by: Joe Perches <[email protected]>
> Suggested-by: Andy Shevchenko <[email protected]>
> Signed-off-by: Joe Simmons-Talbott <[email protected]>
> ---
>
> Changes in v3:
> - Use __ATTR_RO() and add parens to DEVICE_ATTR_{RW,RO} in description
> as suggested by Andy Shevchenko <[email protected]>
>
> Changes in v2:
> - Use DEVICE_ATTR_RO() and DEVICE_ATTR_RW() rather than octal permissions
> where applicable. Rename functions to <var>-show() and
> <var>-store(). Based on review by Joe Perches <[email protected]>
>
> drivers/iio/industrialio-buffer.c | 64 ++++++++++++++----------------
> drivers/iio/industrialio-core.c | 35 ++++++++--------
> drivers/iio/industrialio-trigger.c | 32 +++++++--------
> 3 files changed, 61 insertions(+), 70 deletions(-)
>
> diff --git a/drivers/iio/industrialio-buffer.c b/drivers/iio/industrialio-buffer.c
> index b078eb2f3c9d..80121b1ac554 100644
> --- a/drivers/iio/industrialio-buffer.c
> +++ b/drivers/iio/industrialio-buffer.c
> @@ -630,18 +630,18 @@ static int iio_buffer_add_channel_sysfs(struct iio_dev *indio_dev,
> return ret;
> }
>
> -static ssize_t iio_buffer_read_length(struct device *dev,
> - struct device_attribute *attr,
> - char *buf)
> +static ssize_t length_show(struct device *dev,
> + struct device_attribute *attr,

I think we have enough space to move the attr parameter to the previous line.

> + char *buf)
> {
> struct iio_buffer *buffer = to_iio_dev_attr(attr)->buffer;
>
> return sysfs_emit(buf, "%d\n", buffer->length);
> }
>
> -static ssize_t iio_buffer_write_length(struct device *dev,
> - struct device_attribute *attr,
> - const char *buf, size_t len)
> +static ssize_t length_store(struct device *dev,
> + struct device_attribute *attr,

Ditto.

> + const char *buf, size_t len)
> {
> struct iio_dev *indio_dev = dev_to_iio_dev(dev);
> struct iio_buffer *buffer = to_iio_dev_attr(attr)->buffer;
> @@ -672,9 +672,9 @@ static ssize_t iio_buffer_write_length(struct device *dev,
> return ret ? ret : len;
> }
>
> -static ssize_t iio_buffer_show_enable(struct device *dev,
> - struct device_attribute *attr,
> - char *buf)
> +static ssize_t enable_show(struct device *dev,
> + struct device_attribute *attr,

Ditto.

> + char *buf)
> {
> struct iio_buffer *buffer = to_iio_dev_attr(attr)->buffer;
>
> @@ -1289,10 +1289,10 @@ void iio_disable_all_buffers(struct iio_dev *indio_dev)
> iio_buffer_deactivate_all(indio_dev);
> }
>
> -static ssize_t iio_buffer_store_enable(struct device *dev,
> - struct device_attribute *attr,
> - const char *buf,
> - size_t len)
> +static ssize_t enable_store(struct device *dev,
> + struct device_attribute *attr,

Ditto.

> + const char *buf,
> + size_t len)

And these two may be on one line.

> {
> int ret;
> bool requested_state;
> @@ -1322,19 +1322,19 @@ static ssize_t iio_buffer_store_enable(struct device *dev,
> return (ret < 0) ? ret : len;
> }
>
> -static ssize_t iio_buffer_show_watermark(struct device *dev,
> - struct device_attribute *attr,
> - char *buf)
> +static ssize_t watermark_show(struct device *dev,
> + struct device_attribute *attr,

Ditto.

> + char *buf)
> {
> struct iio_buffer *buffer = to_iio_dev_attr(attr)->buffer;
>
> return sysfs_emit(buf, "%u\n", buffer->watermark);
> }
>
> -static ssize_t iio_buffer_store_watermark(struct device *dev,
> - struct device_attribute *attr,
> - const char *buf,
> - size_t len)
> +static ssize_t watermark_store(struct device *dev,
> + struct device_attribute *attr,

Ditto.

> + const char *buf,
> + size_t len)

Ditto.

> {
> struct iio_dev *indio_dev = dev_to_iio_dev(dev);
> struct iio_buffer *buffer = to_iio_dev_attr(attr)->buffer;
> @@ -1366,9 +1366,9 @@ static ssize_t iio_buffer_store_watermark(struct device *dev,
> return ret ? ret : len;
> }
>
> -static ssize_t iio_dma_show_data_available(struct device *dev,
> - struct device_attribute *attr,
> - char *buf)
> +static ssize_t data_available_show(struct device *dev,
> + struct device_attribute *attr,

Ditto.

> + char *buf)
> {
> struct iio_buffer *buffer = to_iio_dev_attr(attr)->buffer;
>
> @@ -1391,18 +1391,12 @@ static ssize_t direction_show(struct device *dev,
> }
> }
>
> -static DEVICE_ATTR(length, S_IRUGO | S_IWUSR, iio_buffer_read_length,
> - iio_buffer_write_length);
> -static struct device_attribute dev_attr_length_ro = __ATTR(length,
> - S_IRUGO, iio_buffer_read_length, NULL);
> -static DEVICE_ATTR(enable, S_IRUGO | S_IWUSR,
> - iio_buffer_show_enable, iio_buffer_store_enable);
> -static DEVICE_ATTR(watermark, S_IRUGO | S_IWUSR,
> - iio_buffer_show_watermark, iio_buffer_store_watermark);
> -static struct device_attribute dev_attr_watermark_ro = __ATTR(watermark,
> - S_IRUGO, iio_buffer_show_watermark, NULL);
> -static DEVICE_ATTR(data_available, S_IRUGO,
> - iio_dma_show_data_available, NULL);
> +static DEVICE_ATTR_RW(length);
> +static struct device_attribute dev_attr_length_ro = __ATTR_RO(length);
> +static DEVICE_ATTR_RW(enable);
> +static DEVICE_ATTR_RW(watermark);
> +static struct device_attribute dev_attr_watermark_ro = __ATTR_RO(watermark);
> +static DEVICE_ATTR_RO(data_available);
> static DEVICE_ATTR_RO(direction);
>
> /*
> diff --git a/drivers/iio/industrialio-core.c b/drivers/iio/industrialio-core.c
> index e1ed44dec2ab..bb1dd00b99ac 100644
> --- a/drivers/iio/industrialio-core.c
> +++ b/drivers/iio/industrialio-core.c
> @@ -1114,12 +1114,12 @@ int __iio_device_attr_init(struct device_attribute *dev_attr,
> dev_attr->attr.name = name;
>
> if (readfunc) {
> - dev_attr->attr.mode |= S_IRUGO;
> + dev_attr->attr.mode |= 0444;
> dev_attr->show = readfunc;
> }
>
> if (writefunc) {
> - dev_attr->attr.mode |= S_IWUSR;
> + dev_attr->attr.mode |= 0200;
> dev_attr->store = writefunc;
> }
>
> @@ -1393,29 +1393,29 @@ void iio_free_chan_devattr_list(struct list_head *attr_list)
> }
> }
>
> -static ssize_t iio_show_dev_name(struct device *dev,
> - struct device_attribute *attr,
> - char *buf)
> +static ssize_t name_show(struct device *dev,
> + struct device_attribute *attr,

Ditto.

> + char *buf)
> {
> struct iio_dev *indio_dev = dev_to_iio_dev(dev);
> return sysfs_emit(buf, "%s\n", indio_dev->name);
> }
>
> -static DEVICE_ATTR(name, S_IRUGO, iio_show_dev_name, NULL);
> +static DEVICE_ATTR_RO(name);
>
> -static ssize_t iio_show_dev_label(struct device *dev,
> - struct device_attribute *attr,
> - char *buf)
> +static ssize_t label_show(struct device *dev,
> + struct device_attribute *attr,

Ditto.

> + char *buf)
> {
> struct iio_dev *indio_dev = dev_to_iio_dev(dev);
> return sysfs_emit(buf, "%s\n", indio_dev->label);
> }
>
> -static DEVICE_ATTR(label, S_IRUGO, iio_show_dev_label, NULL);
> +static DEVICE_ATTR_RO(label);
>
> -static ssize_t iio_show_timestamp_clock(struct device *dev,
> - struct device_attribute *attr,
> - char *buf)
> +static ssize_t current_timestamp_clock_show(struct device *dev,
> + struct device_attribute *attr,
> + char *buf)
> {
> const struct iio_dev *indio_dev = dev_to_iio_dev(dev);
> const clockid_t clk = iio_device_get_clock(indio_dev);
> @@ -1459,9 +1459,9 @@ static ssize_t iio_show_timestamp_clock(struct device *dev,
> return sz;
> }
>
> -static ssize_t iio_store_timestamp_clock(struct device *dev,
> - struct device_attribute *attr,
> - const char *buf, size_t len)
> +static ssize_t current_timestamp_clock_store(struct device *dev,
> + struct device_attribute *attr,
> + const char *buf, size_t len)
> {
> clockid_t clk;
> int ret;
> @@ -1509,8 +1509,7 @@ int iio_device_register_sysfs_group(struct iio_dev *indio_dev,
> return 0;
> }
>
> -static DEVICE_ATTR(current_timestamp_clock, S_IRUGO | S_IWUSR,
> - iio_show_timestamp_clock, iio_store_timestamp_clock);
> +static DEVICE_ATTR_RW(current_timestamp_clock);
>
> static int iio_device_register_sysfs(struct iio_dev *indio_dev)
> {
> diff --git a/drivers/iio/industrialio-trigger.c b/drivers/iio/industrialio-trigger.c
> index f504ed351b3e..21f113c0ee96 100644
> --- a/drivers/iio/industrialio-trigger.c
> +++ b/drivers/iio/industrialio-trigger.c
> @@ -37,7 +37,7 @@ static LIST_HEAD(iio_trigger_list);
> static DEFINE_MUTEX(iio_trigger_list_lock);
>
> /**
> - * iio_trigger_read_name() - retrieve useful identifying name
> + * name_show() - retrieve useful identifying name
> * @dev: device associated with the iio_trigger
> * @attr: pointer to the device_attribute structure that is
> * being processed
> @@ -46,15 +46,15 @@ static DEFINE_MUTEX(iio_trigger_list_lock);
> * Return: a negative number on failure or the number of written
> * characters on success.
> */
> -static ssize_t iio_trigger_read_name(struct device *dev,
> - struct device_attribute *attr,
> - char *buf)
> +static ssize_t name_show(struct device *dev,
> + struct device_attribute *attr,

Ditto.

> + char *buf)
> {
> struct iio_trigger *trig = to_iio_trigger(dev);
> return sysfs_emit(buf, "%s\n", trig->name);
> }
>
> -static DEVICE_ATTR(name, S_IRUGO, iio_trigger_read_name, NULL);
> +static DEVICE_ATTR_RO(name);
>
> static struct attribute *iio_trig_dev_attrs[] = {
> &dev_attr_name.attr,
> @@ -395,7 +395,7 @@ void iio_dealloc_pollfunc(struct iio_poll_func *pf)
> EXPORT_SYMBOL_GPL(iio_dealloc_pollfunc);
>
> /**
> - * iio_trigger_read_current() - trigger consumer sysfs query current trigger
> + * current_trigger_show() - trigger consumer sysfs query current trigger
> * @dev: device associated with an industrial I/O device
> * @attr: pointer to the device_attribute structure that
> * is being processed
> @@ -407,9 +407,9 @@ EXPORT_SYMBOL_GPL(iio_dealloc_pollfunc);
> * Return: a negative number on failure, the number of characters written
> * on success or 0 if no trigger is available
> */
> -static ssize_t iio_trigger_read_current(struct device *dev,
> - struct device_attribute *attr,
> - char *buf)
> +static ssize_t current_trigger_show(struct device *dev,
> + struct device_attribute *attr,

Ditto.

> + char *buf)
> {
> struct iio_dev *indio_dev = dev_to_iio_dev(dev);
>
> @@ -419,7 +419,7 @@ static ssize_t iio_trigger_read_current(struct device *dev,
> }
>
> /**
> - * iio_trigger_write_current() - trigger consumer sysfs set current trigger
> + * current_trigger_store() - trigger consumer sysfs set current trigger
> * @dev: device associated with an industrial I/O device
> * @attr: device attribute that is being processed
> * @buf: string buffer that holds the name of the trigger
> @@ -432,10 +432,10 @@ static ssize_t iio_trigger_read_current(struct device *dev,
> * Return: negative error code on failure or length of the buffer
> * on success
> */
> -static ssize_t iio_trigger_write_current(struct device *dev,
> - struct device_attribute *attr,
> - const char *buf,
> - size_t len)
> +static ssize_t current_trigger_store(struct device *dev,
> + struct device_attribute *attr,

Ditto.

> + const char *buf,
> + size_t len)

Ditto.

> {
> struct iio_dev *indio_dev = dev_to_iio_dev(dev);
> struct iio_dev_opaque *iio_dev_opaque = to_iio_dev_opaque(indio_dev);
> @@ -494,9 +494,7 @@ static ssize_t iio_trigger_write_current(struct device *dev,
> return ret;
> }
>
> -static DEVICE_ATTR(current_trigger, S_IRUGO | S_IWUSR,
> - iio_trigger_read_current,
> - iio_trigger_write_current);
> +static DEVICE_ATTR_RW(current_trigger);
>
> static struct attribute *iio_trigger_consumer_attrs[] = {
> &dev_attr_current_trigger.attr,
> --
> 2.35.3
>

--
With Best Regards,
Andy Shevchenko

2022-06-06 05:44:15

by Jonathan Cameron

[permalink] [raw]

Subject: Re: [PATCH v3] iio: Use octal permissions and DEVICE_ATTR_{RO,RW}.

On Wed, 1 Jun 2022 21:02:52 +0200
Andy Shevchenko <[email protected]> wrote:

> On Wed, Jun 1, 2022 at 8:54 PM Joe Simmons-Talbott <[email protected]> wrote:
> >
> > As reported by checkpatch.pl. Where possible use DEVICE_ATTR_RO(),
> > DEVICE_ATTR_RW(), and __ATTR_RO(). Change function names to be
> > <var>_show() for read and <var>_store() for write.
>
> Thank you for an update!
> I have a few nit-picks, but no need to resend, I believe Jonathan may
> (or may not :) modify when applying.
> Reviewed-by: Andy Shevchenko <[email protected]>
>

Looks fine to me and I might indeed tidy up the various nit-picks
Andy raised. I'd like to leave this on the list a little longer though.
Feel free to give me a poke if I haven't picked it up in 2 weeks or so.

Thanks,

Jonathan

> > Suggested-by: Joe Perches <[email protected]>
> > Suggested-by: Andy Shevchenko <[email protected]>
> > Signed-off-by: Joe Simmons-Talbott <[email protected]>
> > ---
> >
> > Changes in v3:
> > - Use __ATTR_RO() and add parens to DEVICE_ATTR_{RW,RO} in description
> > as suggested by Andy Shevchenko <[email protected]>
> >
> > Changes in v2:
> > - Use DEVICE_ATTR_RO() and DEVICE_ATTR_RW() rather than octal permissions
> > where applicable. Rename functions to <var>-show() and
> > <var>-store(). Based on review by Joe Perches <[email protected]>
> >
> > drivers/iio/industrialio-buffer.c | 64 ++++++++++++++----------------
> > drivers/iio/industrialio-core.c | 35 ++++++++--------
> > drivers/iio/industrialio-trigger.c | 32 +++++++--------
> > 3 files changed, 61 insertions(+), 70 deletions(-)
> >
> > diff --git a/drivers/iio/industrialio-buffer.c b/drivers/iio/industrialio-buffer.c
> > index b078eb2f3c9d..80121b1ac554 100644
> > --- a/drivers/iio/industrialio-buffer.c
> > +++ b/drivers/iio/industrialio-buffer.c
> > @@ -630,18 +630,18 @@ static int iio_buffer_add_channel_sysfs(struct iio_dev *indio_dev,
> > return ret;
> > }
> >
> > -static ssize_t iio_buffer_read_length(struct device *dev,
> > - struct device_attribute *attr,
> > - char *buf)
> > +static ssize_t length_show(struct device *dev,
> > + struct device_attribute *attr,
>
> I think we have enough space to move the attr parameter to the previous line.
>
> > + char *buf)
> > {
> > struct iio_buffer *buffer = to_iio_dev_attr(attr)->buffer;
> >
> > return sysfs_emit(buf, "%d\n", buffer->length);
> > }
> >
> > -static ssize_t iio_buffer_write_length(struct device *dev,
> > - struct device_attribute *attr,
> > - const char *buf, size_t len)
> > +static ssize_t length_store(struct device *dev,
> > + struct device_attribute *attr,
>
> Ditto.
>
> > + const char *buf, size_t len)
> > {
> > struct iio_dev *indio_dev = dev_to_iio_dev(dev);
> > struct iio_buffer *buffer = to_iio_dev_attr(attr)->buffer;
> > @@ -672,9 +672,9 @@ static ssize_t iio_buffer_write_length(struct device *dev,
> > return ret ? ret : len;
> > }
> >
> > -static ssize_t iio_buffer_show_enable(struct device *dev,
> > - struct device_attribute *attr,
> > - char *buf)
> > +static ssize_t enable_show(struct device *dev,
> > + struct device_attribute *attr,
>
> Ditto.
>
> > + char *buf)
> > {
> > struct iio_buffer *buffer = to_iio_dev_attr(attr)->buffer;
> >
> > @@ -1289,10 +1289,10 @@ void iio_disable_all_buffers(struct iio_dev *indio_dev)
> > iio_buffer_deactivate_all(indio_dev);
> > }
> >
> > -static ssize_t iio_buffer_store_enable(struct device *dev,
> > - struct device_attribute *attr,
> > - const char *buf,
> > - size_t len)
> > +static ssize_t enable_store(struct device *dev,
> > + struct device_attribute *attr,
>
> Ditto.
>
> > + const char *buf,
> > + size_t len)
>
> And these two may be on one line.
>
> > {
> > int ret;
> > bool requested_state;
> > @@ -1322,19 +1322,19 @@ static ssize_t iio_buffer_store_enable(struct device *dev,
> > return (ret < 0) ? ret : len;
> > }
> >
> > -static ssize_t iio_buffer_show_watermark(struct device *dev,
> > - struct device_attribute *attr,
> > - char *buf)
> > +static ssize_t watermark_show(struct device *dev,
> > + struct device_attribute *attr,
>
> Ditto.
>
> > + char *buf)
> > {
> > struct iio_buffer *buffer = to_iio_dev_attr(attr)->buffer;
> >
> > return sysfs_emit(buf, "%u\n", buffer->watermark);
> > }
> >
> > -static ssize_t iio_buffer_store_watermark(struct device *dev,
> > - struct device_attribute *attr,
> > - const char *buf,
> > - size_t len)
> > +static ssize_t watermark_store(struct device *dev,
> > + struct device_attribute *attr,
>
> Ditto.
>
> > + const char *buf,
> > + size_t len)
>
> Ditto.
>
> > {
> > struct iio_dev *indio_dev = dev_to_iio_dev(dev);
> > struct iio_buffer *buffer = to_iio_dev_attr(attr)->buffer;
> > @@ -1366,9 +1366,9 @@ static ssize_t iio_buffer_store_watermark(struct device *dev,
> > return ret ? ret : len;
> > }
> >
> > -static ssize_t iio_dma_show_data_available(struct device *dev,
> > - struct device_attribute *attr,
> > - char *buf)
> > +static ssize_t data_available_show(struct device *dev,
> > + struct device_attribute *attr,
>
> Ditto.
>
> > + char *buf)
> > {
> > struct iio_buffer *buffer = to_iio_dev_attr(attr)->buffer;
> >
> > @@ -1391,18 +1391,12 @@ static ssize_t direction_show(struct device *dev,
> > }
> > }
> >
> > -static DEVICE_ATTR(length, S_IRUGO | S_IWUSR, iio_buffer_read_length,
> > - iio_buffer_write_length);
> > -static struct device_attribute dev_attr_length_ro = __ATTR(length,
> > - S_IRUGO, iio_buffer_read_length, NULL);
> > -static DEVICE_ATTR(enable, S_IRUGO | S_IWUSR,
> > - iio_buffer_show_enable, iio_buffer_store_enable);
> > -static DEVICE_ATTR(watermark, S_IRUGO | S_IWUSR,
> > - iio_buffer_show_watermark, iio_buffer_store_watermark);
> > -static struct device_attribute dev_attr_watermark_ro = __ATTR(watermark,
> > - S_IRUGO, iio_buffer_show_watermark, NULL);
> > -static DEVICE_ATTR(data_available, S_IRUGO,
> > - iio_dma_show_data_available, NULL);
> > +static DEVICE_ATTR_RW(length);
> > +static struct device_attribute dev_attr_length_ro = __ATTR_RO(length);
> > +static DEVICE_ATTR_RW(enable);
> > +static DEVICE_ATTR_RW(watermark);
> > +static struct device_attribute dev_attr_watermark_ro = __ATTR_RO(watermark);
> > +static DEVICE_ATTR_RO(data_available);
> > static DEVICE_ATTR_RO(direction);
> >
> > /*
> > diff --git a/drivers/iio/industrialio-core.c b/drivers/iio/industrialio-core.c
> > index e1ed44dec2ab..bb1dd00b99ac 100644
> > --- a/drivers/iio/industrialio-core.c
> > +++ b/drivers/iio/industrialio-core.c
> > @@ -1114,12 +1114,12 @@ int __iio_device_attr_init(struct device_attribute *dev_attr,
> > dev_attr->attr.name = name;
> >
> > if (readfunc) {
> > - dev_attr->attr.mode |= S_IRUGO;
> > + dev_attr->attr.mode |= 0444;
> > dev_attr->show = readfunc;
> > }
> >
> > if (writefunc) {
> > - dev_attr->attr.mode |= S_IWUSR;
> > + dev_attr->attr.mode |= 0200;
> > dev_attr->store = writefunc;
> > }
> >
> > @@ -1393,29 +1393,29 @@ void iio_free_chan_devattr_list(struct list_head *attr_list)
> > }
> > }
> >
> > -static ssize_t iio_show_dev_name(struct device *dev,
> > - struct device_attribute *attr,
> > - char *buf)
> > +static ssize_t name_show(struct device *dev,
> > + struct device_attribute *attr,
>
> Ditto.
>
> > + char *buf)
> > {
> > struct iio_dev *indio_dev = dev_to_iio_dev(dev);
> > return sysfs_emit(buf, "%s\n", indio_dev->name);
> > }
> >
> > -static DEVICE_ATTR(name, S_IRUGO, iio_show_dev_name, NULL);
> > +static DEVICE_ATTR_RO(name);
> >
> > -static ssize_t iio_show_dev_label(struct device *dev,
> > - struct device_attribute *attr,
> > - char *buf)
> > +static ssize_t label_show(struct device *dev,
> > + struct device_attribute *attr,
>
> Ditto.
>
> > + char *buf)
> > {
> > struct iio_dev *indio_dev = dev_to_iio_dev(dev);
> > return sysfs_emit(buf, "%s\n", indio_dev->label);
> > }
> >
> > -static DEVICE_ATTR(label, S_IRUGO, iio_show_dev_label, NULL);
> > +static DEVICE_ATTR_RO(label);
> >
> > -static ssize_t iio_show_timestamp_clock(struct device *dev,
> > - struct device_attribute *attr,
> > - char *buf)
> > +static ssize_t current_timestamp_clock_show(struct device *dev,
> > + struct device_attribute *attr,
> > + char *buf)
> > {
> > const struct iio_dev *indio_dev = dev_to_iio_dev(dev);
> > const clockid_t clk = iio_device_get_clock(indio_dev);
> > @@ -1459,9 +1459,9 @@ static ssize_t iio_show_timestamp_clock(struct device *dev,
> > return sz;
> > }
> >
> > -static ssize_t iio_store_timestamp_clock(struct device *dev,
> > - struct device_attribute *attr,
> > - const char *buf, size_t len)
> > +static ssize_t current_timestamp_clock_store(struct device *dev,
> > + struct device_attribute *attr,
> > + const char *buf, size_t len)
> > {
> > clockid_t clk;
> > int ret;
> > @@ -1509,8 +1509,7 @@ int iio_device_register_sysfs_group(struct iio_dev *indio_dev,
> > return 0;
> > }
> >
> > -static DEVICE_ATTR(current_timestamp_clock, S_IRUGO | S_IWUSR,
> > - iio_show_timestamp_clock, iio_store_timestamp_clock);
> > +static DEVICE_ATTR_RW(current_timestamp_clock);
> >
> > static int iio_device_register_sysfs(struct iio_dev *indio_dev)
> > {
> > diff --git a/drivers/iio/industrialio-trigger.c b/drivers/iio/industrialio-trigger.c
> > index f504ed351b3e..21f113c0ee96 100644
> > --- a/drivers/iio/industrialio-trigger.c
> > +++ b/drivers/iio/industrialio-trigger.c
> > @@ -37,7 +37,7 @@ static LIST_HEAD(iio_trigger_list);
> > static DEFINE_MUTEX(iio_trigger_list_lock);
> >
> > /**
> > - * iio_trigger_read_name() - retrieve useful identifying name
> > + * name_show() - retrieve useful identifying name
> > * @dev: device associated with the iio_trigger
> > * @attr: pointer to the device_attribute structure that is
> > * being processed
> > @@ -46,15 +46,15 @@ static DEFINE_MUTEX(iio_trigger_list_lock);
> > * Return: a negative number on failure or the number of written
> > * characters on success.
> > */
> > -static ssize_t iio_trigger_read_name(struct device *dev,
> > - struct device_attribute *attr,
> > - char *buf)
> > +static ssize_t name_show(struct device *dev,
> > + struct device_attribute *attr,
>
> Ditto.
>
> > + char *buf)
> > {
> > struct iio_trigger *trig = to_iio_trigger(dev);
> > return sysfs_emit(buf, "%s\n", trig->name);
> > }
> >
> > -static DEVICE_ATTR(name, S_IRUGO, iio_trigger_read_name, NULL);
> > +static DEVICE_ATTR_RO(name);
> >
> > static struct attribute *iio_trig_dev_attrs[] = {
> > &dev_attr_name.attr,
> > @@ -395,7 +395,7 @@ void iio_dealloc_pollfunc(struct iio_poll_func *pf)
> > EXPORT_SYMBOL_GPL(iio_dealloc_pollfunc);
> >
> > /**
> > - * iio_trigger_read_current() - trigger consumer sysfs query current trigger
> > + * current_trigger_show() - trigger consumer sysfs query current trigger
> > * @dev: device associated with an industrial I/O device
> > * @attr: pointer to the device_attribute structure that
> > * is being processed
> > @@ -407,9 +407,9 @@ EXPORT_SYMBOL_GPL(iio_dealloc_pollfunc);
> > * Return: a negative number on failure, the number of characters written
> > * on success or 0 if no trigger is available
> > */
> > -static ssize_t iio_trigger_read_current(struct device *dev,
> > - struct device_attribute *attr,
> > - char *buf)
> > +static ssize_t current_trigger_show(struct device *dev,
> > + struct device_attribute *attr,
>
> Ditto.
>
> > + char *buf)
> > {
> > struct iio_dev *indio_dev = dev_to_iio_dev(dev);
> >
> > @@ -419,7 +419,7 @@ static ssize_t iio_trigger_read_current(struct device *dev,
> > }
> >
> > /**
> > - * iio_trigger_write_current() - trigger consumer sysfs set current trigger
> > + * current_trigger_store() - trigger consumer sysfs set current trigger
> > * @dev: device associated with an industrial I/O device
> > * @attr: device attribute that is being processed
> > * @buf: string buffer that holds the name of the trigger
> > @@ -432,10 +432,10 @@ static ssize_t iio_trigger_read_current(struct device *dev,
> > * Return: negative error code on failure or length of the buffer
> > * on success
> > */
> > -static ssize_t iio_trigger_write_current(struct device *dev,
> > - struct device_attribute *attr,
> > - const char *buf,
> > - size_t len)
> > +static ssize_t current_trigger_store(struct device *dev,
> > + struct device_attribute *attr,
>
> Ditto.
>
> > + const char *buf,
> > + size_t len)
>
> Ditto.
>
> > {
> > struct iio_dev *indio_dev = dev_to_iio_dev(dev);
> > struct iio_dev_opaque *iio_dev_opaque = to_iio_dev_opaque(indio_dev);
> > @@ -494,9 +494,7 @@ static ssize_t iio_trigger_write_current(struct device *dev,
> > return ret;
> > }
> >
> > -static DEVICE_ATTR(current_trigger, S_IRUGO | S_IWUSR,
> > - iio_trigger_read_current,
> > - iio_trigger_write_current);
> > +static DEVICE_ATTR_RW(current_trigger);
> >
> > static struct attribute *iio_trigger_consumer_attrs[] = {
> > &dev_attr_current_trigger.attr,
> > --
> > 2.35.3
> >
>
>

2022-06-14 10:47:42

by Jonathan Cameron

[permalink] [raw]