Let UPGRADING do what UPGRADING is supposed to do
[ikiwiki.git] / release54 / index.mdwn
1 # DragonFly BSD 5.4
2
3 * Version 5.4.0 released xx XXXX 2018
4
5 ** NOTE THAT THIS IS A PAGE IN PROGRESS AND IS INCOMPLETE.  5.4 IS NOT RELEASED. DO NOT LINK TO, READ, OR ACKNOWLEDGE THE EXISTENCE OF THIS PAGE. **
6
7 DragonFly version 5.4 brings a new system compiler, GCC 8, a large number network and virtual machine driver updates, and updates to video support.  This release is 64-bit only, as with previous releases.
8
9 The details of all commits between the 5.2 and 5.4 branches are available in the associated commit messages for [5.4.0rc](http://lists.dragonflybsd.org/pipermail/commits/2018-November/718131.html) and [5.4.0]().
10  
11 ## Big-ticket items
12
13 * Better support for asymmetric NUMA configurations.  In particular, both the memory subsystem and the scheduler now understand the Threadripper 2990WX's architecture.  The scheduler will prioritize CPU nodes with direct-attached memory and the memory subsystem will normalize memory queues for CPU nodes without direct-attached memory (which improves cache locality on those CPUs).
14
15 * Incremental performance work.  DragonFly as a whole is very SMP friendly.  The type of performance work we are doing now mostly revolves around improving fairness for shared-vs-exclusive lock clashes, reducing cache ping-ponging due to non-contending SMP locks (i.e. massive use of shared locks on shared resources), and so forth.
16
17 * Major updates to dports brings us to within a week or two of FreeBSD's ports as of this writing, in particular major updates to chromium, and making the whole mess work with gcc-8.
18
19 ### GCC 8 
20
21 * DragonFly now ships with GCC 8.0, and runs as the default compiler. It is also now used for building dports.
22
23 * GCC 4.7.4 and GCC 5.4.1 are still installed.  4.7.4 is our backup compiler, and 5.4.1 is still there to ensure a smooth transition, but should generally not be used.  buildworld builds all three by default to ensure maximum compatibility.
24
25 ### HAMMER2
26
27 * Bug fixing has continued.  HAMMER2 is recommended as the default root filesystem in non-clustered mode.
28 * Clustered support is not yet available.
29
30 ### Driver updates
31
32 * A number of drivers of use when running DragonFly as a guest VM have been added or updated, including ena, if_vtnet, virtio_balloon, and virtio_pci.
33 * Improvements for DRM and radeon.
34 * Serial-output-only installs are now possible.
35
36 ### Network updates
37
38 * dhcpcd has been added to the base system, and will replace dhclient and rtsold - though not in this release.
39 * A number of network device drivers have been added.
40 * A couple of edge-case panics have been fixed.
41
42 ## Details
43
44 ### Checksums
45
46     MD5 (dfly-x86_64-5.4.0_REL.img) = 
47     MD5 (dfly-x86_64-5.4.0_REL.iso) = 
48     MD5 (dfly-x86_64-5.4.0_REL.img.bz2) = 
49     MD5 (dfly-x86_64-5.4.0_REL.iso.bz2) = 
50
51 ### Upgrading
52
53 If you have an existing 5.2.x system and are running a generic kernel, the normal upgrade process, described below, will work.  
54
55 Change your local /usr/src to 5.4:
56
57     cd /usr/src
58     git fetch origin
59     git branch DragonFly_RELEASE_5_4 origin/DragonFly_RELEASE_5_4
60     git checkout DragonFly_RELEASE_5_4
61     git pull
62
63 And then rebuild: (in /usr/src )
64
65     make buildworld
66     make buildkernel
67     make installkernel
68     make installworld
69     make upgrade
70
71 Don't forget to upgrade your existing packages.  5.4 packages have already been built and are immediately available.
72
73     pkg upgrade
74
75 ## All changes since DragonFly 5.2
76
77 ### Kernel
78
79 * drm has been updated to match Linux kernel 4.7.10 in a number of locations.
80 * The radeon driver has been updated; currently matches Linux 3.18.
81 * CVE-2018-8897 mitigated.
82 * x2apic timer support added.
83 * various updates to autofs
84
85 ### Networking
86
87 * The network tunnel driver, [tun(4)](https://leaf.dragonflybsd.org/cgi/web-man?command=tun&section=4), has been cleaned up and updated.  It's now clonable for anyone building VPN links.
88 * The [tap(4)](https://leaf.dragonflybsd.org/cgi/web-man?command=tap&section=4) and interface cloning have also received related updates and fixes.
89 * Interface groups are now supported in the kernel and [pf(4)](https://leaf.dragonflybsd.org/cgi/web-man?command=pf&section=4).  They can be configured with [ifconfig(8)](https://leaf.dragonflybsd.org/cgi/web-man?command=ifconfig&section=8)
90 * DragonFly now can use [dhcpcd(8)](https://leaf.dragonflybsd.org/cgi/web-man?command=dhcpcd&section=8) for DHCP, for both IPv4 and IPv6.  See [the announcement](http://lists.dragonflybsd.org/pipermail/users/2018-November/357989.html) for details.  The existing utilities dhclient(8) and rtsold(8) are still supported, so no configuration change is required yet.
91 * The ena (Elastic Network Adapter) network driver has been added.
92 * if_iwm has had multiple updates.
93 * if_vtnet, the virtual I/O Ethernet driver, has been updated.
94
95 ### Other drivers
96
97 * The virtio_balloon memory driver has been added.
98 * /dev/sndstat can now be opened multiple times by the same device.
99 * mpr(4) driver for LSI Fusion-MPT 3/3.5 SAS controllers added.
100 * MosChip PCIe serial communications now supported.
101
102 ### Userland
103
104 ### Boot
105
106 * The initrd has had significant improvement and now forms a much more complete rescue system, with over 70 tools added via [crunchgen(1)](https://leaf.dragonflybsd.org/cgi/web-man?command=crunchgen&section=1).  See the [initrd(7)](https://leaf.dragonflybsd.org/cgi/web-man?command=initrd&section=7) man page for details.
107
108 ### Various tools have been upgraded in the base system:
109
110 * [dhcpcd](http://roy.marples.name/projects/dhcpcd) 7.0.8 imported.
111 * [openresolv](https://roy.marples.name/projects/openresolv) 3.9.0 imported, installed as [resolvconf(8)](https://leaf.dragonflybsd.org/cgi/web-man?command=resolvconf&section=8).
112 * [ip6addrctl(8)](https://leaf.dragonflybsd.org/cgi/web-man?command=ip6addrctl&section=8) together with a rc script imported from FreeBSD.
113 * DHCP server for network installs updated to net/isc-dhcp44-server.
114 * OpenSSH updated to 7.6p1.
115 * ACPICA updated to 20181031.
116 * Time zone data updated to tzdata2018g.
117 * Compiler - see next section
118
119 ### Compiler status
120
121 * gcc 8.0 is the default compiler, for kernel, world, and dports.  GCC versions 4 and 5 are still installed and built if needed.
122
123 ### Package updates
124
125 * There's a number of options now for running a web browser on DragonFly; check the [browser documentation page](https://www.dragonflybsd.org/docs/docs/howtos/WebBrowsers/) for a full list.
126
127
128