article.xml revision 276929
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" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
12  <info><title>&os; &release.current; Release Notes</title>
13
14  <author><orgname>The &os; Project</orgname></author>
15
16  <pubdate>$FreeBSD: head/release/doc/en_US.ISO8859-1/relnotes/article.xml 276929 2015-01-10 22:04:07Z gjb $</pubdate>
17
18  <copyright>
19    <year>2015</year>
20    <holder role="mailto:doc@FreeBSD.org">The &os; Documentation
21      Project</holder>
22  </copyright>
23
24  <legalnotice xml:id="trademarks" role="trademarks">
25    &tm-attrib.freebsd;
26    &tm-attrib.ibm;
27    &tm-attrib.ieee;
28    &tm-attrib.intel;
29    &tm-attrib.sparc;
30    &tm-attrib.general;
31  </legalnotice>
32
33  <abstract>
34    <para>The release notes for &os; &release.current; contain
35      a summary of the changes made to the &os; base system on the
36      &release.branch; development line.  This document lists
37      applicable security advisories that were issued since the last
38      release, as well as significant changes to the &os; kernel and
39      userland.  Some brief remarks on upgrading are also
40      presented.</para>
41  </abstract>
42</info>
43
44<sect1 xml:id="intro">
45  <title>Introduction</title>
46
47  <para>This document contains the release notes for &os;
48    &release.current;.  It describes recently added, changed, or
49    deleted features of &os;.  It also provides some notes on
50    upgrading from previous versions of &os;.</para>
51
52  <para releasetype="current">The &release.type; distribution to which
53    these release notes apply represents the latest point along the
54    &release.branch; development branch since &release.branch; was
55    created.  Information regarding pre-built, binary &release.type;
56    distributions along this branch can be found at <uri
57      xlink:href="&release.url;">&release.url;</uri>.</para>
58
59  <para releasetype="snapshot">The &release.type; distribution to
60    which these release notes apply represents a point along the
61    &release.branch; development branch between &release.prev; and the
62    future &release.next;.  Information regarding pre-built, binary
63    &release.type; distributions along this branch can be found at
64    <uri xlink:href="&release.url;">&release.url;</uri>.</para>
65
66  <para releasetype="release">This distribution of &os;
67    &release.current; is a &release.type; distribution.  It can be
68    found at <uri xlink:href="&release.url;">&release.url;</uri> or
69    any of its mirrors.  More information on obtaining this (or other)
70    &release.type; distributions of &os; can be found in the <link
71      xlink:href="&url.books.handbook;/mirrors.html"><quote>Obtaining
72	&os;</quote> appendix</link> to the <link
73      xlink:href="&url.books.handbook;/">&os; Handbook</link>.</para>
74
75  <para>All users are encouraged to consult the release errata before
76    installing &os;.  The errata document is updated with
77    <quote>late-breaking</quote> information discovered late in the
78    release cycle or after the release.  Typically, it contains
79    information on known bugs, security advisories, and corrections to
80    documentation.  An up-to-date copy of the errata for &os;
81    &release.current; can be found on the &os; Web site.</para>
82</sect1>
83
84<sect1 xml:id="new">
85  <title>What's New</title>
86
87  <para>This section describes the most user-visible new or changed
88    features in &os; since &release.prev;.  In general, changes
89    described here are unique to the &release.branch; branch unless
90    specifically marked as &merged; features.</para>
91
92  <para>Typical release note items document recent security advisories
93    issued after &release.prev;, new drivers or hardware support, new
94    commands or options, major bug fixes, or contributed software
95    upgrades.  They may also list changes to major ports/packages or
96    release engineering practices.  Clearly the release notes cannot
97    list every single change made to &os; between releases; this
98    document focuses primarily on security advisories, user-visible
99    changes, and major architectural improvements.</para>
100
101  <sect2 xml:id="security">
102    <title>Security Advisories</title>
103
104    <para>No advisories.</para>
105
106  </sect2>
107
108  <sect2 xml:id="kernel">
109    <title>Kernel Changes</title>
110
111    <para revision="260903">Support for GPS ports has been added to
112      &man.uhso.4;.</para>
113
114    <para revision="264601" contrib="sponsor"
115      sponsor="&darpa_afrl;">The <literal>if_nf10bmac(4)</literal>
116      device has been added, providing support for NetFPGA-10G
117      Embedded CPU Ethernet Core.</para>
118
119    <note>
120      <para>The <literal>if_nf10bmac(4)</literal> driver operates on
121	the FPGA, and is not suited for the PCI host interface.</para>
122    </note>
123
124    <para revision="265132">The &man.full.4; device has been added,
125      and the <literal>lindev(4)</literal> device has been removed.
126      Prior to this change, <literal>lindev(4)</literal> provided only
127      the <filename>/dev/full</filename> character device, returning
128      <literal>ENOSPC</literal> on write attempts.  As this device is
129      not specific to &linux;, a native &os; version has been
130      added.</para>
131
132    <para revision="265236" contrib="sponsor"
133      sponsor="&lsi;, &spectralogic;" sponsorurl="">The &man.mpr.4;
134      device has been added, providing support for LSI Fusion-MPT
135      3 12Gb SCSI/SATA controllers.</para>
136
137    <para revision="265555" contrib="sponsor"
138      sponsor="&lsi;">The &man.mrsas.4; driver has been added,
139      providing support for LSI MegaRAID SAS controllers.  The
140      &man.mfi.4; driver will attach to the controller, by default.
141      To enable &man.mrsas.4; add
142      <literal>hw.mfi.mrsas_enable=1</literal> to
143      <filename>/boot/loader.conf</filename>, which turns off
144      &man.mfi.4; device probing.</para>
145
146    <note>
147      <para>At this time, the &man.mfiutil.8; utility and
148	the &os; version of
149	<application>MegaCLI</application> and
150	<application>StorCli</application> do not work with
151	&man.mrsas.4;.</para>
152    </note>
153
154    <para revision="265876">A kernel bug that inhibited proper
155      functionality of the <literal>dev.cpu.0.freq</literal>
156      &man.sysctl.8; on &intel; processors with Turbo
157      Boost&nbsp;&trade; enabled has been fixed.</para>
158
159    <para revision="266531">The <literal>IMAGACT_BINMISC</literal>
160      kernel configuration option has been enabled by default,
161      which enables application execution through emulators, such
162      as <application>Qemu</application>.</para>
163
164    <para revision="266757" contrib="sponsor"
165	sponsor="&chelsio;">Support for the &man.cxgbe.4; Terminator 5
166      (T5) 10G/40G cards has been added to &man.netmap.4;.</para>
167
168    <para revision="268045">The <literal>VT</literal> kernel
169      configuration file has been removed, and the &man.vt.4;
170      driver is included in the <literal>GENERIC</literal> kernel.
171      To enable &man.vt.4;, enter <literal>set kern.vty=vt</literal>
172      at the &man.loader.8; prompt during boot, or add
173      <literal>kern.vty=vt</literal> to &man.loader.conf.5; and
174      reboot the system.</para>
175
176    <para revision="271697" arch="powerpc">Support for &man.dtrace.1;
177      stack tracing has been fixed for &os;/&arch.powerpc;, using the
178      <literal>trapexit()</literal> and
179      <literal>asttrapexit()</literal> functions instead of checking
180      within addressed kernel space.</para>
181
182    <para revision="271705">Hardware context support has been
183      added to the <literal>drm/i915</literal> driver, adding
184      support for <application>Mesa</application> 9.2 and
185      later.</para>
186
187    <sect3 xml:id="kernel-virtualization">
188      <title>Virtualization support</title>
189
190      <para revision="260410">Support for the <quote>Virtual Interrupt
191	  Delivery</quote> feature of &intel;&nbsp;VT-x is enabled if
192	supported by the CPU.  This feature can be disabled by running
193	<literal>sysctl hw.vmm.vmx.use_apic_vid=0</literal>.
194	Additionally, to persist this setting across reboots, add
195	<literal>hw.vmm.vmx.use_apic_vid=0</literal> to
196	<filename>/etc/sysctl.conf</filename>.</para>
197
198      <para revision="260532">Support for <quote>Posted Interrupt
199	  Processing</quote> is enabled if supported by the CPU.  This
200	feature can be disabled by running <literal>sysctl
201	  hw.vmm.vmx.use_apic_pir=0</literal>.  Additionally, to
202	persist this setting across reboots, add
203	<literal>hw.vmm.vmx.use_apic_pir=0</literal> to
204	<filename>/etc/sysctl.conf</filename>.</para>
205
206      <para revision="260582">Unmapped IO support has been added to
207	&man.virtio_blk.4;.</para>
208
209      <para revision="260583">Unmapped IO support has been added to
210	&man.virtio_scsi.4;.</para>
211
212      <para revision="260847">The &man.virtio_random.4; driver has
213	been added to harvest entropy from the host system.</para>
214
215      <para revision="267536" contrib="sponsor"
216	sponsor="&citrix.rd;">Support for running a &os;/&arch.amd64;
217	<application>Xen</application> guest instance as
218	<acronym>PVH</acronym> guest has been added.
219	<acronym>PVH</acronym> mode, short for <quote>Para-Virtualized
220	  Hardware</quote>, uses para-virtualized drivers for boot
221	and I/O, and uses hardware virtualization extensions for all
222	other tasks, without the need for emulation.</para>
223    </sect3>
224
225    <sect3 xml:id="kernel-arm">
226      <title>ARM support</title>
227
228      <para revision="260921">The &man.nand.4; device is enabled for
229	ARM devices by default.</para>
230    </sect3>
231
232    <sect3 xml:id="boot">
233      <title>Boot Loader Changes</title>
234
235      <para>&nbsp;</para>
236    </sect3>
237
238    <sect3 xml:id="proc">
239      <title>Hardware Support</title>
240
241      <para revision="268303">The &man.asmc.4; driver has been updated
242	to support the &apple;&nbsp;MacMini 3,1.</para>
243
244      <para revision="268351">Support for &os;/ia64 has been dropped
245	as of &os;&nbsp;11.</para>
246
247      <sect4 xml:id="mm">
248	<title>Multimedia Support</title>
249
250	<para>&nbsp;</para>
251      </sect4>
252
253      <sect4 xml:id="net-if">
254	<title>Network Interface Support</title>
255
256	<para revision="258830">Support for Broadcom chipsets
257	  BCM57764, BCM57767, BCM57782, BCM57786 and BCM57787 has
258	  been added to &man.bge.4;.</para>
259
260	<para revision="260448">Support for the &intel;
261	  Centrino&trade; Wireless-N 135 chipset has been
262	  added.</para>
263
264	<para revision="260552">Firmware for &intel;
265	  Centrino&trade; Wireless-N 105 devices has been added
266	  to the base system.</para>
267
268	<para revision="261975">The deprecated nve(4) driver has been
269	  removed.  Users of NVIDIA nForce MCP network adapters are
270	  advised to use the &man.nfe.4; driver instead, which has been
271	  the default driver for this hardware since &os; 7.0.</para>
272
273	<para revision="265348" contrib="sponsor"
274	  sponsor="&netgate;">The &man.ath.hal.4; driver has been
275	  updated to support the Atheros AR1111 chipset.</para>
276
277	<para revision="266770">Support for the &intel;
278	  Centrino&trade; Wireless-N 105 chipset has been
279	  added.</para>
280
281	<para revision="272089">A bug in &man.ipfw.4; that could
282	  potentially lead to a kernel panic when using
283	  &man.dummynet.4; at layer 2 has been fixed.</para>
284      </sect4>
285    </sect3>
286
287    <sect3 xml:id="net-proto">
288      <title>Network Protocols</title>
289
290      <para revision="263140">Support for the IPX network transport
291	protocol has been removed, and will not be supported in
292	&os;&nbsp;11 and later releases.</para>
293    </sect3>
294
295    <sect3 xml:id="disks">
296      <title>Disks and Storage</title>
297
298      <para revision="267359">Support for the
299	<literal>disklabel64</literal> partitioning scheme has been
300	added to &man.gpart.8;.</para>
301
302      <para revision="276526">The <literal>asr(4)</literal> driver has
303	been removed, and is no longer supported.</para>
304    </sect3>
305
306    <sect3 xml:id="fs">
307      <title>File Systems</title>
308
309	<para revision="r270096" contrib="sponsor" sponsor="&ff;">The
310	  new filesystem automount facility, &man.autofs.5;, has been
311	  added.  The new &man.autofs.5; facility is similar to that
312	  found in other &unix;-like operating systems, such as
313	  OS&nbsp;X&trade; and Solaris&trade;.  The &man.autofs.5;
314	  facility uses a &sun;-compatible &man.auto.master.5;
315	  configuration file, and is administered with the
316	  &man.automount.8; userland utility, and the
317	  &man.automountd.8; and &man.autounmountd.8; daemons.</para>
318
319      <sect4 xml:id="fs-zfs">
320	<title>ZFS</title>
321
322	<para>&nbsp;</para>
323      </sect4>
324    </sect3>
325  </sect2>
326
327  <sect2 xml:id="userland">
328    <title>Userland Changes</title>
329
330    <para revision="258838" contrib="sponsor" sponsor="&ff;, &google;"
331      sponsorurl="">The &man.casperd.8; daemon has been added,
332      which provides access to functionality that is not available in
333      the <quote>capability mode</quote> sandbox.</para>
334
335    <para revision="260594">When unable to load a kernel module with
336      &man.kldload.8;, a message informing to view output of
337      &man.dmesg.8; is now printed, opposed to the previous output
338      <quote>Exec format error.</quote>.</para>
339
340    <para revision="260910">Allow &man.pciconf.8; to identify PCI
341      devices that are attached to a driver to be identified by their
342      device name instead of just the selector.  Additionally, an
343      optional device argument to the <literal>-l</literal> flag
344      to restrict the output to only listing details about a single
345      device.</para>
346
347    <para revision="260913">A new flag, <quote>onifconsole</quote> has
348      been added to <filename>/etc/ttys</filename>.  This allows the
349      system to provide a login prompt via serial console if the
350      device is an active kernel console, otherwise it is equivalent
351      to <literal>off</literal>.</para>
352
353    <para revision="260926">Support for displaying VPD for PCI devices
354      via &man.pciconf.8; has been added.</para>
355
356    <para revision="261498">&man.ping.8; protects against malicious
357      network packets using the Capsicum framework to drop
358      privileges.</para>
359
360    <para revision="261504">&os;/&arch.i386; guests can be run under
361      bhyve.</para>
362
363    <para revision="265229">The &man.ps.1; utility has been
364      updated to include the <literal>-J</literal> flag, used to
365      filter output by matching &man.jail.8; IDs and names.
366      Additionally, argument <literal>0</literal> can be used to
367      <literal>-J</literal> to only list processes running on the
368      host system.</para>
369
370    <para revision="265249">The &man.top.1; utility has been updated
371      to filter by &man.jail.8; ID or name, in followup to the
372      &man.ps.1; change in <literal>r265229</literal>.</para>
373
374    <para revision="265995">The Blowfish &man.crypt.3; default format
375      has been changed to
376      <literal>&dollar;2b&dollar;</literal>.</para>
377
378    <para revision="266209">The &man.pmcstat.8; utility has been
379      updated to include a new flag, <literal>-l</literal>, which
380      ends event collection after the specified number of
381      seconds.</para>
382
383    <para revision="266463">The default &man.newsyslog.conf.5; now
384      includes files in the
385      <filename>/etc/newsyslog.conf.d/</filename> and
386      <filename>/usr/local/etc/newsyslog.conf.d/</filename>
387      directories by default for &man.newsyslog.8;.</para>
388
389    <para revision="268461">The &man.readline.3; library is now
390      statically linked in software within the base system, and the
391      shared library is no longer installed, allowing the Ports
392      Collection to use a modern version of the library.</para>
393
394    <para revision="270675">The &man.mailwrapper.8; utility has been
395      updated to use &man.mailer.conf.5; from the
396      <literal>LOCALBASE</literal> environment variable, which
397      defaults to <filename class="directory">/usr/local</filename>
398      if unset.</para>
399
400    <para revision="270745">The &man.ps.1; utility has been updated
401      to include a new keyword, <quote>tracer</quote>, which displays
402      the parent <acronym>PID</acronym> of a child process.</para>
403
404    <para revision="271482">Support for adding empty partitions has
405      been added to the &man.mkimg.1; utility.</para>
406
407    <para revision="272166">The &man.primes.6; utility has been
408      updated to correctly enumerate prime numbers between
409      <literal>4295098369</literal> and
410      <literal>3825123056546413050</literal>, which prior to this
411      change, it would be possible for returned values to be
412      incorrectly identified as prime numbers.</para>
413
414    <para revision="272198">The &man.mkimg.1; utility has been
415      updated to include three options used to print information
416      about &man.mkimg.1; itself:</para>
417
418    <informaltable frame="none" pgwide="0">
419      <tgroup cols="2">
420	<colspec colwidth="1*"/>
421	<colspec colwidth="1*"/>
422	<thead>
423	  <row>
424	    <entry>Option</entry>
425	    <entry>Output</entry>
426	  </row>
427	</thead>
428
429	<tbody>
430	  <row>
431	    <entry><literal>--version</literal></entry>
432	    <entry>The current version of the &man.mkimg.1;
433	      utility</entry>
434	  </row>
435
436	  <row>
437	    <entry><literal>--formats</literal></entry>
438	    <entry>The disk image file formats supported by
439	      &man.mkimg.1;</entry>
440	  </row>
441
442	  <row>
443	    <entry><literal>--schemes</literal></entry>
444	    <entry>The partition schemes supported by
445	      &man.mkimg.1;</entry>
446	  </row>
447	</tbody>
448      </tgroup>
449    </informaltable>
450
451    <para revision="272273">The &man.strptime.3; library has been
452      updated to add support for <acronym>POSIX</acronym>-2001
453      features <literal>%U</literal> and <literal>%W</literal>.</para>
454
455    <sect3 xml:id="abi-compat">
456      <title><acronym>ABI</acronym> Compatibility</title>
457
458      <para revision="271982">The &linux; compatiblity version has
459	been updated to <literal>2.6.18</literal>.  The
460	<literal>compat.linux.osrelease</literal> &man.sysctl.8; is
461	evaluated when building the <filename
462	  role="package">emulators/linux-c6</filename> and related
463	ports.</para>
464    </sect3>
465
466    <sect3 xml:id="rc-scripts">
467      <title><filename>/etc/rc.d</filename> Scripts</title>
468
469      <para revision="270676">The &man.rc.8; subsystem has been
470	updated to allow configuring services in <filename
471	  class="directory">&dollar;{LOCALBASE}/etc/rc.conf.d/</filename>.
472	If <literal>LOCALBASE</literal> is unset, it defaults to
473	<filename class="directory">/usr/local</filename>.</para>
474    </sect3>
475
476    <sect3 xml:id="periodic-scripts">
477      <title><filename>/etc/periodic</filename> Scripts</title>
478
479      <para revision="271321">The daily &man.periodic.8; script
480	<filename>110.clean-tmps</filename> has been updated to
481	avoid crossing filesystem mount boundaries when cleaning
482	files in <filename class="directory">/tmp</filename>.</para>
483    </sect3>
484  </sect2>
485
486  <sect2 xml:id="contrib">
487    <title>Contributed Software</title>
488
489    <para revision="258884" contrib="sponsor"
490      sponsor="&darpa_afrl;">&man.lldb.1; has been updated to upstream
491      snapshot version r196259.</para>
492
493    <para revision="259626">Timezone data files have been updated to
494      version 2013i.</para>
495
496    <para revision="260445">&man.byacc.1; has been updated to version
497      20140101.</para>
498
499    <para revision="261037"><application>OpenSSL</application> has
500      been updated to version 1.0.1.f.</para>
501
502    <para revision="261071">&man.jemalloc.3; has been updated to
503      version 3.5.0.</para>
504
505    <para revision="261212"><application>bmake</application> has been
506      updated to version 20140101.</para>
507
508    <para revision="261283"><application>libc++</application> has been
509      updated to version 3.4.</para>
510
511    <para revision="261320"><application>OpenSSH</application> has
512      been updated to 6.5p1.</para>
513
514    <para revision="261344"><application>mdocml</application> has been
515      updated to version 1.12.3.</para>
516
517    <para revision="261991"><application>LLVM</application> and
518      <application>Clang</application> have been updated to
519      version 3.4.</para>
520
521    <para revision="266527" role="merged"><application>Sendmail</application>
522      has been updated from 8.14.7 to 8.14.9.</para>
523
524    <para revision="267256"><application>OpenSSL</application> has
525      been updated to version 1.0.1h.</para>
526
527    <para revision="276577"><application>file</application> has been
528      updated to version 5.22.</para>
529  </sect2>
530
531  <sect2 xml:id="ports">
532    <title>Ports/Packages Collection Infrastructure</title>
533
534    <para>&nbsp;</para>
535  </sect2>
536
537  <sect2 xml:id="releng">
538    <title>Release Engineering and Integration</title>
539
540    <para>&nbsp;</para>
541  </sect2>
542
543  <sect2 xml:id="doc">
544    <title>Documentation</title>
545
546    <para>&nbsp;</para>
547  </sect2>
548</sect1>
549
550<sect1 xml:id="upgrade">
551  <title>Upgrading from previous releases of &os;</title>
552
553  <para arch="amd64,i386">Binary upgrades between RELEASE versions
554    (and snapshots of the various security branches) are supported
555    using the &man.freebsd-update.8; utility.  The binary upgrade
556    procedure will update unmodified userland utilities, as well as
557    unmodified GENERIC kernels distributed as a part of an official
558    &os; release.  The &man.freebsd-update.8; utility requires that
559    the host being upgraded have Internet connectivity.</para>
560
561  <para>Source-based upgrades (those based on recompiling the &os;
562    base system from source code) from previous versions are
563    supported, according to the instructions in
564    <filename>/usr/src/UPDATING</filename>.</para>
565
566  <important>
567    <para>Upgrading &os; should only be attempted after backing up
568      <emphasis>all</emphasis> data and configuration files.</para>
569  </important>
570</sect1>
571</article>
572