article.xml revision 333724
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" version="5.0"> 15 16 <info> 17 <title>&os; &release.current; Release Notes</title> 18 19 <author> 20 <orgname>The &os; Project</orgname> 21 </author> 22 23 <pubdate>$FreeBSD: stable/11/release/doc/en_US.ISO8859-1/relnotes/article.xml 333724 2018-05-17 15:53:34Z gjb $</pubdate> 24 25 <!-- Last rev: 288943 --> 26 27 <copyright> 28 <year>2017</year> 29 <holder role="mailto:doc@FreeBSD.org">The &os; Documentation 30 Project</holder> 31 </copyright> 32 33 <legalnotice xml:id="trademarks" role="trademarks"> 34 &tm-attrib.freebsd; 35 &tm-attrib.ibm; 36 &tm-attrib.ieee; 37 &tm-attrib.intel; 38 &tm-attrib.sparc; 39 &tm-attrib.general; 40 </legalnotice> 41 42 <abstract> 43 <para>The release notes for &os; &release.current; contain 44 a summary of the changes made to the &os; base system on the 45 &release.branch; development line. This document lists 46 applicable security advisories that were issued since the last 47 release, as well as significant changes to the &os; kernel and 48 userland. Some brief remarks on upgrading are also 49 presented.</para> 50 </abstract> 51 </info> 52 53 <sect1 xml:id="intro"> 54 <title>Introduction</title> 55 56 <para>This document contains the release notes for &os; 57 &release.current;. It describes recently added, changed, or 58 deleted features of &os;. It also provides some notes on 59 upgrading from previous versions of &os;.</para> 60 61 <para releasetype="current">The &release.type; distribution to 62 which these release notes apply represents the latest point 63 along the &release.branch; development branch since 64 &release.branch; was created. Information regarding pre-built, 65 binary &release.type; distributions along this branch can be 66 found at <uri 67 xlink:href="&release.url;">&release.url;</uri>.</para> 68 69 <para releasetype="snapshot">The &release.type; distribution to 70 which these release notes apply represents a point along the 71 &release.branch; development branch between &release.prev; and 72 the future &release.next;. Information regarding pre-built, 73 binary &release.type; distributions along this branch can be 74 found at <uri 75 xlink:href="&release.url;">&release.url;</uri>.</para> 76 77 <para releasetype="release">This distribution of &os; 78 &release.current; is a &release.type; distribution. It can be 79 found at <uri xlink:href="&release.url;">&release.url;</uri> or 80 any of its mirrors. More information on obtaining this (or 81 other) &release.type; distributions of &os; can be found in the 82 <link 83 xlink:href="&url.books.handbook;/mirrors.html"><quote>Obtaining 84 &os;</quote> appendix</link> to the <link 85 xlink:href="&url.books.handbook;/">&os; 86 Handbook</link>.</para> 87 88 <para>All users are encouraged to consult the release errata 89 before installing &os;. The errata document is updated with 90 <quote>late-breaking</quote> information discovered late in the 91 release cycle or after the release. Typically, it contains 92 information on known bugs, security advisories, and corrections 93 to documentation. An up-to-date copy of the errata for &os; 94 &release.current; can be found on the &os; Web site.</para> 95 96 <para>This document describes the most user-visible new or changed 97 features in &os; since &release.prev;. In general, changes 98 described here are unique to the &release.branch; branch unless 99 specifically marked as &merged; features.</para> 100 101 <para>Typical release note items document recent security 102 advisories issued after &release.prev;, new drivers or hardware 103 support, new commands or options, major bug fixes, or 104 contributed software upgrades. They may also list changes to 105 major ports/packages or release engineering practices. Clearly 106 the release notes cannot list every single change made to &os; 107 between releases; this document focuses primarily on security 108 advisories, user-visible changes, and major architectural 109 improvements.</para> 110 </sect1> 111 112 <sect1 xml:id="upgrade"> 113 <title>Upgrading from Previous Releases of &os;</title> 114 115 <para arch="amd64,i386">Binary upgrades between RELEASE versions 116 (and snapshots of the various security branches) are supported 117 using the &man.freebsd-update.8; utility. The binary upgrade 118 procedure will update unmodified userland utilities, as well as 119 unmodified GENERIC kernels distributed as a part of an official 120 &os; release. The &man.freebsd-update.8; utility requires that 121 the host being upgraded have Internet connectivity.</para> 122 123 <para>Source-based upgrades (those based on recompiling the &os; 124 base system from source code) from previous versions are 125 supported, according to the instructions in 126 <filename>/usr/src/UPDATING</filename>.</para> 127 128 <important> 129 <para>Upgrading &os; should only be attempted after backing up 130 <emphasis>all</emphasis> data and configuration files.</para> 131 </important> 132 </sect1> 133 134 <sect1 xml:id="security-errata"> 135 <title>Security and Errata</title> 136 137 <para>This section lists the various Security Advisories and 138 Errata Notices since &release.prev;.</para> 139 140 <sect2 xml:id="security"> 141 <title>Security Advisories</title> 142 143 &security; 144 </sect2> 145 146 <sect2 xml:id="errata"> 147 <title>Errata Notices</title> 148 149 &errata; 150 </sect2> 151 </sect1> 152 153 <sect1 xml:id="userland"> 154 <title>Userland</title> 155 156 <para>This section covers changes and additions to userland 157 applications, contributed software, and system utilities.</para> 158 159 <sect2 xml:id="userland-config"> 160 <title>Userland Configuration Changes</title> 161 162 <para> </para> 163 </sect2> 164 165 <sect2 xml:id="userland-programs"> 166 <title>Userland Application Changes</title> 167 168 <para revision="321092">The &man.ln.1; utility has been updated 169 to correct the behavior of the <literal>-F</literal> flag by 170 unlinking an existing directory before creating a symbolic 171 link.</para> 172 173 <para revision="321241">The &man.crontab.1; utility has been 174 updated to include a new flag, <literal>-f</literal>, which 175 forces &man.crontab.5; removal when <literal>-r</literal> is 176 used non-interactively.</para> 177 178 <para revision="321262">The &man.newsyslog.8; utility has been 179 updated to support <acronym>RFC</acronym>5424-compliant 180 messages when rotating system logs.</para> 181 182 <para revision="321287" contrib="sponsor" sponsor="&gandi;">The 183 &man.sesutil.8; utility has been updated to include 184 &man.libxo.3; support in output.</para> 185 186 <para revision="321927">The &man.diskinfo.8; utility has been 187 updated to include two new flags, <literal>-s</literal> which 188 displays the disk identity (usually the serial number), and 189 <literal>-p</literal> which displays the physical path to the 190 disk in a storage controller. The <literal>-s</literal> and 191 <literal>-p</literal> flags are mutually exclusive, and cannot 192 be used with any other flags.</para> 193 194 <para revision="321929">The &man.diskinfo.8; utility has also 195 been updated to include device model when the 196 <literal>-s</literal> flag is used.</para> 197 198 <para revision="322910">The &man.umount.8; utility has been 199 updated to include a new flag, <literal>-N</literal>, which 200 is used to forcefully unmount an <acronym>NFS</acronym> 201 mounted filesystem.</para> 202 203 <para revision="322919">The &man.pw.8; utility has been updated 204 to properly handle empty secondary group lists as an argument 205 to the <literal>-G</literal> flag when using the 206 <literal>usermod</literal> subcommand.</para> 207 208 <para revision="324124" contrib="sponsor" 209 sponsor="&chelsio;">The &man.getconf.1; utility has been 210 updated to include a new flag, <literal>-a</literal>, which 211 prints the name and value of all system or path configuration 212 values to &man.stdout.4; or optionally a file as an argument 213 to <literal>-a</literal>.</para> 214 215 <para revision="324270">The &man.ps.1; utility has been updated 216 to reflect realtime and idle priorities in state flags.</para> 217 218 <para revision="324271">The &man.ps.1; utility has been updated 219 to display if a process is running with &man.capsicum.4; 220 capability mode, indicated by <literal>C</literal>.</para> 221 222 <para revision="324380">The &man.cpucontrol.8; utility has been 223 updated to include a new flag, <literal>-n</literal>, that 224 disables the default microcode update search path when 225 used.</para> 226 227 <para revision="324674">The &man.fsck.ffs.8; utility has been 228 updated to prevent a filesystem from being reported as 229 modified when only the timestamp in the superblock is 230 updated.</para> 231 232 <para revision="325003" contrib="sponsor" 233 sponsor="&spectralogic;">The &man.diskinfo.8; utility has been 234 updated to display disk rotation rate and if 235 <acronym>TRIM</acronym>/<acronym>UNMAP</acronym> is supported 236 by the disk.</para> 237 238 <para revision="325473">The &man.rsh.1; utility has been updated 239 to include a new flag, <literal>-N</literal>, which disables 240 shutdown of a socket sending path when used.</para> 241 242 <para revision="326413">The &man.pfctl.8; utility has been 243 updated to allow <literal>route-to</literal> to properly 244 handle network interfaces with multiple <acronym>IP</acronym> 245 addresses.</para> 246 247 <para revision="326778" contrib="sponsor" 248 sponsor="&spectralogic;">The &man.camcontrol.8; utility has 249 been updated to include <acronym>ZAC</acronym> (Zoned-device 250 <acronym>ATA</acronym> command set) information when the 251 <literal>identify</literal> subcommand is used.</para> 252 253 <para revision="326848">The &man.pw.8; utility has been updated 254 to correct handling of account expiration periods.</para> 255 256 <para revision="327592">The &man.mdmfs.8; utility has been 257 updated to support &man.tmpfs.5;.</para> 258 259 <para revision="327871">The &man.cpucontrol.8; utility has been 260 updated to include a new flag, <literal>-e</literal>, which is 261 used to re-evaluate reported <acronym>CPU</acronym> features 262 after applying firmware updates.</para> 263 264 <note> 265 <para>The &man.cpucontrol.8; <literal>-e</literal> flag should 266 only be used after microcode update have been applied to all 267 <acronym>CPU</acronym>s in the system, otherwise system 268 instability may be experienced if processor features are not 269 identical across the system.</para> 270 </note> 271 272 <para revision="328139">The &man.du.1; utility has been updated 273 to include the <literal>--si</literal> long option, which is 274 used to display output in "human-readable" output in 275 powers of 1000.</para> 276 277 <para revision="328140">The &man.df.1; utility has been updated 278 to include the <literal>--si</literal> long option, which is 279 an alias to <literal>-H</literal>.</para> 280 281 <para revision="328599">The &man.service.8; utility has been 282 updated to include a new flag, <literal>-j</literal>, which is 283 used to interact with services running within a &man.jail.8;. 284 The argument to <literal>-j</literal> can be either the name 285 or numeric jail <acronym>ID</acronym>.</para> 286 287 <para revision="328604" contrib="sponsor" 288 sponsor="&dellemc;">The &man.fsck.ffs.8; utility has been 289 updated to exit with a non-zero status when the filesystem is 290 not repaired.</para> 291 292 <para revision="328668">The &man.nvmecontrol.8; utility has been 293 updated to print the full 128 bit value for 294 <acronym>SMART</acronym> data, instead of the hexadecimal 295 value.</para> 296 297 <para revision="328716">The &man.nvmecontrol.8; utility has been 298 updated to include control options for Western Digital® 299 HGST drives. The new options are <literal>cap-diag</literal>, 300 <literal>get-crash-dump</literal>, 301 <literal>drive-log</literal>, <literal>purge</literal>, and 302 <literal>purge-monitor</literal>.</para> 303 304 <para revision="330692" contrib="sponsor" 305 sponsor="&dellemc;">The &man.dhclient.8; utility has been 306 updated to be more compliant with <acronym>RFC</acronym>2131 307 by setting the source address field in the 308 <acronym>IP</acronym> header to <literal>0</literal> when 309 sending a <literal>DHCPREQUEST</literal> message to attempt to 310 obtain a previously-assigned <literal>IP</literal> 311 address.</para> 312 313 <para revision="330694" contrib="sponsor" 314 sponsor="&dellemc;">The &man.pw.8; utility has been updated to 315 allow the <literal>@</literal> and <literal>!</literal> 316 characters in the <acronym>GECOS</acronym> field.</para> 317 318 <para revision="331471">The &man.ps.1; utility has been updated 319 to include a <literal>jail</literal> keyword, which when used 320 will list the name of a &man.jail.8; instead of the numeric 321 ID.</para> 322 323 <para revision="331586" contrib="sponsor" 324 sponsor="&mellanox;">The &man.mlx5tool.8; utility has been 325 added, which is used to manage Connect-X 4 and 326 Connect-X 5 devices supported by &man.mlx5io.4;.</para> 327 328 <para revision="331603" contrib="sponsor" 329 sponsor="&chelsio;">The &man.sysctl.8; utility has been 330 updated to support setting an array of values to nodes. Prior 331 to this change, &man.sysctl.8; could only set one value to 332 a node that may return multiple values when queried.</para> 333 334 <para revision="331729">The &man.ifconfig.8; utility has been 335 updated to include a <literal>random</literal> option, which 336 when used with the <literal>ether</literal> option, generates 337 a random <acronym>MAC</acronym> address for an 338 interface.</para> 339 340 <para revision="332126" contrib="sponsor" 341 sponsor="&netflix;">The &man.efibootmgr.8; utility has been 342 added, which is used to manipulate the <acronym>EFI</acronym> 343 boot manager.</para> 344 </sect2> 345 346 <sect2 xml:id="userland-contrib"> 347 <title>Contributed Software</title> 348 349 <para revision="321303">The &man.libarchive.3; library has been 350 updated to version 3.3.2.</para> 351 352 <para revision="322172">The &man.libxo.3; library has been 353 updated to version 0.8.4.</para> 354 355 <para revision="322442"><application>Subversion</application> 356 has been updated to version 1.9.7.</para> 357 358 <para revision="328495">The &man.dtc.1; utility has been updated 359 to upstream commit 9ce35ff8.</para> 360 361 <para revision="328874">The &man.file.1; utility has been 362 updated to version 5.32.</para> 363 364 <para revision="323136"><application>OpenSSH</application> has 365 been updated to version 7.5p1.</para> 366 367 <para revision="324581">The &man.mandoc.1; utility has been 368 updated to version 1.14.3.</para> 369 370 <para revision="327234">The &man.tcpdump.1; utility has been 371 updated to version 4.9.2.</para> 372 373 <para revision="330106">The <acronym>NTP</acronym> utilities 374 have been updated to version 4.2.8p11.</para> 375 376 <para revision="330570">The &man.less.1; utility has been 377 updated to upstream version v530.</para> 378 379 <para revision="331246">The <application>bmake</application> 380 utility has been updated to upstream version 20180222.</para> 381 382 <para revision="331465">The <acronym>BSD</acronym>-licensed 383 &man.diff.1; utility has been imported from OpenBSD, which is 384 installed if <literal>WITHOUT_GNU_DIFF</literal> is set in 385 &man.src.conf.5;, and otherwise not installed by 386 default.</para> 387 388 <para revision="331638"><application>OpenSSL</application> has 389 been updated to version 1.0.2o.</para> 390 391 <para revision="331662">Timezone data files have been updated to 392 version 2018d.</para> 393 394 <para revision="331838">The <application>clang</application>, 395 <application>llvm</application>, 396 <application>lld</application>, 397 <application>lldb</application>, and 398 <literal>compiler-rt</literal> utilities as well as 399 <literal>libc++</literal> have been updated to upstream 400 version 6.0.0.</para> 401 </sect2> 402 403 <sect2 xml:id="userland-installer"> 404 <title>Installation and Configuration Tools</title> 405 406 <para revision="322254" contrib="sponsor" sponsor="&ff;" 407 arch="&arch.arm64;">The &man.bsdinstall.8; installer has been 408 updated to default to <acronym>UEFI</acronym>-only 409 boot.</para> 410 </sect2> 411 412 <sect2 xml:id="userland-rc"> 413 <title><filename class="directory">/etc/rc.d</filename> 414 Scripts</title> 415 416 <para> </para> 417 </sect2> 418 419 <sect2 xml:id="userland-periodic"> 420 <title><filename class="directory">/etc/periodic</filename> 421 Scripts</title> 422 423 <para> </para> 424 </sect2> 425 426 <sect2 xml:id="userland-libraries"> 427 <title>Runtime Libraries and API</title> 428 429 <para> </para> 430 </sect2> 431 432 <sect2 xml:id="userland-abi"> 433 <title>ABI Compatibility</title> 434 435 <para> </para> 436 </sect2> 437 438 <sect2 xml:id="userland-debug"> 439 <title>Userland Debugging</title> 440 441 <para> </para> 442 </sect2> 443 </sect1> 444 445 <sect1 xml:id="kernel"> 446 <title>Kernel</title> 447 448 <para>This section covers changes to kernel configurations, system 449 tuning, and system control parameters that are not otherwise 450 categorized.</para> 451 452 <sect2 xml:id="kernel-general"> 453 <title>General Kernel Changes</title> 454 455 <para> </para> 456 </sect2> 457 458 <sect2 xml:id="kernel-bugfix"> 459 <title>Kernel Bug Fixes</title> 460 461 <para> </para> 462 </sect2> 463 464 <sect2 xml:id="kernel-config"> 465 <title>Kernel Configuration</title> 466 467 <para> </para> 468 </sect2> 469 470 <sect2 xml:id="kernel-modules"> 471 <title>Kernel Modules</title> 472 473 <para> </para> 474 </sect2> 475 476 <sect2 xml:id="kernel-sysctl"> 477 <title>System Tuning and Controls</title> 478 479 <para> </para> 480 </sect2> 481 </sect1> 482 483 <sect1 xml:id="drivers"> 484 <title>Devices and Drivers</title> 485 486 <para>This section covers changes and additions to devices and 487 device drivers since &release.prev;.</para> 488 489 <sect2 xml:id="drivers-device"> 490 <title>Device Drivers</title> 491 492 <para revision="331586" contrib="sponsor" 493 sponsor="&mellanox;">The &man.mlx5io.4; driver has been added, 494 providing an interface to manage supported Connect-X 4 495 and Connect-X 5 network adapters.</para> 496 497 <para revision="330307" contrib="sponsor" 498 sponsor="&chelsio;">The &man.cxgbe.4; driver has been updated 499 to firmware version 1.16.63.0 for T4, T5, and T6 network 500 adapters.</para> 501 </sect2> 502 503 <sect2 xml:id="drivers-storage"> 504 <title>Storage Drivers</title> 505 506 <para> </para> 507 </sect2> 508 509 <sect2 xml:id="drivers-network"> 510 <title>Network Drivers</title> 511 512 <para> </para> 513 </sect2> 514 </sect1> 515 516 <sect1 xml:id="hardware"> 517 <title>Hardware Support</title> 518 519 <para>This section covers general hardware support for physical 520 machines, hypervisors, and virtualization environments, as well 521 as hardware changes and updates that do not otherwise fit in 522 other sections of this document.</para> 523 524 <sect2 xml:id="hardware-support"> 525 <title>Hardware Support</title> 526 527 <para revision="331500">Support for the TAIO 528 <acronym>USB</acronym> multi-protocol adapter 529 (<acronym>TUMPA</acronym>) has been added.</para> 530 </sect2> 531 532 <sect2 xml:id="hardware-virtualization"> 533 <title>Virtualization Support</title> 534 535 <para revision="321413">Support for &man.virtio.console.4; has 536 been added to &man.bhyve.4;.</para> 537 </sect2> 538 539 <sect2 xml:id="hardware-arm"> 540 <title>ARM Support</title> 541 542 <para> </para> 543 </sect2> 544 </sect1> 545 546 <sect1 xml:id="storage"> 547 <title>Storage</title> 548 549 <para>This section covers changes and additions to file systems 550 and other storage subsystems, both local and networked.</para> 551 552 <sect2 xml:id="storage-general"> 553 <title>General Storage</title> 554 555 <para> </para> 556 </sect2> 557 558 <sect2 xml:id="storage-net"> 559 <title>Networked Storage</title> 560 561 <para> </para> 562 </sect2> 563 564 <sect2 xml:id="storage-zfs"> 565 <title>ZFS</title> 566 567 <para> </para> 568 </sect2> 569 570 <sect2 xml:id="storage-geom"> 571 <title><literal>geom(4)</literal></title> 572 573 <para> </para> 574 </sect2> 575 </sect1> 576 577 <sect1 xml:id="boot"> 578 <title>Boot Loader Changes</title> 579 580 <para>This section covers the boot loader, boot menu, and other 581 boot-related changes.</para> 582 583 <sect2 xml:id="boot-loader"> 584 <title>Boot Loader Changes</title> 585 586 <para revision="329114">The length of <acronym>GELI</acronym> 587 passphrases entered when booting a system with encrypted disks 588 is now hidden by default. See the configuration options in 589 &man.geli.8; to restore the previous behavior.</para> 590 </sect2> 591 592 <sect2 xml:id="boot-menu"> 593 <title>Boot Menu Changes</title> 594 595 <para> </para> 596 </sect2> 597 </sect1> 598 599 <sect1 xml:id="network"> 600 <title>Networking</title> 601 602 <para>This section describes changes that affect networking in 603 &os;.</para> 604 605 <sect2 xml:id="network-general"> 606 <title>General Network Changes</title> 607 608 <para> </para> 609 </sect2> 610 611 <sect2 xml:id="network-protocols"> 612 <title>Network Protocols</title> 613 614 <para> </para> 615 </sect2> 616 </sect1> 617 618 <sect1 xml:id="ports"> 619 <title>Ports Collection and Package Infrastructure</title> 620 621 <para>This section covers changes to the &os; Ports 622 Collection, package infrastructure, and package maintenance and 623 installation tools.</para> 624 625 <sect2 xml:id="ports-infrastructure"> 626 <title>Infrastructure Changes</title> 627 628 <para> </para> 629 </sect2> 630 631 <sect2 xml:id="ports-packages "> 632 <title>Packaging Changes</title> 633 634 <para> </para> 635 </sect2> 636 </sect1> 637 638 <sect1 xml:id="doc"> 639 <title>Documentation</title> 640 641 <para>This section covers changes to the &os; Documentation 642 Project sources and toolchain.</para> 643 644 <sect2 xml:id="doc-sources"> 645 <title>Documentation Source Changes</title> 646 647 <para> </para> 648 </sect2> 649 650 <sect2 xml:id="doc-toolchain"> 651 <title>Documentation Toolchain Changes</title> 652 653 <para> </para> 654 </sect2> 655 </sect1> 656 657 <sect1 xml:id="releng"> 658 <title>Release Engineering and Integration</title> 659 660 <para>This section convers changes that are specific to the 661 &os; Release Engineering processes.</para> 662 663 <sect2 xml:id="releng-changes"> 664 <title>Integration Changes</title> 665 666 <para revision="326892">Amazon® EC2™ instances now 667 keep their clocks synchronized using the Amazon Time Sync 668 Service, the <acronym>NTP</acronym> service internal to the 669 EC2™ infrastructure.</para> 670 </sect2> 671 </sect1> 672</article> 673