* [PATCH v1 1/1] gpio: Remove unused and obsoleted gpio_export_link()
@ 2023-01-02 21:08 Andy Shevchenko
2023-01-03 23:39 ` Linus Walleij
` (2 more replies)
0 siblings, 3 replies; 4+ messages in thread
From: Andy Shevchenko @ 2023-01-02 21:08 UTC (permalink / raw)
To: Andy Shevchenko, Christophe Leroy, linux-gpio, linux-doc,
linux-kernel, linux-doc-tw-discuss, linux-arch
Cc: Linus Walleij, Bartosz Golaszewski, Jonathan Corbet, Alex Shi,
Yanteng Si, Hu Haowen, Arnd Bergmann
gpio_export_link() is legacy and unused API, remove it for good.
Signed-off-by: Andy Shevchenko <andriy.shevchenko@linux.intel.com>
---
Documentation/driver-api/gpio/legacy.rst | 9 ---------
.../translations/zh_CN/driver-api/gpio/legacy.rst | 8 --------
Documentation/translations/zh_TW/gpio.txt | 9 ---------
include/asm-generic/gpio.h | 6 ------
include/linux/gpio.h | 8 --------
5 files changed, 40 deletions(-)
diff --git a/Documentation/driver-api/gpio/legacy.rst b/Documentation/driver-api/gpio/legacy.rst
index e17910cc3271..e3e9d26a60ce 100644
--- a/Documentation/driver-api/gpio/legacy.rst
+++ b/Documentation/driver-api/gpio/legacy.rst
@@ -735,10 +735,6 @@ requested using gpio_request()::
/* reverse gpio_export() */
void gpio_unexport();
- /* create a sysfs link to an exported GPIO node */
- int gpio_export_link(struct device *dev, const char *name,
- unsigned gpio)
-
After a kernel driver requests a GPIO, it may only be made available in
the sysfs interface by gpio_export(). The driver can control whether the
signal direction may change. This helps drivers prevent userspace code
@@ -748,11 +744,6 @@ This explicit exporting can help with debugging (by making some kinds
of experiments easier), or can provide an always-there interface that's
suitable for documenting as part of a board support package.
-After the GPIO has been exported, gpio_export_link() allows creating
-symlinks from elsewhere in sysfs to the GPIO sysfs node. Drivers can
-use this to provide the interface under their own device in sysfs with
-a descriptive name.
-
API Reference
=============
diff --git a/Documentation/translations/zh_CN/driver-api/gpio/legacy.rst b/Documentation/translations/zh_CN/driver-api/gpio/legacy.rst
index 6399521d0548..8599e253fcc5 100644
--- a/Documentation/translations/zh_CN/driver-api/gpio/legacy.rst
+++ b/Documentation/translations/zh_CN/driver-api/gpio/legacy.rst
@@ -672,10 +672,6 @@ GPIO 控制器的路径类似 /sys/class/gpio/gpiochip42/ (对于从#42 GPIO
/* gpio_export()的逆操作 */
void gpio_unexport();
- /* 创建一个 sysfs 连接到已导出的 GPIO 节点 */
- int gpio_export_link(struct device *dev, const char *name,
- unsigned gpio)
-
在一个内核驱动申请一个 GPIO 之后,它可以通过 gpio_export()使其在 sysfs
接口中可见。该驱动可以控制信号方向是否可修改。这有助于防止用户空间代码无意间
破坏重要的系统状态。
@@ -683,10 +679,6 @@ GPIO 控制器的路径类似 /sys/class/gpio/gpiochip42/ (对于从#42 GPIO
这个明确的导出有助于(通过使某些实验更容易来)调试,也可以提供一个始终存在的接口,
与文档配合作为板级支持包的一部分。
-在 GPIO 被导出之后,gpio_export_link()允许在 sysfs 文件系统的任何地方
-创建一个到这个 GPIO sysfs 节点的符号链接。这样驱动就可以通过一个描述性的
-名字,在 sysfs 中他们所拥有的设备下提供一个(到这个 GPIO sysfs 节点的)接口。
-
API参考
=======
diff --git a/Documentation/translations/zh_TW/gpio.txt b/Documentation/translations/zh_TW/gpio.txt
index e3c076dd75a5..abd8e4c0973e 100644
--- a/Documentation/translations/zh_TW/gpio.txt
+++ b/Documentation/translations/zh_TW/gpio.txt
@@ -634,18 +634,9 @@ GPIO 控制器的路徑類似 /sys/class/gpio/gpiochip42/ (對於從#42 GPIO
/* gpio_export()的逆操作 */
void gpio_unexport();
- /* 創建一個 sysfs 連接到已導出的 GPIO 節點 */
- int gpio_export_link(struct device *dev, const char *name,
- unsigned gpio)
-
在一個內核驅動申請一個 GPIO 之後,它可以通過 gpio_export()使其在 sysfs
接口中可見。該驅動可以控制信號方向是否可修改。這有助於防止用戶空間代碼無意間
破壞重要的系統狀態。
這個明確的導出有助於(通過使某些實驗更容易來)調試,也可以提供一個始終存在的接口,
與文檔配合作爲板級支持包的一部分。
-
-在 GPIO 被導出之後,gpio_export_link()允許在 sysfs 文件系統的任何地方
-創建一個到這個 GPIO sysfs 節點的符號連結。這樣驅動就可以通過一個描述性的
-名字,在 sysfs 中他們所擁有的設備下提供一個(到這個 GPIO sysfs 節點的)接口。
-
diff --git a/include/asm-generic/gpio.h b/include/asm-generic/gpio.h
index a7752cf152ce..f79220f614aa 100644
--- a/include/asm-generic/gpio.h
+++ b/include/asm-generic/gpio.h
@@ -103,12 +103,6 @@ static inline int gpio_export(unsigned gpio, bool direction_may_change)
return gpiod_export(gpio_to_desc(gpio), direction_may_change);
}
-static inline int gpio_export_link(struct device *dev, const char *name,
- unsigned gpio)
-{
- return gpiod_export_link(dev, name, gpio_to_desc(gpio));
-}
-
static inline void gpio_unexport(unsigned gpio)
{
gpiod_unexport(gpio_to_desc(gpio));
diff --git a/include/linux/gpio.h b/include/linux/gpio.h
index 346f60bbab30..e94815b3ce1d 100644
--- a/include/linux/gpio.h
+++ b/include/linux/gpio.h
@@ -197,14 +197,6 @@ static inline int gpio_export(unsigned gpio, bool direction_may_change)
return -EINVAL;
}
-static inline int gpio_export_link(struct device *dev, const char *name,
- unsigned gpio)
-{
- /* GPIO can never have been exported */
- WARN_ON(1);
- return -EINVAL;
-}
-
static inline void gpio_unexport(unsigned gpio)
{
/* GPIO can never have been exported */
--
2.35.1
^ permalink raw reply related [flat|nested] 4+ messages in thread
* Re: [PATCH v1 1/1] gpio: Remove unused and obsoleted gpio_export_link()
2023-01-02 21:08 [PATCH v1 1/1] gpio: Remove unused and obsoleted gpio_export_link() Andy Shevchenko
@ 2023-01-03 23:39 ` Linus Walleij
2023-01-04 8:49 ` Bartosz Golaszewski
2023-01-04 9:08 ` Jani Nikula
2 siblings, 0 replies; 4+ messages in thread
From: Linus Walleij @ 2023-01-03 23:39 UTC (permalink / raw)
To: Andy Shevchenko
Cc: Christophe Leroy, linux-gpio, linux-doc, linux-kernel,
linux-doc-tw-discuss, linux-arch, Bartosz Golaszewski,
Jonathan Corbet, Alex Shi, Yanteng Si, Hu Haowen, Arnd Bergmann
On Mon, Jan 2, 2023 at 10:08 PM Andy Shevchenko
<andriy.shevchenko@linux.intel.com> wrote:
> gpio_export_link() is legacy and unused API, remove it for good.
>
> Signed-off-by: Andy Shevchenko <andriy.shevchenko@linux.intel.com>
Good riddance.
Reviewed-by: Linus Walleij <linus.walleij@linaro.org>
Yours,
Linus Walleij
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [PATCH v1 1/1] gpio: Remove unused and obsoleted gpio_export_link()
2023-01-02 21:08 [PATCH v1 1/1] gpio: Remove unused and obsoleted gpio_export_link() Andy Shevchenko
2023-01-03 23:39 ` Linus Walleij
@ 2023-01-04 8:49 ` Bartosz Golaszewski
2023-01-04 9:08 ` Jani Nikula
2 siblings, 0 replies; 4+ messages in thread
From: Bartosz Golaszewski @ 2023-01-04 8:49 UTC (permalink / raw)
To: Andy Shevchenko
Cc: Christophe Leroy, linux-gpio, linux-doc, linux-kernel,
linux-doc-tw-discuss, linux-arch, Linus Walleij, Jonathan Corbet,
Alex Shi, Yanteng Si, Hu Haowen, Arnd Bergmann
On Mon, Jan 2, 2023 at 10:08 PM Andy Shevchenko
<andriy.shevchenko@linux.intel.com> wrote:
>
> gpio_export_link() is legacy and unused API, remove it for good.
>
> Signed-off-by: Andy Shevchenko <andriy.shevchenko@linux.intel.com>
> ---
Applied, thanks!
Bart
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [PATCH v1 1/1] gpio: Remove unused and obsoleted gpio_export_link()
2023-01-02 21:08 [PATCH v1 1/1] gpio: Remove unused and obsoleted gpio_export_link() Andy Shevchenko
2023-01-03 23:39 ` Linus Walleij
2023-01-04 8:49 ` Bartosz Golaszewski
@ 2023-01-04 9:08 ` Jani Nikula
2 siblings, 0 replies; 4+ messages in thread
From: Jani Nikula @ 2023-01-04 9:08 UTC (permalink / raw)
To: Andy Shevchenko, Andy Shevchenko, Christophe Leroy, linux-gpio,
linux-doc, linux-kernel, linux-doc-tw-discuss, linux-arch
Cc: Linus Walleij, Bartosz Golaszewski, Jonathan Corbet, Alex Shi,
Yanteng Si, Hu Haowen, Arnd Bergmann
On Mon, 02 Jan 2023, Andy Shevchenko <andriy.shevchenko@linux.intel.com> wrote:
> gpio_export_link() is legacy and unused API, remove it for good.
This seemed vaguely familiar, and true enough, adding that was my 5th
ever commit to the kernel. :)
BR,
Jani.
--
Jani Nikula, Intel Open Source Graphics Center
^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2023-01-04 9:09 UTC | newest]
Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2023-01-02 21:08 [PATCH v1 1/1] gpio: Remove unused and obsoleted gpio_export_link() Andy Shevchenko
2023-01-03 23:39 ` Linus Walleij
2023-01-04 8:49 ` Bartosz Golaszewski
2023-01-04 9:08 ` Jani Nikula
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).