Commit 5e6c7239 authored by Linus Torvalds's avatar Linus Torvalds
Browse files

Merge tag 'gpio-v3.17-3' of git://git.kernel.org/pub/scm/linux/kernel/git/linusw/linux-gpio 

Pull GPIO fixes from Linus Walleij:
 - some documentation sync
 - resource leak in the bt8xx driver
 - again fix the way varargs are used to handle the optional flags on
   the gpiod_* accessors.  Now hopefully nailed the entire problem.

* tag 'gpio-v3.17-3' of git://git.kernel.org/pub/scm/linux/kernel/git/linusw/linux-gpio:
  gpio: move varargs hack outside #ifdef GPIOLIB
  gpio: bt8xx: fix release of managed resources
  Documentation: gpio: documentation for optional getters functions
parents caa55235 0dbc8b7a

Documentation/gpio/consumer.txt

+23 −1
Original line number Diff line number Diff line
@@ -53,7 +53,20 @@ with IS_ERR() (they will never return a NULL pointer). -ENOENT will be returned 
if and only if no GPIO has been assigned to the device/function/index triplet,

other error codes are used for cases where a GPIO has been assigned but an error

occurred while trying to acquire it. This is useful to discriminate between mere

errors and an absence of GPIO for optional GPIO parameters.

errors and an absence of GPIO for optional GPIO parameters. For the common

pattern where a GPIO is optional, the gpiod_get_optional() and

gpiod_get_index_optional() functions can be used. These functions return NULL

instead of -ENOENT if no GPIO has been assigned to the requested function:





	struct gpio_desc *gpiod_get_optional(struct device *dev,

					     const char *con_id,

					     enum gpiod_flags flags)



	struct gpio_desc *gpiod_get_index_optional(struct device *dev,

						   const char *con_id,

						   unsigned int index,

						   enum gpiod_flags flags)



Device-managed variants of these functions are also defined:
@@ -65,6 +78,15 @@ Device-managed variants of these functions are also defined: 
					       unsigned int idx,

					       enum gpiod_flags flags)



	struct gpio_desc *devm_gpiod_get_optional(struct device *dev,

						  const char *con_id,

						  enum gpiod_flags flags)



	struct gpio_desc * devm_gpiod_get_index_optional(struct device *dev,

							const char *con_id,

							unsigned int index,

							enum gpiod_flags flags)



A GPIO descriptor can be disposed of using the gpiod_put() function:



	void gpiod_put(struct gpio_desc *desc)

drivers/gpio/gpio-bt8xx.c

+0 −3
Original line number Diff line number Diff line
@@ -241,9 +241,6 @@ static void bt8xxgpio_remove(struct pci_dev *pdev) 
	bgwrite(~0x0, BT848_INT_STAT);

	bgwrite(0x0, BT848_GPIO_OUT_EN);



	iounmap(bg->mmio);

	release_mem_region(pci_resource_start(pdev, 0),

			   pci_resource_len(pdev, 0));

	pci_disable_device(pdev);

}

include/linux/gpio/consumer.h

+60 −45
Original line number Diff line number Diff line
@@ -38,60 +38,32 @@ enum gpiod_flags { 
struct gpio_desc *__must_check __gpiod_get(struct device *dev,

					 const char *con_id,

					 enum gpiod_flags flags);

#define __gpiod_get(dev, con_id, flags, ...) __gpiod_get(dev, con_id, flags)

#define gpiod_get(varargs...) __gpiod_get(varargs, 0)

struct gpio_desc *__must_check __gpiod_get_index(struct device *dev,

					       const char *con_id,

					       unsigned int idx,

					       enum gpiod_flags flags);

#define __gpiod_get_index(dev, con_id, index, flags, ...)		\

	__gpiod_get_index(dev, con_id, index, flags)

#define gpiod_get_index(varargs...) __gpiod_get_index(varargs, 0)

struct gpio_desc *__must_check __gpiod_get_optional(struct device *dev,

						  const char *con_id,

						  enum gpiod_flags flags);

#define __gpiod_get_optional(dev, con_id, flags, ...)			\

	__gpiod_get_optional(dev, con_id, flags)

#define gpiod_get_optional(varargs...) __gpiod_get_optional(varargs, 0)

struct gpio_desc *__must_check __gpiod_get_index_optional(struct device *dev,

							const char *con_id,

							unsigned int index,

							enum gpiod_flags flags);

#define __gpiod_get_index_optional(dev, con_id, index, flags, ...)	\

	__gpiod_get_index_optional(dev, con_id, index, flags)

#define gpiod_get_index_optional(varargs...)				\

	__gpiod_get_index_optional(varargs, 0)



void gpiod_put(struct gpio_desc *desc);



struct gpio_desc *__must_check __devm_gpiod_get(struct device *dev,

					      const char *con_id,

					      enum gpiod_flags flags);

#define __devm_gpiod_get(dev, con_id, flags, ...)			\

	__devm_gpiod_get(dev, con_id, flags)

#define devm_gpiod_get(varargs...) __devm_gpiod_get(varargs, 0)

struct gpio_desc *__must_check __devm_gpiod_get_index(struct device *dev,

						    const char *con_id,

						    unsigned int idx,

						    enum gpiod_flags flags);

#define __devm_gpiod_get_index(dev, con_id, index, flags, ...)		\

	__devm_gpiod_get_index(dev, con_id, index, flags)

#define devm_gpiod_get_index(varargs...) __devm_gpiod_get_index(varargs, 0)

struct gpio_desc *__must_check __devm_gpiod_get_optional(struct device *dev,

						       const char *con_id,

						       enum gpiod_flags flags);

#define __devm_gpiod_get_optional(dev, con_id, flags, ...)		\

	__devm_gpiod_get_optional(dev, con_id, flags)

#define devm_gpiod_get_optional(varargs...)				\

	__devm_gpiod_get_optional(varargs, 0)

struct gpio_desc *__must_check

__devm_gpiod_get_index_optional(struct device *dev, const char *con_id,

			      unsigned int index, enum gpiod_flags flags);

#define __devm_gpiod_get_index_optional(dev, con_id, index, flags, ...)	\

	__devm_gpiod_get_index_optional(dev, con_id, index, flags)

#define devm_gpiod_get_index_optional(varargs...)			\

	__devm_gpiod_get_index_optional(varargs, 0)



void devm_gpiod_put(struct device *dev, struct gpio_desc *desc);



int gpiod_get_direction(const struct gpio_desc *desc);
@@ -124,27 +96,31 @@ int desc_to_gpio(const struct gpio_desc *desc); 


#else /* CONFIG_GPIOLIB */



static inline struct gpio_desc *__must_check gpiod_get(struct device *dev,

						       const char *con_id)

static inline struct gpio_desc *__must_check __gpiod_get(struct device *dev,

						const char *con_id,

						enum gpiod_flags flags)

{

	return ERR_PTR(-ENOSYS);

}

static inline struct gpio_desc *__must_check gpiod_get_index(struct device *dev,

static inline struct gpio_desc *__must_check

__gpiod_get_index(struct device *dev,

		  const char *con_id,

							     unsigned int idx)

		  unsigned int idx,

		  enum gpiod_flags flags)

{

	return ERR_PTR(-ENOSYS);

}



static inline struct gpio_desc *__must_check

gpiod_get_optional(struct device *dev, const char *con_id)

__gpiod_get_optional(struct device *dev, const char *con_id,

		     enum gpiod_flags flags)

{

	return ERR_PTR(-ENOSYS);

}



static inline struct gpio_desc *__must_check

gpiod_get_index_optional(struct device *dev, const char *con_id,

			 unsigned int index)

__gpiod_get_index_optional(struct device *dev, const char *con_id,

			   unsigned int index, enum gpiod_flags flags)

{

	return ERR_PTR(-ENOSYS);

}
@@ -157,28 +133,33 @@ static inline void gpiod_put(struct gpio_desc *desc) 
	WARN_ON(1);

}



static inline struct gpio_desc *__must_check devm_gpiod_get(struct device *dev,

							    const char *con_id)

static inline struct gpio_desc *__must_check

__devm_gpiod_get(struct device *dev,

		 const char *con_id,

		 enum gpiod_flags flags)

{

	return ERR_PTR(-ENOSYS);

}

static inline

struct gpio_desc *__must_check devm_gpiod_get_index(struct device *dev,

struct gpio_desc *__must_check

__devm_gpiod_get_index(struct device *dev,

		       const char *con_id,

						    unsigned int idx)

		       unsigned int idx,

		       enum gpiod_flags flags)

{

	return ERR_PTR(-ENOSYS);

}



static inline struct gpio_desc *__must_check

devm_gpiod_get_optional(struct device *dev, const char *con_id)

__devm_gpiod_get_optional(struct device *dev, const char *con_id,

			  enum gpiod_flags flags)

{

	return ERR_PTR(-ENOSYS);

}



static inline struct gpio_desc *__must_check

devm_gpiod_get_index_optional(struct device *dev, const char *con_id,

			      unsigned int index)

__devm_gpiod_get_index_optional(struct device *dev, const char *con_id,

				unsigned int index, enum gpiod_flags flags)

{

	return ERR_PTR(-ENOSYS);

}
@@ -303,9 +284,43 @@ static inline int desc_to_gpio(const struct gpio_desc *desc) 
	return -EINVAL;

}





#endif /* CONFIG_GPIOLIB */



/*

 * Vararg-hacks! This is done to transition the kernel to always pass

 * the options flags argument to the below functions. During a transition

 * phase these vararg macros make both old-and-newstyle code compile,

 * but when all calls to the elder API are removed, these should go away

 * and the __gpiod_get() etc functions above be renamed just gpiod_get()

 * etc.

 */

#define __gpiod_get(dev, con_id, flags, ...) __gpiod_get(dev, con_id, flags)

#define gpiod_get(varargs...) __gpiod_get(varargs, 0)

#define __gpiod_get_index(dev, con_id, index, flags, ...)		\

	__gpiod_get_index(dev, con_id, index, flags)

#define gpiod_get_index(varargs...) __gpiod_get_index(varargs, 0)

#define __gpiod_get_optional(dev, con_id, flags, ...)			\

	__gpiod_get_optional(dev, con_id, flags)

#define gpiod_get_optional(varargs...) __gpiod_get_optional(varargs, 0)

#define __gpiod_get_index_optional(dev, con_id, index, flags, ...)	\

	__gpiod_get_index_optional(dev, con_id, index, flags)

#define gpiod_get_index_optional(varargs...)				\

	__gpiod_get_index_optional(varargs, 0)

#define __devm_gpiod_get(dev, con_id, flags, ...)			\

	__devm_gpiod_get(dev, con_id, flags)

#define devm_gpiod_get(varargs...) __devm_gpiod_get(varargs, 0)

#define __devm_gpiod_get_index(dev, con_id, index, flags, ...)		\

	__devm_gpiod_get_index(dev, con_id, index, flags)

#define devm_gpiod_get_index(varargs...) __devm_gpiod_get_index(varargs, 0)

#define __devm_gpiod_get_optional(dev, con_id, flags, ...)		\

	__devm_gpiod_get_optional(dev, con_id, flags)

#define devm_gpiod_get_optional(varargs...)				\

	__devm_gpiod_get_optional(varargs, 0)

#define __devm_gpiod_get_index_optional(dev, con_id, index, flags, ...)	\

	__devm_gpiod_get_index_optional(dev, con_id, index, flags)

#define devm_gpiod_get_index_optional(varargs...)			\

	__devm_gpiod_get_index_optional(varargs, 0)



#if IS_ENABLED(CONFIG_GPIOLIB) && IS_ENABLED(CONFIG_GPIO_SYSFS)



int gpiod_export(struct gpio_desc *desc, bool direction_may_change);

CRA Git | Maintained and supported by SUSTech CRA and CCSE