OS Manuals

/usr/bin/gpionotify

C library and command-line tools for controlling GPIO lines via the Linux GPIO character device uAPI

From libgpiod 2.3.2-r0 (enterprise-packages), captured 2026-11-08 by running gpionotify --help (exit 0). permalink

Usage: /usr/bin/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.

Options:
      --banner		display a banner on successful startup
      --by-name		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
      --localtime	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
      --unquoted	don't quote line or consumer names
      --utc		convert event timestamps to UTC
  -v, --version		output version information and exit

Chips:
    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:
    Periods are taken as milliseconds unless units are specified. e.g. 10us.
    Supported units are 'm', 's', 'ms', and 'us' for minutes, seconds, milliseconds and
    microseconds respectively.

Format specifiers:
  %o   GPIO line offset
  %l   GPIO line name
  %c   GPIO chip name
  %e   numeric info event type ('1' - requested, '2' - released or '3' - reconfigured)
  %E   info event type ('requested', 'released' or 'reconfigured')
  %a   line attributes
  %C   consumer
  %S   event timestamp as seconds
  %U   event timestamp as UTC
  %L   event timestamp as local time
Options (14)
OptionDescriptionSource
--bannerdisplay a banner on successful startuphelp + man
--by-nametreat lines as names even if they would parse as an offsethelp + man
-c, --chip chiprestrict scope to a particular chiphelp + man
-e, --event eventspecify the events to monitor Possible values: 'requested', 'released', 'reconfigured'.help + man
-h, --helpdisplay this help and exithelp + man
-F, --format fmtspecify a custom output formathelp + man
--idle-timeout periodexit gracefully if no events occur for the period specifiedhelp + man
--localtimeconvert event timestamps to local timehelp + man
-n, --num-events numexit after processing num eventshelp + man
-q, --quietdon't generate any outputhelp + man
-s, --strictabort if requested line names are not uniquehelp + man
--unquoteddon't quote line or consumer nameshelp + man
--utcconvert event timestamps to UTChelp + man
-v, --versionoutput version information and exithelp + man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.