docs/faq/FAQ-English.mdwn

   1 This is the official DragonFly FAQ. Primary language is English, but you can also find translations to other languages <a href="http://www.dragonflybsd.org/docs/faq/">here</a>.
   2
   3 [[!toc startlevel=3]]
   4
   5 ### Is DragonFly ready for production?
   6
   7 Yes. DragonFly is generally stable and speedy at this point. For third-party software, it uses DPorts, which is based on the [FreeBSD ports collection](http://www.freebsd.org/ports/index.html) and contains more than 24000 packages. You are advised to keep a close eye on the forums. Check the [forums page](http://www.dragonflybsd.org/mailinglists/) to find out on how to get access. We have an active community that are working on keeping things working. As in any open source project, if you find problems reporting them increases the chance that someone can fix it.
   8
   9
  10 ### What are the potential goals for the next release?
  11
  12 For DragonFly news and events, keep an eye on the [DragonFly BSD Digest](http://www.dragonflydigest.com/), the DragonFly Wiki, and the [DragonFly mailing lists/newsgroups](http://www.dragonflybsd.org/mailinglists/).
  13
  14
  15 ### Is there a branch oriented towards stability, like the FreeBSD's -STABLE?
  16
  17 We have a `-RELEASE` tag which is considered to be stable.
  18
  19
  20 ### How do I upgrade my system?
  21 There are 3 areas to upgrade: userland, kernel and world. To upgrade userland do `pkg upgrade`  but you may need to update <i>pkg</i> itself when its been a while since your last update. The kernel and world need the source code. If you haven't pulled it yet: `cd /usr && make src-create-shallow && cd src && git pull`. Rememeber this is for the <u>initial</u> creation of /usr/src. Update existing tree: `cd /usr/src && git pull` then <br>
  22 `make buildworld` <br>
  23 `make buildkernel`<br>
  24 `make preupgrade`<br>
  25 `make installkernel`<br>
  26 `make installworld`<br>
  27 `make upgrade`<br>
  28 `reboot`.
  29
  30 Detailed information can be found in `more /usr/src/UPDATING`.
  31
  32
  33 ### I get garbage on the screen when I boot or I can't seem to pause at the initial boot menu.
  34
  35 DragonFly, when booting, outputs to both video and serial ports. If the booting computer has a 'noisy' serial device connected, it may read data from it during the boot process. Serial console activation during boot can be disabled by creating the file `/boot.config` with this contents: `-V`
  36
  37
  38 ### How can I speed up my build process?
  39
  40 You can use `make quickworld` instead of `make buildworld`. This reuses existing tools on disk and speeds this step up considerably. For the kernel there is a similar `quickkernel` target.
  41
  42
  43 ### But `make quickworld` / `make quickkernel` fails!
  44
  45 Try `make buildworld` or `make buildkernel` instead.
  46
  47
  48 ### What is used to handle third-party applications? (like ports, yum, apt-get, etc.)
  49
  50 Since 3.6, DragonFly uses DPorts, a patched version of the [FreeBSD ports collection](http://www.freebsd.org/ports/index.html), modified and tested to run on DragonFly systems. You can build from the DPorts collection by going to the port of your choice and running `make config install clean`. Binary packages are advised unless nonstandard options are required, *pkg* is the tool used and has thorough documentation in the man page and the help flag.
  51
  52
  53 ### What architectures does DragonFly support?
  54
  55 DragonFly is currently targeted at the 64-bit x86 line of processors (x86_64); version 3.8 was the last release supporting 32-bit processors (i386). There are currently no plans for support of other processor types. However, support for Sparc or PowerPC or other systems is possible in the future. If you plan to submit code to the DragonFly project, please keep this in mind.
  56
  57
  58 ### How can I contribute?
  59
  60 Pick a topic that you enjoy and start working. Check the [team page](http://www.dragonflybsd.org/team/) to see if there are others interested in your topic, or ask around in the [appropriate forum](http://www.dragonflybsd.org/mailinglists/). You can [download the source](http://www.dragonflybsd.org/download/) to the operating system and to the official site, and send patches in unified diff format (`diff -uN`) to *submit at dragonflybsd.org* for review. Subscribe to that same submit [mailing list/newsgroup](http://www.dragonflybsd.org/mailinglists/) to see feedback on your patches, and to find if they have been accepted or rejected. In addition, you can update the DragonFly Wiki.
  61
  62 Note that you do not have to be a programmer in order to help. Evangelizing DragonFly and testing it on a variety of hardware, and reporting results can help a great deal. Try new features and report to the forums on your experiences. Cleaning up `/etc/rc.d` only requires shell script experience, for instance, and there's always a need for better documentation.
  63
  64
  65 ### Does DragonFly use a dynamic `/dev` filesystem, as in *devfs*?
  66
  67 Since 2.3, DragonFly has a dynamic `/dev` file system, aka [devfs(5)](http://leaf.dragonflybsd.org/cgi/web-man?command=devfs&section=ANY).
  68
  69
  70 ### Will DragonFly use (insert name here) technology?
  71
  72 Yes and no. Features must match the existing plan outlined on the site here, and there's plenty of existing problems to solve before 'nonessential' work can be done. However, if you are willing to work on it, it probably can be done. The [forums](http://www.dragonflybsd.org/mailinglists/) are an excellent place to get feedback and to find others that may be interested in your topic. The [team page](http://www.dragonflybsd.org/team/) is also a good place to check.
  73
  74
  75 ### What's the correct way to name this operating system?
  76
  77 It's a BSD variant, called DragonFly. Note the capitalization on the F, which isn't proper English.