gpionotify - Man Page

manual page for gpionotify v2.1.1


gpionotify [Options] <line>...


Wait for changes to info on GPIO lines and print them to standard output.

Lines are specified by name, or optionally by offset if the chip option is provided.



display a banner on successful startup


treat lines as names even if they would parse as an offset

-c,  --chip <chip>

restrict scope to a particular chip

-e,  --event <event>

specify the events to monitor Possible values: 'requested', 'released', 'reconfigured'. (default is all events)

-h,  --help

display this help and exit

-F,  --format <fmt>

specify a custom output format

--idle-timeout <period>

exit gracefully if no events occur for the period specified


convert event timestamps to local time

-n,  --num-events <num>

exit after processing num events

-q,  --quiet

don't generate any output

-s,  --strict

abort if requested line names are not unique


don't quote line or consumer names


convert event timestamps to UTC

-v,  --version

output version information and exit


A GPIO chip may be identified by number, name, or path. e.g. '0', 'gpiochip0', and '/dev/gpiochip0' all refer to the same chip.


Periods are taken as milliseconds unless units are specified. e.g. 10us. Supported units are 's', 'ms', and 'us'.

Format specifiers


GPIO line offset


GPIO line name


GPIO chip name


numeric info event type ('1' - requested, '2' - released or '3' - reconfigured)


info event type ('requested', 'released' or 'reconfigured')


line attributes




event timestamp as seconds


event timestamp as UTC


event timestamp as local time


Bartosz Golaszewski <>

Reporting Bugs

Report bugs to:
   Bartosz Golaszewski <>
   linux-gpio <>


March 2024 libgpiod v2.1.1