OS Manuals

/usr/bin/gpioget

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

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

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.
Options (12)
OptionDescriptionSource
-a, --as-isleave the line direction unchanged, not forced to inputhelp + 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 'gpioget')help + man
-h, --helpdisplay this help and exithelp + man
-l, --active-lowtreat the line as active lowhelp + man
-p, --hold-period periodwait between requesting the lines and reading the valueshelp + man
--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 nameshelp + 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.