article.xml revision 270536
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 270536 2014-08-25 10:43:55Z 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	</sect4>
325      </sect3>
326
327      <sect3 xml:id="net-proto">
328	<title>Network Protocols</title>
329
330	<para revision="265946">Support for the UDP-Lite protocol
331	  (RFC 3828) has been added to the IPv4 and IPv6
332	  stacks.</para>
333      </sect3>
334
335      <sect3 xml:id="disks">
336	<title>Disks and Storage</title>
337
338	<para revision="259328" contrib="sponsor" sponsor="&ff;">The
339	  &man.geom.8; <literal>label</literal> class is now aware of
340	  resized partitions.  This corrects an issue where
341	  <command>geom resize</command> would resize the partition,
342	  but the label provider in <filename
343	    class="directory">/dev/gptid/</filename> would not be
344	  resized.</para>
345
346	<para revision="260502">The &man.gmirror.8;
347	  utility now has a <literal>resize</literal> command, making
348	  it easier to resize the size of a mirror when all of its
349	  components have been replaced.</para>
350
351	<para revision="265912">The &man.geom.8;
352	  <literal>GEOM_PART</literal> class has been updated to
353	  support automatic partition resizing.  Changes to the
354	  partition size are not saved to disk until
355	  <command>gpart commit</command> is run, and prior to saving,
356	  can be reverted with <command>gpart undo</command>.</para>
357
358	<para revision="268091">Support for the
359	  <literal>disklabel64</literal> partitioning scheme has been
360	  added to &man.gpart.8;.</para>
361      </sect3>
362
363      <sect3 xml:id="fs">
364	<title>File Systems</title>
365
366	<para revision="260178" contrib="vendor"
367	  vendor="&netflix;">A new flag, <literal>-R</literal>,
368	  has been added to the &man.fsck.ffs.8; utility.  When used,
369	  &man.fsck.ffs.8; will restart itself when too many critical
370	  errors have been detected.</para>
371
372	<para revision="263407">The &man.zfs.8; filesystem has been
373	  updated to implement <quote>bookmarks</quote>.  See
374	  &man.zfs.8; for further details.</para>
375
376	<para revision="266122">The &man.zfs.8; filesystem has been
377	  updated to allow tuning the minimum <quote>ashift</quote>
378	  value when creating new top-level virtual devices (vdevs).
379	  To set the minimum ashift value, for example when creating
380	  a &man.zpool.8; on <quote>Advanced Format</quote> drives,
381	  set the <literal>vfs.zfs.min_auto_ashift</literal>
382	  &man.sysctl.8; accordingly.</para>
383      </sect3>
384    </sect2>
385
386    <sect2 xml:id="userland">
387      <title>Userland Changes</title>
388
389      <para revision="260177" contrib="sponsor"
390	sponsor="&netflix;">A new flag is added to &man.camcontrol.8;,
391	<literal>-b</literal>, which outputs the existing buses and
392	their parents.</para>
393
394      <para revision="262075">The &man.newsyslog.8; utility has been
395	updated to rotate files based on the actual file size instead
396	of the blocks on disk.  This matches the behavior documented
397	in &man.newsyslog.conf.5;.</para>
398
399      <para revision="262384">The location of the &man.rctl.8;
400	configuration file can now be overridden in &man.rc.conf.5;.
401	To use a non-default location, set
402	<literal>rctl_rules</literal> in &man.rc.conf.5; to the
403	location of the file.</para>
404
405      <para revision="262855">The <application>ATF</application> test
406	suite has been updated to version 0.20.</para>
407
408      <para revision="263019">The <literal>libucl</literal> library
409	(Unified Configuration Library) has been merged from
410	&os;-CURRENT.</para>
411
412      <para revision="263020">The &man.pkg.7; bootstrapping utility
413	has been synced with the version in &os;-CURRENT.</para>
414
415      <para revision="263403">The &man.zfs.8; userland utility has
416	been updated to include aliases for
417	<command>snapshot</command>, which allows use of <command>zfs
418	  list -t snap</command> and <command>zfs
419	  snap</command>.</para>
420
421      <para revision="263405">The &man.zfs.8; userland utility has
422	been updated to include a new flag to <command>zfs
423	  list</command>, <literal>-p</literal>, which when specified,
424	prints the output in a parsable format.</para>
425
426      <para revision="263508">The &man.clang.1;/llvm suite has been
427	updated to version 3.4.</para>
428
429      <para revision="263783">The Blowfish password format
430	implementation updated.  Support for &dollar;2b&dollar; has
431	been added, allowing use of passwords greater than 256
432	characters long.</para>
433
434      <para revision="264497">The &man.iconv.3; library has been
435	updated to match NetBSD, providing several bug fixes.</para>
436
437      <para revision="265265">The &man.date.1; utility has been
438	updated to include a new flag, <literal>-R</literal>, which
439	prints the date and time output as specified in RFC
440	2822.</para>
441
442      <para revision="265533">The &man.bc.1; utility has been updated
443	to version 1.1, in sync with the version in OpenBSD.</para>
444
445      <para revision="265604" contrib="vendor"
446	vendor="&netflix;">The &man.pmcstat.8; utility has been
447	updated to include a new flag, <literal>-a</literal>, which
448	when specified, produces a full stack track on the sampled
449	points.</para>
450
451      <para revision="265701">The &man.netstat.8; and &man.route.8;
452	utilities have been updated to include a shorthand equivalent
453	to the <literal>-f inet</literal> and <literal>-f
454	  inet6</literal> address specifiers, <literal>-4</literal>
455	and <literal>-6</literal>, respectively.</para>
456
457      <para revision="265879">The &man.crypt.3; library now defaults
458	to SHA512 for password hashing.</para>
459
460      <para revision="266014">The &man.gvinum.8; utility has been
461	updated to allow forceful configuration reset with the
462	<literal>-f</literal> flag.  Additionally, a bug that would
463	prevent <literal>-f</literal> from properly creating
464	a &man.gvinum.8; configuration has been fixed.</para>
465
466      <para revision="266029">The &man.login.conf.5; file now takes
467	precedence over the shell-specific environment files.  In
468	particular, the <literal>PATH</literal>,
469	<literal>BLOCKSIZE</literal> variables are commented from
470	<filename>/usr/share/skel/dot.profile</filename>, and the
471	<literal>path</literal>, <literal>BLOCKSIZE</literal>, and
472	<literal>umask</literal> variables have been commented from
473	<filename>/usr/share/skel/dot.cshrc</filename>.</para>
474
475      <para revision="266279">The &man.ps.1; utility has been
476	updated to include the <literal>-J</literal> flag, used to
477	filter output by matching &man.jail.8; IDs and names.
478	Additionally, argument <literal>0</literal> can be used to
479	<literal>-J</literal> to only list processes running on the
480	host system.</para>
481
482      <para revision="266280">The &man.top.1; utility has been updated
483	to filter by &man.jail.8; ID or name, in followup to the
484	&man.ps.1; change in <literal>r265229</literal>.</para>
485
486      <para revision="266890">The &man.pmcstat.8; utility has been
487	updated to include a new flag, <literal>-l</literal>, which
488	ends event collection after the specified number of
489	seconds.</para>
490
491      <para revision="267113">The default &man.newsyslog.conf.5; now
492	includes files in the
493	<filename>/etc/newsyslog.conf.d/</filename> and
494	<filename>/usr/local/etc/newsyslog.conf.d/</filename>
495	directories by default for &man.newsyslog.8;.</para>
496
497      <para revision="267236">A new flag, <quote>onifconsole</quote>
498	has been added to <filename>/etc/ttys</filename>.  This allows
499	the system to provide a login prompt via serial console if the
500	device is an active kernel console, otherwise it is equivalent
501	to <literal>off</literal>.</para>
502
503      <para revision="268161">The &man.mkimg.1; utility has been
504	merged from &os;-CURRENT.</para>
505
506      <sect3 xml:id="rc-scripts">
507	<title><filename>/etc/rc.d</filename> Scripts</title>
508
509	<para revision="264438">The <filename>network.subr</filename>
510	  &man.rc.8; script has been updated to loosen the requirement
511	  of listing network aliases in numeric order.  Previously,
512	  a network alias of
513	  <literal>_alias<replaceable>2</replaceable></literal>
514	  would not be created if
515	  <literal>_alias<replaceable>1</replaceable></literal> was
516	  not defined.</para>
517      </sect3>
518    </sect2>
519
520    <sect2 xml:id="contrib">
521      <title>Contributed Software</title>
522
523      <para revision="263285">The &man.xz.1; utility has been updated
524	to a post-5.0.5 snapshot.</para>
525
526      <para revision="263369" contrib="sponsor"
527	sponsor="&darpa_afrl;">The &man.lldb.1; debugging library has
528	been updated to the r196322 snapshot.</para>
529
530      <para revision="264377"><application>OpenSSH</application> has
531	been updated to version 6.6p1.</para>
532
533      <para revision="264911">The &man.nc.1; utility has been updated
534	to match the version in OpenBSD 5.5.</para>
535
536      <para revision="265983">The timezone database has been updated
537	to version tzdata2014c.</para>
538
539      <para revision="266692"><application>Sendmail</application>
540	has been updated to 8.14.9.</para>
541
542      <para revision="267258"><application>OpenSSL</application> has
543	been updated to version 1.0.1h.</para>
544    </sect2>
545
546    <sect2 xml:id="ports">
547      <title>Ports/Packages Collection Infrastructure</title>
548
549      <para>&nbsp;</para>
550
551    </sect2>
552
553    <sect2 xml:id="releng">
554      <title>Release Engineering and Integration</title>
555
556      <para revision="263028">The &man.services.mkdb.8; utility has
557	been updated to include endianness awareness, allowing the
558	<filename>services.db</filename> database to be created as
559	part of the release build, regardless of native- or
560	cross-built releases.</para>
561    </sect2>
562
563    <sect2 xml:id="doc">
564      <title>Documentation</title>
565
566      <para>&nbsp;</para>
567
568    </sect2>
569  </sect1>
570
571  <sect1 xml:id="upgrade">
572    <title>Upgrading from Previous Releases of &os;</title>
573
574    <para arch="amd64,i386">Binary upgrades between RELEASE versions
575      (and snapshots of the various security branches) are supported
576      using the &man.freebsd-update.8; utility.  The binary upgrade
577      procedure will update unmodified userland utilities, as well as
578      unmodified GENERIC or SMP kernels distributed as a part of an
579      official &os; release.  The &man.freebsd-update.8; utility
580      requires that the host being upgraded have Internet
581      connectivity.</para>
582
583    <para>Source-based upgrades (those based on recompiling the &os;
584      base system from source code) from previous versions are
585      supported, according to the instructions in
586      <filename>/usr/src/UPDATING</filename>.</para>
587
588    <important>
589      <para>Upgrading &os; should only be attempted after
590	backing up <emphasis>all</emphasis> data and configuration
591	files.</para>
592    </important>
593  </sect1>
594</article>
595