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