History

gpio: uapi: clarify using v2 rather than v1

The documentation contains notes like This struct is part of ABI v1 and is deprecated. Use struct gpio_v2_line_info instead. This could be interpreted to mean the structs can be directly substituted in v1 calls. Clarify that the user should use the corresponding v2 ioctl() and structs.

Kent Gibson committed 2 years ago

Commit b6747ef1 parent ead7c581 file · +7 −7Browse files

Showing the changes to include/uapi/linux/gpio.h (1 of 1 file). Show all

Unified · Split

include/uapi/linux/gpio.h+7−7
@@ -333,7 +333,7 @@ struct gpio_v2_line_event { · 332 unmodified lines
333 * also be empty if the consumer doesn't set this up333 * also be empty if the consumer doesn't set this up
334 *334 *
335 * Note: This struct is part of ABI v1 and is deprecated.335 * Note: This struct is part of ABI v1 and is deprecated.
336 * Use &struct gpio_v2_line_info instead.336 * Use ABI v2 and &struct gpio_v2_line_info instead.
337 */337 */
338struct gpioline_info {338struct gpioline_info {
339 __u32 line_offset;339 __u32 line_offset;
@@ -368,7 +368,7 @@ enum { · 28 unmodified lines
368 * at the end of the structure on 64-bit architectures.368 * at the end of the structure on 64-bit architectures.
369 *369 *
370 * Note: This struct is part of ABI v1 and is deprecated.370 * Note: This struct is part of ABI v1 and is deprecated.
371 * Use &struct gpio_v2_line_info_changed instead.371 * Use ABI v2 and &struct gpio_v2_line_info_changed instead.
372 */372 */
373struct gpioline_info_changed {373struct gpioline_info_changed {
374 struct gpioline_info info;374 struct gpioline_info info;
@@ -409,7 +409,7 @@ struct gpioline_info_changed { · 34 unmodified lines
409 * a valid anonymous file descriptor representing the request409 * a valid anonymous file descriptor representing the request
410 *410 *
411 * Note: This struct is part of ABI v1 and is deprecated.411 * Note: This struct is part of ABI v1 and is deprecated.
412 * Use &struct gpio_v2_line_request instead.412 * Use ABI v2 and &struct gpio_v2_line_request instead.
413 */413 */
414struct gpiohandle_request {414struct gpiohandle_request {
415 __u32 lineoffsets[GPIOHANDLES_MAX];415 __u32 lineoffsets[GPIOHANDLES_MAX];
@@ -431,7 +431,7 @@ struct gpiohandle_request { · 15 unmodified lines
431 * @padding: reserved for future use and should be zero filled431 * @padding: reserved for future use and should be zero filled
432 *432 *
433 * Note: This struct is part of ABI v1 and is deprecated.433 * Note: This struct is part of ABI v1 and is deprecated.
434 * Use &struct gpio_v2_line_config instead.434 * Use ABI v2 and &struct gpio_v2_line_config instead.
435 */435 */
436struct gpiohandle_config {436struct gpiohandle_config {
437 __u32 flags;437 __u32 flags;
@@ -446,7 +446,7 @@ struct gpiohandle_config { · 8 unmodified lines
446 * the desired target state446 * the desired target state
447 *447 *
448 * Note: This struct is part of ABI v1 and is deprecated.448 * Note: This struct is part of ABI v1 and is deprecated.
449 * Use &struct gpio_v2_line_values instead.449 * Use ABI v2 and &struct gpio_v2_line_values instead.
450 */450 */
451struct gpiohandle_data {451struct gpiohandle_data {
452 __u8 values[GPIOHANDLES_MAX];452 __u8 values[GPIOHANDLES_MAX];
@@ -471,7 +471,7 @@ struct gpiohandle_data { · 18 unmodified lines
471 * valid anonymous file descriptor representing the request471 * valid anonymous file descriptor representing the request
472 *472 *
473 * Note: This struct is part of ABI v1 and is deprecated.473 * Note: This struct is part of ABI v1 and is deprecated.
474 * Use &struct gpio_v2_line_request instead.474 * Use ABI v2 and &struct gpio_v2_line_request instead.
475 */475 */
476struct gpioevent_request {476struct gpioevent_request {
477 __u32 lineoffset;477 __u32 lineoffset;
@@ -494,7 +494,7 @@ struct gpioevent_request { · 16 unmodified lines
494 * %GPIOEVENT_EVENT_FALLING_EDGE494 * %GPIOEVENT_EVENT_FALLING_EDGE
495 *495 *
496 * Note: This struct is part of ABI v1 and is deprecated.496 * Note: This struct is part of ABI v1 and is deprecated.
497 * Use &struct gpio_v2_line_event instead.497 * Use ABI v2 and &struct gpio_v2_line_event instead.
498 */498 */
499struct gpioevent_data {499struct gpioevent_data {
500 __u64 timestamp;500 __u64 timestamp;

Keyboard shortcuts

General

Show keyboard shortcuts
?
Focus the current search
/

Issues and pull requests

Open filters
f

Issues, pull requests and Inbox

Select next item
j↓
Select previous item
k↑
Open selected item
Enter
Dismiss filters or clear selection
Esc

Repository code

Go to file
t