Re: [PATCH v3] iio: Use octal permissions and DEVICE_ATTR_{RO,RW}.
From: Jonathan Cameron
Date: Sat Jun 04 2022 - 10:09:06 EST
On Wed, 1 Jun 2022 21:02:52 +0200
Andy Shevchenko <andy.shevchenko@xxxxxxxxx> wrote:
> On Wed, Jun 1, 2022 at 8:54 PM Joe Simmons-Talbott <joetalbott@xxxxxxxxx> 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 <andy.shevchenko@xxxxxxxxx>
>
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 <joe@xxxxxxxxxxx>
> > Suggested-by: Andy Shevchenko <andy.shevchenko@xxxxxxxxx>
> > Signed-off-by: Joe Simmons-Talbott <joetalbott@xxxxxxxxx>
> > ---
> >
> > Changes in v3:
> > - Use __ATTR_RO() and add parens to DEVICE_ATTR_{RW,RO} in description
> > as suggested by Andy Shevchenko <andy.shevchenko@xxxxxxxxx>
> >
> > 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 <joe@xxxxxxxxxxx>
> >
> > 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
> >
>
>