Date: Thu, 12 Jan 2012 00:34:54 +0000 (UTC) From: Hiroki Sato <hrs@FreeBSD.org> To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-stable@freebsd.org, svn-src-stable-9@freebsd.org Subject: svn commit: r229998 - stable/9/release/doc/en_US.ISO8859-1/relnotes Message-ID: <201201120034.q0C0Ysw9084249@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: hrs Date: Thu Jan 12 00:34:54 2012 New Revision: 229998 URL: http://svn.freebsd.org/changeset/base/229998 Log: Add relnotes items: hhook(9) and khelp(9), hw.memtest.tests loader tunable, posix_fallocate(2), boot loader menu updated, iwn(4) firmware update, vxge(4) for Neterion X3100 10GbE Server/Storage adapter added, ipfw(8) fwd IPv6 support, ipfw(8) call/retrun action added, IPv4 /31 network support as in RFC 3021, IPV6_PKTINFO bug fixed, h_ertt(4) (Enhanced Round Trip Time) khelp module added, ng_ipfw(4) IPv6 support, arcmsr(4) 1.20.00.22, cam(4) descriptor format sense data in SPC-3 support added, mxge(4) updated, tws(4) for 3ware 9750 SATA+SAS 6Gb/s RAID controller added, newfs(8), fsck_ffs(8) -E option added, NFS nocto mount option added, vfs.typenumhash loader tunable, libarchive, tar(1), cpio(1) 2.8.4, makefs(8) ISO 9660 support, rtadvd(8), rtsold(8) RDNSS/DNSSL RA option support, rtadvd(8) noifprefix keyword, tftpd(8) interop issue fixed, zpool(8) labelclear command added, awk 20110807, compiler-rt imported, netcat 4.9, tnftp 20100118, less v444, OpenSSH 5.8p2 + hpn patch, pf 4.5, sendmail 8.14.5, tzdata2011m, xz 20110711. - Add descriptions about network configuration changes, openresolv import, and disk partition management utilities. Modified: stable/9/release/doc/en_US.ISO8859-1/relnotes/article.sgml Modified: stable/9/release/doc/en_US.ISO8859-1/relnotes/article.sgml ============================================================================== --- stable/9/release/doc/en_US.ISO8859-1/relnotes/article.sgml Thu Jan 12 00:34:33 2012 (r229997) +++ stable/9/release/doc/en_US.ISO8859-1/relnotes/article.sgml Thu Jan 12 00:34:54 2012 (r229998) @@ -213,14 +213,34 @@ <literal>PT_GNU_STACK</literal> for the specified ABIs (e.g. <literal>elf32</literal> for 32-bit ABI).</para> + <para revision="216758,216615">The &man.hhook.9; (Helper Hook) + and &man.khelp.9; (Kernel Helpers) KPI have been implemented. + These are a kind of superset of &man.pfil.9; framework for + more general use in the kernel. The &man.hhook.9; KPI + provides a way for kernel subsystems to export hook points + that &man.khelp.9; modules can hook to provide enhanced or new + functionality to the kernel. The &man.khelp.9; KPI provides a + framework for managing &man.khelp.9; modules, which indirectly + use the &man.hhook.9; KPI to register their hook functions + with hook points of interest within the kernel. These allow a + structured way to dynamically extend the kernel at runtime in + an ABI preserving manner.</para> + + <para revision="224516" arch="amd64,i386,pc98">A &man.loader.8; + tunable <varname>hw.memtest.tests</varname> has been added. + This controls whether performing a memory testing at boot time + or not. The default value is <literal>1</literal> (performs a + memory test).</para> + <para revision="220137">A new resource accounting API has been - implemented. It can keep per-process, per-jail, - per-loginclass, and per-loginclass resource accounting - information. Note that this is not built nor installed by - default. To build and install them, specify <literal>options - RACCT</literal> in the kernel configuration file and rebuild - the base system as described in &os Handbook (<ulink - url="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/makeworld.html"></ulink>).</para>; + implemented. It can keep per-process, per-jail, and + per-loginclass resource accounting information. Note that + this is not built nor installed by default. To build and + install them, specify <literal>options RACCT</literal> in the + kernel configuration file and rebuild the base system as + described in <ulink + url="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/makeworld.html">&os; + Handbook</ulink>.</para> <para revision="220163">A new resource limiting API has been implemented. It works in conjunction with @@ -231,8 +251,9 @@ that this is not built nor installed by default. To build and install them, specify <literal>options RCTL</literal> in the kernel configuration file and rebuild the base system as - described in &os Handbook (<ulink - url="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/makeworld.html"></ulink>).</para>; + described in <ulink + url="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/makeworld.html">&os; + Handbook</ulink>.</para> <para revision="220031">The &man.sendmsg.2; and &man.recvmsg.2; system calls in &os; Linux ABI compatibility have been @@ -245,6 +266,11 @@ Std 1003.1-2008 (POSIX, Single UNIX Specification Version 4).</para> + <para revision="220791">&man.posix.fallocate.2; system call has + been implemented. This is a function in POSIX to ensure that + a part of storage for regular file data is allocated on the + file system storage media.</para> + <para revision="219304">Two new system calls <function>setloginclass(2)</function> and <function>getloginclass(2)</function> have been added. This @@ -257,11 +283,13 @@ that this is not built nor installed by default. To build and install them, specify <literal>options COMPAT_43</literal> in the kernel configuration file and rebuild the base system as - described in &os; Handbook (<ulink - url="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/makeworld.html"></ulink>).</para>; - - <para revision="218485,219028,219029">The following &man.sysctl.8; variables - for showing availability of various kernel features:</para> + described in <ulink + url="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/makeworld.html">&os; + Handbook</ulink>.</para> + + <para revision="218485,219028,219029">The following + &man.sysctl.8; variables have been added to show availability + of various kernel features:</para> <informaltable frame="none" pgwide="1"> <tgroup cols="2"> @@ -572,6 +600,9 @@ <sect3 id="boot"> <title>Boot Loader Changes</title> + <para revision="222417">The default boot loader menu has been + updated.</para> + <para revision="219541" arch="ia64">The &man.loader.8; loader now supports PBVM (Pre-Boot Virtual Memory). This allows to link the kernel at a fixed virtual address without having to @@ -598,18 +629,15 @@ one wants to use the nominal frequency of the chip in Intel processors, for example.</para> + <para revision="223098" arch="amd64,i386">The &os; &man.usb.4; + subsystem now supports USB 3.0 by default.</para> + <para revision="215649">The &os; &man.usb.4; subsystem now supports USB packet filter. This allows to capture packets which go through each USB host controllers. The implementation is almost based on &man.bpf.4; code. The userland program &man.usbdump.8; has been added.</para> - <sect4 id="mm"> - <title>Multimedia Support</title> - - <para></para> - </sect4> - <sect4 id="net-if"> <title>Network Interface Support</title> @@ -617,9 +645,9 @@ could make AR8152-based network interfaces stop working has been fixed.</para> - <para revision="219647">bxe(4) driver for Broadcom NetXtreme - II 10GbE controller (BCM57710, BCM57711, BCM57711E) has - been added.</para> + <para revision="219647">A bxe(4) driver for Broadcom + NetXtreme II 10GbE controller (BCM57710, BCM57711, + BCM57711E) has been added.</para> <para revision="220009">A &man.cxgb.4; driver has been updated to version 7.11.0.</para> @@ -644,6 +672,10 @@ <para revision="217593">The &man.ixgbe.4; driver has been updated to version 2.3.8.</para> + <para revision="220892">Firmware images in the &man.iwn.4; + driver for 1000, 5000, 6000, and 6500 series have been + updated.</para> + <para revision="216860">A bug in &man.msk.4; driver has been fixed. It could prevent the RX checksum offloading from working.</para> @@ -725,6 +757,9 @@ Ethernet controller, which is commonly found on Vortex86 System On a Chip, has been added.</para> + <para revision="221167">A &man.vxge.4; driver for Neterion + X3100 10GbE Server/Storage adapter has been added.</para> + <para revision="216824">A bug in &man.wpi.4; driver has been fixed. It could display the following error messages and result in the device unusable:</para> @@ -738,6 +773,20 @@ wpi0: wpi_rx_intr: bus_dmamap_load faile <sect3 id="net-proto"> <title>Network Protocols</title> + <para revision="225044">The &man.ipfw.8; now supports IPv6 in + the <command>fwd</command> action.</para> + + <para revision="223666">The &man.ipfw.8; now supports + <command>call</command> and <command>return</command> + action. Upon the <command>call</command> action, The + current rule number is saved in the internal stack and + ruleset processing continues with the first rule numbered + number or higher. The <command>return</command> action + takes rule number saved to internal stack by the last + <command>call</command> action and returns ruleset + processing to the first rule with number greater than number + of corresponding call rule.</para> + <para revision="218794">&os; &man.ipsec.4; support now uses a half of the hash size as the authenticator hash size in Hashed Message Authentication Mode (HMAC-SHA-256, @@ -754,14 +803,26 @@ wpi0: wpi_rx_intr: bus_dmamap_load faile nor installed by default. To build and install them, specify <literal>WITH_OFED=yes</literal> in <filename>/etc/src.conf</filename> and rebuild the base - system as described in &os Handbook (<ulink - url="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/makeworld.html"></ulink>).</para>; + system as described in <ulink + url="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/makeworld.html">&os; + Handbook</ulink>.</para> + + <para revision="226572">&os; TCP/IP network stack now supports + IPv4 prefixes with /31 as described in RFC 3021, + <quote>Using 31-Bit Prefixes on IPv4 Point-to-Point + Links</quote>.</para> <para revision="217169">A bug in &os; TCP/IP network stack has been fixed. The source address selection could not being performed when multicast options were present but without an interface being specified.</para> + <para revision="225682">A bug in + <literal>IPV6_PKTINFO</literal> option used in + &man.sendmsg.2; has been fixed. The caused + <literal>IPV6_USE_MIN_MTU</literal> state set by + &man.setsockopt.2; was ignored.</para> + <para revision="216109,216114,216115,218152,218153,218155"> &os; TCP/IP network stack now supports &man.mod.cc.9; pluggable congestion control framework. This allows TCP congestion @@ -780,12 +841,23 @@ wpi0: wpi_rx_intr: bus_dmamap_load faile For more detail, see &man.mod.cc.4; and &man.mod.cc.9; manual pages.</para> + <para revision="217806">An &man.h.ertt.4; (Enhanced Round Trip + Time) &man.khelp.9; module has been added. This module + allows per-connection, low noise estimate of the + instantaneous RTT in the TCP/IP network stack with a robust + implementation even in the face of delayed acknowledgments + and/or TSO (TCP Segmentation Offload) being in use for a + connection.</para> + <para revision="218912">A new &man.tcp.4; socket option <literal>TCP_CONGESTION</literal> has been added. This allows to select or query a congestion control algorithm that the TCP/IP network stack will use for connections on the socket.</para> + <para revision="225586">The &man.ng.ipfw.4; &man.netgraph.4; + node now supports IPv6.</para> + <para revision="219127">The &man.ng.one2many.4; &man.netgraph.4; node now supports <literal>XMIT_FAILOVER</literal> transmit algorithm. This @@ -816,6 +888,13 @@ wpi0: wpi_rx_intr: bus_dmamap_load faile runtime, but it takes effect only after a device reset.</para> + <para revision="224905">The &man.arcmsr.4; driver has been + updated to version 1.20.00.22.</para> + + <para revision="226067">The &man.cam.4; subsystem now supports + descriptor format sense data in SPC-3 (SCSI Primary Commands + 3) specification.</para> + <para revision="220559">The &man.geom.map.4; GEOM class has been added. This allows to generate multiple geom providers based on a hard-coded layout of a device with no explicit @@ -857,12 +936,11 @@ wpi0: wpi_rx_intr: bus_dmamap_load faile <para revision="216941,217509">A bug in the &man.mmc.4; driver that could fail in device detection has been fixed.</para> - <para revision="219089">ZFS subsystem has been updated to the - SPA (Storage Pool Allocator, also known as zpool) version - 28. It now supports data deduplication, triple parity RAIDZ - (raidz3), snapshot holds, log device removal, zfs diff, - zpool split, zpool import <option>-F</option>, and read-only - zpool import.</para> + <para revision="223958">The &man.mxge.4; driver has been + updated.</para> + + <para revision="226115">A &man.tws.4; driver for 3ware 9750 + SATA+SAS 6Gb/s RAID controller has been added.</para> </sect3> <sect3 id="fs"> @@ -879,16 +957,28 @@ wpi0: wpi_rx_intr: bus_dmamap_load faile automatically enables the softupdates journaling for newly-created UFS file systems.</para> - <para revision="216796">The &os; Fast File System now supports - <literal>TRIM</literal> command when freeing data blocks. A - new flag <option>-t</option> in the &man.newfs.8; and - &man.tunefs.8; utilities sets the TRIM-enable flag in a file - system. The TRIM-enable flag makes the file system send a - delete request to the underlying device for each freed - block. The <literal>TRIM</literal> command is specified as - Data Set Management Command in ATA8-ACS2 standard to carry - the information related to deleted data blocks to device, - especially for SSD (Solid-State Drive) for optimization.</para> + <para revision="216796">The &os; Fast File System now + supports <literal>TRIM</literal> command when freeing data + blocks. A new flag <option>-t</option> in the &man.newfs.8; + and &man.tunefs.8; utilities sets the TRIM-enable flag in a + file system. The TRIM-enable flag makes the file system + send a delete request to the underlying device for each + freed block. The <literal>TRIM</literal> command is + specified as Data Set Management Command in ATA8-ACS2 + standard to carry the information related to deleted data + blocks to device, especially for SSD (Solid-State Drive) for + optimization.</para> + + <para revision="221233">A new flag <option>-E</option> has + been added to &man.newfs.8; and &man.fsck.ffs.8; utilities. + This clears unallocated blocks, notifying the underlying + device that they are not used and that their contents may be + discarded. This is useful in &man.fsck.ffs.8; for file + systems which have been mounted on systems without + <literal>TRIM</literal> support, or with + <literal>TRIM</literal> support disabled, as well as + filesystems which have been copied from one device to + another.</para> <para revision="221124">The &os NFS subsystem has been updated. The new implementation supports NFS version 4 in @@ -919,6 +1009,30 @@ nfsuserd_enable="YES"</programlisting> <para>For more information about NFSv4 and its configuration, see &man.nfsv4.4; and &man.exports.5; manual pages.</para> + + <para revision="221436">The &os; NFS subsystem now supports a + <option>nocto</option> mount option. This disables + close-to-open cache coherency check at open time. This + option may improve performance for read-only mounts, but + should only be used if the data on the server changes + rarely. The &man.mount.nfs.8; utility now also supports + this flag keyword.</para> + + <para revision="225537">A &man.loader.8; tunable + <varname>vfs.typenumhash</varname> has been added and set to + <literal>1</literal> by default. This enables to use a hash + calculation on file system identification number internally + used in the kernel. This fixes <quote>Stale NFS file + handle</quote> error on NFS clients when upgrading or + rebuilding the kernel on the NFS server due to unexpected + change of the values.</para> + + <para revision="219089">The &os; ZFS subsystem has been + updated to the SPA (Storage Pool Allocator, also known as + zpool) version 28. It now supports data deduplication, + triple parity RAIDZ (raidz3), snapshot holds, log device + removal, zfs diff, zpool split, zpool import + <option>-F</option>, and read-only zpool import.</para> </sect3> </sect2> @@ -930,6 +1044,10 @@ nfsuserd_enable="YES"</programlisting> &man.cbrtl.3; have been added to <application>libm</application>.</para> + <para revision="224152,224153,224154">The &man.bsdtar.1; and + &man.cpio.1; utility are now based on + <application>libarchive</application> version 2.8.4.</para> + <para revision="217416">The &man.cpuset.1; utility now supports a <option>-C</option> flag to create a new cpuset and assign an existing process into that set, and an @@ -983,8 +1101,9 @@ nfsuserd_enable="YES"</programlisting> build and install them, specify <literal>WITH_ICONV=yes</literal> in <filename>/etc/src.conf</filename> and rebuild the base system - as described in &os Handbook (<ulink - url="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/makeworld.html"></ulink>).</para>; + described in <ulink + url="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/makeworld.html">&os; + Handbook</ulink>.</para> <para revision="217013">The &man.ifconfig.8; utility now supports <literal>fdx</literal>, <literal>flow</literal>, @@ -1000,6 +1119,9 @@ nfsuserd_enable="YES"</programlisting> now use it instead of GNU <application>libreadline</application>.</para> + <para revision="224762">The &man.makefs.8; utility now supports + ISO 9660 format.</para> + <para revision="220496,220497"><application>libmd</application> and <application>libcrypt</application> now support SHA-256 and SHA-512 algorithm.</para> @@ -1043,6 +1165,22 @@ nfsuserd_enable="YES"</programlisting> usertime</option> and <option>-o systime</option> options for accumulated system and user CPU time, respectively.</para> + <para revision="222732">The &man.rtadvd.8; daemon now supports + <literal>noifprefix</literal> keyword to disable gathering + on-link prefixes from interfaces when no + <literal>addr</literal> keyword is specified. An entry in + <filename>rtadvd.conf</filename> with + <literal>noifprefix</literal> and no <literal>addr</literal> + generates an RA message with no prefix information + option.</para> + + <para revision="222732,224006">The &man.rtsold.8; and + &man.rtadvd.8; daemon now support RDNSS and DNSSL option + described in RFC 6106, <quote>IPv6 Router Advertisement + Options for DNS Configuration</quote>. A &man.rtadvctl.8; + utility to control the &man.rtadvd.8; daemon has been + added.</para> + <para revision="216695">The &man.rtld.1; runtime linker now supports shared objects as filters in ELF shared libraries. Both standard and auxiliary filtering have been supported. The @@ -1098,6 +1236,10 @@ nfsuserd_enable="YES"</programlisting> && and || around an arithmetic expression has been fixed.</para> + <para revision="224536">A bug in the &man.tftpd.8; daemon has + been fixed. It had an interoperability issue when + transferring a large file.</para> + <para revision="202188">The &man.utmp.5; user accounting database has been replaced by &man.utmpx.3;. User accounting utilities will now use <filename>utmpx</filename> database @@ -1112,11 +1254,10 @@ nfsuserd_enable="YES"</programlisting> when a login daemon crashes or fails to remove the entry during shutdown.</para> - <sect3 id="rc-scripts"> - <title><filename>/etc/rc.d</filename> Scripts</title> - - <para></para> - </sect3> + <para revision="224171">The &man.zpool.8: utility now supports + <command>zpool labelclear</command> command. This allows to + wipe the label data from a drive that is not active in a + pool.</para> </sect2> <sect2 id="contrib"> @@ -1125,6 +1266,9 @@ nfsuserd_enable="YES"</programlisting> <para revision="222544"><literal>ACPI CA</literal> has been updated to version 20110527.</para> + <para revision="224731">The <application>awk</application> has + been updated to the 7 August 2011 release.</para> + <para revision="228189"><application>ISC BIND</application> has been updated to version 9.8.1-P1.</para> @@ -1132,9 +1276,21 @@ nfsuserd_enable="YES"</programlisting> has been updated to 2.17.50 (as of 3 July 2007), which is the last available version under GPLv2.</para> + <para revision="222656">The + <application>compiler-rt</application> library, which provides + low-level target-specific interfaces such as functions in + <application>libgcc</application>, has been imported.</para> + <para revision="224014"><literal>dialog</literal> has been updated to version 1.1-20110707.</para> + <para revision="221793">The <literal>netcat</literal> utility + has been updated to version 4.9.</para> + + <para revision="223328">The <application>tnftp</application> (formerly + known as <application>lukemftp</application>) has been updated + to tnftp-20100108.</para> + <para revision="220150"><application>GNU GCC</application> and <application>libstdc++</application> have been updated to rev 127959 of <literal>gcc-4_2-branch</literal> (the last @@ -1145,6 +1301,9 @@ nfsuserd_enable="YES"</programlisting> &os; <application>libc</application> library has been updated to a snapshot as of 4 March, 2011.</para> + <para revision="222906">The <application>LESS</application> + program has been updated to version v444.</para> + <para revision="208954">The <application>LLVM</application> compiler infrastructure and the <application>clang</application>, a C language family @@ -1161,23 +1320,30 @@ nfsuserd_enable="YES"</programlisting> imported. The &man.resolvconf.8; utility now handles &man.resolv.conf.5; file.</para> - <para revision="220286">The <application>timezone</application> + <para revision="221484,224638">The + <application>OpenSSH</application> utility has been updated to + 5.8p2, and optimization for large bandwidth-delay product + connection and <literal>none</literal> cipher support have + been merged</para> + + <para revision="223637">The <application>pf</application> packet + filter has been updated to version 4.5.</para> + + <para revision="223067">The <application>sendmail</application> + has been updated to version 8.14.5.</para> + + <para revision="226750">The <application>timezone</application> database has been updated to the - <application>tzdata2011e</application> release.</para> + <application>tzdata2011m</application> release.</para> <para revision="217698">&man.unifdef.1; utility has been updated to version 2.5.6.</para> - <para>The <application>xz</application> program has been updated - from 5.0.0 to 5.0.1 release.</para> + <para revision="223935">The <application>xz</application> + program has been updated from 5.0.0 to a snapshot as of 11 + July, 2011.</para> </sect2> - <sect2 id="ports"> - <title>Ports/Packages Collection Infrastructure</title> - - <para></para> - </sect2> - <sect2 id="releng"> <title>Release Engineering and Integration</title> @@ -1191,13 +1357,6 @@ nfsuserd_enable="YES"</programlisting> (<filename role="package">x11/kde4</filename>) has been updated from 4.5.5 to 4.7.3.</para> </sect2> - - <sect2 id="doc"> - <title>Documentation</title> - - <para></para> - - </sect2> </sect1> <sect1 id="upgrade"> @@ -1221,6 +1380,10 @@ nfsuserd_enable="YES"</programlisting> supported, according to the instructions in <filename>/usr/src/UPDATING</filename>.</para> + <para>For more specific information about upgrading + instructions, see <ulink + url="http://www.FreeBSD.org/releases/9.0R/installation.html"></ulink>.</para>; + <important> <para>Upgrading &os; should, of course, only be attempted after backing up <emphasis>all</emphasis> data and configuration @@ -1232,7 +1395,12 @@ nfsuserd_enable="YES"</programlisting> <title id="upgrade-pitfalls">User-visible incompatibilities</title> <para>This section describes notable incompatibilities which you - might want to know before upgrading your system.</para> + might want to know before upgrading your system. + <emphasis>Please read this section and <ulink + url="http://www.FreeBSD.org/releases/9.0R/errata.html">Errata + document</ulink> carefully before submitting a problem report + and/or posting a question to the FreeBSD mailing + lists.</emphasis></para> <sect3> <title>Update of <literal>dialog</literal></title> @@ -1282,7 +1450,7 @@ nfsuserd_enable="YES"</programlisting> <para>These commands temporarily disable the integrity check. If it was the cause, the &os; kernel should detect the - partitions after entering the commands as prior releases + partitions after entering the commands as the prior release did. This configuration can be added into <filename>/boot/loader.conf</filename> like the following:</para> @@ -1360,7 +1528,7 @@ boot</screen> <para>and reboot the system. A symbolic link like <filename>/dev/ar<replaceable>0</replaceable></filename> - will be generated for + will NOT be generated for <filename>/dev/raid/r<replaceable>0</replaceable></filename>. Therefore, if your system used <filename>/dev/ar0</filename> as the root partition, @@ -1378,14 +1546,355 @@ boot</screen> </listitem> </itemizedlist> </sect3> - </sect2> -<!-- -TODO: - ipv6 - openresolv - USB ---> + <sect3> + <title>Network Configuration Changes in + <filename>/etc/rc.conf</filename></title> + + <para>Although variables in &man.rc.conf.5; are basically + compatible with earlier releases, ones related to network + configuration are changed because of reorganization of the + &man.rc.8; scripts.</para> -</sect1> + <itemizedlist> + <listitem> + <para>An address configuration now always needs an address + family keyword. For example, the following line</para> + + <programlisting>ifconfig_em0="192.168.2.1 netmask 255.255.255.0"</programlisting> + + <para>should be</para> + + <programlisting>ifconfig_em0="inet 192.168.2.1 netmask 255.255.255.0"</programlisting> + + <para>Although the old convention is still supported in + the existing variables for backward compatibility, some + new variables do not support it.</para> + </listitem> + + <listitem> + <para>The + <varname>ifconfig_<replaceable>IF</replaceable>_alias<replaceable>0</replaceable></varname> + variable now requires an address family keyword to + support non-IPv4 address families. For instance,</para> + + <programlisting>ifconfig_em0_alias0="192.168.2.10 netmask 255.255.255.255"</programlisting> + + <para>should be</para> + + <programlisting>ifconfig_em0_alias0="inet 192.168.2.10 netmask 255.255.255.255"</programlisting> + + <para>Different address families can coexist like the + following:</para> + + <programlisting>ifconfig_em0_alias0="inet 192.168.2.10 netmask 255.255.255.255" +ifconfig_em0_alias1="inet6 2001:db8:1::1 prefixlen 64"</programlisting> + + <para>Note that IPv6 alias configurations in + <varname>ifconfig_<replaceable>IF</replaceable>_alias<replaceable>N</replaceable></varname> + will be ignored when no + <varname>ifconfig_<replaceable>IF</replaceable>_ipv6</varname> + variable is defined because it determines whether IPv6 + functionality is enabled on that interface or not (this + variable will be explained later).</para> + </listitem> + + <listitem> + <para>All of alias and static routing configurations + through &man.rc.conf.5; variables will be deinstalled by + invoking &man.rc.8; scripts or the &man.service.8; command + with <literal>stop</literal> keyword.</para> + + <screen>&prompt.root; service netif stop em0</screen> + + <para>stops the interface <literal>em0</literal>.</para> + + <screen>&prompt.root; service routing stop</screen> + + <para>deinstalls all of static route configurations.</para> + + <para>The releases prior to &release.current; did not + support this functionality properly for non-IPv4 + protocols.</para> + </listitem> + + <listitem> + <para>IPv6 configuration handling has been changed in the + following way. Before in-depth explanations, here is a + before-and-after example:</para> + + <programlisting>ifconfig_em0="192.168.2.1 netmask 255.255.255.0" +ifconfig_em0_alias0="192.168.2.2 netmask 255.255.255.255" + +ipv6_enable="YES" +ipv6_ifconfig_em0="2001:db8:1::1 prefixlen 64" +ipv6_ifconfig_em0_alias0="2001:db8:2::1 prefixlen 64" +# em1 uses SLAAC for IPv6 address configuration</programlisting> + + <para>should be in &release.current;:</para> + + <programlisting>ifconfig_em0="inet 192.168.2.1 netmask 255.255.255.0" +ifconfig_em0_ipv6="inet6 2001:db8:1::1 prefixlen 64 accept_rtadv" +ifconfig_em0_alias0="inet 192.168.2.2 netmask 255.255.255.255" +ifconfig_em0_alias1="inet6 2001:db8:2::1 prefixlen 64" + +ifconfig_em1_ipv6="inet6 accept_rtadv"</programlisting> + + <para>More specific explanations of the changes are as + follow:</para> + + <itemizedlist> + <listitem> + <para>The <varname>ipv6_enable</varname> variable is + deprecated. IPv6 functionality on the system is + enabled by default. No IPv6 communication will + happen if you configure no IPv6 address.</para> + + <para>&release.current; now supports intermediate + configurations between a host and a router IPv6 + node. The <varname>ipv6_enable</varname> variable + assumed that the system was a host node when + <varname>ipv6_gateway_enable</varname> was set to + <literal>NO</literal> (default), and a router node + if not. A host node always accepted ICMPv6 Router + Advertise message, and a router did not.</para> + + <para>In &release.current;, this model is still + applied but in a per-interface basis, not a + system-wide basis. Specifically, an interface has + an <literal>ACCEPT_RTADV</literal> flag, RA messages + will be accepted on that interface for SLAAC + (StateLess Address AutoConfiguration) regardless of + whether the packet forwarding is enabled or + not.</para> + + <para>In addition to them, a per-interface flag + <literal>NO_RADR</literal> and a &man.sysctl.8; + variable <varname>net.inet6.ip6.rfc6204w3</varname> + have been added. This controls whether default + router list information via RA messages on an + RA-accepting interface should be ignore or not. In + an IPv6 router model, it is not supposed accepting + RA messages as information source of the default + router list. Because of that &os; &release.current; + ignores the default router list part when IPv6 + packet forwarding is enabled even if the interface + has an <literal>ACCEPT_RTADV</literal> flag. However, + this can make a difficult situation when the system + has to work as a CPE (Customer Premises Equipment), + which needs RA messages from the upstream network + for network configuration and acts as a router for + the LAN simultaneously. For more information about + this kind of configurations, see RFC 6204.</para> + + <para>To support this kind of configurations, the + <varname>ipv6_cpe_wanif</varname> variable in + &man.rc.conf.5; can be used.</para> + + <programlisting>ipv6_gateway_enable="YES" +ipv6_cpe_wanif="em0"</programlisting> + + <para>means the <literal>em0</literal> interface + accepts RA messages and the default router + information in them, and the other interfaces ignore + the default router information part even when + setting <literal>ACCEPT_RTADV</literal> flag to + them.</para> + + <para>The <varname>ipv6_cpe_wanif</varname> internally + sets the <varname>net.inet6.ip6.rfc6204w3</varname> + and the <varname>net.inet6.ip6.no_radr</varname> + &man.sysctl.8; variable to <literal>1</literal>. + Note that both are set to <literal>0</literal> by + default. When the former is set to + <literal>1</literal>, &os; accepts the default + router list even when IPv6 packet forwarding is + enabled. Note that a system administrator needs to + set a <literal>NO_RADR</literal> flag on the other + RA-accepting interfaces, if any, to prevent it from + accepting unexpected default router information. + The latter variable means the flag is automatically + set to them.</para> + + <para>If <literal>ipv6_enable="YES"</literal> is + defined in &release.current;, it means + <literal>ipv6_activate_all_interfaces="YES"</literal> + in <filename>/etc/rc.conf</filename> and + <literal>inet6 accept_rtadv</literal> + &man.ifconfig.8; option in all network interfaces. + Note that this is only for backward compatibility. + The <varname>ipv6_enable</varname> should not be + used in &release.current;.</para> + </listitem> + + <listitem> + <para>The + <varname>ipv6_ifconfig_<replaceable>IF</replaceable></varname> + variable is renamed to + <varname>ifconfig_<replaceable>IF</replaceable>_ipv6</varname>. + This variable means whether IPv6 functionality + should be enabled on that interface or not. If + there is no + <varname>ifconfig_<replaceable>IF</replaceable>_ipv6</varname>, + no IPv6 functionality on the interface + <replaceable>IF</replaceable>.</para> + + <para>Note that the + <varname>ifconfig_<replaceable>IF</replaceable>_ipv6</varname> + always needs the address family keyword + <literal>inet6</literal>. If you need an automatic + link-local address only, the following line is enough:</para> + + <programlisting>ifconfig_em0_ipv6="inet6 auto_linklocal"</programlisting> + + <para>If you need full-blown IPv6 functionality on all + interfaces like prior releases with + <literal>ipv6_enable="YES"</literal>, including ones + with no + <varname>ifconfig_<replaceable>IF</replaceable>_ipv6 + line</varname>, you might want to use + <varname>ipv6_activate_all_interfaces</varname> + variable as explained later.</para> + + <para>If <literal>ipv6_ifconfig_<replaceable>IF</replaceable>="..."</literal> is + defined in &release.current;, it means + <literal>ifconfig_<replaceable>IF</replaceable>_ipv6="inet6 ..."</literal>. + Note that this is only for backward compatibility. + The <literal>inet6</literal> address family keyword + is required for <varname>ifconfig_<replaceable>IF</replaceable>_ipv6</varname>, + but was NOT required for + <varname>ipv6_ifconfig_<replaceable>IF</replaceable></varname>. The + <varname>ipv6_ifconfig_<replaceable>IF</replaceable></varname> should not be + used in &release.current;.</para> + </listitem> + + <listitem> + <para>An interface with no corresponding + <varname>ifconfig_<replaceable>IF</replaceable>_ipv6</varname> variable is + marked with an <literal>IFDISABLED</literal> flag by + &man.devd.8; daemon. This flag means IPv6 + communication is disabled on that interface. This + can also be found in output of + &man.ifconfig.8;:</para> + + <screen>&prompt.user; ifconfig em0 +em0: flags=8843<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> metric 0 mtu 1500 + options=9b<RXCSUM,TXCSUM,VLAN_MTU,VLAN_HWTAGGING,VLAN_HWCSUM> + ether xx:xx:xx:xx:xx:xx + inet 192.168.2.1 netmask 0xffffff00 broadcast 192.168.2.255 + nd6 options=3<PERFORMNUD,IFDISABLED,ACCEPT_RTADV> + media: Ethernet autoselect (1000baseT <full-duplex>) + status: active +</screen> + + <para>To enable IPv6 functionality, this flag should + be removed first. There are several ways to do so. + Adding an IPv6 address automatically removes this + flag. It is possible to remove this flag explicitly + by using the following command:</para> + + <screen>&prompt.root; ifconfig em0 inet6 -ifdisabled</screen> + + <para>Note that defining an + <varname>ifconfig_<replaceable>IF</replaceable>_ipv6</varname> is the most + reasonable way to activate IPv6 functionality on + that interface. This <literal>IFDISABLED</literal> + flag is to prevent unintended IPv6 communications + in an IPv4-only environment even when the interface + has an IPv6 link-local address. If you need + full-blown IPv6 functionality on all interfaces, you + might want to use + <varname>ipv6_activate_all_interfaces</varname> + variable as explained later.</para> + </listitem> + + <listitem> + <para>The &man.sysctl.8; variable + <varname>net.inet6.ip6.accept_rtadv</varname> has + been changed. It was a system-wide configuration + knob which means whether the system accepts ICMPv6 + Router Advertisement messages or not. In + &release.current;, this knob is converted into a + per-interface <literal>inet6 accept_rtadv</literal> + &man.ifconfig.8; option. Although the + &man.sysctl.8; variable is available still in + &release.current;, it now means whether the + per-interface option is set by default or not. The + default value is <literal>0</literal> (not accept + the RA messages).</para> + </listitem> + + <listitem> + <para>The &man.sysctl.8; variable + <varname>net.inet6.ip6.auto_linklocal</varname> has + been changed. It was a system-wide configuration + knob which means whether an IPv6 link-local address + is generated on an network interface when it becomes + up. In &release.current;, this knob is converted + into a per-interface <literal>inet6 + auto_linklocal</literal> &man.ifconfig.8; option. + Although the &man.sysctl.8; variable is available + still in &release.current;, it now means whether the + per-interface option is set by default or not. The + default value is <literal>1</literal> (generate a + link-local automatically).</para> + </listitem> + + <listitem> + <para>The functionality of + <varname>ipv6_ifconfig_<replaceable>IF</replaceable>_alias<replaceable>0</replaceable></varname> + variable is integrated into + <varname>ifconfig_<replaceable>IF</replaceable>_alias<replaceable>0</replaceable></varname>. + Note that address family keywords are always required:</para> + + <programlisting>ifconfig_em0_alias0="inet 192.168.2.0 netmask 255.255.255.255" +ifconfig_em0_alias1="inet6 2011:db8:1::1 prefixlen 64</programlisting> + + <para>Although + <varname>ipv6_ifconfig_<replaceable>IF</replaceable>_alias<replaceable>N</replaceable></varname> + is still usable in &release.current;, it is only for + backward compatibility.</para> + </listitem> + + <listitem> + <para>A new + <varname>ipv6_activate_all_interfaces</varname> variable + has been added. If this variable is set to + <literal>YES</literal>, <literal>IFDISABLED</literal> + option will not be added even if + <varname>ifconfig_<replaceable>IF</replaceable>_ipv6</varname> variables are not + defined. This can prevent <literal>IFDISABLED</literal> + on dynamically-added interfaces such as &man.ppp.4;, + &man.tap.4;, and &man.ng.iface.4; where defining + <varname>ifconfig_<replaceable>IF</replaceable>_ipv6</varname> in advance is + difficult.</para> + </listitem> + </itemizedlist> + </listitem> + </itemizedlist> + </sect3> + + <sect3> + <title>Openresolv and <filename>/etc/resolv.conf</filename></title> + + <para>The &man.resolvconf.8; utility has been added and it now + handles updating &man.resolv.conf.5; file. Direct + modifications to <filename>/etc/resolv.conf</filename> can + be overwritten by network configuration utilities such as + &man.dhclient.8; and &man.rtsold.8;.</para> + </sect3> + + <sect3> + <title>Disk Partition Management Utilities</title> + + <para>In earlier releases various utilities were available to + manage disk partition information. They are deprecated in + favor of the &man.gpart.8; utility. Specifically, + &man.fdisk.8;, &man.disklabel.8; &man.bsdlabel.8;, and + &man.sunlabel.8; utilities are no longer supported actively + though these are still available for backward + compatibility.</para> + </sect3> + </sect2> + </sect1> </article>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201201120034.q0C0Ysw9084249>