]> CyberLeo.Net >> Repos - FreeBSD/stable/10.git/blob - release/doc/en_US.ISO8859-1/relnotes/article.xml
Document r283548, mkimg(1) now used for i386 memstick images.
[FreeBSD/stable/10.git] / release / doc / en_US.ISO8859-1 / relnotes / article.xml
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$</pubdate>
24
25     <!-- Last rev: 284813 -->
26
27     <copyright>
28       <year>2015</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;.</para>
98
99     <para>Typical release note items document recent security
100       advisories issued after &release.prev;, new drivers or hardware
101       support, new commands or options, major bug fixes, or
102       contributed software upgrades.  They may also list changes to
103       major ports/packages or release engineering practices.  Clearly
104       the release notes cannot list every single change made to &os;
105       between releases; this document focuses primarily on security
106       advisories, user-visible changes, and major architectural
107       improvements.</para>
108   </sect1>
109
110   <sect1 xml:id="upgrade">
111     <title>Upgrading from Previous Releases of &os;</title>
112
113     <para arch="amd64,i386">Binary upgrades between RELEASE versions
114       (and snapshots of the various security branches) are supported
115       using the &man.freebsd-update.8; utility.  The binary upgrade
116       procedure will update unmodified userland utilities, as well as
117       unmodified <filename>GENERIC</filename> kernel distributed as
118       a part of an official &os; release.  The &man.freebsd-update.8;
119       utility requires that the host being upgraded have Internet
120       connectivity.</para>
121
122     <para>Source-based upgrades (those based on recompiling the &os;
123       base system from source code) from previous versions are
124       supported, according to the instructions in
125       <filename>/usr/src/UPDATING</filename>.</para>
126
127     <important>
128       <para>Upgrading &os; should only be attempted after
129         backing up <emphasis>all</emphasis> data and configuration
130         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 revision="276991">The &man.termcap.5; file is installed
163         as-is from sources, instead of reordering, creating
164         <filename>/etc/termcap.db</filename> by default, providing
165         a performance improvements to applications that use the
166         &man.termcap.5; database, such as &man.vi.1; and
167         &man.ncurses.3;.</para>
168     </sect2>
169
170     <sect2 xml:id="userland-programs">
171       <title>Userland Application Changes</title>
172
173       <para revision="275040">A new utility, &man.dpv.1;, has been
174         added to the base system, providing a &man.dialog.1;-style
175         progress view from one or more input streams.  A corresponding
176         library, &man.dpv.3;, has also been added.</para>
177
178       <para revision="275945">The &man.elfdump.1; utility has been
179         updated to support capability mode provided by
180         &man.capsicum.4;.</para>
181
182       <para revision="277434" contrib="sponsor" sponsor="&ff;">The
183         &man.fstyp.8; utility has been added, which is used to
184         determine the filesystem on a specified device.</para>
185
186       <para revision="281044">A regression in the &man.libarchive.3;
187         library that would prevent a directory from being included in
188         the archive when <literal>--one-file-system</literal> is used
189         has been fixed.</para>
190
191       <para revision="281161" contrib="sponsor"
192         sponsor="&limelight;">A new flag, <literal>-R</literal>, has
193         been added to the &man.netstat.8; utility, which is used to
194         dump <acronym>RSS</acronym>/flow information.</para>
195
196       <para revision="281936" contrib="sponsor" sponsor="&ff;">The
197         &man.ar.1; utility has been updated to set
198         <literal>ARCHIVE_EXTRACT_SECURE_SYMLINKS</literal> and
199         <literal>ARCHIVE_EXTRACT_SECURE_NODOTDOT</literal> to disallow
200         directory traversal when extracting an archive, similar to
201         &man.tar.1;.</para>
202
203       <para revision="282278">A race condition in &man.wc.1; that
204         would cause final results to be sent to &man.stderr.4; when
205         receiving the <literal>SIGINFO</literal> signal has been
206         fixed.</para>
207
208       <para revision="282870" contrib="sponsor"
209         sponsor="&scaleengine;">The &man.freebsd-update.8; utility has
210         been updated to prevent fetching updated binary patches when
211         a previous upgrade has not been thoroughly completed.</para>
212
213       <para revision="282974" contrib="sponsor" sponsor="&ff;">The
214         &man.uefisign.8; utility has been added.</para>
215
216       <para revision="283875" contrib="sponsor"
217         sponsor="&multiplay;">The &man.chflags.1;, &man.chgrp.1;,
218         &man.chmod.1;, and &man.chown.8; utilities now affect symbolic
219         links when the <literal>-R</literal> flag is specified, as
220         documented in &man.symlink.7;.</para>
221
222       <para revision="285092">The &man.pw.8; utility has been updated
223         with a new flag, <literal>-R</literal>, that sets the root
224         directory within which the utility will operate.</para>
225
226       <para revision="283258">The &man.date.1; utility has been
227         updated to print the modification time of the file passed as
228         an argument to the <literal>-r</literal> flag, improving
229         compatibility with the <acronym>GNU</acronym> &man.date.1;
230         utility behavior.</para>
231     </sect2>
232
233     <sect2 xml:id="userland-contrib">
234       <title>Contributed Software</title>
235
236       <para revision="282746" contrib="sponsor" sponsor="&ff;">The
237         &man.resolvconf.8; utility has been updated to version
238         3.7.0.</para>
239
240       <para revision="283270">The &man.nc.1; utility has been updated
241         to the OpenBSD 5.7 version.</para>
242
243       <para revision="284398">Timezone data files have been updated to
244         version 2015e.</para>
245
246       <para revision="284460">The &man.acpi.4; subsystem has been
247         updated to version 20150515.</para>
248
249       <para revision="284778">The &man.file.1; utility has been
250         updated to version 5.23.</para>
251
252       <para revision="285206">The &man.unbound.8; utility has been
253         updated to version 1.5.3.</para>
254
255       <para revision="285305">The <application>sendmail</application>
256         utility has been updated to version 8.15.2.</para>
257
258       <para revision="285330"><application>OpenSSL</application> has
259         been updated to version 1.0.1p.</para>
260     </sect2>
261
262     <sect2 xml:id="userland-installer">
263       <title>Installation and Configuration Tools</title>
264
265       <para>&nbsp;</para>
266     </sect2>
267
268     <sect2 xml:id="userland-rc">
269       <title><filename class="directory">/etc/rc.d</filename>
270         Scripts</title>
271
272       <para revision="284009">A new &man.rc.8; script,
273         <filename>growfs</filename>, has been added, which will resize
274         the root filesystem on boot if <filename>/firstboot</filename>
275         exists.</para>
276     </sect2>
277
278     <sect2 xml:id="userland-periodic">
279       <title><filename class="directory">/etc/periodic</filename>
280         Scripts</title>
281
282       <para revision="277520" contrib="sponsor" sponsor="&ff;">A new
283         &man.periodic.8; script,
284         <filename>510.status-world-kernel</filename>, has been added,
285         which evaluates the running userland and kernel versions from
286         the &man.uname.1; <literal>-U</literal> and
287         <literal>-K</literal> arguments, and prints an error if the
288         system userland and kernel are not in sync.</para>
289     </sect2>
290
291     <sect2 xml:id="userland-libraries">
292       <title>Runtime Libraries and API</title>
293
294       <para revision="275040">A new file configuration library,
295         &man.figpar.3;, has been added to the base system.</para>
296
297       <para revision="280392">The &man.setmode.3; function has been
298         updated to consistently set <literal>errno</literal> on
299         failure.</para>
300     </sect2>
301
302     <sect2 xml:id="userland-abi">
303       <title>ABI Compatibility</title>
304
305       <para>&nbsp;</para>
306     </sect2>
307   </sect1>
308
309   <sect1 xml:id="kernel">
310     <title>Kernel</title>
311
312     <para>This section covers changes to kernel configurations, system
313       tuning, and system control parameters that are not otherwise
314       categorized.</para>
315
316     <sect2 xml:id="kernel-bugfix">
317       <title>Kernel Bug Fixes</title>
318
319       <para>&nbsp;</para>
320     </sect2>
321
322     <sect2 xml:id="kernel-config">
323       <title>Kernel Configuration</title>
324
325       <para revision="284522" contrib="sponsor"
326         sponsor="&limelight;">A new kernel configuration option,
327         <literal>EM_MULTIQUEUE</literal>, has been added which enables
328         multi-queue support in the &man.em.4; driver.</para>
329
330       <note>
331         <para>Multi-queue support in the &man.em.4; driver is not
332           officially supported by &intel;.</para>
333       </note>
334     </sect2>
335
336     <sect2 xml:id="kernel-sysctl">
337       <title>System Tuning and Controls</title>
338
339       <para revision="276986">Throttling via <acronym>ACPI</acronym>
340         and <acronym>P4TCC</acronym> via &man.device.hints.5; have
341         been turned off by default.</para>
342
343       <para revision="278982" contrib="sponsor" sponsor="&ff;">The
344         &man.hwpmc.4; default and maximum callchain depths have been
345         increased.  The default has been increased from 16 to 32, and
346         the maximum increased from 32 to 128.</para>
347
348       <para revision="281255" contrib="sponsor"
349         sponsor="&ix;, &ff;">The &man.devfs.5; device filesystem has
350         been changed to update timestamps for read/write operations
351         using seconds precision.  A new &man.sysctl.8;,
352         <literal>vfs.devfs.dotimes</literal> has been added, which
353         when set to a non-zero value, enables default precision
354         timestamps for these operations.</para>
355
356       <para revision="280632">The <literal>kern.osrelease</literal>
357         and <literal>kern.osreldate</literal> are now configurable
358         &man.jail.8; parameters.</para>
359
360       <para revision="284665" contrib="sponsor" sponsor="&ff;">A new
361         &man.sysctl.8;, <literal>kern.racct.enable</literal>, has been
362         added, which when set to a non-zero value allows using
363         &man.rctl.8; with the <literal>GENERIC</literal> kernel.
364         A new kernel configuration option,
365         <literal>RACCT_DISABLED</literal> has also been added.</para>
366
367       <para revision="284665" contrib="sponsor" sponsor="&ff;">The
368         <literal>GENERIC</literal> kernel configuration now includes
369         <literal>RACCT</literal> and <literal>RCTL</literal> by
370         default.</para>
371
372       <note>
373         <para>To enable <literal>RACCT</literal> and
374           <literal>RCTL</literal> on a system using the
375           <literal>GENERIC</literal> kernel configuration, add
376           <literal>kern.racct.enable=1</literal> to
377           &man.loader.conf.5;, and reboot the system.</para>
378       </note>
379     </sect2>
380   </sect1>
381
382   <sect1 xml:id="drivers">
383     <title>Devices and Drivers</title>
384
385     <para>This section covers changes and additions to devices and
386       device drivers since &release.prev;.</para>
387
388     <sect2 xml:id="drivers-device">
389       <title>Device Drivers</title>
390
391       <para revision="282199">The <literal>drm</literal> code has
392         been updated to match &linux; version 3.8.13.</para>
393     </sect2>
394
395     <sect2 xml:id="drivers-storage">
396       <title>Storage Drivers</title>
397
398       <para revision="281957">The &man.hptnr.4; driver has been
399         updated to version 1.1.1.</para>
400     </sect2>
401
402     <sect2 xml:id="drivers-network">
403       <title>Network Drivers</title>
404
405       <para>&nbsp;</para>
406     </sect2>
407   </sect1>
408
409   <sect1 xml:id="hardware">
410     <title>Hardware Support</title>
411
412     <para>This section covers general hardware support for physical
413       machines, hypervisors, and virtualization environments, as well
414       as hardware changes and updates that do not otherwise fit in
415       other sections of this document.</para>
416
417     <sect2 xml:id="hardware-support">
418       <title>Hardware Support</title>
419
420       <para>&nbsp;</para>
421     </sect2>
422
423     <sect2 xml:id="hardware-virtualization">
424       <title>Virtualization Support</title>
425
426       <para revision="280370">The &man.bhyve.8; hypervisor has been
427         updated to support <literal>DSM TRIM</literal> commands for
428         virtual <acronym>AHCI</acronym> disks.</para>
429
430       <para revision="283280" contrib="sponsor" sponsor="&msostc;">The
431         Hyper-V&trade; drivers have been updated with several
432         enhancements:</para>
433
434       <itemizedlist>
435         <listitem>
436           <para>The &man.hv.vmbus.4; driver now has multi-channel
437             support.</para>
438         </listitem>
439
440         <listitem>
441           <para>The &man.hv.storvsc.4; driver now has scatter/gather
442             support, in addition to performance improvements.</para>
443         </listitem>
444
445         <listitem>
446           <para>The &man.hv.kvp.4; driver has received several bug
447             fixes.</para>
448         </listitem>
449       </itemizedlist>
450
451       <para revision="285236" contrib="sponsor" sponsor="&msostc;">The
452         &man.hv.netvsc.4; driver has been updated to support checksum
453         offloading and <acronym>TSO</acronym>.</para>
454     </sect2>
455
456     <sect2 xml:id="hardware-arm">
457       <title>ARM Support</title>
458
459       <para revision="278608">The <literal>bcm2835_cpufreq</literal>
460         driver has been added, which supports <acronym>CPU</acronym>
461         frequency and voltage control on the Raspberry Pi
462         <acronym>SOC</acronym>.</para>
463     </sect2>
464   </sect1>
465
466   <sect1 xml:id="storage">
467     <title>Storage</title>
468
469     <para>This section covers changes and additions to file systems
470       and other storage subsystems, both local and networked.</para>
471
472     <sect2 xml:id="storage-general">
473       <title>General Storage</title>
474
475       <para revision="279002" contrib="sponsor" sponsor="&ix;">The
476         &man.ctl.4; <acronym>LUN</acronym> mapping has been rewritten,
477         replacing <acronym>iSCSI</acronym>-specific mapping mechanisms
478         with a new mechanism that works for any port.</para>
479
480       <para revision="279055" contrib="sponsor" sponsor="&ix;">The
481         &man.ctld.8; utility has been updated to allow controlling
482         non-<acronym>iSCSI</acronym> &man.ctl.4; ports.</para>
483
484       <para revision="283223" contrib="sponsor" sponsor="&ff;">The
485         &man.autofs.5; subsystem has been updated to include a new
486         &man.auto.master.5; map, <literal>-media</literal>, which
487         allows automatically mounting removable media, such as
488         <acronym>CD</acronym> drives or <acronym>USB</acronym> flash
489         drives.</para>
490
491       <para revision="283242" contrib="sponsor" sponsor="&ff;">The
492         &man.autofs.5; subsystem has been updated to include a new
493         &man.auto.master.5; map, <literal>-noauto</literal>, which
494         handles &man.fstab.5; entries set to
495         <literal>noauto</literal>.</para>
496     </sect2>
497
498     <sect2 xml:id="storage-net">
499       <title>Networked Storage</title>
500
501       <para revision="274939" contrib="sponsor" sponsor="&ix;">The
502         &man.ctld.8; utility has been updated to include support for
503         registering <acronym>iSCSI</acronym> targets and portals on
504         <acronym>iSNS</acronym> servers.  This provides a mechanism
505         which allows <acronym>iSCSI</acronym> initiators to find
506         targets and portals without requiring active
507         discovery.</para>
508     </sect2>
509
510     <sect2 xml:id="storage-zfs">
511       <title>ZFS</title>
512
513       <para revision="275490">A new tunable,
514         <literal>vfs.zfs.spa_slop_shift</literal>, has been added,
515         which controls how much space is reserved by default.</para>
516
517       <para revision="277583">The <literal>arc_meta_limit</literal>
518         statistics are now visible through the
519         <literal>kstat</literal> &man.sysctl.8;.  As a result of this
520         change, the <literal>vfs.zfs.arc_meta_used</literal>
521         &man.sysctl.8; has been removed, and replaced with the
522         <literal>kstat.zfs.misc.arcstats.arc_meta_used</literal>
523         &man.sysctl.8;.</para>
524     </sect2>
525
526     <sect2 xml:id="storage-geom">
527       <title>&man.geom.4;</title>
528
529       <para revision="275891" contrib="sponsor" sponsor="&ix;">The
530         &man.ctl.4; subsystem has been updated, increasing the ports
531         limit from <literal>128</literal> to <literal>256</literal>,
532         and <acronym>LUN</acronym> limit from <literal>256</literal>
533         to <literal>1024</literal>.</para>
534     </sect2>
535   </sect1>
536
537   <sect1 xml:id="boot">
538     <title>Boot Loader Changes</title>
539
540     <para>This section covers the boot loader, boot menu, and other
541       boot-related changes.</para>
542
543     <sect2 xml:id="boot-loader">
544       <title>Boot Loader Changes</title>
545
546       <para revision="281843">The boot loader has been updated to
547         support entering the <acronym>GELI</acronym> passphrase before
548         loading the kernel.  To enable this behavior, add
549         <literal>geom_eli_passphrase_prompt="YES"</literal> to
550         &man.loader.conf.5;.</para>
551
552       <para revision="283262" contrib="sponsor" sponsor="&ff;">The
553         memory test run at boot time on &os;/&arch.amd64; platforms
554         has been disabled by default.</para>
555
556       <para revision="283972">A new &man.ttys.5; class,
557         <literal>3wire</literal>, has been added.  This is similar to
558         the existing terminal classes, but does not have a defined
559         baudrate.</para>
560
561       <para revision="284775" contrib="sponsor" sponsor="&ff;"
562         arch="arm">The &man.ttys.5; file for &os;/&arch.arm; has been
563         updated to enable <filename>ttyu1</filename>,
564         <filename>ttyu2</filename>, and <filename>ttyu3</filename> by
565         default, if the callin port is an active console port.</para>
566     </sect2>
567
568     <sect2 xml:id="boot-menu">
569       <title>Boot Menu Changes</title>
570
571       <para>&nbsp;</para>
572     </sect2>
573   </sect1>
574
575   <sect1 xml:id="network">
576     <title>Networking</title>
577
578     <para>This section describes changes that affect networking in
579       &os;.</para>
580
581     <sect2 xml:id="network-protocols">
582       <title>Network Procols</title>
583
584       <para>&nbsp;</para>
585     </sect2>
586   </sect1>
587
588   <sect1 xml:id="ports">
589     <title>Ports Collection and Package Infrastructure</title>
590
591     <para>This section covers changes to the &os;&nbsp;Ports
592       Collection, package infrastructure, and package maintenance and
593       installation tools.</para>
594
595     <sect2 xml:id="ports-infrastructure">
596       <title>Infrastructure Changes</title>
597
598       <para>&nbsp;</para>
599     </sect2>
600
601     <sect2 xml:id="ports-packages ">
602       <title>Packaging Changes</title>
603
604       <para>&nbsp;</para>
605     </sect2>
606   </sect1>
607
608   <sect1 xml:id="doc">
609     <title>Documentation</title>
610
611     <para>This section covers changes to the &os;&nbsp;Documentation
612       Project sources and toolchain.</para>
613
614     <sect2 xml:id="doc-sources">
615       <title>Documentation Source Changes</title>
616
617       <para>&nbsp;</para>
618     </sect2>
619
620     <sect2 xml:id="doc-toolchain">
621       <title>Documentation Toolchain Changes</title>
622
623       <para>&nbsp;</para>
624     </sect2>
625   </sect1>
626
627   <sect1 xml:id="releng">
628     <title>Release Engineering and Integration</title>
629
630     <para>This section convers changes that are specific to the
631       &os;&nbsp;Release Engineering processes.</para>
632
633     <sect2 xml:id="releng-changes">
634       <title>Integration Changes</title>
635
636       <para revision="283161" contrib="sponsor" sponsor="&ff;">The
637         Release Engineering build tools have been updated to support
638         building &os;/&arch.arm; images without external utilities for
639         supported boards where a corresponding
640         <literal>u-boot</literal> port exists in the Ports
641         Collection.</para>
642
643       <para revision="283548" contrib="sponsor" sponsor="&ff;">The
644         &os;/&arch.i386; memory stick installation images are now
645         created using the &man.mkimg.1; utility, matching the way
646         the &os;/&arch.amd64; images are created.</para>
647     </sect2>
648   </sect1>
649 </article>