Added dfly config walkthrough, removed deprecated walkthrough
[ikiwiki.git] / varialus / index.mdwn
index 8b8ad8c..3fcb34f 100644 (file)
 # et
 # Anisoptera
-*The following is an unpaid personal wiki page. The views and opinions expressed herein do not necessarily reflect those of the DragonFly BSD mascot nor its management.*
-### Various Tidbits
-* **Hammer** is hands down the best file system currently in existence. **DragonFly BSD** is an awesome operating system, but it's a bit rough around the edges for everyday use. I would like DragonFly to be easier to use so that my everyday desktop environment can use Hammer.
-* **[Dissonance](https://bitbucket.org/varialus/dissonance)** is my fork of Apache Harmony, which is a clean room implementation of Java with a permissive license. Apache gave up because they couldn't license the Java compatibility testing framework. If Oracle isn't going to provide the compatibility testing framework, then the community should write its own compatibility framework that's better than the official one. This would cause dissonance between Oracle and the community, but that's no reason to not pursue it. I'd like to get Dissonance running on DragonFly.
-* **[Jython](http://www.jython.org/)** is Python written in Java. It's cool. But it's not installed in DragonFly by default.
-* **ee** is roughly equivalent to **nano**. They are both easy to use command line text editors. The exit option will ask you whether you want to save and you can get to it by pressing Ctrl-[ and selecting 'a) leave editor'. It would be cool if there was a shortcut to ee named nano.
-* **pkgin** is roughly equivalent to **apt-get**. They are both fairly straightforward command line package management utilities. It would be cool if there was a shortcut to pkgin named apt-get.
-
-### Various Issues
+*The following is an unpaid personal wiki page about my experiences, issues, and workarounds related to DragonFly BSD.*
+
+## Table of Contents
+
+1. **Featured**
+
+* Walkthrough of DragonFly BSD Installation and Configuration
+* (Not Yet Started) Walkthrough of Xfce Installation and Configuration
+* (Not Yet Started) Walkthrough of Applications Installation and Configuration
+* (Not Yet Started) Walkthrough of C and Go Development Environment Installation and Configuration
+
+2. **Tidbits**
+
+* Shell/Console/Command-Line-Prompt: tcsh/bash, ctrl-d/tab-tab, partial-previous-command-up-key/ctrl-r-partial-previous-command, rehash
+* Package-Management: pkgin/apt-get
+* Administration/root su/sudo/wheel
+* Text-Editor: vi :q!
+* Manual: man man
+* Networking: hosts
+* Power-Down: shutdown -p now
+* File-System: Hammer
+* Operating System: DragonFly BSD
+* Graphical-User-Interface: Xfce
+* Programming: Dissonance/Apache Harmony
+* Programming: Jython/Python
+* Text-Editor: ee/nano
+* Networking: Debian resolv.conf
+
+3. **Issues**
+
+* Disclaimer
+* Default GUI Too Bare
+* Early Keyboard Selection
+* GUI Keyboard Selection
+* Encryption Keyboard Selection
+* Disabled Caps Lock in GUI
+* Random Key for Encrypted Swap
+* Stay Decrypted for  Configuration
+* No Confirmation for Decryption
+* Plain Text Password in Install Log
+* USB Installation Media Named Uniquely
+* 3TB+ HD Install
+* Overwrite 3TB+ Partition Table
+* Lackluster Default Shell
+* Wiki Centered Text
+* XOrg Quit Errors
+
+4. **Workarounds**
+
+* Enable Caps Lock in GUI
+* Install Non-GUI on 3TB+ Hard Drive
+* Install Xfce 4.6 (Notes)
+* Install Xfce 4.8 (Stub)
+* Install Xfce 4.10 (Stub)
+* Set GUI Keyboard Layout
+
+5. **Contribute**
+
+* Port VirtualBox to DragonFly BSD
+* Port Xfce 4.10 to DragonFly BSD
+* DragonFly BSD Network Shares Walkthrough
+* Port bxpkg to DragonFly BSD
+
+6. **Not Yet Formatted Text Dump**
+
+* Project HAMMER Debian
+
+## Featured
+
+**Walkthrough of DragonFly BSD Installation and Configuration**
+
+This walkthrough describes how I install and configure DragonFly BSD. You should customize your installation as you see fit. The walkthrough is being run on VirtualBox which in turn is running on a recent MacBook with plenty of memory.
+
+1. Create a virtual machine in VirtualBox using the FreeBSD (64 bit) template with 4 GB memory, 128 GB dynamically allocated VDI virtual disk image
+
+2. Set the the virtual hardware clock set to UTC time.
+
+3. Download and extract the x86_64 CD [installation media](http://www.dragonflybsd.org/download/) and then add it to the virtual machine, but remember to remove it before taking VirtualBox snapshots.
+
+4. Start the virtual machine. Before it finishes booting, the will be greeted with the following boot menu.
+
+        
+        DragonFly/i386 bootstrap loader, Revision 1.1
+        (justin@pkgbox64.dragonflybsd.org, Mon Jun 16 21:33:12 PDT 2014)
+                                                   |
+        1. Boot DragonFly [kernel]                 |   ,--,           |           ,--,
+        2. Boot DragonFly in Safe Mode             |   |   `-,       ,^,       ,-'   |
+        3. Boot DragonFly without AHCI driver      |    `,    `-,   (/ \)   ,-'    ,'
+        4. Boot DragonFly without ACPI driver      |      `-,    `-,/   \,-'    ,-'
+        9. Escape to loader prompt (also ESC)      |         `------(   )------'
+        r. Boot DragonFly to a rescue ramdisk      |     ,----------(   )----------,
+        s. Boot DragonFly in single user mode      |    |        _,-(   )-,_        |
+        v. Boot DragonFly with verbose logging     |     `-,__,-'   \   /   `-,__,-'
+        R. Reboot                                  |                 | |
+                                                   |                 | |
+                                                   |                 | |
+                                                   |                 | |
+                                                   |                 | |
+                                                   |                 | |
+                                                   |                 `|'
+                                                   |
+        Booting in 10 seconds... _
+
+5. After the computer finishes booting, you will be greeted with the following welcome message and login prompt.
+
+        Welcome to DragonFly!
+        
+        To start the installer, login as 'installer'.  To just get a shell prompt,
+        login as 'root'.
+        
+        DragonFly/x86_64 (Amnesiac) (ttyv0)
+        
+        login: _
+
+6. Type 'installer' without quotes and press enter.
+
+7. The following menu will be displayed.
+
+        F10=Refresh Display                                                            .
+                                                                                       .
+                                                      ,--,           |           ,--,  .
+         ------------------------| Welcome to DragonFly BSD |------------------------- .
+        |                                                                             |.
+        | Welcome to the DragonFly BSD Live CD.                                       |.
+        |                                                                             |.
+        | DragonFly BSD is an efficient and elegant BSD Unix-derived operating        |.
+        | system.  For more information, see http://www.dragonflybsd.org              |.
+        |                                                                             |.
+        | From this CD, you can boot into DragonFly BSD ``live'' (without installing  |.
+        | it) to evaluate it, to install it manually, or to troubleshoot problems     |.
+        | with an existing installation, using either a command prompt or menu-driven |.
+        | utilities.                                                                  |.
+        |                                                                             |.
+        | Also, you can use this automated application to assist you in installing    |.
+        | DragonFly BSD on this computer and configuring it once it is installed.     |.
+        |                                                                             |.
+        |        < Install DragonFly BSD >_ < Configure an Installed System >         |.
+        |    < Live CD Utilities >  < Exit to Live CD >  < Reboot this Computer >     |.
+        |                     < Setup NetBoot Install Services >                      |.
+         ----------------------------------------------------------------------------- .
+                                                                                       .
+                                                                                       .
+        Install DragonFly BSD on a HDD or HDD partition on this computer               .
+
+8. The bottom line changes depending on which option is selected.
+
+9. Highlight the option < Install DragonFly BSD > and press enter.
+
+10. The following menu will be displayed.
+
+        F10=Refresh Display                                                            .
+                                                                                       .
+                                                      ,--,           |           ,--,  .
+                                                      |   `-,       ,^,       ,-'   |  .
+                                                       `,    `-,   (/ \)   ,-'    ,'   .
+         --------------------------| Begin Installation |----------------------------- .
+        |                                                                             |.
+        | This application will install DragonFly BSD on one of the hard disk drives  |.
+        | attached to this computer. It has been designed to make it easy to install  |.
+        | DragonFly BSD in the typical case. If you have special requirements that    |.
+        | are not addressed by this installer, or if you have problems using it, you  |.
+        | are welcome to install DragonFly BSD manually. To do so select Exit to Live |.
+        | CD, login as root, and follow the instructions given in the file /README .  |.
+        |                                                                             |.
+        | NOTE! As with any installation process, YOU ARE STRONGLY ENCOURAGED TO BACK |.
+        | UP ANY IMPORTANT DATA ON THIS COMPUTER BEFORE PROCEEDING!                   |.
+        |                                                                             |.
+        | < Install DragonFly BSD >_ < Return to Welcome Menu >  < Exit to Live CD >  |.
+         ----------------------------| Press F1 for Help |---------------------------- .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+
+11. Highlight the option < Install DragonFly BSD > and press enter.
+
+12. The following menu, specific to your hardware, will be displayed.
+
+        F10=Refresh Display                                                            .
+                                                                                       .
+                                                      ,--,           |           ,--,  .
+                                                      |   `-,       ,^,       ,-'   |  .
+                                                       `,    `-,   (/ \)   ,-'    ,'   .
+                                                         `-,    `-,/   \,-'    ,-'     .
+                                                            `------(   )------'        .
+                                                        ,----------(   )----------,    .
+                                                       |        _,-(   )-,_        |   .
+                 -----------------------| Select Disk |----------------------- _,-'    .
+                |                                                             |        .
+                | Select a disk on which to install DragonFly BSD             |        .
+                |                                                             |        .
+                | < ad0: 131072MB <VBOX HARDDISK 1.0> at ata0-master UDMA33 >_|        .
+                | < Return to Begin Installation >                            |        .
+                 -------------------------------------------------------------         .
+                                                                    `|'                .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+
+13. Highlight the disk on which to install DragonFly BSD and press Enter.
+
+14. The following menu will be displayed.
+
+        F10=Refresh Display                                                            .
+                                                                                       .
+                                                      ,--,           |           ,--,  .
+                                                      |   `-,       ,^,       ,-'   |  .
+                                                       `,    `-,   (/ \)   ,-'    ,'   .
+                                                         `-,    `-,/   \,-'    ,-'     .
+                                                            `------(   )------'        .
+                                                        ,----------(   )----------,    .
+               ------------------------| How Much Disk? |------------------------  |   .
+              |                                                                  |'    .
+              | Select how much of this disk you want to use for DragonFly BSD.  |     .
+              |                                                                  |     .
+              | ad0: 131072MB <VBOX HARDDISK 1.0> at ata0-master UDMA33          |     .
+              |                                                                  |     .
+              |            < Use Entire Disk >_ < Use Part of Disk >             |     .
+              |                    < Return to Select Disk >                     |     .
+               ------------------------------------------------------------------      .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+
+15. If you would like to use your entire disk, then highlight < Use Entire Disk > and press enter.
+
+16. The following menu will be displayed.
+
+        F10=Refresh Display                                                            .
+                                                                                       .
+                                                      ,--,           |           ,--,  .
+                                                      |   `-,       ,^,       ,-'   |  .
+                            ------| Are you absolutely sure? |------  \)   ,-'    ,'   .
+                           |                                        |  \,-'    ,-'     .
+                           | WARNING! ALL data in ALL partitions on |  )------'        .
+                           | the disk                               |  )----------,    .
+                           |                                        |  )-,_        |   .
+                           | ad0: 131072MB <VBOX HARDDISK 1.0> at   |  /   `-,__,-'    .
+                           | ata0-master UDMA33                     | |                .
+                           |                                        | |                .
+                           | will be IRREVOCABLY ERASED!            | |                .
+                           |                                        | |                .
+                           | Are you ABSOLUTELY SURE you wish to    | |                .
+                           | take this action? This is your LAST    | |                .
+                           | CHANCE to cancel!                      ||'                .
+                           |                                        |                  .
+                           |           < OK >_ < Cancel >           |                  .
+                            ----------------------------------------                   .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+
+17. If you are absolutely sure, highlight < OK > and press enter.
+
+18. The following menu will be displayed.
+
+        F10=Refresh Display                                                            .
+                                                                                       .
+                                                      ,--,           |           ,--,  .
+                                                      |   `-,       ,^,       ,-'   |  .
+                                                       `,    `-,   (/ \)   ,-'    ,'   .
+                                                         `-,    `-,/   \,-'    ,-'     .
+                                                            `------(   )------'        .
+                             -----------| Information |------------    )----------,    .
+                            |                                      |   )-,_        |   .
+                            | The disk                             |   /   `-,__,-'    .
+                            |                                      || |                .
+                            | ad0: 131072MB <VBOX HARDDISK 1.0> at || |                .
+                            | ata0-master UDMA33                   || |                .
+                            |                                      || |                .
+                            | was formatted.                       || |                .
+                            |                                      || |                .
+                            |                < OK >                |`|'                .
+                             --------------------------------------                    .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+
+19. Press enter.
+
+20. The following menu will be displayed.
+
+        F10=Refresh Display                                                            .
+                                                                                       .
+                                                      ,--,           |           ,--,  .
+                                                      |   `-,       ,^,       ,-'   |  .
+                                                       `,    `-,   (/ \)   ,-'    ,'   .
+                                                         `-,    `-,/   \,-'    ,-'     .
+                                                            `------(   )------'        .
+                   -----------------| Select file system |------------------ -----,    .
+                  |                                                         |      |   .
+                  | Please select the file system you want to use with      |,__,-'    .
+                  | DragonFly BSD.                                          |          .
+                  |                                                         |          .
+                  | HAMMER is the new DragonFly BSD file system. UFS is the |          .
+                  | traditional BSD file system.                            |          .
+                  |                                                         |          .
+                  | < Use HAMMER >_ < Use UFS >  < Return to Select Disk >  |          .
+                   ---------------------------------------------------------           .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+
+21. If you want to use HAMMER, and honestly why wouldn't you, then highlight HAMMER and press enter.
+
+22. The following menu will be displayed.
+
+        F10=Refresh Display                                                            .
+                                                                                       .
+                                                      ,--,           |           ,--,  .
+               --------------------| Create Subpartitions |---------------------    |  .
+              |                                                                 | ,'   .
+              | Set up the partitions (also knows as just `partitions' in       |'     .
+              | BSD tradition) you want to have on this primary partition. In   |      .
+              | most cases you should be fine with the default settings.        |-,    .
+              |                                                                 |  |   .
+              | For Capacity, use 'M' to indicate megabytes, 'G' to indicate    |-'    .
+              | gigabytes, and so on (up to 'E'.) A single '*' indicates 'use   |      .
+              | the remaining space on the primary partition'.                  |      .
+              |                                                                 |      .
+              | Mountpoint  Capacity  Encrypted                                 |      .
+              | [/boot_   ] [768M   ] [ ]     < Ins > < Del >                   |      .
+              | [swap     ] [8192M  ] [ ]     < Ins > < Del >                   |      .
+              | [/        ] [*      ] [ ]     < Ins > < Del >                   |      .
+              |                               < Add >                           |      .
+              |                                                                 |      .
+              |     < Accept and Create >  < Return to Select Disk >            |      .
+               -------------------| Press F1 for Help |-------------------------       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+
+23. Highlight < Accept and Create > and press enter.
+
+24. The following menu will be displayed.
+
+        F10=Refresh Display                                                            .
+                                                                                       .
+                                                      ,--,           |           ,--,  .
+                                                      |   `-,       ,^,       ,-'   |  .
+                                                       `,    `-,   (/ \)   ,-'    ,'   .
+                                                         `-,    `-,/   \,-'    ,-'     .
+               -------------------------| Install OS |--------------------------       .
+              |                                                                 |-,    .
+              | Everything is now ready to install the actual files which       |  |   .
+              | comprise the DragonFly BSD operating system on the selected     |-'    .
+              | partition of the selected disk.                                 |      .
+              |                                                                 |      .
+              | Note that this process will take quite a while to finish. You   |      .
+              | may wish to take a break now and come back to the computer in a |      .
+              | short while.                                                    |      .
+              |                                                                 |      .
+              | < Begin Installing Files >_ < Return to Create Subpartitions >  |      .
+               -----------------------------------------------------------------       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+
+25. Highlight < Begin Installing Files > and press enter.
+
+26. The following progress bar will be displayed.
+
+        F10=Refresh Display                                                            .
+                                                                                       .
+                                                      ,--,           |           ,--,  .
+                                                      |   `-,       ,^,       ,-'   |  .
+                                                       `,    `-,   (/ \)   ,-'    ,'   .
+                                                         `-,    `-,/   \,-'    ,-'     .
+                                                            `------(   )------'        .
+                                                        ,----------(   )----------,    .
+                  -------------------| Executing Commands |-------------------     |   .
+                 |                                                            |_,-'    .
+                 | /bin/cpdup -o -vvv -u /usr/share /mnt/usr/share            |        .
+                 |                                                            |        .
+                 |          [*#################65%###              ]          |        .
+                 |                                                            |        .
+                 |                         < Cancel >_                        |        .
+                  ------------------------------------------------------------         .
+                                                                    `|'                .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+
+27. When it finishes, the following menu will be displayed.
+
+        F10=Refresh Display                                                            .
+                                                                                       .
+                                                      ,--,           |           ,--,  .
+                                                      |   `-,       ,^,       ,-'   |  .
+                    ---------------| Install Bootblock(s) |----------------,-'    ,'   .
+                   |                                                       |   ,-'     .
+                   | You may now wish to install bootblocks on one or more |--'        .
+                   | disks. If you already have a boot manager installed,  |------,    .
+                   | you can skip this step (but you may have to configure |       |   .
+                   | your boot manager separately.)  If you installed      |-,__,-'    .
+                   | DragonFly BSD on a disk other than your first disk,   |           .
+                   | you will need to put the bootblock on at least your   |           .
+                   | first disk and the DragonFly BSD disk.                |           .
+                   |                                                       |           .
+                   | Disk Drive  Install Bootblock?  Packet Mode?          |           .
+                   | [ad0_     ] [X]                 [X]                   |           .
+                   |                                                       |           .
+                   |           < Accept and Install Bootblocks >           |           .
+                   |                  < Skip this Step >                   |           .
+                    -----------------| Press F1 for Help |-----------------            .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+        The disk on which you wish to install a bootblock                              .
+
+28. Highlight < Accept and Install Bootblocks > and press enter.
+
+29. The following dialog box will be displayed.
+
+        F10=Refresh Display                                                            .
+                                                                                       .
+                                                      ,--,           |           ,--,  .
+                                                      |   `-,       ,^,       ,-'   |  .
+                                                       `,    `-,   (/ \)   ,-'    ,'   .
+                                                         `-,    `-,/   \,-'    ,-'     .
+                                                            `------(   )------'        .
+                                                        ,----------(   )----------,    .
+                                                       |        _,-(   )-,_        |   .
+                           -------------| Information |-------------   /   `-,__,-'    .
+                          |                                         | |                .
+                          | Bootblocks were successfully installed! | |                .
+                          |                                         | |                .
+                          |                 < OK >                  | |                .
+                           -----------------------------------------  |                .
+                                                                    | |                .
+                                                                    `|'                .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+
+30. Press enter.
+
+31. The following menu will be displayed.
+
+        F10=Refresh Display                                                            .
+                                                                                       .
+                                                      ,--,           |           ,--,  .
+                                                      |   `-,       ,^,       ,-'   |  .
+                                                       `,    `-,   (/ \)   ,-'    ,'   .
+                                                         `-,    `-,/   \,-'    ,-'     .
+               -----------------| DragonFly BSD is Installed! |-----------------       .
+              |                                                                 |-,    .
+              | Congratulations!                                                |  |   .
+              |                                                                 |-'    .
+              | DragonFly BSD has successfully been installed on this computer. |      .
+              | You may now proceed to configure the installation. Alternately, |      .
+              | you may wish to reboot the computer and boot into the installed |      .
+              | system to confirm that it works.                                |      .
+              |                                                                 |      .
+              |              < Configure this System >_ < Reboot >              |      .
+              |                   < Return to Welcome Menu >                    |      .
+               -----------------------------------------------------------------       .
+
+32. Highlight < Configure this System > and press enter.
+
+33. The following menu will be displayed.
+
+        F10=Refresh Display                                                            .
+                                                                                       .
+                                                      ,--,           |           ,--,  .
+                            ---| Configure an Installed System |---- ^,       ,-'   |  .
+                           |                                        | \)   ,-'    ,'   .
+                           | The options on this menu allow you to  |  \,-'    ,-'     .
+                           | configure a DragonFly BSD system after |  )------'        .
+                           | it has already been installed.         |  )----------,    .
+                           |                                        |  )-,_        |   .
+                           | < Select timezone >_                   |  /   `-,__,-'    .
+                           | < Set date and time >                  | |                .
+                           | < Set keyboard map >                   | |                .
+                           | < Set root password >                  | |                .
+                           | < Add a user >                         | |                .
+                           | < Configure network interfaces >       | |                .
+                           | < Configure hostname and domain >      | |                .
+                           | < Set console font >                   ||'                .
+                           | < Set screen map >                     |                  .
+                           | < Remove software packages >           |                  .
+                           | < Return to Welcome Menu >             |                  .
+                            ----------------------------------------                   .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+Set the Time Zone of your physical location                                            .
+
+34. Highlight < Select timezone > and press enter.
+
+35. The following menu will be displayed.
+
+        F10=Refresh Display                                                            .
+                                                                                       .
+                                                      ,--,           |           ,--,  .
+                                                      |   `-,       ,^,       ,-'   |  .
+                                                       `,    `-,   (/ \)   ,-'    ,'   .
+                                                         `-,    `-,/   \,-'    ,-'     .
+                                                            `------(   )------'        .
+                                                        ,----------(   )----------,    .
+                          | Local or UTC (Greenwich Mean Time) clock | )-,_        |   .
+                         |                                            |/   `-,__,-'    .
+                         | Is this machine's CMOS clock set to        |                .
+                         | UTC?                                       |                .
+                         |                                            |                .
+                         | If it is set to local time, or you         |                .
+                         | don't know, please choose NO here!         |                .
+                         |                                            |                .
+                         |              < Yes >_ < No >               |                .
+                          --------------------------------------------                 .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+
+36. Highlight < Yes > and press enter.
+
+37. The following menu will be displayed.
+
+        F10=Refresh Display ----------| Select Time Zone |----------                   .
+                           |                                        #                  .
+                           | Select a Time Zone appropriate to your #|           ,--,  .
+                           | physical location.                     #^,       ,-'   |  .
+                           |                                        # \)   ,-'    ,'   .
+                           | < Africa >_                            #  \,-'    ,-'     .
+                           | < America >                            #  )------'        .
+                           | < Antarctica >                         #  )----------,    .
+                           | < Arctic >                             #  )-,_        |   .
+                           | < Asia >                               #  /   `-,__,-'    .
+                           | < Atlantic >                           # |                .
+                           | < Australia >                          # |                .
+                           | < CET >                                # |                .
+                           | < CST6CDT >                            # |                .
+                           | < EET >                                # |                .
+                           | < EST >                                # |                .
+                           | < EST5EDT >                            #|'                .
+                           | < Etc >                                #                  .
+                           | < Europe >                             *                  .
+                           | < GMT >                                *                  .
+                           | < HST >                                *                  .
+                           | < Indian >                             *                  .
+                           | < MET >                                *                  .
+                           | < MST >                                *                  .
+                            ----------------------------------------                   .
+
+38. Highlight < GMT > and press enter.
+
+39. The following dialog box will be displayed.
+
+        F10=Refresh Display                                                            .
+                                                                                       .
+                                                      ,--,           |           ,--,  .
+                                                      |   `-,       ,^,       ,-'   |  .
+                                                       `,    `-,   (/ \)   ,-'    ,'   .
+                                                         `-,    `-,/   \,-'    ,-'     .
+                                                            `------(   )------'        .
+                                                        ,----------(   )----------,    .
+                                                       |        _,-(   )-,_        |   .
+                                --------| Information |--------    \   /   `-,__,-'    .
+                               |                               |    | |                .
+                               | The Time Zone has been set to |    | |                .
+                               | /mnt/usr/share/zoneinfo/GMT.  |    | |                .
+                               |                               |    | |                .
+                               |            < OK >_            |    | |                .
+                                -------------------------------     | |                .
+                                                                    `|'                .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+
+40. Press enter.
+
+41. The menu from step 33 will be displayed.
+
+42. Highlight  < Set keyboard map > and press enter.
+
+43. The following menu will be displayed.
+
+        F10=Refresh Display  -------| Select Keyboard Map |--------                    .
+                            |                                      #                   .
+                            | Select a keyboard map appropriate to # |           ,--,  .
+                            | your keyboard layout.                #,^,       ,-'   |  .
+                            |                                      #/ \)   ,-'    ,'   .
+                            | < be.iso.acc.kbd >_                  #   \,-'    ,-'     .
+                            | < be.iso.kbd >                       #   )------'        .
+                            | < bg.bds.ctrlcaps.kbd >              *   )----------,    .
+                            | < bg.phonetic.ctrlcaps.kbd >         *   )-,_        |   .
+                            | < br275.cp850.kbd >                  *   /   `-,__,-'    .
+                            | < br275.iso.acc.kbd >                *| |                .
+                            | < br275.iso.kbd >                    *| |                .
+                            | < by.cp1131.kbd >                    *| |                .
+                            | < by.cp1251.kbd >                    *| |                .
+                            | < by.iso5.kbd >                      *| |                .
+                            | < ce.iso2.kbd >                      *| |                .
+                            | < colemak.iso15.acc.kbd >            *'|'                .
+                            | < cs.latin2.qwertz.kbd >             *                   .
+                            | < cz.iso2.kbd >                      *                   .
+                            | < danish.cp865.kbd >                 *                   .
+                            | < danish.iso.kbd >                   *                   .
+                            | < el.iso07.kbd >                     *                   .
+                            | < estonian.cp850.kbd >               *                   .
+                            | < estonian.iso.kbd >                 *                   .
+                             --------------------------------------                    .
+
+44. Highlight < us.dvorak.kbd > and press enter.
+
+45. The menu from step 33 will be displayed.
+
+46. Highlight < Add a user > and press enter.
+
+47. The following menu will be displayed.
+
+        F10=Refresh D -------------------| Add user |--------------------              .
+                     |                                                   |             .
+                     | Here you can add a user to an installed system.   |       ,--,  .
+                     |                                                   |    ,-'   |  .
+                     | You can leave the Home Directory, User ID, and    | ,-'    ,'   .
+                     | Login Group fields empty if you want these items  |'    ,-'     .
+                     | to be automatically allocated by the system.      |----'        .
+                     |                                                   |--------,    .
+                     | Note: this user's password will appear in the     |_        |   .
+                     | install log. If this is a problem, please add the | `-,__,-'    .
+                     | user manually after rebooting into the installed  |             .
+                     | system instead.                                   |             .
+                     |                                                   |             .
+                     | Username                 [_                 ]     |             .
+                     | Real Name                [                  ]     |             .
+                     | Password                 [                  ]     |             .
+                     | Password (Again)         [                  ]     |             .
+                     | Shell                    [/bin/tcsh         ]     |             .
+                     | Home Directory           [                  ]     |             .
+                     | User ID                  [                  ]     |             .
+                     | Login Group              [                  ]     |             .
+                     | Other Group Memberships  [                  ]     |             .
+                     |                                                   |             .
+                     | < Accept and Add >  < Return to Configure Menu >  |             .
+        Enter the use ---------------------------------------------------              .
+
+48. In the following fields type the following values without quotes and then highlight <Accept and Add > and press enter.
+
+* Username: 'user'
+* Real Name: 'User'
+* Password: 'ChangeMe'
+* Password (Again): 'ChangeMe'
+
+49. The following dialog box will be displayed.
+
+        F10=Refresh Display                                                            .
+                                                                                       .
+                                                      ,--,           |           ,--,  .
+                                                      |   `-,       ,^,       ,-'   |  .
+                                                       `,    `-,   (/ \)   ,-'    ,'   .
+                                                         `-,    `-,/   \,-'    ,-'     .
+                                                            `------(   )------'        .
+                                                        ,----------(   )----------,    .
+                                                       |        _,-(   )-,_        |   .
+                                   -----| Information |----  ,-'   \   /   `-,__,-'    .
+                                  |                        |        | |                .
+                                  | User `user' was added. |        | |                .
+                                  |                        |        | |                .
+                                  |         < OK >_        |        | |                .
+                                   ------------------------         | |                .
+                                                                    | |                .
+                                                                    `|'                .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+
+50. Press enter.
+
+51. The menu from step 33 will be displayed.
+
+52. Highlight < Set root password > and press enter.
+
+53. The following menu will be displayed.
+
+        F10=Refresh Display                                                            .
+                                                                                       .
+                                                      ,--,           |           ,--,  .
+                                                      |   `-,       ,^,       ,-'   |  .
+                                                       `,    `-,   (/ \)   ,-'    ,'   .
+                  -------------------| Set Root Password |-------------------  ,-'     .
+                 |                                                           |'        .
+                 | Here you can set the super-user (root) password.          |----,    .
+                 |                                                           |     |   .
+                 | Note: root's new password will appear in the install log. |__,-'    .
+                 | If this is a problem, please set root's password manually |         .
+                 | after rebooting into the installed system instead.        |         .
+                 |                                                           |         .
+                 | Root password        [_                 ]                 |         .
+                 | Root password again  [                  ]                 |         .
+                 |                                                           |         .
+                 |                < Accept and Set Password >                |         .
+                 |               < Return to Configure Menu >                |         .
+                  -----------------------------------------------------------          .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+        Enter the root password you would like to use                                  .
+
+54. In the following fields type the following values without quotes and then highlight <Accept and Set Password > and press enter.
+
+* Root password: 'ChangeMe'
+* Root password again: 'ChangeMe'
+
+55. The following dialog box will be displayed.
+
+        F10=Refresh Display                                                            .
+                                                                                       .
+                                                      ,--,           |           ,--,  .
+                                                      |   `-,       ,^,       ,-'   |  .
+                                                       `,    `-,   (/ \)   ,-'    ,'   .
+                                                         `-,    `-,/   \,-'    ,-'     .
+                                                            `------(   )------'        .
+                                                        ,----------(   )----------,    .
+                                                       |        _,-(   )-,_        |   .
+                            ------------| Information |----------- \   /   `-,__,-'    .
+                           |                                      | | |                .
+                           | User root password has been changed. | | |                .
+                           |                                      | | |                .
+                           |                < OK >_               | | |                .
+                            --------------------------------------  | |                .
+                                                                    | |                .
+                                                                    `|'                .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+
+56. Press enter.
+
+57. The menu from step 33 will be displayed.
+
+58. Highlight < Configure network interfaces > and press enter.
+
+59. The following menu will be displayed.
+
+        F10=Refresh Display                                                            .
+                                                                                       .
+                                                      ,--,           |           ,--,  .
+                                                      |   `-,       ,^,       ,-'   |  .
+                                                       `,    `-,   (/ \)   ,-'    ,'   .
+                                                         `-,    `-,/   \,-'    ,-'     .
+                           ----------| Assign IP Address |----------   )------'        .
+                          |                                         |  )----------,    .
+                          | Please select which interface you would |  )-,_        |   .
+                          | like to configure:                      |  /   `-,__,-'    .
+                          |                                         | |                .
+                          | < em0 >_                                | |                .
+                          | < faith0 >                              | |                .
+                          | < lo0 >                                 | |                .
+                          | < ppp0 >                                | |                .
+                          | < sl0 >                                 | |                .
+                          | < Cancel >                              ||'                .
+                           -----------------------------------------                   .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+
+60. Highlight < em0 > and press enter.
+
+61. The following menu will be displayed.
+
+        F10=Refresh Display                                                            .
+                                                                                       .
+                                                      ,--,           |           ,--,  .
+                                                      |   `-,       ,^,       ,-'   |  .
+                                                       `,    `-,   (/ \)   ,-'    ,'   .
+                                                         `-,    `-,/   \,-'    ,-'     .
+                                                            `------(   )------'        .
+                           --------------| Use DHCP? |--------------   )----------,    .
+                          |                                         |  )-,_        |   .
+                          | DHCP allows the interface to            |  /   `-,__,-'    .
+                          | automatically obtain an IP address from | |                .
+                          | a nearby DHCP server.                   | |                .
+                          |                                         | |                .
+                          | Would you like to enable DHCP for em0?  | |                .
+                          |                                         | |                .
+                          |  < Use DHCP >_ < Configure Manually >   | |                .
+                           ----------------------------------------- |'                .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+
+62. Highlight < Use DHCP > and press enter.
+
+63. The following menu, specific to your hardware and network connection, will be displayed.
+
+        F10=Refresh Display                                                            .
+                                                                                       .
+                                                      ,--,           |           ,--,  .
+                           -------------| Information |------------- ^,       ,-'   |  .
+                          |                                         | \)   ,-'    ,'   .
+                          | em0:                                    |  \,-'    ,-'     .
+                          | flags=8843<UP,BROADCAST,RUNNING,SIMPLEX |  )------'        .
+                          | MULTICAST> mtu 1500                     |  )----------,    .
+                          | options=1b<RXCSUM,TXCSUM,VLAN_MTU,VLAN_ |  )-,_        |   .
+                          | WTAGGING>                               |  /   `-,__,-'    .
+                          | inet6 fe80::a00:27ff:fe98:67cc%em0      | |                .
+                          | prefixlen 64 scopeid 0x1                | |                .
+                          | inet 10.0.2.15 netmask 0xffffff00       | |                .
+                          | broadcast 10.0.2.255                    | |                .
+                          | ether 08:00:27:98:67:cc                 | |                .
+                          | media: Ethernet autoselect (1000baseT   | |                .
+                          | <full-duplex>)                          ||'                .
+                          | status: active                          |                  .
+                          |                                         |                  .
+                          |                                         |                  .
+                          |                 < OK >_                 |                  .
+                           -----------------------------------------                   .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+
+64. Press enter.
+
+65. The menu from step 33 will be displayed.
+
+66. Highlight < Configure hostname and domain > and press enter.
+
+67. The following menu will be displayed.
+
+        F10=Refresh Display                                                            .
+                                                                                       .
+                                                      ,--,           |           ,--,  .
+                                                      |   `-,       ,^,       ,-'   |  .
+                                                       `,    `-,   (/ \)   ,-'    ,'   .
+                                                         `-,    `-,/   \,-'    ,-'     .
+                                                            `------(   )------'        .
+                             -------| Set Hostname/Domain |--------    )----------,    .
+                            |                                      |   )-,_        |   .
+                            | Please enter this machine's hostname |   /   `-,__,-'    .
+                            | and domain name.                     || |                .
+                            |                                      || |                .
+                            | Hostname  [_                 ]       || |                .
+                            | Domain    [                  ]       || |                .
+                            |                                      || |                .
+                            |                                      || |                .
+                            |          < OK >  < Cancel >          |`|'                .
+                             --------------------------------------                    .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+        Enter the Hostname (e.g. `machine')                                            .
+
+68. In the following fields type the following values without quotes and then highlight <OK > and press enter.
+
+* Hostname: 'dfly'
+* Domain: 'localhost'
+
+69. The menu from step 33 will be displayed.
+
+70. Highlight < Return to Welcome Menu > and press enter.
+
+71. The menu from step 7 will be displayed.
+
+72. Highlight < Reboot this Computer > and press enter.
+
+73. The following menu will be displayed.
+
+        F10=Refresh Display                                                            .
+                                                                                       .
+                                                      ,--,           |           ,--,  .
+                                                      |   `-,       ,^,       ,-'   |  .
+                                                       `,    `-,   (/ \)   ,-'    ,'   .
+                                                         `-,    `-,/   \,-'    ,-'     .
+                                                            `------(   )------'        .
+                            ---------------| Reboot |---------------   )----------,    .
+                           |                                        |  )-,_        |   .
+                           | This machine is about to be shut down. |  /   `-,__,-'    .
+                           | After the machine has reached its      | |                .
+                           | shutdown state, you may remove the CD  | |                .
+                           | from the CD-ROM drive tray and press   | |                .
+                           | Enter to reboot from the HDD.          | |                .
+                           |                                        | |                .
+                           |               < Reboot >               | |                .
+                           |       < Return to Welcome Menu >       ||'                .
+                            ----------------------------------------                   .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+                                                                                       .
+
+74. Highlight < Reboot > and press enter.
+
+75. The following message will be displayed.
+
+        The operating system has halted.
+        Please press any key to reboot.
+
+76. Remove the virtual CD installation media from the virtual machine.
+
+77. Press any key to reboot. Before it finishes booting, the will be greeted with the menu from step 4.
+
+78. After the computer finishes booting, you will be greeted with the following welcome message and login prompt.
+
+        DragonFly/x86_64 (dfly.localhost) (ttyv0)
+        
+        login: _
+
+79. Log in as root.
+
+80. You will be greeted with the following message and shell prompt.
+
+        Copyright (c) 2003-2014 The DragonFly Project.                              .
+        Copyright (c) 1992-2003 The FreeBSD Project.                                .
+        Copyright (c) 1979, 1980, 1983, 1986, 1988, 1989, 1991, 1992, 1993, 1994    .
+                The Regents of the University of California. All rights reserved.   .
+                                                                                    .
+        DragonFly v3.8.1-RELEASE (X86_64_GENERIC) #16 Mon Jun 16 21:36:15 PDT 2014  .
+                                                                                    .
+        Welcome to DragonFly!                                                       .
+                                                                                    .
+        dfly# _                                                                     .
+
+81. Type 'passwd' without quotes and press enter.
+
+82. Type in a new root password and press enter and then retype the new root password and press enter again.
+
+83. Type 'ee /etc/hosts' without quotes and press enter.
+
+84. Without quotes twice replace 'localhost.my.domain' with 'dfly.localhost'.
+
+85. Press Ctrl-[, then highlight 'a) leave editor' and press enter, then highlight 'a) save changes' and press enter.
+
+86. Type 'exit' without quotes and press enter.
+
+87. Log in as user.
+
+88. You will be greeted with the following message and shell prompt.
+
+        Copyright (c) 2003-2014 The DragonFly Project.                                 .
+        Copyright (c) 1992-2003 The FreeBSD Project.                                   .
+        Copyright (c) 1979, 1980, 1983, 1986, 1988, 1989, 1991, 1992, 1993, 1994       .
+                The Regents of the University of California. All rights reserved.      .
+                                                                                       .
+        DragonFly v3.8.1-RELEASE (X86_64_GENERIC) #16 Mon Jun 16 21:36:15 PDT 2014     .
+                                                                                       .
+        Welcome to DragonFly!                                                          .
+                                                                                       .
+        Man pages are divided into section depending on topic.  There are 9 different  .
+        sections numbered from 1 (General Commands) to 9 (Kernel Developer's Manual).  .
+        You can get an introduction to each topic by typing                            .
+                                                                                       .
+                man <number> intro                                                     .
+                                                                                       .
+        In other words, to get the intro to general commands, type                     .
+                                                                                       .
+                man 1 intro                                                            .
+        > _                                                                            .
+
+89. Type 'passwd' without quotes and press enter.
+
+90. Type 'ChangeMe' without quotes and press enter, then type a new password and press enter, and then retype the new password and press enter again.
+
+91. Type 'exit' without quotes and press enter.
+
+## Tidbits
+* In the default shell, **tcsh**, ctrl-d is equivalent to tab-tab in **bash**, both of which display possible auto completions. If the list of possible auto completions has changed, running the command rehash will update it. Typing part of a previous command and then pressing the up key is equivalent to pressing ctrl-r and then typing part of a previous command, both of which search previously run commands.
+* **pkgin** is roughly equivalent to **apt-get**. They are both fairly straightforward command line package management utilities. Regular programs installed via pkgin are generally located in /usr/pkg/bin.
+* Like Debian, DragonFly BSD is configured by default to use su by default rather sudo, which is the default in Ubuntu. Running su changes the user you are logged in within a single shell instance whereas sudo lets you run a single command as another user. Both programs default to changing the user to root user. To enable your regular user to use su to become root, as root run nano /etc/groups and then change the line wheel:*:0:root to wheel:*:root,yourusername except of course replace rourusername with your user name. Running su - will change the shell environment variables to that of the user to which you're changing.
+* The console text editor vi is supposedly great, but if you're not familiar with it and some command you run opens some system file with it, it can be quite alarming. Don't panic! To exit without saving changes type :q! and then press enter.
+* The command line program man, short for manual, is very handy for finding out information about programs, system files and more. One way to navigate man pages is by using your arrow keys. You can exit out of a manual page by pressing the letter q on your keyboard. To learn more about the man command, run the command man man which will show you the manual page for the man command.
+* When your computer contacts another computer over the Internet, it converts server's name, such as example.com, to numbered address. The server's name is called a domain name and the numbered address is called an IP address, short for Internet protocol address. To find out which domain name goes with which IP address, you computer usually contacts a special server called a DNS server, DNS being an abbreviation of domain name system. DNS generally works pretty well automatically, but when it causes a problem, it can be very frustrating. As of DragonFly BSD 3.0.3, there's a non-critical DNS configuration setting that the DragonFly BSD installer doesn't set. The file /etc/hosts is a text file that can override DNS name-address bindings. The IP addresses 127.0.0.1 and ::1 always point to one's own computer, so your computer's domain name should always point to these two addresses. This is the setting that currently doesn't get set automatically. You can see or set your host name within the file /etc/rc.conf on a line by itself in the following format.
+
+        hostname="computername.localnetworkname"
+
+    And with that name, you can update your /etc/hosts file with your computer's domain name by editing it to contain the following lines.
+
+        ::1 localhost computername.localnetworkname
+        127.0.0.1 localhost computername.localnetworkname
+
+* In DragonFly BSD the command *shutdown -p now* will shutdown and turn off your computer. Using the -h switch instead of -p will shutdown and halt the computer but not turn it off. In Debian and probably other Linux distributions, the command *shutdown -h now* will shutdown and turn off your computer. The -p switch isn't available, but there may be a way to shutdown and halt without turning off your computer.
+* **Hammer** is hands down the best file system currently in existence. It has block level deduplication, it is supported out of the box by operating system with great underpinnings, and it runs great on regular hardware.
+* **DragonFly BSD** is an awesome operating system for many reasons other than that it's the only OS with Hammer, but Hammer is why I'm making the switch. DragonFly's default GUI configuration is a bit rough around the edges for everyday use. But it's nothing that a little ironing can't fix.
+* **[Xfce](http://xfce.org/)** is a lightweight yet feature rich desktop environment. It has maintains an excellent balance between [innovation and compatibility](http://lwn.net/Articles/430598/).
+* **[Dissonance](https://github.com/varialus/dissonance)** is my fork of Apache Harmony, which is a clean room implementation of Java with a permissive license. Sun and now Oracle refuse to license the TCK, a tool used to validate Java compatibility, for use with Harmony. As a result of the dissonance caused by this refusal to cooperate with the community, Apache retired Harmony and resigned from the Java Community Process Executive Committee. I would have preferred for Apache and the community to have instead just written their own TCK, but I don't know what effects the dissonance had on their organization and it was their decision to make, so I can't blame them. It's unfortunate that such a great project has been effectively abandoned, and so it it is with that in mind that I call on the community to support Dissonance; make your own TCK and make it so much better so as to make passing Oracle's TCK effectively meaningless.
+* **[Jython](http://www.jython.org/)** is Python written in Java. It's not included in DragonFly BSD by default, but it's a great tool and I use it.
+* **ee** is roughly equivalent to **nano**. They are both easy to use command line text editors. The exit option will ask you whether you want to save. You can get to the exit confirmation by pressing Ctrl-[ and selecting 'a) leave editor'.
+* If NetworkManager Applet is installed, use it to override an unreliable DNS server rather than editing /etc/resolv.conf directly. Observed in NetworkManager 0.8.1 on Debian Squeeze. (This seems to not always work, particularly the first time you connect and perhaps after idling for a certain amount of time. I haven't narrowed down the exact cause.)
+
+## Issues
 * Varialus should ensure that these issues are properly logged. Yes, I know that they should be properly logged and I intend to eventually get them all logged. In the mean time hopefully my notes will help someone still trying to find the answers to life's persistent questions.
-* The installer should offer the Xfce desktop environment as a supported option. Observed in DragonFly 3.0.2.
+* The installer should offer the Xfce desktop environment as a supported option. Observed in DragonFly 3.0.2. See workaround below.
 * The installer should set the keyboard layout before any typing is required. Observed in DragonFly 3.0.2.
 * The installer should set the keyboard layout for the GUI. Observed in DragonFly 3.0.2. See workaround below.
 * The installer should set the keyboard layout for the encryption password prompt. Observed in DragonFly 3.0.2.
 * When encrypting the swap partition, the installer should configure the boot loader to generate a random key each time the system is booted so that the password doesn't have to be typed twice when the system is booted. Observed in DragonFly 3.0.2.
 * When configuring the system from the installer, if the system just finished installing with encryption, the hard drive should stay unlocked so that the user doesn't have to type in his password again. Observed in DragonFly 3.0.2.
 * When configuring the system from the installer, if the system is encrypted but was not just barely installed, the user should only have to type in his password once, not twice. Observed in DragonFly 3.0.2.
+* When creating a user password in the installer, the password should not be written to a plain text installation log. Observed in DragonFly BSD 3.0.2.
 * When installing from a USB device onto a USB device, the installer should ensure that installed media is named such that when booted without the USB installer, the installed device name doesn't change. Observed in DragonFly 3.0.2.
 * When installing onto a 3TB+ hard drive, the default partition table should be able to handle that size. Observed in DragonFly 3.0.2. Fixed and tested in snapshot on 8/14/2012. See workaround below.
 * After selecting to install using all of a 3TB+ hard drive that already has an MS-DOS/MBR partition table on it, the installer should overwrite the partition table with an adequate partition table such as GPT. Observed in snapshot on 8/14/2012.
 * The default shell provided by the installer should list valid auto completion options after typing a partial command and then pressing tab two or more times. Observed in DragonFly 3.0.2.
 * ->Excepting the bullet point, this syntax should center text in this wiki.<- Observed on 8/25/2012.
+* The following errors should not occur when quitting from the GUI.
 
-### Various Workarounds
+        waiting for X server to shut down xterm: fatal IO error 35 (Resource temporarily unavailable) or KillClient on X server ":0.0"
+        xterm:  fatal IO error 35 (Resource temporarily unavailable) or KillClient on X server "0.0"
+        failed to unset mtrr: Device not configured
+        
+        
+        xauth: (argv):1:  bad display name "myhostname.mysubdomain.mytld:0" in "remove" command
+
+    Observed in DragonFly BSD 3.0.2 64-bit on VirtualBox 4.1.20 in Debian Squeeze.
+
+## Workarounds
 **Enable the Caps Lock Key within the GUI**
 
 Edit the file /etc/X11/xorg.conf.
@@ -39,6 +1099,8 @@ Delete the ctrl:nocaps XkbOptions option from the InputDevice section with the i
        #Option      "XkbOptions" "ctrl:nocaps"
     EndSection
 
+Observed in DragonFly BSD 3.0.2.
+
 **Install Non-GUI on 3TB+ Hard Drive**
 
 *WARNING:* This workaround includes instructions which will delete all data from a hard drive.
@@ -49,6 +1111,91 @@ Install from a [snapshot version of DragonFly](http://avalon.dragonflybsd.org/sn
 
 Tested in snapshot on 8/14/2012.
 
+**Install Xfce 4.6**
+
+*WARNING:* This workaround is not yet complete. Contributions are welcome.
+
+The following testing is being done with a root account and no user account. Additional testing with a regular user account will be done later.
+
+*DragonFly BSD 3.1-DEVELOPMENT Non-GUI Instructions*
+
+Summary
+
+* Install XOrg if it's not already installed.
+* Ensure that mouse works.
+* Get the xfce4 meta-package make file.
+* Install binary files listed in xfce4 meta-package make file.
+
+These instructions are currently a mess. They're currently just a rough outline of how I got it working. I'll go through and clean it up later.
+
+Get a list of which packages would be included if Xfce was installed from source. If you haven't already done so, [create and update the pkgsrc tree](http://www.dragonflybsd.org/docs/howtos/HowToPkgsrc/#index2h2). Running make pkgsrc-create failed for me when I ran it in my virtual machine with 2 GB, but succeeded when I ran it with 3171 MB.
+
+    cd /usr/
+    make pkgsrc-create
+    make pkgsrc-update
+    cd /usr/pkgsrc/meta-pkgs/xfce4
+    pkgin update
+    pkgin in `cat Makefile | grep -E "xfce4.*mk" | sed -e 's/.include.*\/xf/xf/g' -e 's/\/.*/ /g' | tr -d "\n"`
+    pkg_radd modular-xorg
+    ls /dev/
+
+Log into another console window by pressing Ctrl-Alt-F2 or in VirtualBox, Alt-F2.
+
+    man moused
+
+Scroll down until you find where it mentions mouse dev names.
+
+    ee /etc/X11/xorg.conf
+
+Comment out the /dev/sysmouse line by putting a # in front of it. Add the following line.
+
+    Option "Device" "/dev/psm0"
+
+Except replace psm0 with whichever mouse you've got listed in /dev. Then save the file.
+
+    startxfce4
+
+*DragonFly BSD 3.0.2 GUI Instructions*
+
+I got the message Error Code 1 while creating and updating my pkgsrc tree. I haven't yet looked into it further.
+
+Get a list of which packages would be included if Xfce was installed from source. If you haven't already done so, [create and update the pkgsrc tree](http://www.dragonflybsd.org/docs/howtos/HowToPkgsrc/#index2h2).
+
+    cd /usr/
+    make pkgsrc-create
+    make pkgsrc-update
+
+Get a list of which packages would be included if Xfce was installed from source. The pkgsrc tree was maybe already created by default on this version of DragonFly BSD. If it has not already been created, you'd first want to [create it](http://www.dragonflybsd.org/docs/howtos/HowToPkgsrc/#index2h2) before continuing. Update the pkgsrc tree.
+
+    cd /usr/
+    make pkgsrc-update
+
+*Notes*
+
+* [XFCE based LiveDVD/IMG](http://leaf.dragonflybsd.org/mailarchive/users/2012-07/msg00123.html)
+* [Installing a Desktop Environment: Xfce4](http://www.dragonflybsd.org/docs/how_to_get_to_the_desktop/#index11h3)
+* [Desktop Environments: Xfce](http://www.dragonflybsd.org/docs/newhandbook/X/#index9h3)
+* [Longest DragonFly BSD Review: Running Xfce in DragonFlyBSD 3.0.1](http://insidesocal.com/click/2012/04/review-dragonflybsd-301----the-5.html)
+* [Instructions via Google Translate](http://www.google.com/translate_c?langpair=en&u=http://dragonflybsd.fr/index.php?page=Installation+de+Xfce4)
+* [Installing pkgsrc](http://www.dragonflybsd.org/docs/howtos/HowToPkgsrc/#index2h2)
+
+    pkgin search xfce
+
+**Install Xfce 4.8**
+
+*WARNING:* This workaround is not yet complete. Contributions are welcome.
+
+* [Choosing between portability and innovation](http://lwn.net/Articles/430598/)
+* [Xfce 4.8 on BSD flavors](http://gezeiten.org/post/2011/01/Xfce-4.8-on-BSD-flavors)
+* [Xfce 4.8 tour](http://xfce.org/about/tour48)
+
+**Install Xfce 4.10**
+
+*WARNING:* This workaround is not yet complete. Contributions are welcome.
+
+* [Xfce 4.10 released](http://www.xfce.org/about/news/?post=1335571200)
+* [Xfce 4.10 tour](http://xfce.org/about/tour)
+
 **Set the GUI Keyboard Layout**
 
 Edit the file /etc/X11/xorg.conf.
@@ -70,3 +1217,157 @@ Valid keyboard options can be found by searching through /usr/pkg/share/X11/xkb/
 If too many lines scroll by, you can use your arrow buttons to scroll back within the non-graphical console screen by pressing the Scroll Lock button on your keyboard.
 
 Tested in DragonFly 3.0.2.
+
+## Contribute
+
+**Port VirtualBox to DragonFly BSD**
+
+     - Build VirtualBox in GhostBSD (GhostBSD is FreeBSD with Gnome or LXDE installed out of the box.)
+        - Install GhostBSD (Gnome version 3.0 RC1 in VirtualBox)
+           - It's easier to change the keyboard layout in the Gnome version.
+           - If your keyboard stops working during the install then do the following.
+              - Restart GhostBSD LiveCD/LiveUSB
+              - Applications > Accessories > Text Editor
+              - Type your answers to the following fields.
+                 - root password
+                 - username
+                 - full name of user
+                 - user password
+                 - hostname.
+              - Copy and paste your answers into the installer.
+        - Initialize build environment: http://www.freebsd.org/doc/handbook/updating-upgrading-portsnap.html
+           - Handbook Instructions: http://www.freebsd.org/doc/handbook/updating-upgrading-portsnap.html
+           - portsnap fetch (68 MB as root)
+           - portsnap extract (as root)
+           - portsnap update (as root)
+        - Install Guest Additions (from FreeBSD, not from Oracle)
+           - Initialize build environment (See above)
+           - Wiki Instructions: http://wiki.freebsd.org/VirtualBox#Installing_Guest_Additions_for_FreeBSD_guests
+           - Handbook Instructions: http://www.freebsd.org/doc/handbook/virtualization-guest.html
+           - Notes: http://forums.ghostbsd.org/viewtopic.php?f=8&t=693
+           - More Notes: http://forums.freebsd.org/showthread.php?t=29172
+           - Create a supfile.
+              - ee /root/9rel-supfile (as root)
+              - Firefox within VM http://www.dragonflybsd.org/varialus/
+              - Copy and paste the following into your supfile.
+    *default host=CHANGE_THIS.FreeBSD.org
+    *default base=/var/db
+    *default prefix=/usr
+    *default release=cvs tag=RELENG_9_1
+    *default delete use-rel-suffix
+    *default compress
+    src-all
+              - Firefox http://www.freebsd.org/doc/en/books/handbook/cvsup.html#CVSUP-MIRRORS
+              - Pick close server and change line *default host=CHANGE_THIS.FreeBSD.org
+                 - Optionally pick fastest server: http://www.freshports.org/sysutils/fastest_cvsup
+              - Ctrl-[
+              - a) leave editor
+              - a) save changes
+            - cd /root/ (as root)
+            - csup 9rel-supfile (as root)
+            - If outgoing connections to port 5999 are blocked, here are a few possible solutions which I have not yet tried.
+               - http://lists.freebsd.org/pipermail/freebsd-stable/2005-August/017991.html
+               - http://lists.freebsd.org/pipermail/freebsd-questions/2004-February/034761.html
+               - http://lists.freebsd.org/pipermail/freebsd-questions/2004-March/041566.html
+            - cd /usr/ports/emulators/virtualbox-ose-additions && make install clean (as root)
+            - The following console dialog will be be displayed.
+               - Options for virtualbox-ose-additions 4.1.22
+               - [ ] DEBUG   Install debug symbols
+               - [ ] OPENGL  OpenGL support
+               - [X] X11     X11 support (graphics)
+               - <  OK  >            <Cancel>
+            - Highlight <  OK  > and press enter.
+               - The first time I ran this I got a missing dependency error because there had been a minor version update recently. The dependency error was fixed a few hours later. Right after that, the official version of 4.2 was released. To see the original error error, see the edit from 01:48:39 09/13/12.
+            - The following console dialog will be be displayed.
+               - Options for help2man1.40.11
+               - [X] NLS  Native Language Support
+               - <  OK  >            <Cancel>
+            - Highlight <  OK  > and press enter.
+            - The following console dialog will be be displayed.
+               - Options for m4 1.4.16_1,1
+               - [ ] LIBSIGSEGV  Use libsigsegv for better diagnostics
+               - <  OK  >            <Cancel>
+            - Highlight <  OK  > and press enter.
+            - Wait for a little while until it successfully finishes.
+            - Restart virtual machine. (This probably wasn't needed yet.)
+            - Screen resolution increased, but no mouse integration nor copy and paste. Host is Debian Squeeze.
+            - ee /etc/rc.conf (as root)
+            - Add the following lines
+    
+    vboxguest_enable="YES"
+    vboxservice_enable="YES"
+    
+            - The notes at the URL above mention adding lines to xorg.conf for mouse integration, but I didn't see an xorg.conf in /etc/X11 or in /etc so I skipped this step for now.
+            - The notes also mentioned creating a file for HAL users or copying it, but I didn't see a file at /usr/local/share/hal/fdi/policy/10osvendor/90-vboxguest.fdi so I am skipping this step for the moment.
+            - Restart.
+            - I just noticed that the lines had already been added to /etc/rc.conf, so I removed the extra ones that I had added.
+            - Changed to terminal without X server. Host+F2 in VirtualBox, Ctrl-Alt-F2 on hardware.
+            - Log in as root.
+            - The following didn't work.
+            - killall -9 gdm gdm-binary Xorg
+            - Xorg -configure
+            - Xorg -config /root/xorg.conf.new
+            - X started with black screen, no mouse.
+            - I've run out of time to look into this at the moment. I'll return to it later.
+        - Build VirtualBox
+           - Initialize build environment (See above)
+        - Build Guest Additions
+     - Build VirtualBox in DragonFly BSD
+        - Install DragonFly BSD (Xfce IMG/ISO Installer)
+        - Build VirtualBox
+        - Install VirtualBox
+        - Test VirtualBox
+        - Build Guest Additions
+        - Install Guest Additions
+        - Test Guest Additions
+     - Package for pkgsrc
+     - Upload to pkgsrc
+
+**Port Xfce 4.10 to DragonFly BSD**
+
+     - Install DragonFly BSD (Xfce IMG/ISO Installer in VirtualBox)
+     - Build Instructions: http://docs.xfce.org/xfce/building
+     - Package for pkgsrc
+     - Upload to pkgsrc
+
+**DragonFly BSD Network Shares Walkthrough**
+
+     - Install DragonFly BSD (Xfce IMG/ISO Installer in VirtualBox)
+
+**Port bxpkg to DragonFly BSD**
+
+     - Install DragonFly BSD (Xfce IMG/ISO Installer in VirtualBox)
+
+## Not Yet Formatted Text Dump
+
+**Project HAMMER Debian**
+The goal of project HAMMER Debian is to recreate Debian Squeeze using the MATE desktop environment, the DragonFly BSD kernel, and the newer of the frozen Debian testing repository or the Debian stable repository.
+
+Parallel Sub-Project Documentation
+0. Setup Common to Subsequent Sub-Project Documentation
+1. Recreate Debian Squeeze using the MATE desktop environment and the newer of the frozen Debian testing repository or the Debian stable repository.
+2. Recreate Debian Squeeze using the MATE desktop environment and DragonFly BSD.
+3. Recreate Debian Squeeze using the MATE desktop environment and the newer of the frozen kFreeBSD testing repository or the kFreeBSD stable repository.
+4. Recreate Debian Squeeze using the MATE desktop environment and FreeBSD.
+5. Recreate Debian Squeeze using the MATE desktop environment, the DragonFly BSD kernel, and the newer of the frozen Debian testing repository or the Debian stable repository.
+
+0.1. Default values implied where steps are skipped.
+0.2. Installation steps are given using the apt command, but using the aptitude command instead of apt is recommended.
+0.3. These instructions sudo for root user authentication, but some systems may use su or some other method instead.
+0.4.0. The use of the nano terminal command is implied for steps which involve editing text files.
+0.4.1. The Ctrl-x shortcut can be used to bring up the save prompt and then exit from nano.
+0.5.0. Set up a development machine.
+0.5.1.0. The Oracle build of VirtualBox is recommended for its ease of use and highly active development.
+0.5.1.1. Here's a link to the VirtualBox download page. https://www.virtualbox.org/wiki/Downloads
+0.5.1.2. Here's a link to the VirtualBox Linux download page. https://www.virtualbox.org/wiki/Linux_Downloads
+0.5.1.3. Here's the /etc/apt/sources.list repository line for Debian Wheezy. deb http://download.virtualbox.org/virtualbox/debian wheezy contrib
+0.5.1.4. Here's the command to authenticate the Oracle Virtualbox repository. wget -q http://download.virtualbox.org/virtualbox/debian/oracle_vbox.asc -O- | sudo apt-key add -
+0.5.1.5. Here's the authentication fingerprint for the Oracle Virtualbox repository. 7B0F AB3A 13B9 0743 5925  D9C9 5442 2A4B 98AB 5139
+Oracle Corporation (VirtualBox archive signing key) <info@virtualbox.org>
+0.5.1.6. Here are the commands to install VirtualBox. sudo apt-get update
+sudo apt-get install dkms
+sudo apt-get install virtualbox-4.2
+0.5.1.7. It's recommended to add your regular user to the vboxusers group and the following is the recommended method. Gnome 2 Menu > System > Administration > Users and Groups > Manage Groups > vboxusers > Properties > Select Check Box of Your Regular User > OK > Password: > Your Regular User Password > Authenticate > Close > Close
+0.5.2. The recommended host software environment is a recreation of Debian Squeeze using the MATE desktop environment and the newer of the frozen Debian testing repository or the Debian stable repository.
+0.5.3. The recommended host hardware environment is an x64 computer with at least a dual core processor, 2 GB memory, a 250 GB hard disk and an Internet connection.
+0.6.