OS Manuals

/usr/bin/gpiomon

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 gpiomon --help (exit 0). permalink

Usage: /usr/bin/gpiomon [OPTIONS] <line>...

Wait for events 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
  -b, --bias <bias>	specify the line bias
			Possible values: 'pull-down', 'pull-up', 'disabled'.
			(default is to leave bias unchanged)
      --by-name		treat lines as names even if they would parse as an offset
  -c, --chip <chip>	restrict scope to a particular chip
  -C, --consumer <name>	consumer name applied to requested lines (default is 'gpiomon')
  -e, --edges <edges>	specify the edges to monitor
			Possible values: 'falling', 'rising', 'both'.
			(default is 'both')
  -E, --event-clock <clock>
			specify the source clock for event timestamps
			Possible values: 'monotonic', 'realtime', 'hte'.
			(default is 'monotonic')
			By default 'realtime' is formatted as UTC, others as raw u64.
  -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
  -l, --active-low	treat the line as active low, flipping the sense of
			rising and falling edges
      --localtime	format event timestamps as local time
  -n, --num-events <num>
			exit after processing num events
  -p, --debounce-period <period>
			debounce the line(s) with the specified period
  -q, --quiet		don't generate any output
  -I, --initial-state		print initial states of the lines
  -N, --numeric		display line values as '0' (inactive) or '1' (active)
  -s, --strict		abort if requested line names are not unique
      --unquoted	don't quote line or consumer names
      --utc		format event timestamps as UTC (default for 'realtime')
  -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 edge event type ('1' - rising or '2' - falling)
  %E   edge event type ('rising' or 'falling')
  %S   event timestamp as seconds
  %U   event timestamp as UTC
  %L   event timestamp as local time
Options (21)
OptionDescriptionSource
--bannerdisplay a banner on successful startuphelp + man
-b, --bias biasspecify the line bias Possible values: 'pull-down', 'pull-up', 'disabled'.help + man
--by-nametreat lines as names even if they would parse as an offsethelp + man
-c, --chip chiprestrict scope to a particular chiphelp + man
-C, --consumer nameconsumer name applied to requested lines (default is 'gpiomon')help + man
-e, --edges edgesspecify the edges to monitor Possible values: 'falling', 'rising', 'both'.help + man
-E, --event-clock clockspecify the source clock for event timestamps Possible values: 'monotonic', 'realtime', 'hte'.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
-l, --active-lowtreat the line as active low, flipping the sense of rising and falling edgeshelp + man
--localtimeformat event timestamps as local timehelp + man
-n, --num-events numexit after processing num eventshelp + man
-p, --debounce-period perioddebounce the line(s) with the specified periodhelp + man
-q, --quietdon't generate any outputhelp + man
-I, --initial-stateprint initial states of the lineshelp + man
-N, --numericdisplay line values as '0' (inactive) or '1' (active)help + man
-s, --strictabort if requested line names are not uniquehelp + man
--unquoteddon't quote line or consumer nameshelp + man
--utcformat event timestamps as UTC (default for 'realtime')help + 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.