X-Git-Url: https://gitweb.dragonflybsd.org/ikiwiki.git/blobdiff_plain/a151adbdd3af9b9c1e54135ae0209da5c5fa0270..HEAD:/docs/handbook/index.mdwn diff --git a/docs/handbook/index.mdwn b/docs/handbook/index.mdwn index fa1b2d77..fe757f4c 100644 --- a/docs/handbook/index.mdwn +++ b/docs/handbook/index.mdwn @@ -1,295 +1,47 @@ -[[Copyright|handbook-LEGALNOTICE]] © 2004-2009 The DragonFly Documentation Project +## The DragonFly BSD Handbook -[[Copyright|handbook-LEGALNOTICE]] © 1995-2004 The FreeBSD Documentation Project +Copyright © 2009-2018 The DragonFly Project -**Notice: This is the old handbook and parts of it are out of date. Sections marked with an * are available in the [[New Handbook|docs/newhandbook]].** +Welcome to DragonFly BSD! 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. If you are interested in helping with this project, send email to the [DragonFly Documentation project mailing list](http://lists.dragonflybsd.org/). -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/). -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/). +1. [[Introduction|docs/handbook/Introduction]] -###Preface * ([[docs/newhandbook/GettingStarted]]) +1. [[Installation|docs/handbook/Installation]] - 1. [[Preface|handbook-book-preface]] - 1. [[Getting Started|handbook-getting-started]] +1. [[UNIX basics|docs/handbook/UnixBasics]] -###Chapter 1 Introduction * ([[docs/newhandbook/Introduction]]) +1. [[User management|docs/handbook/Users]] - 1. [[Synopsis|handbook-introduction]] - 1. [[Welcome to DragonFly!|handbook-nutshell]] - 1. [[About the DragonFly Project|handbook-history]] +1. [[Environment Quick Start|docs/handbook/Environmentquickstart]] -###Chapter 2 Installation * ([[docs/newhandbook/Installation]]) - - 1. [[Installation from CD|handbook-InstallDragonFlyFromCD]] - 1. [[First steps|handbook-InstallFirstSteps]] - 1. [[Disk setup|handbook-InstallDiskSetup]] - 1. [[Installing to Disk from CD|handbook-InstallToDisk]] - 1. [[New system setup|handbook-InstallationSystemSetup]] +1. [[Upgrading|docs/handbook/Upgrading]] -###Chapter 3 UNIX Basics * ([[docs/newhandbook/UnixBasics]]) +1. [[Configure a custom kernel|docs/handbook/ConfigureKernel]] - 1. [[Synopsis|handbook-basics]] - 1. [[Virtual Consoles and Terminals|handbook-consoles]] - 1. [[Permissions|handbook-permissions]] - 1. [[Directory Structure|handbook-dirstructure]] - 1. [[Disk Organization|handbook-disk-organization]] - 1. [[Mounting and Unmounting File Systems|handbook-mount-unmount]] - 1. [[Processes|handbook-basics-processes]] - 1. [[Daemons, Signals, and Killing Processes|handbook-basics-daemons]] - 1. [[Shells|handbook-shells]] - 1. [[Text Editors|handbook-editors]] - 1. [[Devices and Device Nodes|handbook-basics-devices]] - 1. [[Binary Formats|handbook-binary-formats]] - 1. [[For More Information|handbook-basics-more-information]] +1. [[General Machine/HW Configuration|docs/handbook/Configuration]] -###Chapter 4 [[Installing Applications|docs/howtos/HowToPkgsrc]] +1. [[Specific Machine/HW Configuration|docs/handbook/SpecificMachineConfig]] +* Chromebook, NUC setup, etc. +* Misc laptops +* Ryzen and Threadripper -###Chapter 5 The X Window System * ([[docs/newhandbook/X]]) +1. [[Install DPorts applications|docs/howtos/HowToDPorts]] - 1. [[Synopsis|handbook-x11]] - 1. [[Understanding X|handbook-x-understanding]] - 1. [[Installing X11|handbook-x-install]] - 1. [[X11 Configuration|handbook-x-config]] - 1. [[Using Fonts in X11|handbook-x-fonts]] - 1. [[The X Display Manager|handbook-x-xdm]] - 1. [[Desktop Environments|handbook-x11-wm]] - 1. [[System Administration|handbook-system-administration]] +1. [[Switch Mail Transfer Agent|handbook/mta]] -###Chapter 6 UNIX Configuring and Tuning * ([[docs/newhandbook/Configuration]]) +1. [[Connect to wireless network|docs/newhandbook/WirelessNetwork]] - 1. [[Synopsis|handbook-config-tuning]] - 1. [[Initial Configuration|handbook-configtuning-initial]] - 1. [[Core Configuration|handbook-configtuning-core-configuration]] - 1. [[Application Configuration|handbook-configtuning-appconfig]] - 1. [[Starting Services|handbook-configtuning-starting-services]] - 1. [[Configuring the cron Utility|handbook-configtuning-cron]] - 1. [[Using rc under DragonFly|handbook-configtuning-rcng]] - 1. [[Setting Up Network Interface Cards|handbook-config-network-setup]] - 1. [[Virtual Hosts|handbook-configtuning-virtual-hosts]] - 1. [[Configuration Files|handbook-configtuning-configfiles]] - 1. [[Tuning with sysctl|handbook-configtuning-sysctl]] - 1. [[Tuning Disks|handbook-configtuning-disk]] - 1. [[Tuning Kernel Limits|handbook-configtuning-kernel-limits]] - 1. [[Adding Swap Space|handbook-adding-swap-space]] - 1. [[Power and Resource Management|handbook-acpi-overview]] - 1. [[Using and Debugging DragonFly ACPI|handbook-acpi-debug]] +1. [[X Window Environment|docs/handbook/X]] -###Chapter 7 The DragonFly virtual kernel * ([[docs/newhandbook/vkernel]]) - - 1. [[The DragonFly virtual kernel|docs/user/VKernelOverview]] - 1. [[Setup a virtual kernel environment|docs/user/VKernelSetup]] - 1. [[Setup networking|docs/user/VKernelNetwork]] - 1. [[Run a virtual kernel|docs/user/VKernelRun]] +1. [[DragonFly Virtual Kernel|docs/handbook/vkernel]] -###Chapter 8 The DragonFly Booting Process * ([[docs/newhandbook/Booting]]) +1. [[DragonFly boot process|docs/handbook/Booting]] - 1. [[Synopsis|handbook-boot]] - 1. [[The Booting Problem|handbook-boot-introduction]] - 1. [[The Boot Manager and Boot Stages|handbook-boot-blocks]] - 1. [[Kernel Interaction During Boot|handbook-boot-kernel]] - 1. [[Init: Process Control Initialization|handbook-boot-init]] - 1. [[Shutdown Sequence|handbook-boot-shutdown]] +1. [[Security|docs/handbook/Security]] -###Chapter 9 Users and Basic Account Management * ([[docs/newhandbook/Users]]) +1. [[Jails|docs/handbook/Jails]] - 1. [[Synopsis|handbook-users]] - 1. [[Introduction|handbook-users-introduction]] - 1. [[The Superuser Account|handbook-users-superuser]] - 1. [[System Accounts|handbook-users-system]] - 1. [[User Accounts|handbook-users-user]] - 1. [[Modifying Accounts|handbook-users-modifying]] - 1. [[Limiting Users|handbook-users-limiting]] - 1. [[Personalizing Users|handbook-users-personalizing]] - 1. [[Groups|handbook-users-groups]] +1. [[Serial Communications|docs/newhandbook/serial communications]] -###Chapter 10 Configuring the DragonFly Kernel * ([[docs/newhandbook/ConfigureKernel]]) - - 1. [[Synopsis|handbook-kernelconfig]] - 1. [[Why Build a Custom Kernel?|handbook-kernelconfig-custom-kernel]] - 1. [[Building and Installing a Custom Kernel|handbook-kernelconfig-building]] - 1. [[The Configuration File|handbook-kernelconfig-config]] - 1. [[Making Device Nodes|handbook-kernelconfig-nodes]] - 1. [[If Something Goes Wrong|handbook-kernelconfig-trouble]] - -###Chapter 11 Security * ([[docs/newhandbook/Security]]) - - 1. [[Synopsis|handbook-security]] - 1. [[Introduction|handbook-security-intro]] - 1. [[Securing DragonFly|handbook-securing-freebsd]] - 1. [[DES, MD5, and Crypt|handbook-crypt]] - 1. [[One-time Passwords|handbook-one-time-passwords]] - 1. [['''Kerberos5'''|handbook-kerberos5]] - 1. [[Firewalls|handbook-firewalls]] - 1. [[OpenSSL|handbook-openssl]] - 1. [[VPN over IPsec|handbook-ipsec]] - 1. [[OpenSSH|handbook-openssh]] - -###Chapter 12 Jails * ([[docs/newhandbook/Jails]]) - - 1. [[Synopsis|handbook-jails]] - 1. [[Terms Related to Jails|handbook-jails-terms]] - 1. [[Introduction|handbook-jails-intro]] - 1. [[Creating and Controlling Jails|handbook-jails-build]] - 1. [[Fine Tuning and Administration|handbook-jails-tuning]] - -###Chapter 13 Printing - - 1. [[Synopsis|handbook-printing]] - 1. [[Introduction|handbook-printing-intro-spooler]] - 1. [[Basic Setup|handbook-printing-intro-setup]] - 1. [[Advanced Printer Setup|handbook-printing-advanced]] - 1. [[Using Printers|handbook-printing-using]] - 1. [[Alternatives to the Standard Spooler|handbook-printing-lpd-alternatives]] - 1. [[Troubleshooting|handbook-printing-troubleshooting]] - -###Chapter 14 Storage - - 1. [[Synopsis|handbook-disks]] - 1. [[Device Names|handbook-disks-naming]] - 1. [[Adding Disks|handbook-disks-adding]] - 1. [[RAID|handbook-raid]] - 1. [[Creating and Using Optical Media (CDs)|handbook-creating-cds]] - 1. [[Creating and Using Optical Media (DVDs)|handbook-creating-dvds]] - 1. [[Creating and Using Floppy Disks|handbook-floppies]] - 1. [[Creating and Using Data Tapes|handbook-backups-tapebackups]] - 1. [[Backups to Floppies|handbook-backups-floppybackups]] - 1. [[Backup Basics|handbook-backup-basics]] - 1. [[Network, Memory, and File-Backed File Systems|handbook-disks-virtual]] - 1. [[File System Quotas|handbook-quotas]] - -###Chapter 15 The Vinum Volume Manager - - 1. [[Synopsis|handbook-vinum-vinum]] - 1. [[Disks Are Too Small|handbook-vinum-intro]] - 1. [[Access Bottlenecks|handbook-vinum-access-bottlenecks]] - 1. [[Data Integrity|handbook-vinum-data-integrity]] - 1. [[Vinum Objects|handbook-vinum-objects]] - 1. [[Some Examples|handbook-vinum-examples]] - 1. [[Object Naming|handbook-vinum-object-naming]] - 1. [[Configuring Vinum|handbook-vinum-config]] - 1. [[Using Vinum for the Root Filesystem|handbook-vinum-root]] - -###Chapter 16 Localization - I18N/L10N Usage and Setup - - 1. [[Synopsis|handbook-l10n]] - 1. [[The Basics|handbook-l10n-basics]] - 1. [[Using Localization|handbook-using-localization]] - 1. [[Compiling I18N Programs|handbook-l10n-compiling]] - 1. [[Localizing DragonFly to Specific Languages|handbook-lang-setup]] - -###Chapter 17 Desktop Applications - - 1. [[Synopsis|handbook-desktop]] - 1. [[Browsers|handbook-desktop-browsers]] - 1. [[Productivity|handbook-desktop-productivity]] - 1. [[Document Viewers|handbook-desktop-viewers]] - 1. [[Finance|handbook-desktop-finance]] - 1. [[Summary|handbook-desktop-summary]] - -###Chapter 18 Multimedia - - 1. [[Synopsis|handbook-multimedia]] - 1. [[Setting Up the Sound Card|handbook-sound-setup]] - 1. [[MP3 Audio|handbook-sound-mp3]] - 1. [[Video Playback|handbook-video-playback]] - 1. [[Setting Up TV Cards|handbook-tvcard]] - -###Chapter 19 Serial Communications - - 1. [[Synopsis|handbook-serialcomms]] - 1. [[Introduction|handbook-serial]] - 1. [[Terminals|handbook-term]] - 1. [[Dial-in Service|handbook-dialup]] - 1. [[Dial-out Service|handbook-dialout]] - 1. [[Setting Up the Serial Console|handbook-serialconsole-setup]] - -### Chapter 20 PPP and SLIP - - 1. [[Synopsis|handbook-ppp-and-slip]] - 1. [[Using User PPP|handbook-userppp]] - 1. [[Using Kernel PPP|handbook-ppp]] - 1. [[Troubleshooting PPP Connections|handbook-ppp-troubleshoot]] - 1. [[Using PPP over Ethernet (PPPoE)|handbook-pppoe]] - 1. [[Using SLIP|handbook-slip]] - -### Chapter 21 Advanced Networking - - 1. [[Synopsis|handbook-advanced-networking]] - 1. [[Gateways and Routes|handbook-network-routing]] - 1. [[Wireless Networking|handbook-network-wireless]] - 1. [[Bluetooth|handbook-network-bluetooth]] - 1. [[Bridging|handbook-network-bridging]] - 1. [[NFS|handbook-network-nfs]] - 1. [[Diskless Operation|handbook-network-diskless]] - 1. [[ISDN|handbook-network-isdn]] - 1. [[NIS/YP|handbook-network-nis]] - 1. [[DHCP|handbook-network-dhcp]] - 1. [[DNS|handbook-network-dns]] - 1. [[NTP|handbook-network-ntp]] - 1. [[Network Address Translation|handbook-network-natd]] - 1. [[The '''inetd ''' **Super-Server**|handbook-network-inetd]] - 1. [[Parallel Line IP (PLIP)|handbook-network-plip]] - 1. [[IPv6|handbook-network-ipv6]] - -###Chapter 22 Electronic Mail - - 1. [[Synopsis|handbook-mail]] - 1. [[Using Electronic Mail|handbook-mail-using]] - 1. [['''sendmail ''' Configuration|handbook-sendmail]] - 1. [[Changing Your Mail Transfer Agent|handbook-mail-changingmta]] - 1. [[Troubleshooting|handbook-mail-trouble]] - 1. [[Advanced Topics|handbook-mail-advanced]] - 1. [[SMTP with UUCP|handbook-smtp-uucp]] - 1. [[Setting up to send only|handbook-outgoing-only]] - 1. [[Using Mail with a Dialup Connection|handbook-smtp-dialup]] - 1. [[SMTP Authentication|handbook-smtp-auth]] - 1. [[Mail User Agents|handbook-mail-agents]] - 1. [[Using fetchmail|handbook-mail-fetchmail]] - 1. [[Using procmail|handbook-mail-procmail]] - -###Chapter 23 Updating DragonFly - - 1. [[Initial Setup|handbook-updating]] - 1. [[Configuration|handbook-updating-using]] - 1. [[Preparing to Update|handbook-updating-before-building]] - 1. [[Updating the System|handbook-updating-makeworld]] - -###Chapter 24 Debug the DragonFly kernel - - 1. [[Debug the DragonFly kernel|docs/user/DebugKernelCrashDumps]] - 1. [[Configure your system|docs/user/DebugKernelCrashDumps#head-c7f19c562c575c26006f6b7cce69df26e2873bc9]] - 1. [[Debug the crash dump|docs/user/DebugKernelCrashDumps#head-f2abcea0beb4c42a93034c32e6209064484c2900]] - 1. [[Further information|docs/user/DebugKernelCrashDumps#head-e306fd7a51d5b330b0e770f96a6796e28c5ce0df]] - -###Chapter 25 Linux Binary Compatibility - - 1. [[Synopsis|handbook-linuxemu]] - 1. [[Installation|handbook-linuxemu-lbc-install]] - 1. [[Installing Mathematica ®|handbook-linuxemu-mathematica]] - 1. [[Installing Maple ®|handbook-linuxemu-maple]] - 1. [[Installing MATLAB $reg;|handbook-linuxemu-matlab]] - 1. [[Installing Oracle $reg;|handbook-linuxemu-oracle]] - 1. [[Installing SAP ® R/3 ®|handbook-sapr3]] - 1. [[Advanced Topics|handbook-linuxemu-advanced]] - -###Appendices - - 1. [[Appendices|handbook-appendices]] - 1. [[Obtaining DragonFly|handbook-mirrors]] - 1. [[CDROM and DVD Publishers|handbook-mirrors]] - 1. [[Mirror Sites|mirrors/]] - 1. [[Bibliography|handbook-bibliography]] - 1. [[Books and Magazines Specific to BSD|handbook-bibliography]] - 1. [[Users' Guides|handbook-bibliography-userguides]] - 1. [[Administrators' Guides|handbook-bibliography-adminguides]] - 1. [[Programmers' Guides|handbook-bibliography-programmers]] - 1. [[Operating System Internals|handbook-bibliography-osinternals]] - 1. [[Security Reference|handbook-bibliography-security]] - 1. [[Hardware Reference|handbook-bibliography-hardware]] - 1. [[UNIX ® History|handbook-bibliography-history]] - 1. [[Magazines and Journals|handbook-bibliography-journals]] - 1. [[Resources on the Internet|handbook-eresources]] - 1. [[Mailing Lists|mailinglists/]] - 1. [[Usenet Newsgroups|handbook-eresources-news]] - 1. [[World Wide Web Servers|handbook-eresources-web]] +1. [[Running a Browser Securely|docs/handbook/RunSecureBrowser]]