xref: /linux/Documentation/userspace-api/gpio/gpio-get-lineinfo-unwatch-ioctl.rst (revision 7255fcc80d4b525cc10cfaaf7f485830d4ed2000)
1.. SPDX-License-Identifier: GPL-2.0
2
3.. _GPIO_GET_LINEINFO_UNWATCH_IOCTL:
4
5*******************************
6GPIO_GET_LINEINFO_UNWATCH_IOCTL
7*******************************
8
9Name
10====
11
12GPIO_GET_LINEINFO_UNWATCH_IOCTL - Disable watching a line for changes to its
13requested state and configuration information.
14
15Synopsis
16========
17
18.. c:macro:: GPIO_GET_LINEINFO_UNWATCH_IOCTL
19
20``int ioctl(int chip_fd, GPIO_GET_LINEINFO_UNWATCH_IOCTL, u32 *offset)``
21
22Arguments
23=========
24
25``chip_fd``
26    The file descriptor of the GPIO character device returned by `open()`.
27
28``offset``
29    The offset of the line to no longer watch.
30
31Description
32===========
33
34Remove the line from the list of lines being watched on this ``chip_fd``.
35
36This is the reverse of gpio-v2-get-lineinfo-watch-ioctl.rst (v2) and
37gpio-get-lineinfo-watch-ioctl.rst (v1).
38
39Unwatching a line that is not watched is an error (**EBUSY**).
40
41First added in 5.7.
42
43Return Value
44============
45
46On success 0.
47
48On error -1 and the ``errno`` variable is set appropriately.
49Common error codes are described in error-codes.rst.
50