lib/libgpiod
1
0
Fork 0
mirror of https://git.kernel.org/pub/scm/libs/libgpiod/libgpiod.git synced 2026-10-24 00:48:53 +03:00
Code Activity
Files
python-v2.4.0
libgpiod/docs/building.rst
Bartosz Golaszewski 2cd1efbc57 doc: clarify the differences between building from git and tarballs 
Several users reported having trouble understanding the "building"
section of the docs and being confused on whether they should use
autogen.sh or configure. Clarify these bits in the docs.

Link: https://lore.kernel.org/r/20250311140147.66484-1-brgl@bgdev.pl
Signed-off-by: Bartosz Golaszewski <bartosz.golaszewski@linaro.org>
2025-03-13 09:21:47 +01:00

2.6 KiB
Raw Permalink Blame History

Downloading, building & installing

Downloading

Libgpiod is packaged by several linux distributions. You should typically be able to install it using your package manager. If you want to build libgpiod from sources, the upstream git repository for libgpiod is hosted at kernel.org. together with release tarballs.

Building

The core C library does not have any external dependencies other than the standard C library with GNU extensions.

The project is built using GNU autotools. In the general case, the steps needed to download a source tarball, unpack it, build the library together with the command-line tools and install the resulting binaries are as follows:

wget https://mirrors.edge.kernel.org/pub/software/libs/libgpiod/libgpiod-x.y.z.tar.xz
tar -xvf ./libgpiod-x.y.z.tar.xz
cd ./libgpiod-x.y.z/
./configure --enable-tools
make
sudo make install

The build system requires the following packages to be installed on the host system for the basic build:

  • autotools
  • autoconf-archive
  • libtool
  • pkg-config

Note

Development files for additional libraries may be required depending on selected options. The configure script will report any missing additional required dependencies.

Note

The command-line tools optionally depend on libedit for the interactive feature.

The project can also be built directly from the git repository. However in this case the configure script does not exist and must be created first - either by calling autoreconf:

autoreconf -ifv
./configure --enable-tools
make

Or by executing the provided autogen.sh script directly from the git tree:

./autogen.sh --enable-tools
make

Note

The autogen script will execute ./configure and pass all the command-line arguments to it.

For all configure features, see: ./configure --help.

Installing

To install the project run:

make install

Note

The above may require superuser privileges.

This will install libgpiod under the default system paths. If you want to install it under non-standard path, pass the --prefix=<install path> option to configure.

View Git Blame Copy Permalink