docs/handbook/index.mdwn

   1 [[Copyright|handbook-LEGALNOTICE]] &copy; 2004-2009 The DragonFly Documentation Project
   2
   3 [[Copyright|handbook-LEGALNOTICE]] &copy; 1995-2004 The FreeBSD Documentation Project
   4
   5 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](http://leaf.dragonflybsd.org/mailarchive/).
   6
   7 Portions of this document originally documented use of the [FreeBSD](http://www.freebsd.org/) 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](http://leaf.dragonflybsd.org/mailarchive/).
   8
   9 ###Preface
  10
  11    1. [[Preface|handbook-book-preface]]
  12    1. [[Getting Started|handbook-getting-started]]
  13
  14 ###Chapter 1 Introduction
  15
  16    1. [[Synopsis|handbook-introduction]]
  17    1. [[Welcome to DragonFly!|handbook-nutshell]]
  18    1. [[About the DragonFly Project|handbook-history]]
  19
  20 ###Chapter 2 Installation
  21
  22    1. [[Installation from CD|handbook-InstallDragonFlyFromCD]]
  23    1. [[First steps|handbook-InstallFirstSteps]]
  24    1. [[Disk setup|handbook-InstallDiskSetup]]
  25    1. [[Installing to Disk from CD|handbook-InstallToDisk]]
  26    1. [[New system setup|handbook-InstallationSystemSetup]]
  27
  28 ###Chapter 3 UNIX Basics
  29
  30    1. [[Synopsis|handbook-basics]]
  31    1. [[Virtual Consoles and Terminals|handbook-consoles]]
  32    1. [[Permissions|handbook-permissions]]
  33    1. [[Directory Structure|handbook-dirstructure]]
  34    1. [[Disk Organization|handbook-disk-organization]]
  35    1. [[Mounting and Unmounting File Systems|handbook-mount-unmount]]
  36    1. [[Processes|handbook-basics-processes]]
  37    1. [[Daemons, Signals, and Killing Processes|handbook-basics-daemons]]
  38    1. [[Shells|handbook-shells]]
  39    1. [[Text Editors|handbook-editors]]
  40    1. [[Devices and Device Nodes|handbook-basics-devices]]
  41    1. [[Binary Formats|handbook-binary-formats]]
  42    1. [[For More Information|handbook-basics-more-information]]
  43
  44 ###Chapter 4 Installing Applications
  45
  46    1. [[Synopsis|handbook-pkgsrc]]
  47    1. [[Overview of Software Installation|handbook-pkgsrc-overview]]
  48    1. [[Finding Your Application|handbook-pkgsrc-finding-applications]]
  49    1. [[Using the Binary Packages System|handbook-pkgsrc-using]]
  50    1. [[Using the pkgsrc Source Tree|handbook-pkgsrc-sourcetree-using]]
  51    1. [[Post-installation Activities|handbook-pkgsrc-nextsteps]]
  52    1. [[Dealing with Broken Packages|handbook-pkgsrc-broken]]
  53
  54 ###Chapter 5 The X Window System
  55
  56    1. [[Synopsis|handbook-x11]]
  57    1. [[Understanding X|handbook-x-understanding]]
  58    1. [[Installing X11|handbook-x-install]]
  59    1. [[X11 Configuration|handbook-x-config]]
  60    1. [[Using Fonts in X11|handbook-x-fonts]]
  61    1. [[The X Display Manager|handbook-x-xdm]]
  62    1. [[Desktop Environments|handbook-x11-wm]]
  63    1. [[System Administration|handbook-system-administration]]
  64
  65 ###Chapter 6 UNIX Configuring and Tuning
  66
  67    1. [[Synopsis|handbook-config-tuning]]
  68    1. [[Initial Configuration|handbook-configtuning-initial]]
  69    1. [[Core Configuration|handbook-configtuning-core-configuration]]
  70    1. [[Application Configuration|handbook-configtuning-appconfig]]
  71    1. [[Starting Services|handbook-configtuning-starting-services]]
  72    1. [[Configuring the cron Utility|handbook-configtuning-cron]]
  73    1. [[Using rc under DragonFly|handbook-configtuning-rcng]]
  74    1. [[Setting Up Network Interface Cards|handbook-config-network-setup]]
  75    1. [[Virtual Hosts|handbook-configtuning-virtual-hosts]]
  76    1. [[Configuration Files|handbook-configtuning-configfiles]]
  77    1. [[Tuning with sysctl|handbook-configtuning-sysctl]]
  78    1. [[Tuning Disks|handbook-configtuning-disk]]
  79    1. [[Tuning Kernel Limits|handbook-configtuning-kernel-limits]]
  80    1. [[Adding Swap Space|handbook-adding-swap-space]]
  81    1. [[Power and Resource Management|handbook-acpi-overview]]
  82    1. [[Using and Debugging DragonFly ACPI|handbook-acpi-debug]]
  83
  84 ###Chapter 7 The DragonFly virtual kernel
  85
  86    1. [[The DragonFly virtual kernel|docs/user/list/VKernelOverview]]
  87    1. [[Setup a virtual kernel environment|docs/user/list/VKernelSetup]]
  88    1. [[Setup networking|docs/user/list/VKernelNetwork]]
  89    1. [[Run a virtual kernel|docs/user/list/VKernelRun]]
  90
  91 ###Chapter 8 The DragonFly Booting Process
  92
  93    1. [[Synopsis|handbook-boot]]
  94    1. [[The Booting Problem|handbook-boot-introduction]]
  95    1. [[The Boot Manager and Boot Stages|handbook-boot-blocks]]
  96    1. [[Kernel Interaction During Boot|handbook-boot-kernel]]
  97    1. [[Init: Process Control Initialization|handbook-boot-init]]
  98    1. [[Shutdown Sequence|handbook-boot-shutdown]]
  99
 100 ###Chapter 9 Users and Basic Account Management
 101
 102    1. [[Synopsis|handbook-users]]
 103    1. [[Introduction|handbook-users-introduction]]
 104    1. [[The Superuser Account|handbook-users-superuser]]
 105    1. [[System Accounts|handbook-users-system]]
 106    1. [[User Accounts|handbook-users-user]]
 107    1. [[Modifying Accounts|handbook-users-modifying]]
 108    1. [[Limiting Users|handbook-users-limiting]]
 109    1. [[Personalizing Users|handbook-users-personalizing]]
 110    1. [[Groups|handbook-users-groups]]
 111
 112 ###Chapter 10 Configuring the DragonFly Kernel
 113
 114    1. [[Synopsis|handbook-kernelconfig]]
 115    1. [[Why Build a Custom Kernel?|handbook-kernelconfig-custom-kernel]]
 116    1. [[Building and Installing a Custom Kernel|handbook-kernelconfig-building]]
 117    1. [[The Configuration File|handbook-kernelconfig-config]]
 118    1. [[Making Device Nodes|handbook-kernelconfig-nodes]]
 119    1. [[If Something Goes Wrong|handbook-kernelconfig-trouble]]
 120
 121 ###Chapter 11 Security
 122
 123    1. [[Synopsis|handbook-security]]
 124    1. [[Introduction|handbook-security-intro]]
 125    1. [[Securing DragonFly|handbook-securing-freebsd]]
 126    1. [[DES, MD5, and Crypt|handbook-crypt]]
 127    1. [[One-time Passwords|handbook-one-time-passwords]]
 128    1. [['''Kerberos5'''|handbook-kerberos5]]
 129    1. [[Firewalls|handbook-firewalls]]
 130    1. [[OpenSSL|handbook-openssl]]
 131    1. [[VPN over IPsec|handbook-ipsec]]
 132    1. [[OpenSSH|handbook-openssh]]
 133
 134 ###Chapter 12 Jails
 135
 136    1. [[Synopsis|handbook-jails]]
 137    1. [[Terms Related to Jails|handbook-jails-terms]]
 138    1. [[Introduction|handbook-jails-intro]]
 139    1. [[Creating and Controlling Jails|handbook-jails-build]]
 140    1. [[Fine Tuning and Administration|handbook-jails-tuning]]
 141
 142 ###Chapter 13 Printing
 143
 144    1. [[Synopsis|handbook-printing]]
 145    1. [[Introduction|handbook-printing-intro-spooler]]
 146    1. [[Basic Setup|handbook-printing-intro-setup]]
 147    1. [[Advanced Printer Setup|handbook-printing-advanced]]
 148    1. [[Using Printers|handbook-printing-using]]
 149    1. [[Alternatives to the Standard Spooler|handbook-printing-lpd-alternatives]]
 150    1. [[Troubleshooting|handbook-printing-troubleshooting]]
 151
 152 ###Chapter 14 Storage
 153
 154    1. [[Synopsis|handbook-disks]]
 155    1. [[Device Names|handbook-disks-naming]]
 156    1. [[Adding Disks|handbook-disks-adding]]
 157    1. [[RAID|handbook-raid]]
 158    1. [[Creating and Using Optical Media (CDs)|handbook-creating-cds]]
 159    1. [[Creating and Using Optical Media (DVDs)|handbook-creating-dvds]]
 160    1. [[Creating and Using Floppy Disks|handbook-floppies]]
 161    1. [[Creating and Using Data Tapes|handbook-backups-tapebackups]]
 162    1. [[Backups to Floppies|handbook-backups-floppybackups]]
 163    1. [[Backup Basics|handbook-backup-basics]]
 164    1. [[Network, Memory, and File-Backed File Systems|handbook-disks-virtual]]
 165    1. [[File System Quotas|handbook-quotas]]
 166
 167 ###Chapter 15 The Vinum Volume Manager
 168
 169    1. [[Synopsis|handbook-vinum-vinum]]
 170    1. [[Disks Are Too Small|handbook-vinum-intro]]
 171    1. [[Access Bottlenecks|handbook-vinum-access-bottlenecks]]
 172    1. [[Data Integrity|handbook-vinum-data-integrity]]
 173    1. [[Vinum Objects|handbook-vinum-objects]]
 174    1. [[Some Examples|handbook-vinum-examples]]
 175    1. [[Object Naming|handbook-vinum-object-naming]]
 176    1. [[Configuring Vinum|handbook-vinum-config]]
 177    1. [[Using Vinum for the Root Filesystem|handbook-vinum-root]]
 178
 179 ###Chapter 16 Localization - I18N/L10N Usage and Setup
 180
 181    1. [[Synopsis|handbook-l10n]]
 182    1. [[The Basics|handbook-l10n-basics]]
 183    1. [[Using Localization|handbook-using-localization]]
 184    1. [[Compiling I18N Programs|handbook-l10n-compiling]]
 185    1. [[Localizing DragonFly to Specific Languages|handbook-lang-setup]]
 186
 187 ###Chapter 17 Desktop Applications
 188
 189    1. [[Synopsis|handbook-desktop]]
 190    1. [[Browsers|handbook-desktop-browsers]]
 191    1. [[Productivity|handbook-desktop-productivity]]
 192    1. [[Document Viewers|handbook-desktop-viewers]]
 193    1. [[Finance|handbook-desktop-finance]]
 194    1. [[Summary|handbook-desktop-summary]]
 195
 196 ###Chapter 18 Multimedia
 197
 198    1. [[Synopsis|handbook-multimedia]]
 199    1. [[Setting Up the Sound Card|handbook-sound-setup]]
 200    1. [[MP3 Audio|handbook-sound-mp3]]
 201    1. [[Video Playback|handbook-video-playback]]
 202    1. [[Setting Up TV Cards|handbook-tvcard]]
 203
 204 ###Chapter 19 Serial Communications
 205
 206    1. [[Synopsis|handbook-serialcomms]]
 207    1. [[Introduction|handbook-serial]]
 208    1. [[Terminals|handbook-term]]
 209    1. [[Dial-in Service|handbook-dialup]]
 210    1. [[Dial-out Service|handbook-dialout]]
 211    1. [[Setting Up the Serial Console|handbook-serialconsole-setup]]
 212
 213 ### Chapter 20 PPP and SLIP
 214
 215    1. [[Synopsis|handbook-ppp-and-slip]]
 216    1. [[Using User PPP|handbook-userppp]]
 217    1. [[Using Kernel PPP|handbook-ppp]]
 218    1. [[Troubleshooting PPP Connections|handbook-ppp-troubleshoot]]
 219    1. [[Using PPP over Ethernet (PPPoE)|handbook-pppoe]]
 220    1. [[Using SLIP|handbook-slip]]
 221
 222 ### Chapter 21 Advanced Networking
 223
 224    1. [[Synopsis|handbook-advanced-networking]]
 225    1. [[Gateways and Routes|handbook-network-routing]]
 226    1. [[Wireless Networking|handbook-network-wireless]]
 227    1. [[Bluetooth|handbook-network-bluetooth]]
 228    1. [[Bridging|handbook-network-bridging]]
 229    1. [[NFS|handbook-network-nfs]]
 230    1. [[Diskless Operation|handbook-network-diskless]]
 231    1. [[ISDN|handbook-network-isdn]]
 232    1. [[NIS/YP|handbook-network-nis]]
 233    1. [[DHCP|handbook-network-dhcp]]
 234    1. [[DNS|handbook-network-dns]]
 235    1. [[NTP|handbook-network-ntp]]
 236    1. [[Network Address Translation|handbook-network-natd]]
 237    1. [[The '''inetd ''' **Super-Server**|handbook-network-inetd]]
 238    1. [[Parallel Line IP (PLIP)|handbook-network-plip]]
 239    1. [[IPv6|handbook-network-ipv6]]
 240
 241 ###Chapter 22 Electronic Mail
 242
 243    1. [[Synopsis|handbook-mail]]
 244    1. [[Using Electronic Mail|handbook-mail-using]]
 245    1. [['''sendmail ''' Configuration|handbook-sendmail]]
 246    1. [[Changing Your Mail Transfer Agent|handbook-mail-changingmta]]
 247    1. [[Troubleshooting|handbook-mail-trouble]]
 248    1. [[Advanced Topics|handbook-mail-advanced]]
 249    1. [[SMTP with UUCP|handbook-smtp-uucp]]
 250    1. [[Setting up to send only|handbook-outgoing-only]]
 251    1. [[Using Mail with a Dialup Connection|handbook-smtp-dialup]]
 252    1. [[SMTP Authentication|handbook-smtp-auth]]
 253    1. [[Mail User Agents|handbook-mail-agents]]
 254    1. [[Using fetchmail|handbook-mail-fetchmail]]
 255    1. [[Using procmail|handbook-mail-procmail]]
 256
 257 ###Chapter 23 Updating DragonFly
 258
 259    1. [[Initial Setup|handbook-updating]]
 260    1. [[Configuration|handbook-updating-using]]
 261    1. [[Preparing to Update|handbook-updating-before-building]]
 262    1. [[Updating the System|handbook-updating-makeworld]]
 263
 264 ###Chapter 24 Debug the DragonFly kernel
 265
 266    1. [[Debug the DragonFly kernel|docs/user/list/DebugKernelCrashDumps]]
 267    1. [[Configure your system|docs/user/list/DebugKernelCrashDumps#head-c7f19c562c575c26006f6b7cce69df26e2873bc9]]
 268    1. [[Debug the crash dump|docs/user/list/DebugKernelCrashDumps#head-f2abcea0beb4c42a93034c32e6209064484c2900]]
 269    1. [[Further information|docs/user/list/DebugKernelCrashDumps#head-e306fd7a51d5b330b0e770f96a6796e28c5ce0df]]
 270
 271 ###Chapter 25 Linux Binary Compatibility
 272
 273    1. [[Synopsis|handbook-linuxemu]]
 274    1. [[Installation|handbook-linuxemu-lbc-install]]
 275    1. [[Installing Mathematica &reg;|handbook-linuxemu-mathematica]]
 276    1. [[Installing Maple &reg;|handbook-linuxemu-maple]]
 277    1. [[Installing MATLAB $reg;|handbook-linuxemu-matlab]]
 278    1. [[Installing Oracle $reg;|handbook-linuxemu-oracle]]
 279    1. [[Installing SAP &reg;  R/3 &reg;|handbook-sapr3]]
 280    1. [[Advanced Topics|handbook-linuxemu-advanced]]
 281
 282 ###Appendices
 283
 284    1. [[Appendices|handbook-appendices]]
 285    1. [[Obtaining DragonFly|handbook-mirrors]]
 286    1. [[CDROM and DVD Publishers|handbook-mirrors]]
 287    1. [[FTP Sites|handbook-mirrors-ftp]]
 288    1. [[Using CVSup|handbook-cvsup]]
 289    1. [[CVS Tags|handbook-cvs-tags]]
 290    1. [[Bibliography|handbook-bibliography]]
 291    1. [[Books and Magazines Specific to BSD|handbook-bibliography]]
 292    1. [[Users' Guides|handbook-bibliography-userguides]]
 293    1. [[Administrators' Guides|handbook-bibliography-adminguides]]
 294    1. [[Programmers' Guides|handbook-bibliography-programmers]]
 295    1. [[Operating System Internals|handbook-bibliography-osinternals]]
 296    1. [[Security Reference|handbook-bibliography-security]]
 297    1. [[Hardware Reference|handbook-bibliography-hardware]]
 298    1. [[UNIX &reg; History|handbook-bibliography-history]]
 299    1. [[Magazines and Journals|handbook-bibliography-journals]]
 300    1. [[Resources on the Internet|handbook-eresources]]
 301    1. [[Mailing Lists|handbook-eresources]]
 302    1. [[Usenet Newsgroups|handbook-eresources-news]]
 303    1. [[World Wide Web Servers|handbook-eresources-web]]