gpionotify - Man Page

manual page for gpionotify v2.0.2


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


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.

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 <>


August 2023 libgpiod v2.0.2