Compiling_source

Chapter 30: Compiling from Source

Overview

This chapter covers compiling software from source code, which is essential for custom builds, security, and understanding how software works.

---

29.1 Build Environment Setup

Installing Build Tools

# Arch Linux
sudo pacman -S --needed base-devel

# Debian/Ubuntu
sudo apt install build-essential

# RHEL/CentOS
sudo dnf groupinstall "Development Tools"

# Verify installation
gcc --version
make --version

Additional Dependencies

# Arch Linux - common build dependencies
sudo pacman -S \
    cmake \
    autoconf \
    automake \
    pkg-config \
    libtool \
    flex \
    bison \
    gettext \
    ninja \
    meson

# Install development libraries as needed
sudo pacman -S openssl dev zlib libpng libjpeg

---

29.2 Build Process

Standard Build Steps

              Source Compilation Process
+------------------------------------------------------------------+
|                                                                   |
|   1. Download Source                                             |
|      └─ wget/curl/git clone                                      |
|                                                                   |
|   2. Extract                                                     |
|      └─ tar -xvf source.tar.gz                                  |
|                                                                   |
|   3. Configure                                                   |
|      └─ ./configure --prefix=/usr/local                         |
|          - Checks system capabilities                            |
|          - Generates Makefile                                    |
|                                                                   |
|   4. Build                                                       |
|      └─ make                                                    |
|          - Compiles source into binaries                         |
|                                                                   |
|   5. Install                                                     |
|      └─ sudo make install                                        |
|          - Copies files to system                                |
|                                                                   |
|   6. ldconfig (if needed)                                        |
|      └─ Updates library cache                                    |
|                                                                   |
+------------------------------------------------------------------+

Example: Building nginx from Source

# Install dependencies
sudo pacman -S openssl pcre zlib

# Download source
wget https://nginx.org/download/nginx-1.24.0.tar.gz
tar -xvzf nginx-1.24.0.tar.gz
cd nginx-1.24.0

# Configure with options
./configure \
    --prefix=/usr/local/nginx \
    --sbin-path=/usr/local/nginx/sbin/nginx \
    --conf-path=/usr/local/nginx/conf/nginx.conf \
    --error-log-path=/var/log/nginx/error.log \
    --http-log-path=/var/log/nginx/access.log \
    --pid-path=/var/run/nginx.pid \
    --lock-path=/var/run/nginx.lock \
    --with-http_ssl_module \
    --with-http_v2_module \
    --with-http_gzip_static_module \
    --with-pcre \
    --with-openssl=/usr/include/openssl

# Build
make -j$(nproc)

# Install
sudo make install

# Update library cache
sudo ldconfig

---

29.3 CMake Build System

CMake Basics

# Basic CMake workflow
mkdir build
cd build
cmake ..
make
sudo make install

CMake Examples

# Configure with options
cmake -DCMAKE_INSTALL_PREFIX=/usr/local \
      -DCMAKE_BUILD_TYPE=Release \
      -DENABLE_FEATURE=ON \
      ..

# Out-of-source build (recommended)
mkdir -p build/release
cd build/release
cmake -DCMAKE_BUILD_TYPE=Release ../..
make

---

29.4 Autotools (configure/make)

configure Options

# Common configure options
./configure \
    --prefix=/usr/local              # Installation prefix
    --sysconfdir=/etc               # Config files location
    --localstatedir=/var             # Variable data
    --enable-shared                 # Build shared libraries
    --enable-static                 # Build static libraries
    --disable-debug                 # Disable debug symbols
    --with-package=option           # Package-specific options
    --without-package               # Disable package
    --help                          # Show all options

make Options

# Build with multiple cores
make -j$(nproc)

# Build specific target
make nginx

# Install to staging directory
make DESTDIR=/tmp/staging install

# Clean build
make clean
make distclean

---

29.5 Meson/Ninja Build

Modern Build System

# Install
sudo pacman -S meson ninja

# Configure
meson setup builddir

# Build
ninja -C builddir

# Install
sudo ninja -C builddir install

---

29.6 Managing Multiple Versions

Using /usr/local

# Install to /usr/local
./configure --prefix=/usr/local
sudo make install

# Update library cache
sudo ldconfig

# Find installed binaries
which nginx
ldd $(which nginx)

Using checkinstall

# Install checkinstall
sudo pacman -S checkinstall

# Create package instead of make install
sudo checkinstall --pkgname=nginx-custom --pkgversion=1.24.0 make install

---

29.7 Build Troubleshooting

Common Issues

# Missing dependencies
configure: error: *** missing ***
# Solution: Install required -dev packages

# Library not found
# Solution: Set LDFLAGS
export LDFLAGS="-L/usr/local/lib"
export LD_LIBRARY_PATH="/usr/local/lib:$LD_LIBRARY_PATH"

# Header not found
# Solution: Set CPPFLAGS
export CPPFLAGS="-I/usr/local/include"

# Compiler not found
# Solution: Set CC
export CC=gcc-13
export CXX=g++-13

Build Logs

# Save configure output
./configure > configure.log 2>&1

# Save build output
make > build.log 2>&1

# Verbose build
make V=1

---

29.8 Creating Packages

Arch Linux PKGBUILD

# Example PKGBUILD
pkgname=nginx-custom
pkgver=1.24.0
pkgrel=1
arch=('x86_64')
depends=('openssl' 'pcre' 'zlib')

build() {
    cd $pkgname-$pkgver
    ./configure --prefix=/usr/local
    make
}

package() {
    cd $pkgname-$pkgver
    make DESTDIR=$pkgdir install
}

RPM Spec File

# Example nginx.spec
Name:           nginx-custom
Version:        1.24.0
Release:        1%{?dist}
Summary:        Custom nginx build

%build
./configure --prefix=/usr/local
make %{?_smp_mflags}

%install
make install DESTDIR=%{buildroot}

%files
%{_prefix}/local/nginx

---

Summary

In this chapter, you learned:

• ✅ Setting up build environment
• ✅ Autotools build process (configure/make)
• ✅ CMake build system
• ✅ Meson/Ninja builds
• ✅ Troubleshooting build issues
• ✅ Creating distribution packages

---

Next Chapter

Chapter 30: Repository Management

---

Last Updated: February 2026