article.xml revision 346164
1<?xml version="1.0" encoding="iso-8859-1"?> 2<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN" 3 "../../../share/xml/freebsd50.dtd" [ 4<!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN" "release.ent"> 5 %release; 6<!ENTITY % sponsor PUBLIC "-//FreeBSD//ENTITIES Sponsor Specification//EN" "sponsor.ent"> 7 %sponsor; 8<!ENTITY % vendor PUBLIC "-//FreeBSD//ENTITIES Vendor Specification//EN" "vendor.ent"> 9 %vendor; 10<!ENTITY security SYSTEM "../../share/xml/security.xml"> 11<!ENTITY errata SYSTEM "../../share/xml/errata.xml"> 12]> 13<article xmlns="http://docbook.org/ns/docbook" 14 xmlns:xlink="http://www.w3.org/1999/xlink" 15 xml:id="top" 16 version="5.0"> 17 18 <info> 19 <title>&os; &release.current; Release Notes</title> 20 21 <author> 22 <orgname>The &os; Project</orgname> 23 </author> 24 25 <pubdate>$FreeBSD: stable/11/release/doc/en_US.ISO8859-1/relnotes/article.xml 346164 2019-04-12 19:05:43Z gjb $</pubdate> 26 27 <!-- Last rev: 288943 --> 28 29 <copyright> 30 <year>2019</year> 31 <holder role="mailto:doc@FreeBSD.org">The &os; Documentation 32 Project</holder> 33 </copyright> 34 35 <legalnotice xml:id="trademarks" role="trademarks"> 36 &tm-attrib.freebsd; 37 &tm-attrib.ibm; 38 &tm-attrib.ieee; 39 &tm-attrib.intel; 40 &tm-attrib.sparc; 41 &tm-attrib.general; 42 </legalnotice> 43 44 <abstract> 45 <para>The release notes for &os; &release.current; contain 46 a summary of the changes made to the &os; base system on the 47 &release.branch; development line. This document lists 48 applicable security advisories that were issued since the last 49 release, as well as significant changes to the &os; kernel and 50 userland. Some brief remarks on upgrading are also 51 presented.</para> 52 </abstract> 53 </info> 54 55 <sect1 xml:id="intro"> 56 <title>Introduction</title> 57 58 <para>This document contains the release notes for &os; 59 &release.current;. It describes recently added, changed, or 60 deleted features of &os;. It also provides some notes on 61 upgrading from previous versions of &os;.</para> 62 63 <para releasetype="current">The &release.type; distribution to 64 which these release notes apply represents the latest point 65 along the &release.branch; development branch since 66 &release.branch; was created. Information regarding pre-built, 67 binary &release.type; distributions along this branch can be 68 found at <uri 69 xlink:href="&release.url;">&release.url;</uri>.</para> 70 71 <para releasetype="snapshot">The &release.type; distribution to 72 which these release notes apply represents a point along the 73 &release.branch; development branch between &release.prev; and 74 the future &release.next;. Information regarding pre-built, 75 binary &release.type; distributions along this branch can be 76 found at <uri 77 xlink:href="&release.url;">&release.url;</uri>.</para> 78 79 <para releasetype="release">This distribution of &os; 80 &release.current; is a &release.type; distribution. It can be 81 found at <uri xlink:href="&release.url;">&release.url;</uri> or 82 any of its mirrors. More information on obtaining this (or 83 other) &release.type; distributions of &os; can be found in the 84 <link 85 xlink:href="&url.books.handbook;/mirrors.html"><quote>Obtaining 86 &os;</quote> appendix</link> to the <link 87 xlink:href="&url.books.handbook;/">&os; 88 Handbook</link>.</para> 89 90 <para>All users are encouraged to consult the release errata 91 before installing &os;. The errata document is updated with 92 <quote>late-breaking</quote> information discovered late in the 93 release cycle or after the release. Typically, it contains 94 information on known bugs, security advisories, and corrections 95 to documentation. An up-to-date copy of the errata for &os; 96 &release.current; can be found on the &os; Web site.</para> 97 98 <para>This document describes the most user-visible new or changed 99 features in &os; since &release.prev;. In general, changes 100 described here are unique to the &release.branch; branch unless 101 specifically marked as &merged; features.</para> 102 103 <para>Typical release note items document recent security 104 advisories issued after &release.prev;, new drivers or hardware 105 support, new commands or options, major bug fixes, or 106 contributed software upgrades. They may also list changes to 107 major ports/packages or release engineering practices. Clearly 108 the release notes cannot list every single change made to &os; 109 between releases; this document focuses primarily on security 110 advisories, user-visible changes, and major architectural 111 improvements.</para> 112 </sect1> 113 114 <sect1 xml:id="upgrade"> 115 <title>Upgrading from Previous Releases of &os;</title> 116 117 <para arch="amd64,i386">Binary upgrades between RELEASE versions 118 (and snapshots of the various security branches) are supported 119 using the &man.freebsd-update.8; utility. The binary upgrade 120 procedure will update unmodified userland utilities, as well as 121 unmodified GENERIC kernels distributed as a part of an official 122 &os; release. The &man.freebsd-update.8; utility requires that 123 the host being upgraded have Internet connectivity.</para> 124 125 <para>Source-based upgrades (those based on recompiling the &os; 126 base system from source code) from previous versions are 127 supported, according to the instructions in 128 <filename>/usr/src/UPDATING</filename>.</para> 129 130 <important> 131 <para>Upgrading &os; should only be attempted after backing up 132 <emphasis>all</emphasis> data and configuration files.</para> 133 </important> 134 </sect1> 135 136 <sect1 xml:id="security-errata"> 137 <title>Security and Errata</title> 138 139 <para>This section lists the various Security Advisories and 140 Errata Notices since &release.prev;.</para> 141 142 <sect2 xml:id="security"> 143 <title>Security Advisories</title> 144 145 &security; 146 </sect2> 147 148 <sect2 xml:id="errata"> 149 <title>Errata Notices</title> 150 151 &errata; 152 </sect2> 153 </sect1> 154 155 <sect1 xml:id="userland"> 156 <title>Userland</title> 157 158 <para>This section covers changes and additions to userland 159 applications, contributed software, and system utilities.</para> 160 161 <sect2 xml:id="userland-config"> 162 <title>Userland Configuration Changes</title> 163 164 <para> </para> 165 </sect2> 166 167 <sect2 xml:id="userland-programs"> 168 <title>Userland Application Changes</title> 169 170 <para> </para> 171 </sect2> 172 173 <sect2 xml:id="userland-contrib"> 174 <title>Contributed Software</title> 175 176 <para> </para> 177 </sect2> 178 179 <sect2 xml:id="userland-installer"> 180 <title>Installation and Configuration Tools</title> 181 182 <para> </para> 183 </sect2> 184 185 <sect2 xml:id="userland-rc"> 186 <title><filename class="directory">/etc/rc.d</filename> 187 Scripts</title> 188 189 <para> </para> 190 </sect2> 191 192 <sect2 xml:id="userland-periodic"> 193 <title><filename class="directory">/etc/periodic</filename> 194 Scripts</title> 195 196 <para> </para> 197 </sect2> 198 199 <sect2 xml:id="userland-libraries"> 200 <title>Runtime Libraries and API</title> 201 202 <para> </para> 203 </sect2> 204 205 <sect2 xml:id="userland-abi"> 206 <title>ABI Compatibility</title> 207 208 <para> </para> 209 </sect2> 210 211 <sect2 xml:id="userland-debug"> 212 <title>Userland Debugging</title> 213 214 <para> </para> 215 </sect2> 216 </sect1> 217 218 <sect1 xml:id="kernel"> 219 <title>Kernel</title> 220 221 <para>This section covers changes to kernel configurations, system 222 tuning, and system control parameters that are not otherwise 223 categorized.</para> 224 225 <sect2 xml:id="kernel-general"> 226 <title>General Kernel Changes</title> 227 228 <para> </para> 229 </sect2> 230 231 <sect2 xml:id="kernel-bugfix"> 232 <title>Kernel Bug Fixes</title> 233 234 <para> </para> 235 </sect2> 236 237 <sect2 xml:id="kernel-config"> 238 <title>Kernel Configuration</title> 239 240 <para> </para> 241 </sect2> 242 243 <sect2 xml:id="kernel-modules"> 244 <title>Kernel Modules</title> 245 246 <para> </para> 247 </sect2> 248 249 <sect2 xml:id="kernel-sysctl"> 250 <title>System Tuning and Controls</title> 251 252 <para> </para> 253 </sect2> 254 </sect1> 255 256 <sect1 xml:id="drivers"> 257 <title>Devices and Drivers</title> 258 259 <para>This section covers changes and additions to devices and 260 device drivers since &release.prev;.</para> 261 262 <sect2 xml:id="drivers-device"> 263 <title>Device Drivers</title> 264 265 <para> </para> 266 </sect2> 267 268 <sect2 xml:id="drivers-storage"> 269 <title>Storage Drivers</title> 270 271 <para> </para> 272 </sect2> 273 274 <sect2 xml:id="drivers-network"> 275 <title>Network Drivers</title> 276 277 <para> </para> 278 </sect2> 279 </sect1> 280 281 <sect1 xml:id="hardware"> 282 <title>Hardware Support</title> 283 284 <para>This section covers general hardware support for physical 285 machines, hypervisors, and virtualization environments, as well 286 as hardware changes and updates that do not otherwise fit in 287 other sections of this document.</para> 288 289 <sect2 xml:id="hardware-support"> 290 <title>Hardware Support</title> 291 292 <para> </para> 293 </sect2> 294 295 <sect2 xml:id="hardware-virtualization"> 296 <title>Virtualization Support</title> 297 298 <para revision="321413">Support for &man.virtio.console.4; has 299 been added to &man.bhyve.4;.</para> 300 </sect2> 301 302 <sect2 xml:id="hardware-arm"> 303 <title>ARM Support</title> 304 305 <para> </para> 306 </sect2> 307 </sect1> 308 309 <sect1 xml:id="storage"> 310 <title>Storage</title> 311 312 <para>This section covers changes and additions to file systems 313 and other storage subsystems, both local and networked.</para> 314 315 <sect2 xml:id="storage-general"> 316 <title>General Storage</title> 317 318 <para> </para> 319 </sect2> 320 321 <sect2 xml:id="storage-net"> 322 <title>Networked Storage</title> 323 324 <para> </para> 325 </sect2> 326 327 <sect2 xml:id="storage-zfs"> 328 <title>ZFS</title> 329 330 <para> </para> 331 </sect2> 332 333 <sect2 xml:id="storage-geom"> 334 <title><literal>geom(4)</literal></title> 335 336 <para> </para> 337 </sect2> 338 </sect1> 339 340 <sect1 xml:id="boot"> 341 <title>Boot Loader Changes</title> 342 343 <para>This section covers the boot loader, boot menu, and other 344 boot-related changes.</para> 345 346 <sect2 xml:id="boot-loader"> 347 <title>Boot Loader Changes</title> 348 349 <para> </para> 350 </sect2> 351 352 <sect2 xml:id="boot-menu"> 353 <title>Boot Menu Changes</title> 354 355 <para> </para> 356 </sect2> 357 </sect1> 358 359 <sect1 xml:id="network"> 360 <title>Networking</title> 361 362 <para>This section describes changes that affect networking in 363 &os;.</para> 364 365 <sect2 xml:id="network-general"> 366 <title>General Network Changes</title> 367 368 <para> </para> 369 </sect2> 370 371 <sect2 xml:id="network-protocols"> 372 <title>Network Protocols</title> 373 374 <para> </para> 375 </sect2> 376 </sect1> 377 378 <sect1 xml:id="ports"> 379 <title>Ports Collection and Package Infrastructure</title> 380 381 <para>This section covers changes to the &os; Ports 382 Collection, package infrastructure, and package maintenance and 383 installation tools.</para> 384 385 <sect2 xml:id="ports-infrastructure"> 386 <title>Infrastructure Changes</title> 387 388 <para> </para> 389 </sect2> 390 391 <sect2 xml:id="ports-packages "> 392 <title>Packaging Changes</title> 393 394 <para> </para> 395 </sect2> 396 </sect1> 397 398 <sect1 xml:id="doc"> 399 <title>Documentation</title> 400 401 <para>This section covers changes to the &os; Documentation 402 Project sources and toolchain.</para> 403 404 <sect2 xml:id="doc-sources"> 405 <title>Documentation Source Changes</title> 406 407 <para> </para> 408 </sect2> 409 410 <sect2 xml:id="doc-toolchain"> 411 <title>Documentation Toolchain Changes</title> 412 413 <para> </para> 414 </sect2> 415 </sect1> 416 417 <sect1 xml:id="releng"> 418 <title>Release Engineering and Integration</title> 419 420 <para>This section convers changes that are specific to the 421 &os; Release Engineering processes.</para> 422 423 <sect2 xml:id="releng-changes"> 424 <title>Integration Changes</title> 425 426 <para> </para> 427 </sect2> 428 </sect1> 429</article> 430