DragonFly Handbook

The DragonFly Documentation Project

Welcome to DragonFly! This handbook covers the installation and day to day use of the DragonFly operating system. 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 DragonFly Documentation project mailing list.

Portions of this document originally documented use of the FreeBSD operating system. While many functions should be similar on DragonFly, some differences should be expected. If you find instructions here that no longer apply to DragonFly, please contact the documentation mailing list at DragonFly Documentation project mailing list .

Table of Contents
Preface
Getting Started
- 1 Introduction
  - 1.1 Synopsis
    1.2 Welcome to DragonFly!
    1.3 About the DragonFly Project
  2 Installation from CD
  - 2.1 Making room
    2.2 Disk setup
    2.3 Installing to Disk from CD
    2.4 New system setup
  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 using NetBSD's pkgsrc framework
  - 4.1 Synopsis
    4.2 Overview of Software Installation
    4.3 Finding Your Application
    4.4 Using the Binary Packages System
    4.5 Using the pkgsrc ® Source Tree
    4.6 Post-installation Activities
    4.7 Dealing with Broken Packages
  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. System Administration
- 6 Configuration and Tuning
  - 6.1 Synopsis
    6.2 Initial Configuration
    6.3 Core Configuration
    6.4 Application Configuration
    6.5 Starting Services
    6.6 Configuring the cron Utility
    6.7 Using rc under DragonFly
    6.8 Setting Up Network Interface Cards
    6.9 Virtual Hosts
    6.10 Configuration Files
    6.11 Tuning with sysctl
    6.12 Tuning Disks
    6.13 Tuning Kernel Limits
    6.14 Adding Swap Space
    6.15 Power and Resource Management
    6.16 Using and Debugging DragonFly ACPI
  7 The DragonFly virtual kernel
  - 7.1 Overview
    7.2 Setup a virtual kernel environment
    7.3 Setup networking
    7.4 Run a virtual kernel
  8 The DragonFly Booting Process
  - 8.1 Synopsis
    8.2 The Booting Problem
    8.3 The Boot Manager and Boot Stages
    8.4 Kernel Interaction During Boot
    8.5 Init: Process Control Initialization
    8.6 Shutdown Sequence
  9 Users and Basic Account Management
  - 9.1 Synopsis
    9.2 Introduction
    9.3 The Superuser Account
    9.4 System Accounts
    9.5 User Accounts
    9.6 Modifying Accounts
    9.7 Limiting Users
    9.8 Personalizing Users
    9.9 Groups
  10 Configuring the DragonFly Kernel
  - 10.1 Synopsis
    10.2 Why Build a Custom Kernel?
    10.3 Building and Installing a Custom Kernel
    10.4 The Configuration File
    10.5 Making Device Nodes
    10.6 If Something Goes Wrong
  11 Security
  - 11.1 Synopsis
    11.2 Introduction
    11.3 Securing DragonFly
    11.4 DES, MD5, and Crypt
    11.5 One-time Passwords
    11.6 '''Kerberos5 '''
    11.7 Firewalls
    11.8 OpenSSL
    11.9 VPN over IPsec
    11.10 OpenSSH
  12 Jails
  - 12.1 Synopsis
    12.2 Terms Related to Jails
    12.3 Introduction
    12.4 Creating and Controlling Jails
    12.5 Fine Tuning and Administration
  13 Printing
  - 13.1 Synopsis
    13.2 Introduction
    13.3 Basic Setup
    13.4 Advanced Printer Setup
    13.5 Using Printers
    13.6 Alternatives to the Standard Spooler
    13.7 Troubleshooting
  14 Storage
  - 14.1 Synopsis
    14.2 Device Names
    14.3 Adding Disks
    14.4 RAID
    14.5 Creating and Using Optical Media (CDs)
    14.6 Creating and Using Optical Media (DVDs)
    14.7 Creating and Using Floppy Disks
    14.8 Creating and Using Data Tapes
    14.9 Backups to Floppies
    14.10 Backup Basics
    14.11 Network, Memory, and File-Backed File Systems
    14.12 File System Quotas
  15 The Vinum Volume Manager
  - 15.1 Synopsis
    15.2 Disks Are Too Small
    15.3 Access Bottlenecks
    15.4 Data Integrity
    15.5 Vinum Objects
    15.6 Some Examples
    15.7 Object Naming
    15.8 Configuring Vinum
    15.9 Using Vinum for the Root Filesystem
  16 Localization - I18N/L10N Usage and Setup
  - 16.1 Synopsis
    16.2 The Basics
    16.3 Using Localization
    16.4 Compiling I18N Programs
    16.5 Localizing DragonFly to Specific Languages
  17 Desktop Applications
  - 17.1 Synopsis
    17.2 Browsers
    17.3 Productivity
    17.4 Document Viewers
    17.5 Finance
    17.6 Summary
  18 Multimedia
  - 18.1 Synopsis
    18.2 Setting Up the Sound Card
    18.3 MP3 Audio
    18.4 Video Playback
    18.5 Setting Up TV Cards
  19 Serial Communications
  - 19.1 Synopsis
    19.2 Introduction
    19.3 Terminals
    19.4 Dial-in Service
    19.5 Dial-out Service
    19.6 Setting Up the Serial Console
  20 PPP and SLIP
  - 20.1 Synopsis
    20.2 Using User PPP
    20.3 Using Kernel PPP
    20.4 Troubleshooting PPP Connections
    20.5 Using PPP over Ethernet (PPPoE)
    20.6 Using SLIP
  21 Advanced Networking
  - 21.1 Synopsis
    21.2 Gateways and Routes
    21.3 Wireless Networking
    21.4 Bluetooth
    21.5 Bridging
    21.6 NFS
    21.7 Diskless Operation
    21.8 ISDN
    21.9 NIS/YP
    21.10 DHCP
    21.11 DNS
    21.12 NTP
    21.13 Network Address Translation
    21.14 The '''inetd ''' ``Super-Server''
    21.15 Parallel Line IP (PLIP)
    21.16 IPv6
  22 Electronic Mail
  - 22.1 Synopsis
    22.2 Using Electronic Mail
    22.3 '''sendmail ''' Configuration
    22.4 Changing Your Mail Transfer Agent
    22.5 Troubleshooting
    22.6 Advanced Topics
    22.7 SMTP with UUCP
    22.8 Setting up to send only
    22.9 Using Mail with a Dialup Connection
    22.10 SMTP Authentication
    22.11 Mail User Agents
    22.12 Using fetchmail
    22.13 Using procmail
  23 Updating DragonFly
  - 23.1 Initial Setup
    23.2 Configuration
    23.3 Preparing to Update
    23.4 Updating the System
  24 Debug the DragonFly kernel
  - 24.1 Overview
    24.2 Configure your system
    24.3 Debug the crash dump
    24.4 Further information
  25 Linux Binary Compatibility
  - 25.1 Synopsis
    25.2 Installation
    25.3 Installing Mathematica ®
    25.4 Installing Maple ™
    25.5 Installing MATLAB ®
    25.6 Installing Oracle ®
    25.7 Installing SAP ® R/3 ®
    25.8 Advanced Topics
III. Appendices
1. Obtaining DragonFly
  - A.1 CDROM and DVD Publishers
    A.2 FTP Sites
    A.3 Using CVSup
    A.4 CVS Tags
  B. Bibliography
  - B.1 Books & Magazines Specific to BSD
    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
  List of Tables, Figures and examples