Handbook:Parts

This page Article description::lists a set of reusable parts for many Gentoo handbooks.

Take care that:
 * All main sections include Handbook:Parts/TOC as a way of binding the structure of the Handbook together.

This is the Gentoo Handbook, an effort to centralize Gentoo Linux information. This Handbook contains the installation instructions for an Internet-based installation and basic instructions about working with Portage, Gentoo's package manager.

Installing Gentoo

 * About the Gentoo Linux installation
 * This chapter introduces the installation approach documented in this handbook.


 * Choosing the right installation medium
 * It is possible to install Gentoo in many ways. This chapter explains how to install Gentoo using the minimal Installation CD.


 * Configuring the network
 * To be able to download the latest source code, networking will need to be configured.


 * Preparing the disks
 * Before Gentoo can be installed, the necessary partitions must be created. This chapter describes how to partition a disk.


 * Installing the Gentoo installation files
 * The basic Gentoo system is downloaded as a stage3 archive. This chapter explains how to download and extract the archive, and also how to configure Portage, Gentoo's package management program.


 * Installing the Gentoo base system
 * After installing and configuring the stage3, the base system is set up so that a minimal environment is available.


 * Configuring the Linux kernel
 * The Linux kernel is the core of every distribution. This chapter explains how to configure the kernel.


 * Configuring the system
 * Some important configuration files must be created. This chapter provides an overview of these files and explains how to tailor the configuration.


 * Installing system tools
 * In this chapter some important tools are selected and installed.


 * Configuring the bootloader
 * In this chapter the right bootloader is installed and configured.


 * Finalizing the installation
 * The installation is now almost done. The last finishing touches are documented in this chapter.

Working with Gentoo

 * A Portage introduction
 * This chapter explains simple steps readers must understand to maintain the software on their system.


 * USE flags
 * USE flags are a very important aspect of Gentoo. In this chapter, readers learn to work with USE flags and understand how USE flags interact with their system.


 * Portage features
 * Discover the features Portage has, such as support for distributed compiling, ccache, and more.


 * Init script system
 * Gentoo uses a special initscript format which, among other features, allows dependency-driven decisions and virtual initscripts. This chapter explains all these aspects and explains how to deal with these scripts.


 * Environment variables
 * Environment variables can be easily managed with Gentoo. This chapter explains how to do that, and also describes frequently used variables.

Working with Portage

 * Files and directories
 * To know Portage in-depth, first learn where it stores its files and data.


 * Variables
 * Portage is completely configurable, with several options that can be set in a configuration file, or as environment variables.


 * Mixing software branches
 * Gentoo provides software separated in several branches, depending on stability and architectural support. "Mixing Software Branches" explains how these branches can be configured and how to override this separation individually.


 * Additional tools
 * Portage comes with a few extra tools that might make the Gentoo experience even better. Read on to discover how to use and other tools.


 * Custom package repository
 * This chapter gives some tips and tricks on how to use a custom package repository, how to synchronize only the required categories, how to inject packages, and more.


 * Advanced features
 * As time passes, Portage evolves and matures. New features are continually being added. Many of these are useful only to the more experienced user. This chapter explains some of Portage's newer features.

Gentoo network configuration

 * Getting started
 * A guide to quickly get the network interface up and running in most common environments.


 * Advanced configuration
 * Here we learn about how the configuration works - this is prerequisite knowledge before continuing with modular networking.


 * Modular networking
 * Learn how to choose different DHCP clients, setting up bonding, bridging, VLANs, and more.


 * Wireless
 * Configuring Gentoo for wireless networks


 * Adding functionality
 * Adventurous users can add their own functions to the networking tools.


 * Dynamic management
 * For laptop users or people who move their computer around different networks.