FreeBSD Handbook

The FreeBSD Documentation Project

May 1997


Welcome to FreeBSD! This handbook covers the installation and day to day use of FreeBSD Release 2.2.2. This manual is a work in progress and is the work of many individuals. Many sections do not yet exist and some of those that do exist need to be updated. If you are interested in helping with this project, send email to the FreeBSD documentation project mailing list <freebsd-doc@FreeBSD.ORG> The latest version of this document is always available from the FreeBSD World Wide Web server. It may also be downloaded in plain text, postscript or HTML from the FreeBSD FTP server or one of the numerous mirror sites. You may also want to Search the Handbook.

Part 1:
Getting Started

1. Introduction

1.1. FreeBSD in a nutshell
1.2. A brief history of FreeBSD
1.3. FreeBSD Project goals
1.4. The FreeBSD development model
1.5. About the current release

2. Installing FreeBSD

2.1. Supported Configurations
2.2. Preparing for the installation
2.3. Installing FreeBSD
2.4. MS-DOS user's Questions and Answers

3. Unix Basics

3.1. The online manual
3.2. GNU Info files

4. Installing Applications: The Ports collection

4.1. Why have a Ports Collection?
4.2. How does the Ports collection work?
4.3. Getting a FreeBSD Port
4.4. Skeletons
4.5. It does not work?!
4.6. I have this program that I would like to make into a port...
4.7. Some Questions and Answers

Part 2:
System Administration

5. Configuring the FreeBSD Kernel

5.1. Why build a custom kernel?
5.2. Building and Installing a Custom Kernel
5.3. The Configuration File
5.4. Making Device Nodes
5.5. If Something Goes Wrong

6. Security

6.1. DES, MD5, and Crypt
6.2. S/Key
6.3. Kerberos
6.4. Firewalls

7. Printing

7.1. What the Spooler Does
7.2. Why You Should Use the Spooler
7.3. Setting Up the Spooling System
7.4. Simple Printer Setup
7.5. Using Printers
7.6. Advanced Printer Setup
7.7. Alternatives to the Standard Spooler
7.8. Acknowledgments

8. Disk quotas

8.1. Configuring your system to enable disk quotas
8.2. Setting quota limits
8.3. Checking quota limits and disk usage
8.4. * Quotas over NFS

9. The X Window System

10. PC Hardware compatibility

10.1. Resources on the Internet
10.2. Sample Configurations
10.3. Core/Processing
10.4. Input/Output Devices
10.5. Storage Devices

11. Localization

11.1. Russian Language (KOI8-R encoding)

Part 3:
Network Communications

12. Serial Communications

12.1. Serial Basics
12.2. Terminals
12.3. Dialin service
12.4. Dialout service

13. PPP and SLIP

13.1. Setting up user PPP
13.2. Setting up kernel PPP
13.3. Setting up a SLIP client
13.4. Setting up a SLIP server

14. Advanced networking

14.1. Gateways and routes
14.2. NFS
14.3. Diskless operation
14.4. ISDN

15. Electronic Mail

15.1. Basic Information
15.2. Configuration
15.3. FAQ

Part 4:
Advanced topics

16. The Cutting Edge: FreeBSD-current and FreeBSD-stable

16.1. Staying current with FreeBSD
16.2. Staying stable with FreeBSD
16.3. Synchronizing source trees over the Internet

17. Contributing to FreeBSD

17.1. What is needed
17.2. How to contribute
17.3. Donors Gallery
17.4. Derived software contributors
17.5. Additional FreeBSD contributors
17.6. 386BSD Patch kit patch contributors

18. Source Tree Guidelines and Policies

18.1. MAINTAINER on Makefiles
18.2. Contributed software
18.3. Shared libraries

19. Adding New Kernel Configuration Options

19.1. What's a kernel option, anyway?
19.2. Now what do I have to do for it?

20. Kernel Debugging

20.1. Debugging a kernel crash dump with kgdb
20.2. Post-mortem analysis of a dump
20.3. On-line kernel debugging using DDB
20.4. On-line kernel debugging using remote GDB
20.5. Debugging a console driver

21. Linux Emulation

21.1. How to install the Linux emulator
21.2. How to Install Mathematica on FreeBSD

22. FreeBSD internals

22.1. The FreeBSD Booting Process
22.2. PC memory utilization
22.3. DMA: What it is and how it works

Part 5:
Appendices

23. Obtaining FreeBSD

23.1. CD-ROM Publishers
23.2. FTP Sites
23.3. CTM Sites
23.4. CVSup Sites

24. Bibliography

24.1. Books & magazines specific to FreeBSD
24.2. Users' guides
24.3. Administrators' guides
24.4. Programmers' guides
24.5. Operating System Internals
24.6. Security reference
24.7. Hardware reference
24.8. UNIX history
24.9. Magazines and journals

25. Resources on the Internet

25.1. Mailing lists
25.2. Usenet newsgroups
25.3. World Wide Web servers

26. FreeBSD Project Staff

26.1. The FreeBSD core team
26.2. The FreeBSD Developers
26.3. The FreeBSD Documentation Project
26.4. Who is responsible for what

27. PGP keys

27.1. Officers
27.2. Core team members

FreeBSD Home Page
www@freebsd.org
Updated June 2, 1997