Documentation: gpio: Reconfiguration with unset direction (uAPI v2)
authorKent Gibson <warthog618@gmail.com>
Wed, 26 Jun 2024 05:29:25 +0000 (13:29 +0800)
committerBartosz Golaszewski <bartosz.golaszewski@linaro.org>
Mon, 1 Jul 2024 07:38:45 +0000 (09:38 +0200)
Update description of reconfiguration rules, adding requirement that a
direction flag be set to enable changing configuration for a line.

Signed-off-by: Kent Gibson <warthog618@gmail.com>
Link: https://lore.kernel.org/r/20240626052925.174272-5-warthog618@gmail.com
Signed-off-by: Bartosz Golaszewski <bartosz.golaszewski@linaro.org>
Documentation/userspace-api/gpio/gpio-v2-line-set-config-ioctl.rst

index 9b942a8a53ca9ab938eca9e072a1d873c19a617d..cfaab801556ca415439561c5ebe8ead76bf674b8 100644 (file)
@@ -35,11 +35,14 @@ Description
 Update the configuration of previously requested lines, without releasing the
 line or introducing potential glitches.
 
-The new configuration must specify the configuration of all requested lines.
+The new configuration must specify a configuration for all requested lines.
 
 The same :ref:`gpio-v2-get-line-config-rules` and
 :ref:`gpio-v2-get-line-config-support` that apply when requesting the lines
-also apply when updating the line configuration.
+also apply when updating the line configuration, with the additional
+restriction that a direction flag must be set to enable reconfiguration.
+If no direction flag is set in the configuration for a given line then the
+configuration for that line is left unchanged.
 
 The motivating use case for this command is changing direction of
 bi-directional lines between input and output, but it may also be used to