xref: /linux/Documentation/userspace-api/gpio/gpio-handle-set-line-values-ioctl.rst (revision 16b2bb7fe5e4a0757608e844902fdf05617f51f8)
1*16b2bb7fSKent Gibson.. SPDX-License-Identifier: GPL-2.0
2*16b2bb7fSKent Gibson
3*16b2bb7fSKent Gibson.. _GPIO_HANDLE_SET_LINE_VALUES_IOCTL:
4*16b2bb7fSKent Gibson
5*16b2bb7fSKent Gibson*********************************
6*16b2bb7fSKent GibsonGPIO_HANDLE_SET_LINE_VALUES_IOCTL
7*16b2bb7fSKent Gibson*********************************
8*16b2bb7fSKent Gibson.. warning::
9*16b2bb7fSKent Gibson    This ioctl is part of chardev_v1.rst and is obsoleted by
10*16b2bb7fSKent Gibson    gpio-v2-line-set-values-ioctl.rst.
11*16b2bb7fSKent Gibson
12*16b2bb7fSKent GibsonName
13*16b2bb7fSKent Gibson====
14*16b2bb7fSKent Gibson
15*16b2bb7fSKent GibsonGPIO_HANDLE_SET_LINE_VALUES_IOCTL - Set the values of all requested output lines.
16*16b2bb7fSKent Gibson
17*16b2bb7fSKent GibsonSynopsis
18*16b2bb7fSKent Gibson========
19*16b2bb7fSKent Gibson
20*16b2bb7fSKent Gibson.. c:macro:: GPIO_HANDLE_SET_LINE_VALUES_IOCTL
21*16b2bb7fSKent Gibson
22*16b2bb7fSKent Gibson``int ioctl(int handle_fd, GPIO_HANDLE_SET_LINE_VALUES_IOCTL, struct gpiohandle_data *values)``
23*16b2bb7fSKent Gibson
24*16b2bb7fSKent GibsonArguments
25*16b2bb7fSKent Gibson=========
26*16b2bb7fSKent Gibson
27*16b2bb7fSKent Gibson``handle_fd``
28*16b2bb7fSKent Gibson    The file descriptor of the GPIO character device, as returned in the
29*16b2bb7fSKent Gibson    :c:type:`request.fd<gpiohandle_request>` by gpio-get-linehandle-ioctl.rst.
30*16b2bb7fSKent Gibson
31*16b2bb7fSKent Gibson``values``
32*16b2bb7fSKent Gibson    The :c:type:`line_values<gpiohandle_data>` to set.
33*16b2bb7fSKent Gibson
34*16b2bb7fSKent GibsonDescription
35*16b2bb7fSKent Gibson===========
36*16b2bb7fSKent Gibson
37*16b2bb7fSKent GibsonSet the values of all requested output lines.
38*16b2bb7fSKent Gibson
39*16b2bb7fSKent GibsonOnly the values of output lines may be set.
40*16b2bb7fSKent GibsonAttempting to set the value of input lines is an error (**EPERM**).
41*16b2bb7fSKent Gibson
42*16b2bb7fSKent GibsonReturn Value
43*16b2bb7fSKent Gibson============
44*16b2bb7fSKent Gibson
45*16b2bb7fSKent GibsonOn success 0.
46*16b2bb7fSKent Gibson
47*16b2bb7fSKent GibsonOn error -1 and the ``errno`` variable is set appropriately.
48*16b2bb7fSKent GibsonCommon error codes are described in error-codes.rst.
49