Beyond Linux® From Scratch (System V Edition) - Version r12.1-1159

Chapter 9. General Libraries

Protobuf-27.2

Introduction to Protobuf

The Protobuf package contains utilities and libraries for using data in Google's data interchange format.

[Note]

Note

Development versions of BLFS may not build or run some packages properly if LFS or dependencies have been updated since the most recent stable versions of the books.

Package Information

Protobuf Dependencies

Required

Abseil-cpp-20240116.2 and CMake-3.29.5

Optional

gtest (for tests)

Installation of Protobuf

Install Protobuf by running the following commands: 

mkdir build &&
cd    build &&

cmake -DCMAKE_INSTALL_PREFIX=/usr      \
      -DCMAKE_BUILD_TYPE=Release       \
      -DCMAKE_SKIP_INSTALL_RPATH=ON    \
      -Dprotobuf_BUILD_TESTS=OFF       \
      -Dprotobuf_ABSL_PROVIDER=package \
      -Dprotobuf_BUILD_LIBUPB=OFF      \
      -Dprotobuf_BUILD_SHARED_LIBS=ON  \
      -Dutf8_range_ENABLE_INSTALL=OFF  \
      -G Ninja ..                      &&
ninja

This package does come with a test suite, but it requires gtest, which is not part of BLFS.

Now, as the root user: 

sed 's/utf8_range//' -i *.pc &&
ninja install

Command Explanations

-DCMAKE_SKIP_INSTALL_RPATH=ON: This switch makes cmake remove hardcoded library search paths (rpath) when installing a binary executable file or a shared library. This package does not need rpath once it's installed into the standard location, and rpath may sometimes cause unwanted effects or even security issues.

sed 's/utf8_range//' -i *.pc: This command removes a leftover reference to libutf8_range from the pkg-config files installed by this package.

-Dprotobuf_BUILD_TESTS=OFF: This parameter prevents the tests from being built because gtest is not part of BLFS.

-Dprotobuf_ABSL_PROVIDER=package: This parameter allows the build system to use the system-installed copy of Abseil-cpp-20240116.2.

-Dprotobuf_BUILD_SHARED_LIBS=ON: This parameter enables building shared versions of the libraries provided by this package instead of static versions.

-Dutf8_range_ENABLE_INSTALL=OFF: This parameter disables installing the utf8_range static library. The functions provided by this library and used by protobuf is already embedded into libprotobuf.so, so installing a full copy of the static library is just wasting the disk space.

Contents

Installed Programs: protoc-26.1.0 and protoc (a symlink to protoc-26.1.0)
Installed Libraries: libprotobuf.so, libprotobuf-lite.so, and libprotoc.so
Installed Directories: /usr/include/google, /usr/include/java, /usr/include/upb_generator, and /usr/lib/cmake/protobuf

Short Descriptions

protoc

parses protocol buffer files and generates output for several programming languages and formats

libprotobuf.so

contains functions for utilizing data in Google's data interchange format

libprotobuf-lite.so

contains a simpler version of the functions for utilizing data in Google's data interchange format

libprotoc.so

contains functions used by protoc at runtime for outputting data for several programming languages and formats