lists.openwall.net   lists  /  announce  owl-users  owl-dev  john-users  john-dev  passwdqc-users  yescrypt  popa3d-users  /  oss-security  kernel-hardening  musl  sabotage  tlsify  passwords  /  crypt-dev  xvendor  /  Bugtraq  Full-Disclosure  linux-kernel  linux-netdev  linux-ext4  linux-hardening  linux-cve-announce  PHC 
Open Source and information security mailing list archives
 
Hash Suite: Windows password security audit tool. GUI, reports in PDF.
[<prev] [next>] [<thread-prev] [day] [month] [year] [list]
Message-ID: <20090531032802.GA14148@tarshish>
Date:	Sun, 31 May 2009 06:28:03 +0300
From:	Baruch Siach <baruch@...s.co.il>
To:	Andrew Morton <akpm@...ux-foundation.org>
Cc:	linux-kernel@...r.kernel.org, dbrownell@...rs.sourceforge.net
Subject: Re: [PATCH] gpio: driver for PrimeCell PL061 GPIO controller

Hi Andrew,

On Wed, May 27, 2009 at 04:38:44PM -0700, Andrew Morton wrote:
> On Tue, 19 May 2009 10:35:29 +0300
> Baruch Siach <baruch@...s.co.il> wrote:
> 
> > 
> > Signed-off-by: Baruch Siach <baruch@...s.co.il>
> 
> Patch looks nice and simple.  Was there really nothing you can think of
> for a changelog?  Like, what's a "PrimeCell PL061 GPIO"?  What hardware
> would one find it on?  Is it possible that a "PrimeCell PL061 GPIO" can
> appear on any CPU architecture at all, or is it specific to
> arm/x86/whatever?
> 
> etc.

OK. I'll add a changelog.

> > --- a/drivers/gpio/Kconfig
> > +++ b/drivers/gpio/Kconfig
> > @@ -67,6 +67,11 @@ config GPIO_SYSFS
> >  
> >  comment "Memory mapped GPIO expanders:"
> >  
> > +config GPIO_PL061
> > +	bool "PrimeCell PL061 GPIO support"
> > +	help
> > +	  Say yes here to support the PrimeCell PL061 GPIO device
> > +
> 
> hm, so gpio drivers can't be loaded as modules?

I guess gpio drives can be loaded as modules, but this is also an interrupt 
controller. Is there a safe way to unload an interrupt controller? Is there an 
example of a driver doing this?

> > ...
> >
> > --- /dev/null
> > +++ b/drivers/gpio/pl061.c
> > @@ -0,0 +1,336 @@
> > +/*
> > + *  linux/drivers/gpio/pl061.c
> > + *
> > + *  Copyright (C) 2008, 2009 Provigent Ltd.
> > + *
> > + * This program is free software; you can redistribute it and/or modify
> > + * it under the terms of the GNU General Public License version 2 as
> > + * published by the Free Software Foundation.
> > + *
> > + * Driver for the ARM PrimeCell(tm) General Purpose Input/Output (PL061)
> > + *
> > + * Data sheet: ARM DDI 0190B, September 2000
> > + */
> > +#include <linux/spinlock.h>
> > +#include <linux/errno.h>
> > +#include <linux/module.h>
> > +#include <linux/platform_device.h>
> > +#include <linux/io.h>
> > +#include <linux/irq.h>
> > +#include <linux/bitops.h>
> > +#include <linux/workqueue.h>
> > +#include <linux/gpio.h>
> > +#include <linux/gpio/pl061.h>
> > +
> > +#define PL061_GPIO_NR	8
> > +
> > +struct pl061_gpio {
> > +	spinlock_t		lock;
> > +	spinlock_t		irq_lock;
> 
> It's unclear (to me) why this has two different locks.  Perhaps only
> one was needed.  If we indeed need two locks then please add code
> comments which explain the role of each one.  And the nesting rules if
> appropriate.

The first lock protects the GPIO related hardware registers. The irq_lock 
protects the interrupt handling registers. They are mostly independent from 
each other. I'll add a comment explaining this.

> > +	void __iomem		*base;
> > +	struct gpio_chip	gc;
> > +	struct work_struct	gpio_free_work;
> > +	DECLARE_BITMAP(gpios_to_free, PL061_GPIO_NR);
> > +};
> > +
> > +static u32 (*pl061_pending_irq)(int irq);
> > +
> > +static int pl061_direction_input(struct gpio_chip *gc, unsigned offset)
> > +{
> > +	struct pl061_gpio *chip = container_of(gc, struct pl061_gpio, gc);
> > +	unsigned long flags;
> > +	unsigned char gpiodir;
> > +
> > +	if (offset >= gc->ngpio)
> > +		return -EINVAL;
> > +
> > +	spin_lock_irqsave(&chip->lock, flags);
> > +	gpiodir = readb (chip->base + GPIODIR);
> 
> Please pass this patch (and indeed, all patches) through
> scripts/checkpatch.pl and consider the resulting output.

OK.

> > +	gpiodir &= ~(1 << offset);
> > +	writeb(gpiodir, chip->base + GPIODIR);
> > +	spin_unlock_irqrestore(&chip->lock, flags);
> > +
> > +	return 0;
> > +}
> > +
> >
> > ...
> >
> > +static void pl061_irq_shutdown(unsigned irq)
> > +{
> > +	struct pl061_gpio *chip = get_irq_chip_data(irq);
> > +	int offset = irq_to_gpio(irq) - chip->gc.base;
> > +
> > +	pl061_irq_disable(irq);
> > +	set_bit(offset, chip->gpios_to_free);
> > +	schedule_work(&chip->gpio_free_work);
> > +}
> 
> It's usually a bug to add a schedule_work() and no corresponding
> flush_work()/cancel_work_sync()/etc.  
> 
> Because the callback might still be pending after module removal,
> device shutdown, etc.
> 
> If this is for some reason not a bug, I'd suggest that code somments be
> added explaining why.

Is this still a bug when the driver can't be removed?

> > ...
> >
> > +static void pl061_irq_handler(unsigned irq, struct irq_desc *desc)
> > +{
> > +	desc->chip->ack(irq);
> > +	while (1) {
> > +		unsigned long pending;
> > +		int gpio;
> > +
> > +		pending = pl061_pending_irq(irq);
> > +		if (pending == 0)
> > +			break;
> > +
> > +		for_each_bit(gpio, &pending, BITS_PER_LONG) {
> > +			generic_handle_irq(gpio_to_irq(gpio));
> > +		}
> 
> The braces are superfluous, but checkpatch misses this.

OK.

> > +	}
> > +	desc->chip->unmask(irq);
> > +}
> > +
> > +static void pl061_gpio_free(struct work_struct *work)
> > +{
> > +	struct pl061_gpio *chip = container_of(work, struct pl061_gpio,
> > +			gpio_free_work);
> > +	int offset;
> > +
> > +	while (!bitmap_empty(chip->gpios_to_free, PL061_GPIO_NR)) {
> > +		for_each_bit(offset, chip->gpios_to_free, PL061_GPIO_NR) {
> > +			int gpio = offset + chip->gc.base;
> > +
> > +			if (test_and_clear_bit(offset, chip->gpios_to_free))
> > +				gpio_free(gpio);
> > +		}
> > +	}
> 
> Does this function need to do multiple passes over gpios_to_free like
> this?  It seems unnecessary.
> 
> If it is indeed needed then please add a comment explaining what's
> going on.

It's probably not needed. I'll remove this.

> > +}
> > +
> > +static int __init pl061_probe(struct platform_device *dev)
> > +{
> > +	struct pl061_platform_data *pdata;
> > +	struct pl061_gpio *chip;
> > +	struct resource *r;
> > +	int ret, irq, i;
> > +
> > +	pdata = dev->dev.platform_data;
> > +	if (pdata == NULL)
> > +		return -ENODEV;
> > +
> > +	chip = kzalloc(sizeof(*chip), GFP_KERNEL);
> > +	if (chip == NULL)
> > +		return -ENOMEM;
> > +
> > +	r = platform_get_resource(dev, IORESOURCE_MEM, 0);
> > +	if (r == NULL) {
> > +		ret = -ENODEV;
> > +		goto free_mem;
> > +	}
> > +
> > +	chip->base = ioremap(r->start, r->end - r->start + 1);
> > +	if (chip->base == NULL) {
> > +		ret = -ENOMEM;
> > +		goto free_mem;
> > +	}
> > +
> > +	spin_lock_init(&chip->lock);
> > +	spin_lock_init(&chip->irq_lock);
> > +
> > +	bitmap_zero(chip->gpios_to_free, PL061_GPIO_NR);
> 
> Well.  kzalloc() already did that.

OK.

> > +	INIT_WORK(&chip->gpio_free_work, pl061_gpio_free);
> > +
> > +	chip->gc.direction_input = pl061_direction_input;
> > +	chip->gc.direction_output = pl061_direction_output;
> > +	chip->gc.get = pl061_get_value;
> > +	chip->gc.set = pl061_set_value;
> > +	chip->gc.base = pdata->gpio_base;
> > +	chip->gc.ngpio = PL061_GPIO_NR;
> > +	chip->gc.label = dev->name;
> > +	chip->gc.dev = &dev->dev;
> > +	chip->gc.owner = THIS_MODULE;
> > +
> > +	ret = gpiochip_add(&chip->gc);
> > +	if (ret)
> > +		goto iounmap;
> > +
> > +	/*
> > +	 * irq_chip support
> > +	 */
> > +	writeb(0, chip->base + GPIOIE); /* disable irqs */
> > +	irq = platform_get_irq(dev, 0);
> > +	if (irq < 0) {
> > +		ret = -ENODEV;
> > +		goto iounmap;
> > +	}
> > +	set_irq_chained_handler(irq, pl061_irq_handler);
> > +	pl061_pending_irq = pdata->pending_irqs;
> > +
> > +	for (i = 0; i < PL061_GPIO_NR; i++) {
> > +		if (pdata->directions & (1 << i))
> > +			pl061_direction_output(&chip->gc, i,
> > +					pdata->values & (1 << i));
> > +		else
> > +			pl061_direction_input(&chip->gc, i);
> > +
> > +		set_irq_chip(gpio_to_irq(i+pdata->gpio_base), &pl061_irqchip);
> > +		set_irq_handler(gpio_to_irq(i+pdata->gpio_base),
> > +				handle_simple_irq);
> > +		set_irq_flags(gpio_to_irq(i+pdata->gpio_base), IRQF_VALID);
> > +		set_irq_chip_data(gpio_to_irq(i+pdata->gpio_base), chip);
> > +	}
> > +
> > +	return 0;
> > +
> > +iounmap:
> > +	iounmap(chip->base);
> > +free_mem:
> > +	kfree(chip);
> > +
> > +	return ret;
> > +}
> > +
> >
> > ...

baruch

-- 
                                                     ~. .~   Tk Open Systems
=}------------------------------------------------ooO--U--Ooo------------{=
   - baruch@...s.co.il - tel: +972.2.679.5364, http://www.tkos.co.il -
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@...r.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/

Powered by blists - more mailing lists

Powered by Openwall GNU/*/Linux Powered by OpenVZ