article.xml revision 257814
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]>
7<article xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
8<info><title>&os; &release.current; Release Notes</title>
9  
10
11  <author><orgname>The &os; Project</orgname></author>
12
13  <pubdate>$FreeBSD: stable/10/release/doc/en_US.ISO8859-1/relnotes/article.xml 257814 2013-11-07 21:08:12Z gjb $</pubdate>
14
15  <copyright>
16    <year>2000</year>
17    <year>2001</year>
18    <year>2002</year>
19    <year>2003</year>
20    <year>2004</year>
21    <year>2005</year>
22    <year>2006</year>
23    <year>2007</year>
24    <year>2008</year>
25    <year>2009</year>
26    <year>2010</year>
27    <year>2011</year>
28    <year>2012</year>
29    <year>2013</year>
30    <holder role="mailto:doc@FreeBSD.org">The &os; Documentation 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 a summary
44      of the changes made to the &os; base system on the
45      &release.branch; development line.
46      This document lists applicable security advisories that were issued since
47      the last release, as well as significant changes to the &os;
48      kernel and userland.
49      Some brief remarks on upgrading are also 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
58    describes recently added, changed, or deleted features of &os;.
59    It also provides some notes on upgrading
60    from previous versions of &os;.</para>
61
62  <para releasetype="current">The &release.type; distribution to which these release notes
63    apply represents the latest point along the &release.branch; development
64    branch since &release.branch; was created.  Information regarding pre-built, binary
65    &release.type; distributions along this branch
66    can be found at <uri xlink:href="&release.url;">&release.url;</uri>.</para>
67
68  <para releasetype="snapshot">The &release.type; distribution to which these release notes
69    apply represents a point along the &release.branch; development
70    branch between &release.prev; and the future &release.next;.
71    Information regarding
72    pre-built, binary &release.type; distributions along this branch
73    can be found at <uri xlink:href="&release.url;">&release.url;</uri>.</para>
74
75  <para releasetype="release">This distribution of &os; &release.current; is a
76    &release.type; distribution.  It can be found at <uri xlink:href="&release.url;">&release.url;</uri> or any of its mirrors.  More
77    information on obtaining this (or other) &release.type;
78    distributions of &os; can be found in the <link xlink:href="&url.books.handbook;/mirrors.html"><quote>Obtaining
79    &os;</quote> appendix</link> to the <link xlink:href="&url.books.handbook;/">&os;
80    Handbook</link>.</para>
81
82  <para>All users are encouraged to consult the release errata before
83    installing &os;.  The errata document is updated with
84    <quote>late-breaking</quote> information discovered late in the
85    release cycle or after the release.  Typically, it contains
86    information on known bugs, security advisories, and corrections to
87    documentation.  An up-to-date copy of the errata for &os;
88    &release.current; can be found on the &os; Web site.</para>
89
90</sect1>
91
92<sect1 xml:id="new">
93  <title>What's New</title>
94
95  <para>This section describes
96    the most user-visible new or changed features in &os;
97    since &release.prev;.
98    In general, changes described here are unique to the &release.branch;
99    branch unless specifically marked as &merged; features.
100  </para>
101
102  <para>Typical release note items
103    document recent security advisories issued after
104    &release.prev;,
105    new drivers or hardware support, new commands or options,
106    major bug fixes, or contributed software upgrades.  They may also
107    list changes to major ports/packages or release engineering
108    practices.  Clearly the release notes cannot list every single
109    change made to &os; between releases; this document focuses
110    primarily on security advisories, user-visible changes, and major
111    architectural improvements.</para>
112
113  <sect2 xml:id="security">
114    <title>Security Advisories</title>
115
116    <para/>
117
118  </sect2>
119
120  <sect2 xml:id="kernel">
121    <title>Kernel Changes</title>
122
123    <para>A new &man.cpuset.2; API has been added
124      for thread to CPU binding and CPU resource grouping and
125      assignment.  The &man.cpuset.1; userland utility has been added
126      to allow manipulation of processor sets.</para>
127
128    <para role="merged">The &man.ddb.4; kernel debugger now has an output capture
129      facility.  Input and output from &man.ddb.4; can now be captured
130      to a memory buffer for later inspection using &man.sysctl.8; or
131      a textdump.  The new <command>capture</command> command controls
132      this feature.</para>
133
134    <para role="merged">The &man.ddb.4; debugger now supports a simple scripting
135      facility, which supports a set of named scripts consisting of a
136      set of &man.ddb.4; commands.  These commands can be managed from
137      within &man.ddb.4; or with the use of the new &man.ddb.8;
138      utility.  More details can be found in the &man.ddb.4; manual
139      page.</para>
140
141    <para role="merged">The kernel now supports a new textdump format of kernel
142      dumps.  A textdump provides higher-level information via
143      mechanically generated/extracted debugging output, rather than a
144      simple memory dump.  This facility can be used to generate brief
145      kernel bug reports that are rich in debugging information, but
146      are not dependent on kernel symbol tables or precisely
147      synchronized source code.  More information can be found in the
148      &man.textdump.4; manual page.</para>
149
150    <para>Kernel support for M:N threading has been removed.  While
151      the KSE (Kernel Scheduled Entities) project was quite successful
152      in bringing threading to FreeBSD, the M:N approach taken by the
153      KSE library was never developed to its full potential.
154      Backwards compatibility for applications using KSE threading
155      will be provided via &man.libmap.conf.5; for dynamically linked
156      binaries.  The &os; Project greatly appreciates the work of
157      &a.julian;, &a.deischen;, and &a.davidxu; on KSE support.</para>
158
159    <para>The &os; kernel now exports information about certain kernel
160      features via the <varname>kern.features</varname> sysctl tree.
161      The &man.feature.present.3; library call provides a convenient
162      interface for user applications to test the presence of
163      features.</para>
164
165    <para arch="amd64">The &os; kernel now has support for large
166      memory page mappings (<quote>superpages</quote>).</para>
167
168    <para arch="amd64,i386,ia64,powerpc" role="merged">The ULE
169      scheduler is now the default process scheduler
170      in <filename>GENERIC</filename> kernels.</para>
171
172    <sect3 xml:id="boot">
173      <title>Boot Loader Changes</title>
174
175      <para arch="amd64,i386" role="merged">The BTX kernel used by the boot
176	loader has been changed to invoke BIOS routines from real
177	mode.  This change makes it possible to boot &os; from USB
178	devices.</para>
179
180      <para arch="amd64,i386" role="merged">A new gptboot boot loader has
181        been added to support booting from a GPT labeled disk.  A
182        new <command>boot</command> command has been added to
183        &man.gpt.8;, which makes a GPT disk bootable by writing the
184        required bits of the boot loader, creating a new boot
185        partition if required.</para>
186
187    </sect3>
188
189    <sect3 xml:id="proc">
190      <title>Hardware Support</title>
191
192      <para role="merged">The &man.cmx.4; driver, a driver for Omnikey CardMan 4040
193        PCMCIA smartcard readers, has been added.</para>
194
195      <para>The &man.syscons.4; driver now supports Colemak keyboard layout.</para>
196
197      <para role="merged">The &man.uslcom.4; driver, a driver for Silicon
198        Laboratories CP2101/CP2102-based USB serial adapters, has been
199        imported from OpenBSD.</para>
200
201      <sect4 xml:id="mm">
202	<title>Multimedia Support</title>
203
204	<para/>
205
206      </sect4>
207
208      <sect4 xml:id="net-if">
209	<title>Network Interface Support</title>
210
211	<para>The &man.ale.4; driver has been added to provide support
212	  for Atheros AR8121/AR8113/AR8114 Gigabit/Fast Ethernet controllers.</para>
213
214	<para>The &man.em.4; driver has been split into two drivers
215	  with some common parts.  The &man.em.4; driver will continue
216	  to support adapters up to the 82575, as well as new
217	  client/desktop adapters.  A new &man.igb.4; driver
218	  will support new server adapters.</para>
219
220	<para>The &man.jme.4; driver has been added to provide support
221	  for PCIe network adapters based on JMicron JMC250 Gigabit
222	  Ethernet and JMC260 Fast Ethernet controllers.</para>
223
224	<para>The &man.malo.4; driver has been added to provide
225	  support for Marvell Libertas 88W8335 based PCI network
226	  adapters.</para>
227
228	<para>The firmware for the &man.mxge.4; driver has been
229	  updated from 1.4.25 to 1.4.29.</para>
230
231	<para>The &man.sf.4; driver has been overhauled to improve its
232	  performance and to add support for checksum offloading.  It
233	  should also work on all architectures.</para>
234
235	<para>The &man.re.4; driver has been overhauled to fix a
236	  number of issues.  This driver now has Wake On LAN (WOL)
237	  support.</para>
238
239	<para>The &man.vr.4; driver has been overhauled to fix a
240	  number of outstanding issues.  It also now works on all
241	  architectures.</para>
242
243	<para arch="amd64,i386" role="merged">The &man.wpi.4; driver has
244	  been updated to include a number of stability fixes.</para>
245
246      </sect4>
247    </sect3>
248
249    <sect3 xml:id="net-proto">
250      <title>Network Protocols</title>
251
252      <para>The &man.bpf.4; packet filter and capture facility now
253        supports a zero-copy mode of operation, in which buffers are
254        loaned from a user process to the kernel.  This feature can
255        be enabled by setting
256        the <varname>net.bpf.zerocopy_enable</varname> sysctl
257        variable to <literal>1</literal>.</para>
258
259      <para>ISDN4BSD(I4B), <filename>netatm</filename>, and all
260        related subsystems have been removed due to lack of
261        multi-processor support.</para>
262
263      <para role="merged">A bug in TCP options padding, where the wrong padding
264        bytes were used, has been fixed.</para>
265
266      <para role="merged">The IEEE 802.11s element identifiers have
267        been updated to reflect the final version of the amendment.  This
268        update breaks compatibility with older mesh setups but is necessary
269        as the previous IDs are used by another amendment leading to
270        unexpected results when trying to associate with an accesspoint
271        using the affected IDs.</para>
272
273    </sect3>
274
275    <sect3 xml:id="disks">
276      <title>Disks and Storage</title>
277
278      <para role="merged">The &man.aac.4; driver now supports volumes larger than
279        2TB in size.</para>
280
281      <para>The &man.ata.4; driver now supports a spindown command for
282        disks; after a configurable amount of time, if no requests
283        have been received for a disk, the disk will be spun down
284        until the next request.  The &man.atacontrol.8; utility now
285        supports a <command>spindown</command> command to configure
286        this feature.</para>
287
288      <para role="merged">The &man.hptrr.4; driver has been updated to version 1.2
289        from Highpoint.</para>
290
291    </sect3>
292
293    <sect3 xml:id="fs">
294      <title>File Systems</title>
295
296      <para>A problem with using &man.mmap.2; on ZFS filesystems has
297        been fixed.</para>
298
299      <para>A new kernel-mode NFS lock manager has been added,
300        improving performance and behavior of NFS locking.  A new
301        &man.clear.locks.8; command has been added to clear locks held
302        on behalf of an NFS client.</para>
303
304      <para role="merged">The <application>ZFS</application> file system
305        has been upgraded to version 28.  Changes include Data
306        Deduplication, Triple parity RAIDZ, and zfs diff.</para>
307
308    </sect3>
309  </sect2>
310
311  <sect2 xml:id="userland">
312    <title>Userland Changes</title>
313
314    <para role="merged">The &man.adduser.8; utility now supports
315      a <option>-M</option> option to set the mode of a new user's
316      home directory.</para>
317
318    <para>BSD-licensed versions of &man.ar.1; and &man.ranlib.1;,
319      based on <filename>libarchive</filename>, have replaced the GNU
320      Binutils versions of these utilities.</para>
321
322    <para>BSD-licensed versions of &man.bc.1; and &man.dc.1; have
323      replaced their GNU counterparts.</para>
324
325    <para role="merged">&man.chflags.1; now supports a <option>-v</option> flag for
326      verbose output and a <option>-f</option> flag to ignore errors
327      with the same semantics as (for example)
328      &man.chmod.1;.</para>
329
330    <para>For compatibility with other implementations, &man.cp.1; now
331      supports a <option>-a</option> flag, which is equivalent to
332      specifying the <option>-RrP</option> flags.</para>
333
334    <para>BSD-licensed version of &man.cpio.1; based on
335      <filename>libarchive</filename>, has replaced the GNU cpio.
336      Note that the GNU cpio is still installed as
337      <filename>gcpio</filename>.</para>
338
339    <para>The &man.env.1; program now supports <option>-u
340      <replaceable>name</replaceable></option>
341      which will completely unset the given variable
342      <replaceable>name</replaceable> by removing it from the environment,
343      instead of just setting it to a null value.</para>
344
345    <para>The &man.fdopendir.3; library function has been added.</para>
346
347    <para role="merged">The &man.fetch.3; library now support HTTP 1.1
348      If-Modified-Since behavior.  The &man.fetch.1; program now
349      supports <option>-i <replaceable>filename</replaceable></option>
350      which will only download the specified HTTP URL if the content
351      is newer than <replaceable>filename</replaceable>.</para>
352
353    <para>&man.find.1; has been enhanced by the addition of a number
354      of primaries that were present in GNU find but not &os;
355      &man.find.1;.</para>
356
357    <para>&man.kgdb.1; now supports a new <command>add-kld</command>
358      command to make it easier to debug crash dumps with kernel
359      modules.</para>
360
361    <para>The &man.ls.1; program now supports a <option>-D</option>
362      option to specify a date format string to be used with the long
363      format (<option>-l</option>) output.</para>
364
365    <para>&man.nc.1; now supports a <option>-O</option> switch to
366      disable the use of TCP options.</para>
367
368    <para>&man.nc.1;'s <option>-o</option> switch has been deprecated.
369      It will be removed in a future release.</para>
370
371    <para>The &man.ping6.8; utility now returns <literal>2</literal>
372      when the packet transmission was successful but no responses
373      were received (this is the same behavior as &man.ping.8;).
374      It returned a non-zero value before this change.</para>
375
376    <para>The &man.procstat.1; utility has been added to display
377      detailed information about processes.</para>
378
379    <para role="merged">The &man.realpath.1; utility now supports
380      a <option>-q</option> flag to suppress warnings; it now also
381      accepts multiple paths on its command line.</para>
382
383    <para>&man.sh.1; has many bug fixes, some new features, and will now
384      refuse to parse some invalid scripts.  Additionally, it now
385      has filename completion and defaults to the &quot;emacs&quot; editing
386      mode.</para>
387
388    <para>The &man.split.1; utility now supports a <option>-n</option>
389      flag to split a file into a certain number of chunks.</para>
390
391    <para>The &man.tar.1; utility now supports a <option>-Z</option>
392      flag to enable &man.compress.1;-style
393      compression/decompression.</para>
394
395    <para>The &man.tar.1; utility now supports a
396      <option>--numeric-owner</option> flag to ignore user/group names
397      on create and extract.</para>
398
399    <para>The &man.tar.1; utility now supports an
400      <option>-S</option> flag to sparsify files on extraction.</para>
401
402    <para>The &man.tar.1; utility now supports a <option>-s</option>
403      flag to substitute filenames based on the specified regular
404      expression.</para>
405
406    <para>The &man.tcgetsid.3; library function has been added to
407      return the process group ID for the session leader for the
408      controlling terminal.  It is defined in IEEE Std 1003.1-2001
409      (POSIX).</para>
410
411    <para>&man.top.1; now supports a <option>-P</option> flag to
412      provide per-CPU usage statistics.</para>
413
414    <para>&man.zdump.8; is now working properly on 64 bit architectures.
415      </para>
416
417    <para>&man.traceroute.8; now has the ability to print the AS
418      number for each hop with the new <option>-a</option> switch; a
419      new <option>-A</option> option allows selecting a particular
420      WHOIS server.</para>
421
422    <para>&man.traceroute6.8; now supports a <option>-U</option> flag
423      to send probe packets with no upper-layer protocol, rather than
424      the usual UDP probe packets.</para>
425
426    <sect3 xml:id="rc-scripts">
427      <title><filename>/etc/rc.d</filename> Scripts</title>
428
429      <para/>
430
431    </sect3>
432  </sect2>
433
434  <sect2 xml:id="contrib">
435    <title>Contributed Software</title>
436
437    <para role="merged"><application>AMD</application> has been updated from 6.0.10
438      to 6.1.5.</para>
439
440    <para role="merged"><application>awk</application> has been updated from 1 May
441      2007 release to the 23 October 2007 release.</para>
442
443    <para role="merged"><application>bzip2</application> has been updated from 1.0.4
444      to 1.0.5.</para>
445
446    <para><application>CVS</application> has been updated from 1.11.17
447      to a post-1.11.22 snapshot from 10 March 2008.</para>
448
449    <para><application>FILE</application> has been updated from 4.23
450      to 5.03.</para>
451
452    <para><application>hostapd</application> has been
453      updated from 0.5.8 to 0.5.10.</para>
454
455    <para><application>IPFilter</application> has been updated from
456      4.1.23 to 4.1.28.</para>
457
458    <para><application>less</application> has been updated from
459      v408 to v429.</para>
460
461    <para><application>ncurses</application> has been updated from
462      5.6-20061217 to 5.6-20080503.</para>
463
464    <para role="merged"><application>OpenSSH</application> has been updated
465      from 4.5p1 to 5.1p1.</para>
466
467    <para role="merged"><application>OpenPAM</application> has been updated from the
468      Figwort release to the Hydrangea release.</para>
469
470    <para role="merged"><application>sendmail</application> has been updated from
471      8.14.1 to 8.14.7.</para>
472
473    <para role="merged">The timezone database has been updated from
474      the <application>tzdata2008h</application> release to
475      the <application>tzdata2009m</application> release.</para>
476
477    <para>The stdtime part of libc, &man.zdump.8; and &man.zic.8;
478      have been updated from the <application>tzcode2004a</application>
479      release to the <application>tzcode2009h</application> release.
480      If you have upgraded from source or via the &man.freebsd-update.8;,
481      then please run &man.tzsetup.8; to install a new /etc/localtime.
482      </para>
483
484    <para><application>WPA Supplicant</application> has been
485      updated from 0.5.8 to 0.5.10.</para>
486
487    <para role="merged"><application>xz</application> has been updated
488      from snapshot as of 12 April 2010 to 5.0.0.</para>
489
490  </sect2>
491
492  <sect2 xml:id="ports">
493    <title>Ports/Packages Collection Infrastructure</title>
494
495    <para>The &man.pkg.create.1; utility now supports
496      <option>-n</option>.  When this option is specified and a
497      package tarball exists, it will not be overwritten.  This is
498      useful when multiple packages are saved with several consecutive
499      runs of &man.pkg.create.1; with the <option>-Rb</option>
500      options.</para>
501
502    <para>The pkg_sign and pkg_check utilities for cryptographically
503      signing &os; packages have been removed.  They were only useful
504      for packages compressed using &man.gzip.1;; however
505      &man.bzip2.1; compression has been the norm for some time
506      now.</para>
507
508  </sect2>
509
510  <sect2 xml:id="releng">
511    <title>Release Engineering and Integration</title>
512
513    <para role="merged">The supported version of
514      the <application>GNOME</application> desktop environment
515      (<package>x11/gnome2</package>) has been
516      updated from 2.20.1 to 2.22.</para>
517
518  </sect2>
519
520  <sect2 xml:id="doc">
521    <title>Documentation</title>
522
523    <para/>
524
525  </sect2>
526</sect1>
527
528<sect1 xml:id="upgrade">
529  <title>Upgrading from previous releases of &os;</title>
530
531  <para arch="amd64,i386">Beginning with &os; 6.2-RELEASE,
532    binary upgrades between RELEASE versions (and snapshots of the
533    various security branches) are supported using the
534    &man.freebsd-update.8; utility.  The binary upgrade procedure will
535    update unmodified userland utilities, as well as unmodified GENERIC or
536    SMP kernels distributed as a part of an official &os; release.
537    The &man.freebsd-update.8; utility requires that the host being
538    upgraded have Internet connectivity.</para>
539
540  <para>Source-based upgrades (those based on recompiling the &os;
541    base system from source code) from previous versions are
542    supported, according to the instructions in
543    <filename>/usr/src/UPDATING</filename>.</para>
544
545  <important>
546    <para>Upgrading &os; should, of course, only be attempted after
547      backing up <emphasis>all</emphasis> data and configuration
548      files.</para>
549  </important>
550</sect1>
551</article>
552