gpioget(1)

gpioget1

Libgpiod command-line utility

Usage

gpioget [OPTIONS] <line> ...

Overview

Read values of GPIO lines.

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

Options

-a, --as-is

leave the line direction unchanged, not forced to input

-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 'gpioget')

-h, --help

display this help and exit

-l, --active-low

treat the line as active low

-p, --hold-period <period>

wait between requesting the lines and reading the values

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

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

Releases

4 releases since Debian 11 (Bullseye); the text changed 3 times.

  1. 11
  2. 12
  3. 13
  4. Arch

--active-low since Debian 13 (Trixie); --as-is since Debian 13 (Trixie); --bias since Debian 13 (Trixie); --by-name since Debian 13 (Trixie); --chip since Debian 13 (Trixie); --help since Debian 13 (Trixie); --hold-period since Debian 13 (Trixie); --numeric since Debian 13 (Trixie); --strict since Debian 13 (Trixie); --unquoted since Debian 13 (Trixie); --version since Debian 13 (Trixie); -a since Debian 13 (Trixie); -b since Debian 13 (Trixie); -c since Debian 13 (Trixie); -h since Debian 13 (Trixie); -l since Debian 13 (Trixie); -p since Debian 13 (Trixie); -s since Debian 13 (Trixie); -v since Debian 13 (Trixie).

Author

Bartosz Golaszewski <[email protected]>

Reporting bugs

Report bugs to:
Bartosz Golaszewski <[email protected]>
linux-gpio <[email protected]>

From libgpiod 2.3.1-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.