This page will list everything that is needed to create published versions of our documentation for sale. The current plan is update the Handbook in order to provide a PDF to FreeBSD Mall for a printed book edition, and to create Google Book and Kindle versions for supported e-readers with e-reader proceeds going directly to the Foundation. Once this pilot project is complete, the viability of creating other publications for sale (e.g. Porter's Handbook) can be discussed.
There is still a demand for a printed version of the handbook from customers of e.g. FreeBSD Mall. It was suggested that the Fourth Edition should cover 7.0 to either 8.2 or 9.0. The current Third Edition was published in 1993 and covers FreeBSD 4.X and 5.X only. Due to the current size of the Handbook (over 1,000 printed pages), it was recommended to change from a two volume printed edition to a three volume edition: 1) FreeBSD installation and basic system administration 2) FreeBSD as a server OS 3) FreeBSD as a desktop OS.
Table 1: What Needs to Happen
This is by no means a complete list. Add tasks as needed.
Task |
Responsible |
Estimated Completion Date |
Create Table of Contents for each Publication (book) |
|
|
Review Handbook to remove stuff prior to 7.0 |
|
|
Complete Table 2 for each chapter |
|
|
Update Screenshots |
|
|
|
|
|
|
|
|
Write Preface for each Publication |
|
|
Commission Cover Art |
dru@ |
3 weeks prior to publication |
Convert to pdf (for Mall) |
bcr@ |
|
Create Foundation accounts for Amazon and Google Books |
dru@ |
1 week prior to publication |
Convert to epub |
bcr@ |
|
Convert HTML to Kindle format for Amazon |
dru@ |
3 days prior to publication (for Amazon review) |
Announce availability of publications |
|
|
Table 2: Chapter Status
Possible statuses are: needs review, needs to be written, needs to be removed, ready to publish.
Chapters which are currently missing from the Handbook should be added to the Table.
As PRs are closed, they should be removed from the Outstanding PRs column.
Chapter |
Status |
Outstanding PRs |
Estimated Completion Date |
Notes |
Preface |
|
|
|
|
I. Getting Started |
|
|
|
|
1 Introduction |
|
|
|
|
1.1 Synopsis |
|
|
|
|
1.2 Welcome to FreeBSD! |
|
|
|
|
1.3 About the FreeBSD Project |
|
|
|
|
2 Installing FreeBSD |
|
|
|
|
2.1 Synopsis |
|
|
|
|
2.2 Hardware Requirements |
|
|
|
|
2.3 Pre-installation Tasks |
|
|
|
|
2.4 Starting the Installation |
|
|
|
|
2.5 Introducing Sysinstall |
|
|
|
|
2.6 Allocating Disk Space |
|
|
|
|
2.7 Choosing What to Install |
|
|
|
|
2.8 Choosing Your Installation Media |
|
|
|
|
2.9 Committing to the Installation |
|
|
|
|
2.10 Post-installation |
|
|
|
|
2.11 Troubleshooting |
|
|
|
|
2.12 Advanced Installation Guide |
|
|
|
|
2.13 Preparing Your Own Installation Media |
|
|
|
|
3 UNIX Basics |
|
|
|
|
3.1 Synopsis |
|
|
|
|
3.2 Virtual Consoles and Terminals |
|
|
|
|
3.3 Permissions |
|
|
|
|
3.4 Directory Structure |
|
|
|
|
3.5 Disk Organization |
|
|
|
|
3.6 Mounting and Unmounting File Systems |
|
|
|
|
3.7 Processes |
|
|
|
|
3.8 Daemons, Signals, and Killing Processes |
|
|
|
|
3.9 Shells |
|
|
|
|
3.10 Text Editors |
|
|
|
|
3.11 Devices and Device Nodes |
|
|
|
|
3.12 Binary Formats |
|
|
|
|
3.13 For More Information |
|
|
|
|
4 Installing Applications: Packages and Ports |
|
|
|
|
4.1 Synopsis |
|
|
|
|
4.2 Overview of Software Installation |
|
|
|
|
4.3 Finding Your Application |
|
|
|
|
4.4 Using the Packages System |
|
|
|
|
4.5 Using the Ports Collection |
|
|
|
|
4.6 Post-installation Activities |
|
|
|
|
4.7 Dealing with Broken Ports |
|
|
|
|
5 The X Window System |
|
|
|
|
5.1 Synopsis |
|
|
|
|
5.2 Understanding X |
|
|
|
|
5.3 Installing X11 |
|
|
|
|
5.4 X11 Configuration |
|
|
|
|
5.5 Using Fonts in X11 |
|
|
|
|
5.6 The X Display Manager |
|
|
|
|
5.7 Desktop Environments |
|
|
|
|
II. Common Tasks |
|
|
|
|
6 Desktop Applications |
|
|
|
|
6.1 Synopsis |
|
|
|
|
6.2 Browsers |
|
|
|
|
6.3 Productivity |
|
|
|
|
6.4 Document Viewers |
|
|
|
|
6.5 Finance |
|
|
|
|
6.6 Summary |
|
|
|
|
7 Multimedia |
|
|
|
|
7.1 Synopsis |
|
|
|
|
7.2 Setting Up the Sound Card |
|
|
|
|
7.3 MP3 Audio |
|
|
|
|
7.4 Video Playback |
|
|
|
|
7.5 Setting Up TV Cards |
|
|
|
|
7.6 Image Scanners |
|
|
|
|
8 Configuring the FreeBSD Kernel |
|
|
|
|
8.1 Synopsis |
|
|
|
|
8.2 Why Build a Custom Kernel? |
|
|
|
|
8.3 Finding the System Hardware |
|
|
|
|
8.4 Kernel Drivers, Subsystems, and Modules |
|
|
|
|
8.5 Building and Installing a Custom Kernel |
|
|
|
|
8.6 The Configuration File |
|
|
|
|
8.7 If Something Goes Wrong |
|
|
|
|
9 Printing |
|
|
|
|
9.1 Synopsis |
|
|
|
|
9.2 Introduction |
|
|
|
|
9.3 Basic Setup |
|
|
|
|
9.4 Advanced Printer Setup |
|
|
|
|
9.5 Using Printers |
|
|
|
|
9.6 Alternatives to the Standard Spooler |
|
|
|
|
9.7 Troubleshooting |
|
|
|
|
10 Linux Binary Compatibility |
|
|
|
|
10.1 Synopsis |
|
|
|
|
10.2 Installation |
|
|
|
|
10.3 Installing Mathematica® |
|
|
|
|
10.4 Installing Maple™ |
|
|
|
|
10.5 Installing MATLAB® |
|
|
|
|
10.6 Installing Oracle® |
|
|
|
|
10.7 Advanced Topics |
|
|
|
|
III. System Administration |
|
|
|
|
11 Configuration and Tuning |
|
|
|
|
11.1 Synopsis |
|
|
|
|
11.2 Initial Configuration |
|
|
|
|
11.3 Core Configuration |
|
|
|
|
11.4 Application Configuration |
|
|
|
|
11.5 Starting Services |
|
|
|
|
11.6 Configuring the cron Utility |
|
|
|
|
11.7 Using rc under FreeBSD |
|
|
|
|
11.8 Setting Up Network Interface Cards |
|
|
|
|
11.9 Virtual Hosts |
|
|
|
|
11.10 Configuration Files |
|
|
|
|
11.11 Tuning with sysctl |
|
|
|
|
11.12 Tuning Disks |
|
|
|
|
11.13 Tuning Kernel Limits |
|
|
|
|
11.14 Adding Swap Space |
|
|
|
|
11.15 Power and Resource Management |
|
|
|
|
11.16 Using and Debugging FreeBSD ACPI |
|
|
|
|
12 The FreeBSD Booting Process |
|
|
|
|
12.1 Synopsis |
|
|
|
|
12.2 The Booting Problem |
|
|
|
|
12.3 The Boot Manager and Boot Stages |
|
|
|
|
12.4 Kernel Interaction During Boot |
|
|
|
|
12.5 Device Hints |
|
|
|
|
12.6 Init: Process Control Initialization |
|
|
|
|
12.7 Shutdown Sequence |
|
|
|
|
13 Users and Basic Account Management |
|
|
|
|
13.1 Synopsis |
|
|
|
|
13.2 Introduction |
|
|
|
|
13.3 The Superuser Account |
|
|
|
|
13.4 System Accounts |
|
|
|
|
13.5 User Accounts |
|
|
|
|
13.6 Modifying Accounts |
|
|
|
|
13.7 Limiting Users |
|
|
|
|
13.8 Groups |
|
|
|
|
14 Security |
|
|
|
|
14.1 Synopsis |
|
|
|
|
14.2 Introduction |
|
|
|
|
14.3 Securing FreeBSD |
|
|
|
|
14.4 DES, Blowfish, MD5, and Crypt |
|
|
|
|
14.5 One-time Passwords |
|
|
|
|
14.6 TCP Wrappers |
|
|
|
|
14.7 Kerberos5 |
|
|
|
|
14.8 OpenSSL |
|
|
|
|
14.9 VPN over IPsec |
|
|
|
|
14.10 OpenSSH |
|
|
|
|
14.11 File System Access Control Lists |
|
|
|
|
14.12 Monitoring Third Party Security Issues |
|
|
|
|
14.13 FreeBSD Security Advisories |
|
|
|
|
14.14 Process Accounting |
|
|
|
|
15 Jails |
|
|
|
|
15.1 Synopsis |
|
|
|
|
15.2 Terms Related to Jails |
|
|
|
|
15.3 Introduction |
|
|
|
|
15.4 Creating and Controlling Jails |
|
|
|
|
15.5 Fine Tuning and Administration |
|
|
|
|
15.6 Application of Jails |
|
|
|
|
16 Mandatory Access Control |
|
|
|
|
16.1 Synopsis |
|
|
|
|
16.2 Key Terms in this Chapter |
|
|
|
|
16.3 Explanation of MAC |
|
|
|
|
16.4 Understanding MAC Labels |
|
|
|
|
16.5 Planning the Security Configuration |
|
|
|
|
16.6 Module Configuration |
|
|
|
|
16.7 The MAC seeotheruids Module |
|
|
|
|
16.8 The MAC bsdextended Module |
|
|
|
|
16.9 The MAC ifoff Module |
|
|
|
|
16.10 The MAC portacl Module |
|
|
|
|
16.11 The MAC partition Module |
|
|
|
|
16.12 The MAC Multi-Level Security Module |
|
|
|
|
16.13 The MAC Biba Module |
|
|
|
|
16.14 The MAC LOMAC Module |
|
|
|
|
16.15 Nagios in a MAC Jail |
|
|
|
|
16.16 User Lock Down |
|
|
|
|
16.17 Troubleshooting the MAC Framework |
|
|
|
|
17 Security Event Auditing |
|
|
|
|
17.1 Synopsis |
|
|
|
|
17.2 Key Terms in this Chapter |
|
|
|
|
17.3 Installing Audit Support |
|
|
|
|
17.4 Audit Configuration |
|
|
|
|
17.5 Administering the Audit Subsystem |
|
|
|
|
18 Storage |
|
|
|
|
18.1 Synopsis |
|
|
|
|
18.2 Device Names |
|
|
|
|
18.3 Adding Disks |
|
|
|
|
18.4 RAID |
|
|
|
|
18.5 USB Storage Devices |
|
|
|
|
18.6 Creating and Using Optical Media (CDs) |
|
|
|
|
18.7 Creating and Using Optical Media (DVDs) |
|
|
|
|
18.8 Creating and Using Floppy Disks |
|
|
|
|
18.9 Creating and Using Data Tapes |
|
|
|
|
18.10 Backups to Floppies |
|
|
|
|
18.11 Backup Strategies |
|
|
|
|
18.12 Backup Basics |
|
|
|
|
18.13 Network, Memory, and File-Backed File Systems |
|
|
|
|
18.14 File System Snapshots |
|
|
|
|
18.15 File System Quotas |
|
|
|
|
18.16 Encrypting Disk Partitions |
|
|
|
|
18.17 Encrypting Swap Space |
|
|
|
|
18.18 Highly Available Storage (HAST) |
|
|
|
|
19 GEOM: Modular Disk Transformation Framework |
|
|
|
|
19.1 Synopsis |
|
|
|
|
19.2 GEOM Introduction |
|
|
|
|
19.3 RAID0 - Striping |
|
|
|
|
19.4 RAID1 - Mirroring |
|
|
|
|
19.5 GEOM Gate Network Devices |
|
|
|
|
19.6 Labeling Disk Devices |
|
|
|
|
19.7 UFS Journaling Through GEOM |
|
|
|
|
20 File Systems Support |
|
|
|
|
20.1 Synopsis |
|
|
|
|
20.2 The Z File System (ZFS) |
|
|
|
|
21 The Vinum Volume Manager |
|
|
|
|
21.1 Synopsis |
|
|
|
|
21.2 Disks Are Too Small |
|
|
|
|
21.3 Access Bottlenecks |
|
|
|
|
21.4 Data Integrity |
|
|
|
|
21.5 Vinum Objects |
|
|
|
|
21.6 Some Examples |
|
|
|
|
21.7 Object Naming |
|
|
|
|
21.8 Configuring Vinum |
|
|
|
|
21.9 Using Vinum for the Root Filesystem |
|
|
|
|
22 Virtualization |
|
|
|
|
22.1 Synopsis |
|
|
|
|
22.2 FreeBSD as a Guest OS |
|
|
|
|
22.3 FreeBSD as a Host OS |
|
|
|
|
23 Localization - I18N/L10N Usage and Setup |
|
|
|
|
23.1 Synopsis |
|
|
|
|
23.2 The Basics |
|
|
|
|
23.3 Using Localization |
|
|
|
|
23.4 Compiling I18N Programs |
|
|
|
|
23.5 Localizing FreeBSD to Specific Languages |
|
|
|
|
24 Updating and Upgrading FreeBSD |
|
|
|
|
24.1 Synopsis |
|
|
|
|
24.2 FreeBSD Update |
|
|
|
|
24.3 Portsnap: A Ports Collection Update Tool |
|
|
|
|
24.4 Updating the Documentation Set |
|
|
|
|
24.5 Tracking a Development Branch |
|
|
|
|
24.6 Synchronizing Your Source |
|
|
|
|
24.7 Rebuilding “world” |
|
|
|
|
24.8 Deleting obsolete files, directories and libraries |
|
|
|
|
24.9 Tracking for Multiple Machines |
|
|
|
|
25 DTrace |
|
|
|
|
25.1 Synopsis |
|
|
|
|
25.2 Implementation Differences |
|
|
|
|
25.3 Enabling DTrace Support |
|
|
|
|
25.4 Using DTrace |
|
|
|
|
25.5 The D Language |
|
|
|
|
IV. Network Communication |
|
|
|
|
26 Serial Communications |
|
|
|
|
26.1 Synopsis |
|
|
|
|
26.2 Introduction |
|
|
|
|
26.3 Terminals |
|
|
|
|
26.4 Dial-in Service |
|
|
|
|
26.5 Dial-out Service |
|
|
|
|
26.6 Setting Up the Serial Console |
|
|
|
|
27 PPP and SLIP |
|
|
|
|
27.1 Synopsis |
|
|
|
|
27.2 Using User PPP |
|
|
|
|
27.3 Using Kernel PPP |
|
|
|
|
27.4 Troubleshooting PPP Connections |
|
|
|
|
27.5 Using PPP over Ethernet (PPPoE) |
|
|
|
|
27.6 Using PPP over ATM (PPPoA) |
|
|
|
|
27.7 Using SLIP |
|
|
|
|
28 Electronic Mail |
|
|
|
|
28.1 Synopsis |
|
|
|
|
28.2 Using Electronic Mail |
|
|
|
|
28.3 sendmail Configuration |
|
|
|
|
28.4 Changing Your Mail Transfer Agent |
|
|
|
|
28.5 Troubleshooting |
|
|
|
|
28.6 Advanced Topics |
|
|
|
|
28.7 SMTP with UUCP |
|
|
|
|
28.8 Setting Up to Send Only |
|
|
|
|
28.9 Using Mail with a Dialup Connection |
|
|
|
|
28.10 SMTP Authentication |
|
|
|
|
28.11 Mail User Agents |
|
|
|
|
28.12 Using fetchmail |
|
|
|
|
28.13 Using procmail |
|
|
|
|
29 Network Servers |
|
|
|
|
29.1 Synopsis |
|
|
|
|
29.2 The inetd “Super-Server” |
|
|
|
|
29.3 Network File System (NFS) |
|
|
|
|
29.4 Network Information System (NIS/YP) |
|
|
|
|
29.5 Automatic Network Configuration (DHCP) |
|
|
|
|
29.6 Domain Name System (DNS) |
|
|
|
|
29.7 Apache HTTP Server |
|
|
|
|
29.8 File Transfer Protocol (FTP) |
|
|
|
|
29.9 File and Print Services for Microsoft® Windows® clients (Samba) |
|
|
|
|
29.10 Clock Synchronization with NTP |
|
|
|
|
29.11 Remote Host Logging with syslogd |
|
|
|
|
30 Firewalls |
|
|
|
|
30.1 Introduction |
|
|
|
|
30.2 Firewall Concepts |
|
|
|
|
30.3 Firewall Packages |
|
|
|
|
30.4 The OpenBSD Packet Filter (PF) and ALTQ |
|
|
|
|
30.5 The IPFILTER (IPF) Firewall |
|
|
|
|
30.6 IPFW |
|
|
|
|
31 Advanced Networking |
|
|
|
|
31.1 Synopsis |
|
|
|
|
31.2 Gateways and Routes |
|
|
|
|
31.3 Wireless Networking |
|
|
|
|
31.4 Bluetooth |
|
|
|
|
31.5 Bridging |
|
|
|
|
31.6 Link Aggregation and Failover |
|
|
|
|
31.7 Diskless Operation |
|
|
|
|
31.8 ISDN |
|
|
|
|
31.9 Network Address Translation |
|
|
|
|
31.10 Parallel Line IP (PLIP) |
|
|
|
|
31.11 IPv6 |
|
|
|
|
31.12 Asynchronous Transfer Mode (ATM) |
|
|
|
|
31.13 Common Address Redundancy Protocol (CARP) |
|
|
|
|
V. Appendices |
|
|
|
|
A. Obtaining FreeBSD |
|
|
|
|
A.1 CDROM and DVD Publishers |
|
|
|
|
A.2 FTP Sites |
|
|
|
|
A.3 BitTorrent |
|
|
|
|
A.4 Anonymous CVS |
|
|
|
|
A.5 Using CTM |
|
|
|
|
A.6 Using CVSup |
|
|
|
|
A.7 CVS Tags |
|
|
|
|
A.8 AFS Sites |
|
|
|
|
A.9 rsync Sites |
|
|
|
|
B. Bibliography |
|
|
|
|
B.1 Books & Magazines Specific to FreeBSD |
|
|
|
|
B.2 Users' Guides |
|
|
|
|
B.3 Administrators' Guides |
|
|
|
|
B.4 Programmers' Guides |
|
|
|
|
B.5 Operating System Internals |
|
|
|
|
B.6 Security Reference |
|
|
|
|
B.7 Hardware Reference |
|
|
|
|
B.8 UNIX® History |
|
|
|
|
B.9 Magazines and Journals |
|
|
|
|
C. Resources on the Internet |
|
|
|
|
C.1 Mailing Lists |
|
|
|
|
C.2 Usenet Newsgroups |
|
|
|
|
C.3 World Wide Web Servers |
|
|
|
|
C.4 Email Addresses |
|
|
|
|
D. PGP Keys |
|
|
|
|
D.1 Officers |
|
|
|
|
D.2 Core Team Members |
|
|
|
|
D.3 Developers |
|
|
|
|
FreeBSD Glossary |
|
|
|
|
Index |
|
|
|
|
Colophon |
|
|
|
|