Fill out dports documentation
[ikiwiki.git] / release34 / index.mdwn
... / ...
CommitLineData
1# DragonFly Release 3.4
2
3Version 3.4.0 released xx April 2013.
4
5## Big-ticket items
6
7### Experimental packaging system: dports
8
9John Marino has created a system that uses the FreeBSD ports system to build ports for DragonFly, and uses [pkgng](https://github.com/pkgng/pkgng#readme) to manage the binary packages produced from those ports.
10
11The default packaging system on DragonFly is pkgsrc. To use dports, you must (FIXME)
12
13### Performance improvements under extreme load
14
15The process of testing [poudriere](https://fossil.etoilebsd.net/poudriere/doc/trunk/doc/index.wiki), the dports build system, exposed stability issues when repeatedly mounting and unmounting many tmpfs systems on large multicore (48) systems. These issues have been fixed.
16
17### New USB stack
18
19[USB4BSD](http://www.selasky.org/hans_petter/usb4bsd/) has been incorporated into this release. More USB devices are compatible with DragonFly, and xhci (USB 3.0) users may be able to take full advantage of their newer hardware. Since this is a new feature, it is available in 3.4 but *not* built by default. See the [original announcement](http://lists.dragonflybsd.org/pipermail/users/2012-October/017542.html) for how to do so. This feature was available in DragonFly 3.2 but is still experimental.
20
21## Availability
22
23Two release options are now available for 32-bit as well as for 64-bit. 64-bit installations are recommended if you do not need the linux emulation layer.
24
25* An ISO, to be burned to a physical CD or used as an image to install a virtual machine.
26* A bootable USB disk-key image. (minimum 2G USB stick needed)
27
28The release ISO images should be available on most of the [[mirrors|mirrors]]. If the ISO is not available on a certain mirror, please try another one or download it from the DragonFly master site. Each image is in the "Live CD" format, meaning that it boots into a running and fully functional DragonFly system, which can be used for testing or system recovery tasks as well as installation. Check the [hardware page](http://www.dragonflybsd.org/docs/supportedhardware/) or boot a Live CD to check for compatibility.
29
30
31### MD5 sums
32
33MD5 sums for the compressed images:
34
35* MD5 (dfly-i386-3.2.1_REL.img.bz2) = a592...
36* (FIXME)
37
38MD5 sums for the uncompressed images:
39
40* MD5 (dfly-i386-3.2.1_REL.img) = 52c416d...
41* (FIXME)
42
43### pkgsrc packages
44
45(FIXME)
46
47We offer roughly 10,000 pre-built [pkgsrc](http://www.pkgsrc.org) packages for this release. The [pkg_radd(1)](http://leaf.dragonflybsd.org/cgi/web-man?command=pkg_radd&section=ANY) utility may be used to download pre-built binary packages. The path can be overridden by setting BINPKG_BASE in `/etc/pkg_radd.conf`.
48
49To get a list of all packages, let [pkg_search(1)](http://leaf.dragonflybsd.org/cgi/web-man?command=pkg_search&section=ANY) download the summary file for that release:
50
51 # pkg_search -d
52
53We supply a Makefile in `/usr` to track the pkgsrc tree and we supply a Git mirror of the NetBSD pkgsrc CVS repo at `git://git.dragonflybsd.org/pkgsrcv2.git`. We recommend that users use it, instead of pulling from NetBSD with CVS. Our Git mirror is updated several times a day. Type 'make' in /usr to see the available commands for performing these actions.
54
55## DragonFly 3.4 Special Installation and Upgrade Notes
56
57**Disk size warning** - GUI disk installs and installations using HAMMER should be to disks over 50G in size. HAMMER history will consume disk space quickly. Either use UFS on smaller disks, or prune your file history carefully.
58
59**Virtual PC users** - Virtual PC does not supply serial numbers for the virtual disks. The system may need to be manually directed in the boot loader if the disk identifier changes. (Hit ? in the boot loader for a list of available volumes.)
60
61**Qemu users** - If you see a large number of error messages on the console when booting, you may need to boot DragonFly with ACPI disabled. This can be done in the menu presented at initial boot. If that doesn't help, try placing hw.ioapic_enable=0 in /boot/loader.conf.
62
63**Installer Crypt Options** - The installer can encrypt the root volume and the swap volume. It will not work properly for other volumes despite any additional check-boxes you might see. Installer and boot-time support works but is still a bit rough around the edges. Performance will be relatively high on multi-core machines.
64
65## DragonFly 3.4.0 Release Notes
66
67> ### Kernel changes
68
69* (FIXME)
70
71> ### Hardware changes
72
73* (FIXME)
74
75> ### New Multiprocessor-safe Work
76
77* (FIXME)
78
79> ### Userland changes
80
81* (FIXME)
82
83> ### Removals
84
85* None in this release (FIXME)
86
87> ### Contributed Software
88
89* Shipping with pkgsrc-2013Q1.
90* (FIXME)
91
92>### Security related
93
94* No specific security-related updates in this release. (FIXME)