article.xml revision 270537
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]>
11<article xmlns="http://docbook.org/ns/docbook"
12  xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
13
14  <info>
15    <title>&os; &release.current; Release Notes</title>
16
17    <author>
18      <orgname>The &os; Project</orgname>
19    </author>
20
21    <pubdate>$FreeBSD: stable/10/release/doc/en_US.ISO8859-1/relnotes/article.xml 270537 2014-08-25 10:43:56Z gjb $</pubdate>
22
23    <copyright>
24      <year>2000</year>
25      <year>2001</year>
26      <year>2002</year>
27      <year>2003</year>
28      <year>2004</year>
29      <year>2005</year>
30      <year>2006</year>
31      <year>2007</year>
32      <year>2008</year>
33      <year>2009</year>
34      <year>2010</year>
35      <year>2011</year>
36      <year>2012</year>
37      <year>2013</year>
38      <year>2014</year>
39      <holder role="mailto:doc@FreeBSD.org">The &os; Documentation
40	Project</holder>
41    </copyright>
42
43    <legalnotice xml:id="trademarks" role="trademarks">
44      &tm-attrib.freebsd;
45      &tm-attrib.ibm;
46      &tm-attrib.ieee;
47      &tm-attrib.intel;
48      &tm-attrib.sparc;
49      &tm-attrib.general;
50    </legalnotice>
51
52    <abstract>
53      <para>The release notes for &os; &release.current; contain
54	a summary of the changes made to the &os; base system on the
55	&release.branch; development line.  This document lists
56	applicable security advisories that were issued since the last
57	release, as well as significant changes to the &os; kernel and
58	userland.  Some brief remarks on upgrading are also
59	presented.</para>
60    </abstract>
61  </info>
62
63  <sect1 xml:id="intro">
64    <title>Introduction</title>
65
66    <para>This document contains the release notes for &os;
67      &release.current;.  It describes recently added, changed, or
68      deleted features of &os;.  It also provides some notes on
69      upgrading from previous versions of &os;.</para>
70
71    <para releasetype="current">The &release.type; distribution to
72      which these release notes apply represents the latest point
73      along the &release.branch; development branch since
74      &release.branch; was created.  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="snapshot">The &release.type; distribution to
80      which these release notes apply represents a point along the
81      &release.branch; development branch between &release.prev; and
82      the future &release.next;.  Information regarding pre-built,
83      binary &release.type; distributions along this branch can be
84      found at <uri
85	xlink:href="&release.url;">&release.url;</uri>.</para>
86
87    <para releasetype="release">This distribution of &os;
88      &release.current; is a &release.type; distribution.  It can be
89      found at <uri xlink:href="&release.url;">&release.url;</uri> or
90      any of its mirrors.  More information on obtaining this (or
91      other) &release.type; distributions of &os; can be found in the
92      <link
93	xlink:href="&url.books.handbook;/mirrors.html"><quote>Obtaining
94	  &os;</quote> appendix</link> to the <link
95	xlink:href="&url.books.handbook;/">&os;
96	Handbook</link>.</para>
97
98    <para>All users are encouraged to consult the release errata
99      before installing &os;.  The errata document is updated with
100      <quote>late-breaking</quote> information discovered late in the
101      release cycle or after the release.  Typically, it contains
102      information on known bugs, security advisories, and corrections
103      to documentation.  An up-to-date copy of the errata for &os;
104      &release.current; can be found on the &os; Web site.</para>
105  </sect1>
106
107  <sect1 xml:id="new">
108    <title>What's New</title>
109
110    <para>This section describes the most user-visible new or changed
111      features in &os; since &release.prev;.</para>
112
113    <para>Typical release note items document recent security
114      advisories issued after &release.prev;, new drivers or hardware
115      support, new commands or options, major bug fixes, or
116      contributed software upgrades.  They may also list changes to
117      major ports/packages or release engineering practices.  Clearly
118      the release notes cannot list every single change made to &os;
119      between releases; this document focuses primarily on security
120      advisories, user-visible changes, and major architectural
121      improvements.</para>
122
123    <sect2 xml:id="security">
124      <title>Security Advisories</title>
125
126      <para>&nbsp;</para>
127
128    </sect2>
129
130    <sect2 xml:id="kernel">
131      <title>Kernel Changes</title>
132
133      <para revision="260338">The
134	<literal>vfs.zfs.zio.use_uma</literal> &man.sysctl.8; has been
135	re-enabled.  On multi-CPU machines with enough RAM, this can
136	easily double &man.zfs.8; performance or reduce CPU usage in
137	half.  It was originally disabled due to memory and
138	<acronym>KVA</acronym> exhaustion problem reports, which
139	should be resolved due to several change in the VM
140	subsystem.</para>
141
142      <para revision="260385" contrib="sponsor" sponsor="&ix;">The
143	&man.geom.4; RAID driver has been
144	updated to support unmapped I/O.</para>
145
146      <para revision="260431">A new &man.sysctl.8;,
147	<literal>kern.panic_reboot_wait_time</literal>, has been
148	added, which allows controlling how long the system will wait
149	after &man.panic.9; before rebooting.</para>
150
151      <para revision="260857">The &man.virtio_blk.4; driver has been
152	updated to support unmapped I/O.</para>
153
154      <para revision="260858">The &man.virtio_scsi.4; driver has been
155	updated to support unmapped I/O.</para>
156
157      <para revision="262861">The &man.vt.4; driver has been merged
158	from &os;-CURRENT.  To enable &man.vt.4;, enter
159	<literal>set kern.vty=vt</literal> at the &man.loader.8;
160	prompt during boot, or add <literal>kern.vty=vt</literal> to
161	&man.loader.conf.5; and reboot the system.</para>
162
163      <para revision="262967">Support for MegaRAID Fury cards has been
164	added to the &man.mfi.4; driver.</para>
165
166      <para revision="263024">The &man.aacraid.4; driver has been
167	updated to version 3.2.5.</para>
168
169      <para revision="263122">Support for &man.hwpmc.4; has been added
170	for &powerpc;&nbsp;970 class processors.</para>
171
172      <para revision="263197">Support for ADT7460 and ADT7467 fan
173	controllers found in newer PowerBooks&trade; and
174	iBooks&trade; has been added to the &man.iicbus.4;
175	driver.</para>
176
177      <para revision="263256">A panic triggered by removing
178	a &man.urtwn.4; device has been fixed.</para>
179
180      <para revision="263799">A potential deadlock in the &man.usb.4;
181	stack triggered by detaching USB devices that create character
182	devices has been fixed.</para>
183
184      <para revision="263869">Support for &amd;&nbsp;Family 16h sensor
185	devices has been added to &man.amdtemp.4;.</para>
186
187      <para revision="264522">Support for LUN-based CD changers has
188	been removed from the &man.cd.4; driver.</para>
189
190      <para revision="264734">Support for 9th generation HP host bus
191	adapter cards has been added to &man.ciss.4;.</para>
192
193      <para revision="265388" contrib="sponsor" sponsor="&lsi;">The
194	&man.mpr.4; device has been added,
195	providing support for LSI Fusion-MPT 3 12Gb SCSI/SATA
196	controllers.</para>
197
198      <para revision="265536">The <literal>GEOM_VINUM</literal> option
199	is now able to be built both directly into the kernel or as
200	a &man.kldload.8; loadable module.</para>
201
202      <para revision="265610">The &man.uslcom.4; driver has been
203	updated to support 26 new devices.</para>
204
205      <para revision="265922" contrib="sponsor" sponsor="&lsi;">The
206	&man.mrsas.4; driver has been added,
207	providing support for LSI MegaRAID SAS controllers.  The
208	&man.mfi.4; driver will attach to the controller, by default.
209	To enable &man.mrsas.4; add
210	<literal>hw.mfi.mrsas_enable=1</literal> to
211	<filename>/boot/loader.conf</filename>, which turns off
212	&man.mfi.4; device probing.</para>
213
214      <note>
215	<para>At this time, the &man.mfiutil.8; utility and
216	  the &os; version of
217	  <application>MegaCLI</application> and
218	  <application>StorCli</application> do not work with
219	  &man.mrsas.4;.</para>
220      </note>
221
222      <para revision="266165">A kernel bug that inhibited proper
223	functionality of the <literal>dev.cpu.0.freq</literal>
224	&man.sysctl.8; on &intel; processors with Turbo
225	Boost&trade; enabled has been fixed.</para>
226
227      <sect3 xml:id="kernel-virtualization">
228	<title>Virtualization Support</title>
229
230	<para revision="259450">Support for &microsoft; Hyper-V
231	  has been added to &os;/i386 as loadable modules, however
232	  not available in the <filename>GENERIC</filename> kernel
233	  configuration.</para>
234
235	<para revision="261090">The &man.bhyve.4; hypervisor now
236	  supports soft power-off functionality via the ACPI S5
237	  state.</para>
238      </sect3>
239
240      <sect3 xml:id="kernel-arm">
241	<title>ARM Support</title>
242
243	<para revision="259355">The <filename>WANDBOARD</filename>
244	  kernel configuration file has been added.</para>
245
246	<para revision="265067">Boot devices may now be specified by
247	  setting a u-boot environment variable.  If a boot device is
248	  not specified, the probe mechanism will be used.  To specify
249	  the boot device, set the
250	  <literal>loaderdev=<replaceable>device</replaceable></literal>
251	  u-boot environment variable.</para>
252
253	<para revision="266000">The <literal>nexus(4)</literal> driver
254	  has been updated to include <quote>Flattened Device
255	    Tree</quote> support, replacing the &man.fdtbus.4; driver
256	  in most cases.</para>
257
258	<para revision="266105">The &man.gpioiic.4; and
259	  &man.gpioled.4; have been merged from &os;-CURRENT.</para>
260      </sect3>
261
262      <sect3 xml:id="boot">
263	<title>Boot Loader Changes</title>
264
265	<para revision="262701">A kernel selection menu has been added
266	  to &man.loader.8;.  If the <quote>beastie menu</quote> is
267	  enabled, the kernel to boot may be selected from the kernel
268	  selection menu.  Additional kernels may be listed in
269	  &man.loader.conf.5; as a comma- or space-separated list.  By
270	  default, <literal>kernel</literal> and
271	  <literal>kernel.old</literal> are listed.</para>
272      </sect3>
273
274      <sect3 xml:id="proc">
275	<title>Hardware Support</title>
276
277	<para>&nbsp;</para>
278
279	<sect4 xml:id="mm">
280	  <title>Multimedia Support</title>
281
282	  <para>&nbsp;</para>
283
284	</sect4>
285
286	<sect4 xml:id="net-if">
287	  <title>Network Interface Support</title>
288
289	  <para revision="259453">Support for Ralink RT5370 and
290	    RT5372 chipsets has been added to the &man.run.4;
291	    driver.</para>
292
293	  <para revision="260120">Firmware for the &man.run.4; driver
294	    has been updated to version 0.33.</para>
295
296	  <para revision="261868">Support for the Ralink RT3593
297	    chipset has been added to the &man.run.4; driver.</para>
298
299	  <para revision="261972">The &man.nve.4; driver is now
300	    deprecated, and the &man.nfe.4; driver should be used
301	    instead.</para>
302
303	  <para revision="262137">Support for the &man.axge.4; driver
304	    has been added.  This driver supports the ASIX AX88178A
305	    and AX88179 USB ethernet adapters.  The AX88178A supports
306	    USB 2.0, and the AX88179 supports USB 2.0 and 3.0.</para>
307
308	  <para revision="262363">The &man.urndis.4; driver has been
309	    imported from OpenBSD.</para>
310
311	  <para revision="264866">Support for multiple
312	    transmitter/receiver queues has been added to the
313	    &man.vmx.4; driver.</para>
314
315	  <note>
316	    <para>The &os;&nbsp;guest operating system must have
317	      <acronym>MSIX</acronym> enabled as a prerequisite for
318	      multiple queues.</para>
319	  </note>
320
321	  <para revision="265345">Support for the ASUS USB-N10 Nano
322	    wireless card has been added to the &man.urtwn.4;
323	    driver.</para>
324
325	  <para revision="266212">Transmission checksum offloading has
326	    been disabled for the RTL8168C and RTL8168CP chipsets in
327	    the &man.re.4; driver for TCP and UDP frames.  This is
328	    due to a report of UDP datagrams with IP options
329	    generating corrupt frames.</para>
330	</sect4>
331      </sect3>
332
333      <sect3 xml:id="net-proto">
334	<title>Network Protocols</title>
335
336	<para revision="265946">Support for the UDP-Lite protocol
337	  (RFC 3828) has been added to the IPv4 and IPv6
338	  stacks.</para>
339      </sect3>
340
341      <sect3 xml:id="disks">
342	<title>Disks and Storage</title>
343
344	<para revision="259328" contrib="sponsor" sponsor="&ff;">The
345	  &man.geom.8; <literal>label</literal> class is now aware of
346	  resized partitions.  This corrects an issue where
347	  <command>geom resize</command> would resize the partition,
348	  but the label provider in <filename
349	    class="directory">/dev/gptid/</filename> would not be
350	  resized.</para>
351
352	<para revision="260502">The &man.gmirror.8;
353	  utility now has a <literal>resize</literal> command, making
354	  it easier to resize the size of a mirror when all of its
355	  components have been replaced.</para>
356
357	<para revision="265912">The &man.geom.8;
358	  <literal>GEOM_PART</literal> class has been updated to
359	  support automatic partition resizing.  Changes to the
360	  partition size are not saved to disk until
361	  <command>gpart commit</command> is run, and prior to saving,
362	  can be reverted with <command>gpart undo</command>.</para>
363
364	<para revision="268091">Support for the
365	  <literal>disklabel64</literal> partitioning scheme has been
366	  added to &man.gpart.8;.</para>
367      </sect3>
368
369      <sect3 xml:id="fs">
370	<title>File Systems</title>
371
372	<para revision="260178" contrib="vendor"
373	  vendor="&netflix;">A new flag, <literal>-R</literal>,
374	  has been added to the &man.fsck.ffs.8; utility.  When used,
375	  &man.fsck.ffs.8; will restart itself when too many critical
376	  errors have been detected.</para>
377
378	<para revision="263407">The &man.zfs.8; filesystem has been
379	  updated to implement <quote>bookmarks</quote>.  See
380	  &man.zfs.8; for further details.</para>
381
382	<para revision="266122">The &man.zfs.8; filesystem has been
383	  updated to allow tuning the minimum <quote>ashift</quote>
384	  value when creating new top-level virtual devices (vdevs).
385	  To set the minimum ashift value, for example when creating
386	  a &man.zpool.8; on <quote>Advanced Format</quote> drives,
387	  set the <literal>vfs.zfs.min_auto_ashift</literal>
388	  &man.sysctl.8; accordingly.</para>
389      </sect3>
390    </sect2>
391
392    <sect2 xml:id="userland">
393      <title>Userland Changes</title>
394
395      <para revision="260177" contrib="sponsor"
396	sponsor="&netflix;">A new flag is added to &man.camcontrol.8;,
397	<literal>-b</literal>, which outputs the existing buses and
398	their parents.</para>
399
400      <para revision="262075">The &man.newsyslog.8; utility has been
401	updated to rotate files based on the actual file size instead
402	of the blocks on disk.  This matches the behavior documented
403	in &man.newsyslog.conf.5;.</para>
404
405      <para revision="262384">The location of the &man.rctl.8;
406	configuration file can now be overridden in &man.rc.conf.5;.
407	To use a non-default location, set
408	<literal>rctl_rules</literal> in &man.rc.conf.5; to the
409	location of the file.</para>
410
411      <para revision="262855">The <application>ATF</application> test
412	suite has been updated to version 0.20.</para>
413
414      <para revision="263019">The <literal>libucl</literal> library
415	(Unified Configuration Library) has been merged from
416	&os;-CURRENT.</para>
417
418      <para revision="263020">The &man.pkg.7; bootstrapping utility
419	has been synced with the version in &os;-CURRENT.</para>
420
421      <para revision="263403">The &man.zfs.8; userland utility has
422	been updated to include aliases for
423	<command>snapshot</command>, which allows use of <command>zfs
424	  list -t snap</command> and <command>zfs
425	  snap</command>.</para>
426
427      <para revision="263405">The &man.zfs.8; userland utility has
428	been updated to include a new flag to <command>zfs
429	  list</command>, <literal>-p</literal>, which when specified,
430	prints the output in a parsable format.</para>
431
432      <para revision="263508">The &man.clang.1;/llvm suite has been
433	updated to version 3.4.</para>
434
435      <para revision="263783">The Blowfish password format
436	implementation updated.  Support for &dollar;2b&dollar; has
437	been added, allowing use of passwords greater than 256
438	characters long.</para>
439
440      <para revision="264497">The &man.iconv.3; library has been
441	updated to match NetBSD, providing several bug fixes.</para>
442
443      <para revision="265265">The &man.date.1; utility has been
444	updated to include a new flag, <literal>-R</literal>, which
445	prints the date and time output as specified in RFC
446	2822.</para>
447
448      <para revision="265533">The &man.bc.1; utility has been updated
449	to version 1.1, in sync with the version in OpenBSD.</para>
450
451      <para revision="265604" contrib="vendor"
452	vendor="&netflix;">The &man.pmcstat.8; utility has been
453	updated to include a new flag, <literal>-a</literal>, which
454	when specified, produces a full stack track on the sampled
455	points.</para>
456
457      <para revision="265701">The &man.netstat.8; and &man.route.8;
458	utilities have been updated to include a shorthand equivalent
459	to the <literal>-f inet</literal> and <literal>-f
460	  inet6</literal> address specifiers, <literal>-4</literal>
461	and <literal>-6</literal>, respectively.</para>
462
463      <para revision="265879">The &man.crypt.3; library now defaults
464	to SHA512 for password hashing.</para>
465
466      <para revision="266014">The &man.gvinum.8; utility has been
467	updated to allow forceful configuration reset with the
468	<literal>-f</literal> flag.  Additionally, a bug that would
469	prevent <literal>-f</literal> from properly creating
470	a &man.gvinum.8; configuration has been fixed.</para>
471
472      <para revision="266029">The &man.login.conf.5; file now takes
473	precedence over the shell-specific environment files.  In
474	particular, the <literal>PATH</literal>,
475	<literal>BLOCKSIZE</literal> variables are commented from
476	<filename>/usr/share/skel/dot.profile</filename>, and the
477	<literal>path</literal>, <literal>BLOCKSIZE</literal>, and
478	<literal>umask</literal> variables have been commented from
479	<filename>/usr/share/skel/dot.cshrc</filename>.</para>
480
481      <para revision="266279">The &man.ps.1; utility has been
482	updated to include the <literal>-J</literal> flag, used to
483	filter output by matching &man.jail.8; IDs and names.
484	Additionally, argument <literal>0</literal> can be used to
485	<literal>-J</literal> to only list processes running on the
486	host system.</para>
487
488      <para revision="266280">The &man.top.1; utility has been updated
489	to filter by &man.jail.8; ID or name, in followup to the
490	&man.ps.1; change in <literal>r265229</literal>.</para>
491
492      <para revision="266890">The &man.pmcstat.8; utility has been
493	updated to include a new flag, <literal>-l</literal>, which
494	ends event collection after the specified number of
495	seconds.</para>
496
497      <para revision="267113">The default &man.newsyslog.conf.5; now
498	includes files in the
499	<filename>/etc/newsyslog.conf.d/</filename> and
500	<filename>/usr/local/etc/newsyslog.conf.d/</filename>
501	directories by default for &man.newsyslog.8;.</para>
502
503      <para revision="267236">A new flag, <quote>onifconsole</quote>
504	has been added to <filename>/etc/ttys</filename>.  This allows
505	the system to provide a login prompt via serial console if the
506	device is an active kernel console, otherwise it is equivalent
507	to <literal>off</literal>.</para>
508
509      <para revision="268161">The &man.mkimg.1; utility has been
510	merged from &os;-CURRENT.</para>
511
512      <sect3 xml:id="rc-scripts">
513	<title><filename>/etc/rc.d</filename> Scripts</title>
514
515	<para revision="264438">The <filename>network.subr</filename>
516	  &man.rc.8; script has been updated to loosen the requirement
517	  of listing network aliases in numeric order.  Previously,
518	  a network alias of
519	  <literal>_alias<replaceable>2</replaceable></literal>
520	  would not be created if
521	  <literal>_alias<replaceable>1</replaceable></literal> was
522	  not defined.</para>
523      </sect3>
524    </sect2>
525
526    <sect2 xml:id="contrib">
527      <title>Contributed Software</title>
528
529      <para revision="263285">The &man.xz.1; utility has been updated
530	to a post-5.0.5 snapshot.</para>
531
532      <para revision="263369" contrib="sponsor"
533	sponsor="&darpa_afrl;">The &man.lldb.1; debugging library has
534	been updated to the r196322 snapshot.</para>
535
536      <para revision="264377"><application>OpenSSH</application> has
537	been updated to version 6.6p1.</para>
538
539      <para revision="264911">The &man.nc.1; utility has been updated
540	to match the version in OpenBSD 5.5.</para>
541
542      <para revision="265983">The timezone database has been updated
543	to version tzdata2014c.</para>
544
545      <para revision="266692"><application>Sendmail</application>
546	has been updated to 8.14.9.</para>
547
548      <para revision="267258"><application>OpenSSL</application> has
549	been updated to version 1.0.1h.</para>
550    </sect2>
551
552    <sect2 xml:id="ports">
553      <title>Ports/Packages Collection Infrastructure</title>
554
555      <para>&nbsp;</para>
556
557    </sect2>
558
559    <sect2 xml:id="releng">
560      <title>Release Engineering and Integration</title>
561
562      <para revision="263028">The &man.services.mkdb.8; utility has
563	been updated to include endianness awareness, allowing the
564	<filename>services.db</filename> database to be created as
565	part of the release build, regardless of native- or
566	cross-built releases.</para>
567    </sect2>
568
569    <sect2 xml:id="doc">
570      <title>Documentation</title>
571
572      <para>&nbsp;</para>
573
574    </sect2>
575  </sect1>
576
577  <sect1 xml:id="upgrade">
578    <title>Upgrading from Previous Releases of &os;</title>
579
580    <para arch="amd64,i386">Binary upgrades between RELEASE versions
581      (and snapshots of the various security branches) are supported
582      using the &man.freebsd-update.8; utility.  The binary upgrade
583      procedure will update unmodified userland utilities, as well as
584      unmodified GENERIC or SMP kernels distributed as a part of an
585      official &os; release.  The &man.freebsd-update.8; utility
586      requires that the host being upgraded have Internet
587      connectivity.</para>
588
589    <para>Source-based upgrades (those based on recompiling the &os;
590      base system from source code) from previous versions are
591      supported, according to the instructions in
592      <filename>/usr/src/UPDATING</filename>.</para>
593
594    <important>
595      <para>Upgrading &os; should only be attempted after
596	backing up <emphasis>all</emphasis> data and configuration
597	files.</para>
598    </important>
599  </sect1>
600</article>
601