Your company here — click to reach over 10,000 unique daily visitors

gpiomon - Man Page

manual page for gpiomon v2.1.2


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.



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)


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


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

-s,  --strict

abort if requested line names are not unique


don't quote line or consumer names


format event timestamps as UTC (default for 'realtime')

-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 edge event type ('1' - rising or '2' - falling)


edge event type ('rising' or 'falling')


event timestamp as seconds


event timestamp as UTC


event timestamp as local time


Bartosz Golaszewski <brgl@bgdev.pl>

Reporting Bugs

Report bugs to:
   Bartosz Golaszewski <brgl@bgdev.pl>
   linux-gpio <linux-gpio@vger.kernel.org>


June 2024 libgpiod v2.1.2