From owner-svn-doc-projects@FreeBSD.ORG Sun Sep 29 15:07:47 2013 Return-Path: Delivered-To: svn-doc-projects@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id 9C442F91; Sun, 29 Sep 2013 15:07:47 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 706A02AC8; Sun, 29 Sep 2013 15:07:47 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r8TF7loi043594; Sun, 29 Sep 2013 15:07:47 GMT (envelope-from bcr@svn.freebsd.org) Received: (from bcr@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r8TF7ljW043593; Sun, 29 Sep 2013 15:07:47 GMT (envelope-from bcr@svn.freebsd.org) Message-Id: <201309291507.r8TF7ljW043593@svn.freebsd.org> From: Benedict Reuschling Date: Sun, 29 Sep 2013 15:07:47 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-projects@freebsd.org Subject: svn commit: r42735 - projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs X-SVN-Group: doc-projects MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-projects@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for doc projects trees List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 29 Sep 2013 15:07:47 -0000 Author: bcr Date: Sun Sep 29 15:07:46 2013 New Revision: 42735 URL: http://svnweb.freebsd.org/changeset/doc/42735 Log: Provide a small example that shows how to augment a non-ZFS filesystem on a ZFS volume with ZFS features. Modified: projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Modified: projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml ============================================================================== --- projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Sun Sep 29 10:12:35 2013 (r42734) +++ projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Sun Sep 29 15:07:46 2013 (r42735) @@ -531,6 +531,26 @@ errors: No known data errors Creating & Destroying Volumes + + A volume can be formatted with any filesystem on top of + it. This will appear to the user as if they are working with + that specific filesystem and not ZFS. This way, it can be + used to augment non-ZFS filesystems with ZFS features that + they do not have. For example, combining the ZFS compression + property together with a 250 MB volume allows to create a + compressed FAT filesystem. + + &prompt.root; zfs create -V 250m -o compression=on tank/fat32 +&prompt.root; zfs list tank +NAME USED AVAIL REFER MOUNTPOINT +tank 258M 670M 31K /tank +&prompt.root; newfs_msdos -F32 /dev/zvol/tank/fat32 +&prompt.root; mount -t msdosfs /dev/zvol/tank/fat32 /mnt +&prompt.root; df -h /mnt | grep fat32 +Filesystem Size Used Avail Capacity Mounted on +/dev/zvol/tank/fat32 249M 24k 249M 0% /mnt +&prompt.root; mount | grep fat32 +/dev/zvol/tank/fat32 on /mnt (msdosfs, local) @@ -544,7 +564,7 @@ errors: No known data errors - It is possible to set user-defined properties in ZFS. They + It is possible to set user-defined properties in ZFS. They become part of the pool configuration and can be used to provide additional information about the pool or it's contents. To distnguish these custom properties from the ones supplied by From owner-svn-doc-projects@FreeBSD.ORG Tue Oct 1 20:34:47 2013 Return-Path: Delivered-To: svn-doc-projects@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id E8C6578; Tue, 1 Oct 2013 20:34:47 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id C6AD6285A; Tue, 1 Oct 2013 20:34:47 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r91KYlvm017137; Tue, 1 Oct 2013 20:34:47 GMT (envelope-from bcr@svn.freebsd.org) Received: (from bcr@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r91KYluV017135; Tue, 1 Oct 2013 20:34:47 GMT (envelope-from bcr@svn.freebsd.org) Message-Id: <201310012034.r91KYluV017135@svn.freebsd.org> From: Benedict Reuschling Date: Tue, 1 Oct 2013 20:34:47 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-projects@freebsd.org Subject: svn commit: r42795 - projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs X-SVN-Group: doc-projects MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-projects@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for doc projects trees List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 01 Oct 2013 20:34:48 -0000 Author: bcr Date: Tue Oct 1 20:34:47 2013 New Revision: 42795 URL: http://svnweb.freebsd.org/changeset/doc/42795 Log: Add a section about zpool iostat with a few examples. Modified: projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Modified: projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml ============================================================================== --- projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Tue Oct 1 19:30:26 2013 (r42794) +++ projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Tue Oct 1 20:34:47 2013 (r42795) @@ -506,8 +506,51 @@ errors: No known data errors Performance Monitoring - - + ZFS has a built-in monitoring isystem that can display + statistics about I/O happening on the pool in real-time. + Additionally, it shows the free and used space on the pool and + how much I/O bandwidth are currently utilized for read and + write operations. By default, all pools in the system will be + monitored and displayed. A pool name can be provided to just + monitor one pool. A basic example is provided below: + +&prompt.root; zpool iostat + capacity operations bandwidth +pool alloc free read write read write +---------- ----- ----- ----- ----- ----- ----- +data 288G 1.53T 2 11 11.3K 57.1K + + To monitor I/O activity on the pool continuously, a + number indicating the seconds after which to refresh the + display can be specified. ZFS will then print the next + statistic line after each intervall has been reached. Press + CtrlC + to stop this continuous monitoring. Alternatively, a second + whole number can be provided on the command line after the + intervall to indicate how many of these statistics should be + displayed in total. + + An even more detailed pool I/O statistic can be + displayed using the -v parameter. For + each storage device that is part of the pool ZFS will + provide a separate statistic line. This is helpful to + determine reads and writes on devices that slow down I/O on + the whole pool. In the following example, we have a + mirrored pool consisting of two devices. For each of these, + a separate line is shown with the current I/O + activity. + +&prompt.root; zpool iostat -v + capacity operations bandwidth +pool alloc free read write read write +----------------------- ----- ----- ----- ----- ----- ----- +data 288G 1.53T 2 12 9.23K 61.5K + mirror 288G 1.53T 2 12 9.23K 61.5K + ada1 - - 0 4 5.61K 61.7K + ada2 - - 1 4 5.04K 61.7K +----------------------- ----- ----- ----- ----- ----- ----- + Splitting a Storage Pool @@ -533,12 +576,12 @@ errors: No known data errors A volume can be formatted with any filesystem on top of - it. This will appear to the user as if they are working with - that specific filesystem and not ZFS. This way, it can be - used to augment non-ZFS filesystems with ZFS features that - they do not have. For example, combining the ZFS compression - property together with a 250 MB volume allows to create a - compressed FAT filesystem. + it. This will appear to the user as if they are working with + that specific filesystem and not ZFS. This way, it can be + used to augment non-ZFS filesystems with ZFS features that + they do not have. For example, combining the ZFS compression + property together with a 250 MB volume allows to create a + compressed FAT filesystem. &prompt.root; zfs create -V 250m -o compression=on tank/fat32 &prompt.root; zfs list tank @@ -564,12 +607,12 @@ Filesystem Size Used Avail Cap - It is possible to set user-defined properties in ZFS. They - become part of the pool configuration and can be used to provide - additional information about the pool or it's contents. To - distnguish these custom properties from the ones supplied by - ZFS by default, the colon (:) is used in the - property name. + It is possible to set user-defined properties in ZFS. + They become part of the pool configuration and can be used to + provide additional information about the pool or it's + contents. To distnguish these custom properties from the ones + supplied by ZFS by default, the colon (:) + is used in the property name. &prompt.root; zfs set custom:costcenter=1234 &prompt.root; zfs get custom:costcenter From owner-svn-doc-projects@FreeBSD.ORG Wed Oct 2 14:37:17 2013 Return-Path: Delivered-To: svn-doc-projects@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id D5F40A5E; Wed, 2 Oct 2013 14:37:17 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id BFF0D2F06; Wed, 2 Oct 2013 14:37:17 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r92EbHaR069005; Wed, 2 Oct 2013 14:37:17 GMT (envelope-from gjb@svn.freebsd.org) Received: (from gjb@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r92EbFaM068964; Wed, 2 Oct 2013 14:37:15 GMT (envelope-from gjb@svn.freebsd.org) Message-Id: <201310021437.r92EbFaM068964@svn.freebsd.org> From: Glen Barber Date: Wed, 2 Oct 2013 14:37:15 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-projects@freebsd.org Subject: svn commit: r42804 - in projects/zfsupdate-201307: de_DE.ISO8859-1/htdocs de_DE.ISO8859-1/share/xml el_GR.ISO8859-7/share/xml en_US.ISO8859-1/articles/committers-guide en_US.ISO8859-1/articles/cont... X-SVN-Group: doc-projects MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-projects@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for doc projects trees List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 02 Oct 2013 14:37:17 -0000 Author: gjb Date: Wed Oct 2 14:37:14 2013 New Revision: 42804 URL: http://svnweb.freebsd.org/changeset/doc/42804 Log: MFH: Merged /head/de_DE.ISO8859-1:r42573-42802 Merged /head/el_GR.ISO8859-7:r42573-42802 Merged /projects/ISBN_1-57176-407-0/en_US.ISO8859-1:r41456 Merged /head/en_US.ISO8859-1:r42573-42802 Merged /head/fr_FR.ISO8859-1:r42573-42802 Merged /head/hu_HU.ISO8859-2:r42573-42802 Merged /head/ja_JP.eucJP:r42573-42802 Merged /head/mn_MN.UTF-8:r42573-42802 Merged /head/nl_NL.ISO8859-1:r42573-42802 Merged /head/pl_PL.ISO8859-2:r42573-42802 Merged /head/ru_RU.KOI8-R:r42573-42802 Merged /head/share:r42573-42802 Merged /head/zh_CN.GB2312:r42573-42802 Approved by: doceng (implicit) Sponsored by: The FreeBSD Foundation Added: projects/zfsupdate-201307/en_US.ISO8859-1/books/porters-handbook/versions.xml - copied unchanged from r42802, head/en_US.ISO8859-1/books/porters-handbook/versions.xml projects/zfsupdate-201307/en_US.ISO8859-1/htdocs/news/status/report-2013-07-2013-09.xml - copied unchanged from r42802, head/en_US.ISO8859-1/htdocs/news/status/report-2013-07-2013-09.xml projects/zfsupdate-201307/en_US.ISO8859-1/htdocs/releases/9.2R/announce.xml - copied unchanged from r42802, head/en_US.ISO8859-1/htdocs/releases/9.2R/announce.xml projects/zfsupdate-201307/en_US.ISO8859-1/htdocs/releases/9.2R/errata.html - copied unchanged from r42802, head/en_US.ISO8859-1/htdocs/releases/9.2R/errata.html projects/zfsupdate-201307/en_US.ISO8859-1/htdocs/releases/9.2R/hardware.html - copied unchanged from r42802, head/en_US.ISO8859-1/htdocs/releases/9.2R/hardware.html projects/zfsupdate-201307/en_US.ISO8859-1/htdocs/releases/9.2R/installation.html - copied unchanged from r42802, head/en_US.ISO8859-1/htdocs/releases/9.2R/installation.html projects/zfsupdate-201307/en_US.ISO8859-1/htdocs/releases/9.2R/readme.html - copied unchanged from r42802, head/en_US.ISO8859-1/htdocs/releases/9.2R/readme.html projects/zfsupdate-201307/en_US.ISO8859-1/htdocs/releases/9.2R/relnotes.xml - copied unchanged from r42802, head/en_US.ISO8859-1/htdocs/releases/9.2R/relnotes.xml projects/zfsupdate-201307/ja_JP.eucJP/htdocs/releases/9.2R/ - copied from r42802, head/ja_JP.eucJP/htdocs/releases/9.2R/ projects/zfsupdate-201307/share/pgpkeys/arundel.key - copied unchanged from r42802, head/share/pgpkeys/arundel.key projects/zfsupdate-201307/share/pgpkeys/br.key - copied unchanged from r42802, head/share/pgpkeys/br.key projects/zfsupdate-201307/share/pgpkeys/danilo.key - copied unchanged from r42802, head/share/pgpkeys/danilo.key projects/zfsupdate-201307/share/pgpkeys/secteam-secretary.key - copied unchanged from r42802, head/share/pgpkeys/secteam-secretary.key projects/zfsupdate-201307/share/pgpkeys/zbb.key - copied unchanged from r42802, head/share/pgpkeys/zbb.key projects/zfsupdate-201307/share/security/advisories/FreeBSD-SA-13:11.sendfile.asc - copied unchanged from r42802, head/share/security/advisories/FreeBSD-SA-13:11.sendfile.asc projects/zfsupdate-201307/share/security/advisories/FreeBSD-SA-13:12.ifioctl.asc - copied unchanged from r42802, head/share/security/advisories/FreeBSD-SA-13:12.ifioctl.asc projects/zfsupdate-201307/share/security/advisories/FreeBSD-SA-13:13.nullfs.asc - copied unchanged from r42802, head/share/security/advisories/FreeBSD-SA-13:13.nullfs.asc projects/zfsupdate-201307/share/security/patches/SA-13:11/ - copied from r42802, head/share/security/patches/SA-13:11/ projects/zfsupdate-201307/share/security/patches/SA-13:12/ - copied from r42802, head/share/security/patches/SA-13:12/ projects/zfsupdate-201307/share/security/patches/SA-13:13/ - copied from r42802, head/share/security/patches/SA-13:13/ Deleted: projects/zfsupdate-201307/en_US.ISO8859-1/htdocs/projects/c99/ Modified: projects/zfsupdate-201307/de_DE.ISO8859-1/htdocs/where.xml projects/zfsupdate-201307/de_DE.ISO8859-1/share/xml/news.xml projects/zfsupdate-201307/de_DE.ISO8859-1/share/xml/release.l10n.ent projects/zfsupdate-201307/el_GR.ISO8859-7/share/xml/teams.ent projects/zfsupdate-201307/en_US.ISO8859-1/articles/committers-guide/article.xml projects/zfsupdate-201307/en_US.ISO8859-1/articles/contributors/contrib.additional.xml projects/zfsupdate-201307/en_US.ISO8859-1/articles/contributors/contrib.committers.xml projects/zfsupdate-201307/en_US.ISO8859-1/books/dev-model/book.xml projects/zfsupdate-201307/en_US.ISO8859-1/books/faq/book.xml projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/basics/chapter.xml projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/desktop/chapter.xml projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/dtrace/chapter.xml projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/multimedia/chapter.xml projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/ports/chapter.xml projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.xml projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/security/chapter.xml projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/x11/chapter.xml projects/zfsupdate-201307/en_US.ISO8859-1/books/porters-handbook/Makefile projects/zfsupdate-201307/en_US.ISO8859-1/books/porters-handbook/book.xml projects/zfsupdate-201307/en_US.ISO8859-1/books/porters-handbook/uses.xml projects/zfsupdate-201307/en_US.ISO8859-1/htdocs/administration.xml projects/zfsupdate-201307/en_US.ISO8859-1/htdocs/advocacy/myths.xml projects/zfsupdate-201307/en_US.ISO8859-1/htdocs/cgi/man.cgi projects/zfsupdate-201307/en_US.ISO8859-1/htdocs/donations/donors.xml projects/zfsupdate-201307/en_US.ISO8859-1/htdocs/news/status/Makefile projects/zfsupdate-201307/en_US.ISO8859-1/htdocs/news/status/README projects/zfsupdate-201307/en_US.ISO8859-1/htdocs/projects/Makefile projects/zfsupdate-201307/en_US.ISO8859-1/htdocs/projects/projects.xml projects/zfsupdate-201307/en_US.ISO8859-1/htdocs/releases/10.0R/schedule.xml projects/zfsupdate-201307/en_US.ISO8859-1/htdocs/releases/9.2R/Makefile projects/zfsupdate-201307/en_US.ISO8859-1/htdocs/releases/9.2R/schedule.xml projects/zfsupdate-201307/en_US.ISO8859-1/htdocs/releases/Makefile projects/zfsupdate-201307/en_US.ISO8859-1/htdocs/releng/index.xml projects/zfsupdate-201307/en_US.ISO8859-1/htdocs/security/security.xml projects/zfsupdate-201307/en_US.ISO8859-1/htdocs/where.xml projects/zfsupdate-201307/en_US.ISO8859-1/share/xml/release.l10n.ent projects/zfsupdate-201307/en_US.ISO8859-1/share/xml/teams.ent projects/zfsupdate-201307/fr_FR.ISO8859-1/share/xml/release.l10n.ent (contents, props changed) projects/zfsupdate-201307/fr_FR.ISO8859-1/share/xml/teams.ent projects/zfsupdate-201307/hu_HU.ISO8859-2/share/xml/teams.ent projects/zfsupdate-201307/ja_JP.eucJP/books/handbook/cutting-edge/chapter.xml projects/zfsupdate-201307/ja_JP.eucJP/books/handbook/desktop/chapter.xml projects/zfsupdate-201307/ja_JP.eucJP/books/handbook/install/chapter.xml projects/zfsupdate-201307/ja_JP.eucJP/books/handbook/introduction/chapter.xml projects/zfsupdate-201307/ja_JP.eucJP/books/handbook/ports/chapter.xml projects/zfsupdate-201307/ja_JP.eucJP/books/handbook/x11/chapter.xml projects/zfsupdate-201307/ja_JP.eucJP/htdocs/projects/Makefile projects/zfsupdate-201307/ja_JP.eucJP/htdocs/projects/projects.xml projects/zfsupdate-201307/ja_JP.eucJP/htdocs/releases/Makefile projects/zfsupdate-201307/ja_JP.eucJP/htdocs/security/security.xml projects/zfsupdate-201307/ja_JP.eucJP/htdocs/where.xml projects/zfsupdate-201307/ja_JP.eucJP/share/xml/l10n.ent projects/zfsupdate-201307/ja_JP.eucJP/share/xml/news.xml projects/zfsupdate-201307/ja_JP.eucJP/share/xml/release.l10n.ent projects/zfsupdate-201307/mn_MN.UTF-8/share/xml/teams.ent projects/zfsupdate-201307/nl_NL.ISO8859-1/share/xml/release.l10n.ent (contents, props changed) projects/zfsupdate-201307/nl_NL.ISO8859-1/share/xml/teams.ent projects/zfsupdate-201307/pl_PL.ISO8859-2/share/xml/teams.ent projects/zfsupdate-201307/ru_RU.KOI8-R/share/xml/teams.ent projects/zfsupdate-201307/share/pgpkeys/addkey.sh projects/zfsupdate-201307/share/pgpkeys/arved.key projects/zfsupdate-201307/share/pgpkeys/avg.key projects/zfsupdate-201307/share/pgpkeys/bf.key projects/zfsupdate-201307/share/pgpkeys/des.key projects/zfsupdate-201307/share/pgpkeys/erwin.key projects/zfsupdate-201307/share/pgpkeys/gahr.key projects/zfsupdate-201307/share/pgpkeys/gavin.key projects/zfsupdate-201307/share/pgpkeys/gjb.key projects/zfsupdate-201307/share/pgpkeys/issyl0.key projects/zfsupdate-201307/share/pgpkeys/jase.key projects/zfsupdate-201307/share/pgpkeys/jkim.key projects/zfsupdate-201307/share/pgpkeys/loos.key projects/zfsupdate-201307/share/pgpkeys/marius.key projects/zfsupdate-201307/share/pgpkeys/mat.key projects/zfsupdate-201307/share/pgpkeys/matthew.key projects/zfsupdate-201307/share/pgpkeys/pgollucci.key projects/zfsupdate-201307/share/pgpkeys/pgpkeys-developers.xml projects/zfsupdate-201307/share/pgpkeys/pgpkeys-officers.xml projects/zfsupdate-201307/share/pgpkeys/pgpkeys-other.xml projects/zfsupdate-201307/share/pgpkeys/pgpkeys.ent projects/zfsupdate-201307/share/pgpkeys/roberto.key projects/zfsupdate-201307/share/pgpkeys/security-officer.key projects/zfsupdate-201307/share/pgpkeys/skreuzer.key projects/zfsupdate-201307/share/pgpkeys/stas.key projects/zfsupdate-201307/share/pgpkeys/syrinx.key projects/zfsupdate-201307/share/pgpkeys/thierry.key projects/zfsupdate-201307/share/security/advisories/FreeBSD-SA-13:09.ip_multicast.asc projects/zfsupdate-201307/share/security/advisories/FreeBSD-SA-13:10.sctp.asc projects/zfsupdate-201307/share/xml/advisories.xml projects/zfsupdate-201307/share/xml/authors.ent projects/zfsupdate-201307/share/xml/commercial.consult.xml projects/zfsupdate-201307/share/xml/events2013.xml projects/zfsupdate-201307/share/xml/mirrors.xml projects/zfsupdate-201307/share/xml/news.dtd projects/zfsupdate-201307/share/xml/news.xml projects/zfsupdate-201307/share/xml/release.ent projects/zfsupdate-201307/zh_CN.GB2312/share/xml/teams.ent Directory Properties: projects/zfsupdate-201307/de_DE.ISO8859-1/ (props changed) projects/zfsupdate-201307/el_GR.ISO8859-7/ (props changed) projects/zfsupdate-201307/en_US.ISO8859-1/ (props changed) projects/zfsupdate-201307/fr_FR.ISO8859-1/ (props changed) projects/zfsupdate-201307/hu_HU.ISO8859-2/ (props changed) projects/zfsupdate-201307/ja_JP.eucJP/ (props changed) projects/zfsupdate-201307/mn_MN.UTF-8/ (props changed) projects/zfsupdate-201307/nl_NL.ISO8859-1/ (props changed) projects/zfsupdate-201307/pl_PL.ISO8859-2/ (props changed) projects/zfsupdate-201307/ru_RU.KOI8-R/ (props changed) projects/zfsupdate-201307/share/ (props changed) projects/zfsupdate-201307/zh_CN.GB2312/ (props changed) Modified: projects/zfsupdate-201307/de_DE.ISO8859-1/htdocs/where.xml ============================================================================== --- projects/zfsupdate-201307/de_DE.ISO8859-1/htdocs/where.xml Wed Oct 2 14:27:28 2013 (r42803) +++ projects/zfsupdate-201307/de_DE.ISO8859-1/htdocs/where.xml Wed Oct 2 14:37:14 2013 (r42804) @@ -2,7 +2,7 @@ - + ]> @@ -69,10 +69,10 @@ FreeBSD &rel.current;-RELEASE - [Lesen] - [Lesen] - [Lesen] - [Lesen] + [Lesen] + [Lesen] + [Lesen] + [Lesen] @@ -86,7 +86,6 @@ [Distribution] [ISO] - powerpc64 Modified: projects/zfsupdate-201307/de_DE.ISO8859-1/share/xml/news.xml ============================================================================== --- projects/zfsupdate-201307/de_DE.ISO8859-1/share/xml/news.xml Wed Oct 2 14:27:28 2013 (r42803) +++ projects/zfsupdate-201307/de_DE.ISO8859-1/share/xml/news.xml Wed Oct 2 14:37:14 2013 (r42804) @@ -4,7 +4,7 @@ @@ -18,15 +18,15 @@ Distribution ISO - Statusseite + FreeBSD &betarel2.current;-&betarel2.vers; - - [Lesen] - + + + @@ -52,12 +52,14 @@ [Distribution] [ISO] + sparc64 Modified: projects/zfsupdate-201307/el_GR.ISO8859-7/share/xml/teams.ent ============================================================================== --- projects/zfsupdate-201307/el_GR.ISO8859-7/share/xml/teams.ent Wed Oct 2 14:27:28 2013 (r42803) +++ projects/zfsupdate-201307/el_GR.ISO8859-7/share/xml/teams.ent Wed Oct 2 14:37:14 2013 (r42804) @@ -61,3 +61,5 @@ re@FreeBSD.org"> security-officer@FreeBSD.org"> + +secteam-secretary@FreeBSD.org"> Modified: projects/zfsupdate-201307/en_US.ISO8859-1/articles/committers-guide/article.xml ============================================================================== --- projects/zfsupdate-201307/en_US.ISO8859-1/articles/committers-guide/article.xml Wed Oct 2 14:27:28 2013 (r42803) +++ projects/zfsupdate-201307/en_US.ISO8859-1/articles/committers-guide/article.xml Wed Oct 2 14:37:14 2013 (r42804) @@ -1567,7 +1567,7 @@ U stable/9/share/man/man4/netmap.4 contain the original version tags. To do this: &prompt.user; svn propdel svn:keywords -R . -&prompt.root; svn commit +&prompt.user; svn commit @@ -2346,6 +2346,45 @@ ControlPersist yes will review code. + + If in doubt... + + When you are not sure about something, whether it be a + technical issue or a project convention be sure to ask. If you + stay silent you will never make progress. + + If it relates to a technical issue ask on the public + mailing lists. Avoid the temptation to email the individual + person that knows the answer. This way everyone will be able to + learn from the question and the answer. + + For project specific or administrative questions you should + ask, in order: + + + + Your mentor or former mentor. + + + + An experienced committer on IRC, email, etc. + + + + Any team with a "hat", as they should give you a + definitive answer. + + + + If still not sure, ask on &a.developers;. + + + + Once your question is answered, if no one pointed you to + documentation that spelled out the answer to your question, + document it, as others will have the same question. + + GNATS Modified: projects/zfsupdate-201307/en_US.ISO8859-1/articles/contributors/contrib.additional.xml ============================================================================== --- projects/zfsupdate-201307/en_US.ISO8859-1/articles/contributors/contrib.additional.xml Wed Oct 2 14:27:28 2013 (r42803) +++ projects/zfsupdate-201307/en_US.ISO8859-1/articles/contributors/contrib.additional.xml Wed Oct 2 14:37:14 2013 (r42804) @@ -2129,11 +2129,6 @@ - Danilo Egêa Gondolfo - danilogondolfo@gmail.com - - - Danny Braniss danny@cs.huji.ac.il @@ -4856,6 +4851,11 @@ + Johannes Meixner + xmj@chaot.net + + + Johannes Stille Modified: projects/zfsupdate-201307/en_US.ISO8859-1/articles/contributors/contrib.committers.xml ============================================================================== --- projects/zfsupdate-201307/en_US.ISO8859-1/articles/contributors/contrib.committers.xml Wed Oct 2 14:27:28 2013 (r42803) +++ projects/zfsupdate-201307/en_US.ISO8859-1/articles/contributors/contrib.committers.xml Wed Oct 2 14:37:14 2013 (r42804) @@ -116,6 +116,10 @@ + &a.zbb.email; + + + &a.novel.email; @@ -156,6 +160,10 @@ + &a.br.email; + + + &a.oleg.email; @@ -404,6 +412,10 @@ + &a.danilo.email; + + + &a.daichi.email; Modified: projects/zfsupdate-201307/en_US.ISO8859-1/books/dev-model/book.xml ============================================================================== --- projects/zfsupdate-201307/en_US.ISO8859-1/books/dev-model/book.xml Wed Oct 2 14:27:28 2013 (r42803) +++ projects/zfsupdate-201307/en_US.ISO8859-1/books/dev-model/book.xml Wed Oct 2 14:37:14 2013 (r42804) @@ -46,6 +46,12 @@ + 1.4 + September, 2013 + Remove mention of CVS and CVSup which are no + longer used by the project. + + 1.3 October, 2012 Remove hats held by specific people, these @@ -896,22 +902,6 @@ -
- CVSup Mirror Site Coordinator - - The CVSup Mirror Site Coordinator coordinates all the - s to ensure that they - are distributing current versions of the software, that they - have the capacity to update themselves when major updates - are in progress, and making it easy for the general public - to find their closest CVSup mirror. - - - Hat currently held by: - The CVSup-master team cvsup-master@FreeBSD.org. - -
-
Postmaster @@ -1030,11 +1020,11 @@ responsibility to ensure that technical problems that arise in the repository are resolved quickly. The source repository manager has the authority to back out commits if this is - necessary to resolve a CVS technical problem. + necessary to resolve a SVN technical problem. Hat held by: - the Source Repository Manager cvs@FreeBSD.org. + the Source Repository Manager clusteradm@FreeBSD.org.
@@ -1240,20 +1230,6 @@ for review is posted. - -
- CVSup Mirror Site Admin - - A CVSup Mirror Site Admin has accesses to a server that he/she - uses to mirror the CVS repository. The admin works with the - to ensure the site - remains up-to-date and is following the general policy of - official mirror sites. - -
- - @@ -1402,93 +1378,6 @@ -
- Adding/Removing an official CVSup Mirror - - - A mirror is a replica of the - official CVSup master that contains all the up-to-date source - code for all the branches in the FreeBSD project, ports and - documentation. - - - - Adding an official CVSup mirror starts with the potential - installing the - cvsup-mirror package. Having done this and - updated the source code with a mirror site, he now runs a - fairly recent unofficial CVSup mirror. - - - - Deciding he has a stable environment, the processing - power, the network capacity and the - storage capacity to run an official mirror, he mails the - who decides whether - the mirror should become an official mirror or not. - - - - In making this decision, the - has to determine whether that geographical area needs - another mirror site, if the mirror administrator has the - skills to run it reliably, if the network bandwidth is - adequate and if the master server has the capacity to server - another mirror. - - - - If decides that the - mirror should become an official mirror, he obtains an - authentication key from the mirror admin that he installs so - the mirror admin can update the mirror from the master server. - - - -
- Process summary: adding a CVSup mirror - -
-
- - - When a CVSup mirror administrator of an unofficial mirror - offers to become an official mirror site, the CVSup - coordinator decides if another mirror is needed and if - there is sufficient capacity to accommodate it. If so, - an authorisation key is requested and the mirror is given - access to the main distribution site and added to the - list of official mirrors. - - - - - Tools used in this process: - - - - - - - - - - - - Hats involved in this process: - - - - - - - - - - -
-
Committing code @@ -2183,9 +2072,8 @@ The major support tools for supporting the development process are - CVS, CVSup, Perforce, GNATS, Mailman and OpenSSH. Except for - CVSup, these are externally - developed tools. These tools are commonly used in the open source world. + Perforce, GNATS, Mailman and OpenSSH. These are externally + developed tools and are commonly used in the open source world.
@@ -2198,18 +2086,6 @@
-
- CVSup - - CVSup is a software package for distributing and updating - collections of files across a network. It consists of a - client program, cvsup, and a server program, cvsupd. The - package is tailored specifically for distributing CVS - repositories, and by taking advantage of CVS' properties, it - performs updates much faster than traditional systems. - -
-
GNATS Modified: projects/zfsupdate-201307/en_US.ISO8859-1/books/faq/book.xml ============================================================================== --- projects/zfsupdate-201307/en_US.ISO8859-1/books/faq/book.xml Wed Oct 2 14:27:28 2013 (r42803) +++ projects/zfsupdate-201307/en_US.ISO8859-1/books/faq/book.xml Wed Oct 2 14:37:14 2013 (r42804) @@ -964,7 +964,7 @@ - Channel ##FreeBSD on Channel #FreeBSD on Freenode is a general help channel with many users at any time. The conversations have been known to run off-topic for a @@ -5238,9 +5238,12 @@ ttyvb "/usr/libexec/getty Pc" - Run the command xmodmap -e "pointer = 3 2 1" - from .xinitrc or - .xsession. + Run the command + xmodmap -e "pointer = 3 2 1". + You add the above command to + .xinitrc or + .xsession to make it happen + automatically. @@ -7233,7 +7236,7 @@ hint.sio.7.irq="12" - &os; a lot of swap space even when the computer has + &os; uses a lot of swap space even when the computer has free memory left. Why? Modified: projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml ============================================================================== --- projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml Wed Oct 2 14:27:28 2013 (r42803) +++ projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml Wed Oct 2 14:37:14 2013 (r42804) @@ -5021,17 +5021,25 @@ redirect_port tcp 192.168.0.3:80 80 - Running out of addresses. Today this is not so much of - a concern, since RFC1918 private address space (10.0.0.0/8, 172.16.0.0/12, and 192.168.0.0/16) and - NAT are being employed. + Running out of addresses. For years the use of + RFC1918 private address space + (10.0.0.0/8, + 172.16.0.0/12, and + 192.168.0.0/16) and NAT + has slowed down the exhaustion. Even though, there are + very few remaining IPv4 addresses. The Internet + Assigned Numbers Authority (IANA) has + issued the last of the available major blocks to the + Regional Registries. Once each Regional Registry runs + out, there will be no more available and switching to + IPv6 will be critical. - Router table entries were getting too large. This is - still a concern today. + Every block of IPv4 addresses allocated required + routing information to be exchanged between many routers + on the Internet, and these routing tables were getting + too large to allow efficient routing. @@ -5054,7 +5062,7 @@ redirect_port tcp 192.168.0.3:80 80 - There are other useful features of + There are many other useful features of IPv6: @@ -5280,6 +5288,12 @@ redirect_port tcp 192.168.0.3:80 80SixXS offers tunnels with end-points all around the globe. + + + Hurricane + Electric offers tunnels with end-points all around + the globe. + Tunnel via 6-to-4 as described in - <acronym>DNS</acronym> in the <acronym>IPv6</acronym> - World - - There used to be two types of DNS - records for IPv6. The - IETF has declared AAAA - records as the current standard. - - Using AAAA records is straightforward. - Assign the hostname to the IPv6 address - in the primary zone DNS file: - - MYHOSTNAME AAAA MYIPv6ADDR - - Current versions of &man.named.8; and dns/djbdns support - AAAA records. - - - Applying the Needed Changes to <filename>/etc/rc.conf</filename> - <acronym>IPv6</acronym> Client Settings + <acronym>IPv6</acronym> Client + Auto-Configuration - These settings configure a machine on a + To automatically configure a machine on a LAN which acts as a client, not a - router. To instruct &man.rtsol.8; to autoconfigure the - interface on boot on - &os; 9.x and later, add - this line to rc.conf: - - ipv6_prefer="YES" + router, two items are required. First to enable the + em0 to receive the router + solicitation messages, add this line to + rc.conf: + + ifconfig_em0_ipv6="inet6 accept_rtadv" + + Secondly, the router solicitation daemon, &man.rtsol.8;, + should be enabled by adding the following to + rc.conf: + + rtsold_enable="YES" For &os; 8.x, add: ipv6_enable="YES" + + + <acronym>IPv6</acronym> Client Static + Configuration To statically assign the IPv6 address, 2001:471:1f11:251:290:27ff:fee0:2093, + role="ip6addr">2001:db8:4672:6565:2026:5043:2d42:5344, to fxp0, add the following for &os; 9.x: - ifconfig_fxp0_ipv6="inet6 2001:471:1f11:251:290:27ff:fee0:2093 prefixlen 64" + ifconfig_fxp0_ipv6="inet6 2001:db8:4672:6565:2026:5043:2d42:5344 prefixlen 64" Be sure to change prefixlen @@ -5349,16 +5354,16 @@ redirect_port tcp 192.168.0.3:80 80 - For &os; 8x, + For &os; 8.x, add: - ipv6_ifconfig_fxp0="2001:471:1f11:251:290:27ff:fee0:2093" + ipv6_ifconfig_fxp0="2001:db8:4672:6565:2026:5043:2d42:5344" To assign a default router of 2001:471:1f11:251::1, add the + role="ip6addr">2001:db8:4672:6565::1, add the following to /etc/rc.conf: - ipv6_defaultrouter="2001:471:1f11:251::1" + ipv6_defaultrouter="2001:db8:4672:6565::1" @@ -5372,9 +5377,9 @@ redirect_port tcp 192.168.0.3:80 80The first entry lists the generic tunneling interfaces to be configured. This example configures one interface, - gif0: + gif0: - gif_interfaces="gif0" + gif_interfaces="gif0" To configure that interface with a local endpoint of MY_IPv4_ADDR to a remote endpoint @@ -5476,6 +5481,23 @@ redirect_port tcp 192.168.0.3:80 80RFC 4038 section 4.2 may be useful to some adminstrators. + + + Application Use of <acronym>IPv6</acronym> + + Currently IPv6 support for many + applications and services is very good, though for some + software it still needs work. For authoritative + information about the support of + IPv6, please consult the Official + Documentation for the software in question. + + Web, DNS and Mail applications + and servers have the best support for + IPv6 because they are the most common + use case. Other applications may have varying degrees + of IPv6 support. + Modified: projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/basics/chapter.xml ============================================================================== --- projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/basics/chapter.xml Wed Oct 2 14:27:28 2013 (r42803) +++ projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/basics/chapter.xml Wed Oct 2 14:37:14 2013 (r42804) @@ -70,10 +70,6 @@ - What binary format is used under &os;. - - - How to read manual pages for more information. @@ -97,8 +93,8 @@ console - Unless &os; has been configured to automatically start - a graphical environment during startup, the system will boot + Unless &os; has been configured to automatically start a + graphical environment during startup, the system will boot into a command line login prompt, as seen in this example: @@ -106,10 +102,10 @@ login: - The first line contains some information about the - system. The amd64 indicates that the - system in this example is running a 64-bit version of &os;. - The hostname is pc3.example.org, and + The first line contains some information about the system. + The amd64 indicates that the system in this + example is running a 64-bit version of &os;. The hostname is + pc3.example.org, and ttyv0 indicates that this is the system console. @@ -120,10 +116,10 @@ login: Logging into &os; - &os; is a multiuser, multiprocessing system. This is - the formal description that is usually given to a system that - can be used by many different people, who simultaneously run a - lot of programs on a single machine. + &os; is a multiuser, multiprocessing system. This is the + formal description that is usually given to a system that can + be used by many different people, who simultaneously run a lot + of programs on a single machine. Every multiuser system needs some way to distinguish one user from the rest. In &os; (and all the @@ -131,9 +127,8 @@ login: requiring that every user must log into the system before being able to run programs. Every user has a unique name (the username) and a personal, - secret key (the password). &os; will ask - for these two before allowing a user to run any - programs. + secret key (the password). &os; will ask for + these two before allowing a user to run any programs. startup scripts When a &os; system boots, startup scripts are @@ -145,8 +140,8 @@ login: login: Type the username that was configured during system - installation, as described in , and press + installation, as described in + , and press Enter. Then enter the password associated with the username and press Enter. The password is not echoed for security @@ -274,8 +269,8 @@ console none &prompt.root; vidcontrol -i mode - The output of this command lists the video modes that - are supported by the hardware. To select a new video mode, + The output of this command lists the video modes that are + supported by the hardware. To select a new video mode, specify the mode using &man.vidcontrol.1; as the root user: @@ -294,9 +289,9 @@ console none UNIX - &os;, being a direct descendant of BSD &unix;, is based - on several key &unix; concepts. The first and most pronounced - is that &os; is a multi-user operating system that can handle + &os;, being a direct descendant of BSD &unix;, is based on + several key &unix; concepts. The first and most pronounced is + that &os; is a multi-user operating system that can handle several users working simultaneously on completely unrelated tasks. The system is responsible for properly sharing and managing requests for hardware devices, peripherals, memory, and @@ -304,12 +299,12 @@ console none Much more information about user accounts is in the chapter about accounts. It is important to - understand that each person (user) who uses the computer should be - given their own username and password. The system keeps track - of the people using the computer based on this username. Since - it is often the case that several people are working on the same - project &unix; also provides groups. Several users can be placed - in the same group. + understand that each person (user) who uses the computer should + be given their own username and password. The system keeps + track of the people using the computer based on this username. + Since it is often the case that several people are working on + the same project &unix; also provides groups. Several users can + be placed in the same group. Because the system is capable of supporting multiple users, everything the system manages has a set of permissions governing @@ -321,9 +316,10 @@ console none This section will discuss the traditional &unix; - permissions. For finer grained file system access - control, see the File System - Access Control Lists section. + permissions. For finer grained file system access control, + see the + File System Access Control Lists + section. permissions @@ -391,6 +387,7 @@ console none + &man.ls.1; @@ -1026,9 +1023,9 @@ root 5211 0.0 0.2 3620 1724 2 class="directory">/var/ Multi-purpose log, temporary, transient, and spool files. A memory-based file system is sometimes - mounted at /var. This can be - automated using the varmfs-related variables in + mounted at + /var. This can + be automated using the varmfs-related variables in &man.rc.conf.5; or with an entry in /etc/fstab; refer to &man.mdmfs.8; for details. @@ -1057,8 +1054,8 @@ root 5211 0.0 0.2 3620 1724 2 /var/tmp/ Temporary files which are usually preserved - across a system reboot, unless /var is a + across a system reboot, unless + /var is a memory-based file system. @@ -1091,8 +1088,8 @@ root 5211 0.0 0.2 3620 1724 2 Files and directories are referenced by giving the file or directory name, followed by a forward slash, /, followed by any other directory names that - are necessary. For example, if the directory foo contains a directory + are necessary. For example, if the directory + foo contains a directory bar which contains the file readme.txt, the full name, or path, to the file is @@ -1107,11 +1104,12 @@ root 5211 0.0 0.2 3620 1724 2 file system contains exactly one directory at the very top level, called the root directory for that file system. This root directory can contain other directories. - One file system is designated the root file - system or /. Every other file - system is mounted under the root file - system. No matter how many disks are on the &os; system, every - directory appears to be part of the same disk. + One file system is designated the + root file system or /. + Every other file system is mounted under + the root file system. No matter how many disks are on the &os; + system, every directory appears to be part of the same + disk. Consider three file systems, called A, B, and C. Each file @@ -1167,10 +1165,10 @@ root 5211 0.0 0.2 3620 1724 2 Any files that are in the B1 or B2 directories can be reached with the path - /A1/B1 or /A1/B2 as necessary. Any files - that were in /A1 have - been temporarily hidden. They will reappear if + /A1/B1 or + /A1/B2 as necessary. Any + files that were in /A1 + have been temporarily hidden. They will reappear if B is unmounted from A. @@ -1197,8 +1195,9 @@ root 5211 0.0 0.2 3620 1724 2 and the paths would be - /A2/B1 and /A2/B2 respectively. + /A2/B1 and + /A2/B2 *** DIFF OUTPUT TRUNCATED AT 1000 LINES *** From owner-svn-doc-projects@FreeBSD.ORG Wed Oct 2 14:37:48 2013 Return-Path: Delivered-To: svn-doc-projects@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id E9842AAE; Wed, 2 Oct 2013 14:37:48 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id D39C72F0E; Wed, 2 Oct 2013 14:37:48 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r92EbmCv069489; Wed, 2 Oct 2013 14:37:48 GMT (envelope-from gjb@svn.freebsd.org) Received: (from gjb@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r92Ebkcm069452; Wed, 2 Oct 2013 14:37:46 GMT (envelope-from gjb@svn.freebsd.org) Message-Id: <201310021437.r92Ebkcm069452@svn.freebsd.org> From: Glen Barber Date: Wed, 2 Oct 2013 14:37:46 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-projects@freebsd.org Subject: svn commit: r42805 - in projects/sysctl: de_DE.ISO8859-1/htdocs de_DE.ISO8859-1/share/xml el_GR.ISO8859-7/share/xml en_US.ISO8859-1/articles/committers-guide en_US.ISO8859-1/articles/contributors e... X-SVN-Group: doc-projects MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-projects@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for doc projects trees List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 02 Oct 2013 14:37:49 -0000 Author: gjb Date: Wed Oct 2 14:37:45 2013 New Revision: 42805 URL: http://svnweb.freebsd.org/changeset/doc/42805 Log: MFH: Merged /head/de_DE.ISO8859-1:r42573-42802 Merged /head/el_GR.ISO8859-7:r42573-42802 Merged /projects/ISBN_1-57176-407-0/en_US.ISO8859-1:r41456 Merged /head/en_US.ISO8859-1:r42573-42802 Merged /head/fr_FR.ISO8859-1:r42573-42802 Merged /head/hu_HU.ISO8859-2:r42573-42802 Merged /head/ja_JP.eucJP:r42573-42802 Merged /head/mn_MN.UTF-8:r42573-42802 Merged /head/nl_NL.ISO8859-1:r42573-42802 Merged /head/pl_PL.ISO8859-2:r42573-42802 Merged /head/ru_RU.KOI8-R:r42573-42802 Merged /head/share:r42573-42802 Merged /head/zh_CN.GB2312:r42573-42802 Approved by: doceng (implicit) Sponsored by: The FreeBSD Foundation Added: projects/sysctl/en_US.ISO8859-1/books/porters-handbook/versions.xml - copied unchanged from r42802, head/en_US.ISO8859-1/books/porters-handbook/versions.xml projects/sysctl/en_US.ISO8859-1/htdocs/news/status/report-2013-07-2013-09.xml - copied unchanged from r42802, head/en_US.ISO8859-1/htdocs/news/status/report-2013-07-2013-09.xml projects/sysctl/en_US.ISO8859-1/htdocs/releases/9.2R/announce.xml - copied unchanged from r42802, head/en_US.ISO8859-1/htdocs/releases/9.2R/announce.xml projects/sysctl/en_US.ISO8859-1/htdocs/releases/9.2R/errata.html - copied unchanged from r42802, head/en_US.ISO8859-1/htdocs/releases/9.2R/errata.html projects/sysctl/en_US.ISO8859-1/htdocs/releases/9.2R/hardware.html - copied unchanged from r42802, head/en_US.ISO8859-1/htdocs/releases/9.2R/hardware.html projects/sysctl/en_US.ISO8859-1/htdocs/releases/9.2R/installation.html - copied unchanged from r42802, head/en_US.ISO8859-1/htdocs/releases/9.2R/installation.html projects/sysctl/en_US.ISO8859-1/htdocs/releases/9.2R/readme.html - copied unchanged from r42802, head/en_US.ISO8859-1/htdocs/releases/9.2R/readme.html projects/sysctl/en_US.ISO8859-1/htdocs/releases/9.2R/relnotes.xml - copied unchanged from r42802, head/en_US.ISO8859-1/htdocs/releases/9.2R/relnotes.xml projects/sysctl/ja_JP.eucJP/htdocs/releases/9.2R/ - copied from r42802, head/ja_JP.eucJP/htdocs/releases/9.2R/ projects/sysctl/share/pgpkeys/arundel.key - copied unchanged from r42802, head/share/pgpkeys/arundel.key projects/sysctl/share/pgpkeys/br.key - copied unchanged from r42802, head/share/pgpkeys/br.key projects/sysctl/share/pgpkeys/danilo.key - copied unchanged from r42802, head/share/pgpkeys/danilo.key projects/sysctl/share/pgpkeys/secteam-secretary.key - copied unchanged from r42802, head/share/pgpkeys/secteam-secretary.key projects/sysctl/share/pgpkeys/zbb.key - copied unchanged from r42802, head/share/pgpkeys/zbb.key projects/sysctl/share/security/advisories/FreeBSD-SA-13:11.sendfile.asc - copied unchanged from r42802, head/share/security/advisories/FreeBSD-SA-13:11.sendfile.asc projects/sysctl/share/security/advisories/FreeBSD-SA-13:12.ifioctl.asc - copied unchanged from r42802, head/share/security/advisories/FreeBSD-SA-13:12.ifioctl.asc projects/sysctl/share/security/advisories/FreeBSD-SA-13:13.nullfs.asc - copied unchanged from r42802, head/share/security/advisories/FreeBSD-SA-13:13.nullfs.asc projects/sysctl/share/security/patches/SA-13:11/ - copied from r42802, head/share/security/patches/SA-13:11/ projects/sysctl/share/security/patches/SA-13:12/ - copied from r42802, head/share/security/patches/SA-13:12/ projects/sysctl/share/security/patches/SA-13:13/ - copied from r42802, head/share/security/patches/SA-13:13/ Deleted: projects/sysctl/en_US.ISO8859-1/htdocs/projects/c99/ Modified: projects/sysctl/de_DE.ISO8859-1/htdocs/where.xml projects/sysctl/de_DE.ISO8859-1/share/xml/news.xml projects/sysctl/de_DE.ISO8859-1/share/xml/release.l10n.ent projects/sysctl/el_GR.ISO8859-7/share/xml/teams.ent projects/sysctl/en_US.ISO8859-1/articles/committers-guide/article.xml projects/sysctl/en_US.ISO8859-1/articles/contributors/contrib.additional.xml projects/sysctl/en_US.ISO8859-1/articles/contributors/contrib.committers.xml projects/sysctl/en_US.ISO8859-1/books/dev-model/book.xml projects/sysctl/en_US.ISO8859-1/books/faq/book.xml projects/sysctl/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml projects/sysctl/en_US.ISO8859-1/books/handbook/basics/chapter.xml projects/sysctl/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml projects/sysctl/en_US.ISO8859-1/books/handbook/desktop/chapter.xml projects/sysctl/en_US.ISO8859-1/books/handbook/dtrace/chapter.xml projects/sysctl/en_US.ISO8859-1/books/handbook/multimedia/chapter.xml projects/sysctl/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml projects/sysctl/en_US.ISO8859-1/books/handbook/ports/chapter.xml projects/sysctl/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.xml projects/sysctl/en_US.ISO8859-1/books/handbook/security/chapter.xml projects/sysctl/en_US.ISO8859-1/books/handbook/x11/chapter.xml projects/sysctl/en_US.ISO8859-1/books/porters-handbook/Makefile projects/sysctl/en_US.ISO8859-1/books/porters-handbook/book.xml projects/sysctl/en_US.ISO8859-1/books/porters-handbook/uses.xml projects/sysctl/en_US.ISO8859-1/htdocs/administration.xml projects/sysctl/en_US.ISO8859-1/htdocs/advocacy/myths.xml projects/sysctl/en_US.ISO8859-1/htdocs/cgi/man.cgi projects/sysctl/en_US.ISO8859-1/htdocs/donations/donors.xml projects/sysctl/en_US.ISO8859-1/htdocs/news/status/Makefile projects/sysctl/en_US.ISO8859-1/htdocs/news/status/README projects/sysctl/en_US.ISO8859-1/htdocs/projects/Makefile projects/sysctl/en_US.ISO8859-1/htdocs/projects/projects.xml projects/sysctl/en_US.ISO8859-1/htdocs/releases/10.0R/schedule.xml projects/sysctl/en_US.ISO8859-1/htdocs/releases/9.2R/Makefile projects/sysctl/en_US.ISO8859-1/htdocs/releases/9.2R/schedule.xml projects/sysctl/en_US.ISO8859-1/htdocs/releases/Makefile projects/sysctl/en_US.ISO8859-1/htdocs/releng/index.xml projects/sysctl/en_US.ISO8859-1/htdocs/security/security.xml projects/sysctl/en_US.ISO8859-1/htdocs/where.xml projects/sysctl/en_US.ISO8859-1/share/xml/release.l10n.ent projects/sysctl/en_US.ISO8859-1/share/xml/teams.ent projects/sysctl/fr_FR.ISO8859-1/share/xml/release.l10n.ent (contents, props changed) projects/sysctl/fr_FR.ISO8859-1/share/xml/teams.ent projects/sysctl/hu_HU.ISO8859-2/share/xml/teams.ent projects/sysctl/ja_JP.eucJP/books/handbook/cutting-edge/chapter.xml projects/sysctl/ja_JP.eucJP/books/handbook/desktop/chapter.xml projects/sysctl/ja_JP.eucJP/books/handbook/install/chapter.xml projects/sysctl/ja_JP.eucJP/books/handbook/introduction/chapter.xml projects/sysctl/ja_JP.eucJP/books/handbook/ports/chapter.xml projects/sysctl/ja_JP.eucJP/books/handbook/x11/chapter.xml projects/sysctl/ja_JP.eucJP/htdocs/projects/Makefile projects/sysctl/ja_JP.eucJP/htdocs/projects/projects.xml projects/sysctl/ja_JP.eucJP/htdocs/releases/Makefile projects/sysctl/ja_JP.eucJP/htdocs/security/security.xml projects/sysctl/ja_JP.eucJP/htdocs/where.xml projects/sysctl/ja_JP.eucJP/share/xml/l10n.ent projects/sysctl/ja_JP.eucJP/share/xml/news.xml projects/sysctl/ja_JP.eucJP/share/xml/release.l10n.ent projects/sysctl/mn_MN.UTF-8/share/xml/teams.ent projects/sysctl/nl_NL.ISO8859-1/share/xml/release.l10n.ent (contents, props changed) projects/sysctl/nl_NL.ISO8859-1/share/xml/teams.ent projects/sysctl/pl_PL.ISO8859-2/share/xml/teams.ent projects/sysctl/ru_RU.KOI8-R/share/xml/teams.ent projects/sysctl/share/pgpkeys/addkey.sh projects/sysctl/share/pgpkeys/arved.key projects/sysctl/share/pgpkeys/avg.key projects/sysctl/share/pgpkeys/bf.key projects/sysctl/share/pgpkeys/des.key projects/sysctl/share/pgpkeys/erwin.key projects/sysctl/share/pgpkeys/gahr.key projects/sysctl/share/pgpkeys/gavin.key projects/sysctl/share/pgpkeys/gjb.key projects/sysctl/share/pgpkeys/issyl0.key projects/sysctl/share/pgpkeys/jase.key projects/sysctl/share/pgpkeys/jkim.key projects/sysctl/share/pgpkeys/loos.key projects/sysctl/share/pgpkeys/marius.key projects/sysctl/share/pgpkeys/mat.key projects/sysctl/share/pgpkeys/matthew.key projects/sysctl/share/pgpkeys/pgollucci.key projects/sysctl/share/pgpkeys/pgpkeys-developers.xml projects/sysctl/share/pgpkeys/pgpkeys-officers.xml projects/sysctl/share/pgpkeys/pgpkeys-other.xml projects/sysctl/share/pgpkeys/pgpkeys.ent projects/sysctl/share/pgpkeys/roberto.key projects/sysctl/share/pgpkeys/security-officer.key projects/sysctl/share/pgpkeys/skreuzer.key projects/sysctl/share/pgpkeys/stas.key projects/sysctl/share/pgpkeys/syrinx.key projects/sysctl/share/pgpkeys/thierry.key projects/sysctl/share/security/advisories/FreeBSD-SA-13:09.ip_multicast.asc projects/sysctl/share/security/advisories/FreeBSD-SA-13:10.sctp.asc projects/sysctl/share/xml/advisories.xml projects/sysctl/share/xml/authors.ent projects/sysctl/share/xml/commercial.consult.xml projects/sysctl/share/xml/events2013.xml projects/sysctl/share/xml/mirrors.xml projects/sysctl/share/xml/news.dtd projects/sysctl/share/xml/news.xml projects/sysctl/share/xml/release.ent projects/sysctl/zh_CN.GB2312/share/xml/teams.ent Directory Properties: projects/sysctl/de_DE.ISO8859-1/ (props changed) projects/sysctl/el_GR.ISO8859-7/ (props changed) projects/sysctl/en_US.ISO8859-1/ (props changed) projects/sysctl/fr_FR.ISO8859-1/ (props changed) projects/sysctl/hu_HU.ISO8859-2/ (props changed) projects/sysctl/ja_JP.eucJP/ (props changed) projects/sysctl/mn_MN.UTF-8/ (props changed) projects/sysctl/nl_NL.ISO8859-1/ (props changed) projects/sysctl/pl_PL.ISO8859-2/ (props changed) projects/sysctl/ru_RU.KOI8-R/ (props changed) projects/sysctl/share/ (props changed) projects/sysctl/zh_CN.GB2312/ (props changed) Modified: projects/sysctl/de_DE.ISO8859-1/htdocs/where.xml ============================================================================== --- projects/sysctl/de_DE.ISO8859-1/htdocs/where.xml Wed Oct 2 14:37:14 2013 (r42804) +++ projects/sysctl/de_DE.ISO8859-1/htdocs/where.xml Wed Oct 2 14:37:45 2013 (r42805) @@ -2,7 +2,7 @@ - + ]> @@ -69,10 +69,10 @@ FreeBSD &rel.current;-RELEASE - [Lesen] - [Lesen] - [Lesen] - [Lesen] + [Lesen] + [Lesen] + [Lesen] + [Lesen] @@ -86,7 +86,6 @@ [Distribution] [ISO] - powerpc64 Modified: projects/sysctl/de_DE.ISO8859-1/share/xml/news.xml ============================================================================== --- projects/sysctl/de_DE.ISO8859-1/share/xml/news.xml Wed Oct 2 14:37:14 2013 (r42804) +++ projects/sysctl/de_DE.ISO8859-1/share/xml/news.xml Wed Oct 2 14:37:45 2013 (r42805) @@ -4,7 +4,7 @@ @@ -18,15 +18,15 @@ Distribution ISO - Statusseite + FreeBSD &betarel2.current;-&betarel2.vers; - - [Lesen] - + + + @@ -52,12 +52,14 @@ [Distribution] [ISO] + sparc64 Modified: projects/sysctl/el_GR.ISO8859-7/share/xml/teams.ent ============================================================================== --- projects/sysctl/el_GR.ISO8859-7/share/xml/teams.ent Wed Oct 2 14:37:14 2013 (r42804) +++ projects/sysctl/el_GR.ISO8859-7/share/xml/teams.ent Wed Oct 2 14:37:45 2013 (r42805) @@ -61,3 +61,5 @@ re@FreeBSD.org"> security-officer@FreeBSD.org"> + +secteam-secretary@FreeBSD.org"> Modified: projects/sysctl/en_US.ISO8859-1/articles/committers-guide/article.xml ============================================================================== --- projects/sysctl/en_US.ISO8859-1/articles/committers-guide/article.xml Wed Oct 2 14:37:14 2013 (r42804) +++ projects/sysctl/en_US.ISO8859-1/articles/committers-guide/article.xml Wed Oct 2 14:37:45 2013 (r42805) @@ -1567,7 +1567,7 @@ U stable/9/share/man/man4/netmap.4 contain the original version tags. To do this: &prompt.user; svn propdel svn:keywords -R . -&prompt.root; svn commit +&prompt.user; svn commit @@ -2346,6 +2346,45 @@ ControlPersist yes will review code. + + If in doubt... + + When you are not sure about something, whether it be a + technical issue or a project convention be sure to ask. If you + stay silent you will never make progress. + + If it relates to a technical issue ask on the public + mailing lists. Avoid the temptation to email the individual + person that knows the answer. This way everyone will be able to + learn from the question and the answer. + + For project specific or administrative questions you should + ask, in order: + + + + Your mentor or former mentor. + + + + An experienced committer on IRC, email, etc. + + + + Any team with a "hat", as they should give you a + definitive answer. + + + + If still not sure, ask on &a.developers;. + + + + Once your question is answered, if no one pointed you to + documentation that spelled out the answer to your question, + document it, as others will have the same question. + + GNATS Modified: projects/sysctl/en_US.ISO8859-1/articles/contributors/contrib.additional.xml ============================================================================== --- projects/sysctl/en_US.ISO8859-1/articles/contributors/contrib.additional.xml Wed Oct 2 14:37:14 2013 (r42804) +++ projects/sysctl/en_US.ISO8859-1/articles/contributors/contrib.additional.xml Wed Oct 2 14:37:45 2013 (r42805) @@ -2129,11 +2129,6 @@ - Danilo Egêa Gondolfo - danilogondolfo@gmail.com - - - Danny Braniss danny@cs.huji.ac.il @@ -4856,6 +4851,11 @@ + Johannes Meixner + xmj@chaot.net + + + Johannes Stille Modified: projects/sysctl/en_US.ISO8859-1/articles/contributors/contrib.committers.xml ============================================================================== --- projects/sysctl/en_US.ISO8859-1/articles/contributors/contrib.committers.xml Wed Oct 2 14:37:14 2013 (r42804) +++ projects/sysctl/en_US.ISO8859-1/articles/contributors/contrib.committers.xml Wed Oct 2 14:37:45 2013 (r42805) @@ -116,6 +116,10 @@ + &a.zbb.email; + + + &a.novel.email; @@ -156,6 +160,10 @@ + &a.br.email; + + + &a.oleg.email; @@ -404,6 +412,10 @@ + &a.danilo.email; + + + &a.daichi.email; Modified: projects/sysctl/en_US.ISO8859-1/books/dev-model/book.xml ============================================================================== --- projects/sysctl/en_US.ISO8859-1/books/dev-model/book.xml Wed Oct 2 14:37:14 2013 (r42804) +++ projects/sysctl/en_US.ISO8859-1/books/dev-model/book.xml Wed Oct 2 14:37:45 2013 (r42805) @@ -46,6 +46,12 @@ + 1.4 + September, 2013 + Remove mention of CVS and CVSup which are no + longer used by the project. + + 1.3 October, 2012 Remove hats held by specific people, these @@ -896,22 +902,6 @@
-
- CVSup Mirror Site Coordinator - - The CVSup Mirror Site Coordinator coordinates all the - s to ensure that they - are distributing current versions of the software, that they - have the capacity to update themselves when major updates - are in progress, and making it easy for the general public - to find their closest CVSup mirror. - - - Hat currently held by: - The CVSup-master team cvsup-master@FreeBSD.org. - -
-
Postmaster @@ -1030,11 +1020,11 @@ responsibility to ensure that technical problems that arise in the repository are resolved quickly. The source repository manager has the authority to back out commits if this is - necessary to resolve a CVS technical problem. + necessary to resolve a SVN technical problem. Hat held by: - the Source Repository Manager cvs@FreeBSD.org. + the Source Repository Manager clusteradm@FreeBSD.org.
@@ -1240,20 +1230,6 @@ for review is posted.
- -
- CVSup Mirror Site Admin - - A CVSup Mirror Site Admin has accesses to a server that he/she - uses to mirror the CVS repository. The admin works with the - to ensure the site - remains up-to-date and is following the general policy of - official mirror sites. - -
- - @@ -1402,93 +1378,6 @@ -
- Adding/Removing an official CVSup Mirror - - - A mirror is a replica of the - official CVSup master that contains all the up-to-date source - code for all the branches in the FreeBSD project, ports and - documentation. - - - - Adding an official CVSup mirror starts with the potential - installing the - cvsup-mirror package. Having done this and - updated the source code with a mirror site, he now runs a - fairly recent unofficial CVSup mirror. - - - - Deciding he has a stable environment, the processing - power, the network capacity and the - storage capacity to run an official mirror, he mails the - who decides whether - the mirror should become an official mirror or not. - - - - In making this decision, the - has to determine whether that geographical area needs - another mirror site, if the mirror administrator has the - skills to run it reliably, if the network bandwidth is - adequate and if the master server has the capacity to server - another mirror. - - - - If decides that the - mirror should become an official mirror, he obtains an - authentication key from the mirror admin that he installs so - the mirror admin can update the mirror from the master server. - - - -
- Process summary: adding a CVSup mirror - -
-
- - - When a CVSup mirror administrator of an unofficial mirror - offers to become an official mirror site, the CVSup - coordinator decides if another mirror is needed and if - there is sufficient capacity to accommodate it. If so, - an authorisation key is requested and the mirror is given - access to the main distribution site and added to the - list of official mirrors. - - - - - Tools used in this process: - - - - - - - - - - - - Hats involved in this process: - - - - - - - - - - -
-
Committing code @@ -2183,9 +2072,8 @@ The major support tools for supporting the development process are - CVS, CVSup, Perforce, GNATS, Mailman and OpenSSH. Except for - CVSup, these are externally - developed tools. These tools are commonly used in the open source world. + Perforce, GNATS, Mailman and OpenSSH. These are externally + developed tools and are commonly used in the open source world.
@@ -2198,18 +2086,6 @@
-
- CVSup - - CVSup is a software package for distributing and updating - collections of files across a network. It consists of a - client program, cvsup, and a server program, cvsupd. The - package is tailored specifically for distributing CVS - repositories, and by taking advantage of CVS' properties, it - performs updates much faster than traditional systems. - -
-
GNATS Modified: projects/sysctl/en_US.ISO8859-1/books/faq/book.xml ============================================================================== --- projects/sysctl/en_US.ISO8859-1/books/faq/book.xml Wed Oct 2 14:37:14 2013 (r42804) +++ projects/sysctl/en_US.ISO8859-1/books/faq/book.xml Wed Oct 2 14:37:45 2013 (r42805) @@ -964,7 +964,7 @@ - Channel ##FreeBSD on Channel #FreeBSD on Freenode is a general help channel with many users at any time. The conversations have been known to run off-topic for a @@ -5238,9 +5238,12 @@ ttyvb "/usr/libexec/getty Pc" - Run the command xmodmap -e "pointer = 3 2 1" - from .xinitrc or - .xsession. + Run the command + xmodmap -e "pointer = 3 2 1". + You add the above command to + .xinitrc or + .xsession to make it happen + automatically. @@ -7233,7 +7236,7 @@ hint.sio.7.irq="12" - &os; a lot of swap space even when the computer has + &os; uses a lot of swap space even when the computer has free memory left. Why? Modified: projects/sysctl/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml ============================================================================== --- projects/sysctl/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml Wed Oct 2 14:37:14 2013 (r42804) +++ projects/sysctl/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml Wed Oct 2 14:37:45 2013 (r42805) @@ -5021,17 +5021,25 @@ redirect_port tcp 192.168.0.3:80 80 - Running out of addresses. Today this is not so much of - a concern, since RFC1918 private address space (10.0.0.0/8, 172.16.0.0/12, and 192.168.0.0/16) and - NAT are being employed. + Running out of addresses. For years the use of + RFC1918 private address space + (10.0.0.0/8, + 172.16.0.0/12, and + 192.168.0.0/16) and NAT + has slowed down the exhaustion. Even though, there are + very few remaining IPv4 addresses. The Internet + Assigned Numbers Authority (IANA) has + issued the last of the available major blocks to the + Regional Registries. Once each Regional Registry runs + out, there will be no more available and switching to + IPv6 will be critical. - Router table entries were getting too large. This is - still a concern today. + Every block of IPv4 addresses allocated required + routing information to be exchanged between many routers + on the Internet, and these routing tables were getting + too large to allow efficient routing. @@ -5054,7 +5062,7 @@ redirect_port tcp 192.168.0.3:80 80 - There are other useful features of + There are many other useful features of IPv6: @@ -5280,6 +5288,12 @@ redirect_port tcp 192.168.0.3:80 80SixXS offers tunnels with end-points all around the globe. + + + Hurricane + Electric offers tunnels with end-points all around + the globe. + Tunnel via 6-to-4 as described in - <acronym>DNS</acronym> in the <acronym>IPv6</acronym> - World - - There used to be two types of DNS - records for IPv6. The - IETF has declared AAAA - records as the current standard. - - Using AAAA records is straightforward. - Assign the hostname to the IPv6 address - in the primary zone DNS file: - - MYHOSTNAME AAAA MYIPv6ADDR - - Current versions of &man.named.8; and dns/djbdns support - AAAA records. - - - Applying the Needed Changes to <filename>/etc/rc.conf</filename> - <acronym>IPv6</acronym> Client Settings + <acronym>IPv6</acronym> Client + Auto-Configuration - These settings configure a machine on a + To automatically configure a machine on a LAN which acts as a client, not a - router. To instruct &man.rtsol.8; to autoconfigure the - interface on boot on - &os; 9.x and later, add - this line to rc.conf: - - ipv6_prefer="YES" + router, two items are required. First to enable the + em0 to receive the router + solicitation messages, add this line to + rc.conf: + + ifconfig_em0_ipv6="inet6 accept_rtadv" + + Secondly, the router solicitation daemon, &man.rtsol.8;, + should be enabled by adding the following to + rc.conf: + + rtsold_enable="YES" For &os; 8.x, add: ipv6_enable="YES" + + + <acronym>IPv6</acronym> Client Static + Configuration To statically assign the IPv6 address, 2001:471:1f11:251:290:27ff:fee0:2093, + role="ip6addr">2001:db8:4672:6565:2026:5043:2d42:5344, to fxp0, add the following for &os; 9.x: - ifconfig_fxp0_ipv6="inet6 2001:471:1f11:251:290:27ff:fee0:2093 prefixlen 64" + ifconfig_fxp0_ipv6="inet6 2001:db8:4672:6565:2026:5043:2d42:5344 prefixlen 64" Be sure to change prefixlen @@ -5349,16 +5354,16 @@ redirect_port tcp 192.168.0.3:80 80 - For &os; 8x, + For &os; 8.x, add: - ipv6_ifconfig_fxp0="2001:471:1f11:251:290:27ff:fee0:2093" + ipv6_ifconfig_fxp0="2001:db8:4672:6565:2026:5043:2d42:5344" To assign a default router of 2001:471:1f11:251::1, add the + role="ip6addr">2001:db8:4672:6565::1, add the following to /etc/rc.conf: - ipv6_defaultrouter="2001:471:1f11:251::1" + ipv6_defaultrouter="2001:db8:4672:6565::1" @@ -5372,9 +5377,9 @@ redirect_port tcp 192.168.0.3:80 80The first entry lists the generic tunneling interfaces to be configured. This example configures one interface, - gif0: + gif0: - gif_interfaces="gif0" + gif_interfaces="gif0" To configure that interface with a local endpoint of MY_IPv4_ADDR to a remote endpoint @@ -5476,6 +5481,23 @@ redirect_port tcp 192.168.0.3:80 80RFC 4038 section 4.2 may be useful to some adminstrators. + + + Application Use of <acronym>IPv6</acronym> + + Currently IPv6 support for many + applications and services is very good, though for some + software it still needs work. For authoritative + information about the support of + IPv6, please consult the Official + Documentation for the software in question. + + Web, DNS and Mail applications + and servers have the best support for + IPv6 because they are the most common + use case. Other applications may have varying degrees + of IPv6 support. + Modified: projects/sysctl/en_US.ISO8859-1/books/handbook/basics/chapter.xml ============================================================================== --- projects/sysctl/en_US.ISO8859-1/books/handbook/basics/chapter.xml Wed Oct 2 14:37:14 2013 (r42804) +++ projects/sysctl/en_US.ISO8859-1/books/handbook/basics/chapter.xml Wed Oct 2 14:37:45 2013 (r42805) @@ -70,10 +70,6 @@ - What binary format is used under &os;. - - - How to read manual pages for more information. @@ -97,8 +93,8 @@ console - Unless &os; has been configured to automatically start - a graphical environment during startup, the system will boot + Unless &os; has been configured to automatically start a + graphical environment during startup, the system will boot into a command line login prompt, as seen in this example: @@ -106,10 +102,10 @@ login: - The first line contains some information about the - system. The amd64 indicates that the - system in this example is running a 64-bit version of &os;. - The hostname is pc3.example.org, and + The first line contains some information about the system. + The amd64 indicates that the system in this + example is running a 64-bit version of &os;. The hostname is + pc3.example.org, and ttyv0 indicates that this is the system console. @@ -120,10 +116,10 @@ login: Logging into &os; - &os; is a multiuser, multiprocessing system. This is - the formal description that is usually given to a system that - can be used by many different people, who simultaneously run a - lot of programs on a single machine. + &os; is a multiuser, multiprocessing system. This is the + formal description that is usually given to a system that can + be used by many different people, who simultaneously run a lot + of programs on a single machine. Every multiuser system needs some way to distinguish one user from the rest. In &os; (and all the @@ -131,9 +127,8 @@ login: requiring that every user must log into the system before being able to run programs. Every user has a unique name (the username) and a personal, - secret key (the password). &os; will ask - for these two before allowing a user to run any - programs. + secret key (the password). &os; will ask for + these two before allowing a user to run any programs. startup scripts When a &os; system boots, startup scripts are @@ -145,8 +140,8 @@ login: login: Type the username that was configured during system - installation, as described in , and press + installation, as described in + , and press Enter. Then enter the password associated with the username and press Enter. The password is not echoed for security @@ -274,8 +269,8 @@ console none &prompt.root; vidcontrol -i mode - The output of this command lists the video modes that - are supported by the hardware. To select a new video mode, + The output of this command lists the video modes that are + supported by the hardware. To select a new video mode, specify the mode using &man.vidcontrol.1; as the root user: @@ -294,9 +289,9 @@ console none UNIX - &os;, being a direct descendant of BSD &unix;, is based - on several key &unix; concepts. The first and most pronounced - is that &os; is a multi-user operating system that can handle + &os;, being a direct descendant of BSD &unix;, is based on + several key &unix; concepts. The first and most pronounced is + that &os; is a multi-user operating system that can handle several users working simultaneously on completely unrelated tasks. The system is responsible for properly sharing and managing requests for hardware devices, peripherals, memory, and @@ -304,12 +299,12 @@ console none Much more information about user accounts is in the chapter about accounts. It is important to - understand that each person (user) who uses the computer should be - given their own username and password. The system keeps track - of the people using the computer based on this username. Since - it is often the case that several people are working on the same - project &unix; also provides groups. Several users can be placed - in the same group. + understand that each person (user) who uses the computer should + be given their own username and password. The system keeps + track of the people using the computer based on this username. + Since it is often the case that several people are working on + the same project &unix; also provides groups. Several users can + be placed in the same group. Because the system is capable of supporting multiple users, everything the system manages has a set of permissions governing @@ -321,9 +316,10 @@ console none This section will discuss the traditional &unix; - permissions. For finer grained file system access - control, see the File System - Access Control Lists section. + permissions. For finer grained file system access control, + see the + File System Access Control Lists + section. permissions @@ -391,6 +387,7 @@ console none + &man.ls.1; @@ -1026,9 +1023,9 @@ root 5211 0.0 0.2 3620 1724 2 class="directory">/var/ Multi-purpose log, temporary, transient, and spool files. A memory-based file system is sometimes - mounted at /var. This can be - automated using the varmfs-related variables in + mounted at + /var. This can + be automated using the varmfs-related variables in &man.rc.conf.5; or with an entry in /etc/fstab; refer to &man.mdmfs.8; for details. @@ -1057,8 +1054,8 @@ root 5211 0.0 0.2 3620 1724 2 /var/tmp/ Temporary files which are usually preserved - across a system reboot, unless /var is a + across a system reboot, unless + /var is a memory-based file system. @@ -1091,8 +1088,8 @@ root 5211 0.0 0.2 3620 1724 2 Files and directories are referenced by giving the file or directory name, followed by a forward slash, /, followed by any other directory names that - are necessary. For example, if the directory foo contains a directory + are necessary. For example, if the directory + foo contains a directory bar which contains the file readme.txt, the full name, or path, to the file is @@ -1107,11 +1104,12 @@ root 5211 0.0 0.2 3620 1724 2 file system contains exactly one directory at the very top level, called the root directory for that file system. This root directory can contain other directories. - One file system is designated the root file - system or /. Every other file - system is mounted under the root file - system. No matter how many disks are on the &os; system, every - directory appears to be part of the same disk. + One file system is designated the + root file system or /. + Every other file system is mounted under + the root file system. No matter how many disks are on the &os; + system, every directory appears to be part of the same + disk. Consider three file systems, called A, B, and C. Each file @@ -1167,10 +1165,10 @@ root 5211 0.0 0.2 3620 1724 2 Any files that are in the B1 or B2 directories can be reached with the path - /A1/B1 or /A1/B2 as necessary. Any files - that were in /A1 have - been temporarily hidden. They will reappear if + /A1/B1 or + /A1/B2 as necessary. Any + files that were in /A1 + have been temporarily hidden. They will reappear if B is unmounted from A. @@ -1197,8 +1195,9 @@ root 5211 0.0 0.2 3620 1724 2 and the paths would be - /A2/B1 and /A2/B2 respectively. + /A2/B1 and + /A2/B2 *** DIFF OUTPUT TRUNCATED AT 1000 LINES *** From owner-svn-doc-projects@FreeBSD.ORG Wed Oct 2 17:53:48 2013 Return-Path: Delivered-To: svn-doc-projects@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id A2217207; Wed, 2 Oct 2013 17:53:48 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 8EBFF2CB5; Wed, 2 Oct 2013 17:53:48 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r92Hrmjl064158; Wed, 2 Oct 2013 17:53:48 GMT (envelope-from bcr@svn.freebsd.org) Received: (from bcr@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r92HrmFV064157; Wed, 2 Oct 2013 17:53:48 GMT (envelope-from bcr@svn.freebsd.org) Message-Id: <201310021753.r92HrmFV064157@svn.freebsd.org> From: Benedict Reuschling Date: Wed, 2 Oct 2013 17:53:48 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-projects@freebsd.org Subject: svn commit: r42807 - projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs X-SVN-Group: doc-projects MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-projects@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for doc projects trees List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 02 Oct 2013 17:53:48 -0000 Author: bcr Date: Wed Oct 2 17:53:48 2013 New Revision: 42807 URL: http://svnweb.freebsd.org/changeset/doc/42807 Log: Add basic information about ZFS delegation and small corrections to other parts. Submitted by: Allan Jude Modified: projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Modified: projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml ============================================================================== --- projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Wed Oct 2 16:19:37 2013 (r42806) +++ projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Wed Oct 2 17:53:48 2013 (r42807) @@ -25,7 +25,7 @@ Data integrity: checksums are created when data is written - and checked when data is read. If on-disk data corruption is + and checked when data is read. If on-disk data corruption is detected, the user is notified and recovery methods are initiated. @@ -476,7 +476,13 @@ errors: No known data errors Adding & Removing Devices - + Creating a ZFS Storage Pool (zpool) + involves making a number of decisions that are relatively + permanent. Although additional vdevs can be added to a pool, + the layout of the pool cannot be changed once the pool has + been created, instead the data must be backed up and the pool + recreated. Currently, devices cannot be removed from a + zpool. @@ -574,14 +580,15 @@ data 288G 1.53T Creating & Destroying Volumes - + A volume can be formatted with any filesystem on top of - it. This will appear to the user as if they are working with - that specific filesystem and not ZFS. This way, it can be - used to augment non-ZFS filesystems with ZFS features that - they do not have. For example, combining the ZFS compression - property together with a 250 MB volume allows to create a - compressed FAT filesystem. + it. This will appear to the user as if they are working with + a regular disk using that specific filesystem and not ZFS. + In this way, non-ZFS file systems can be augmented with + ZFS features that they would not normally have. For example, + combining the ZFS compression property together with a + 250 MB volume allows to create a compressed FAT + filesystem. &prompt.root; zfs create -V 250m -o compression=on tank/fat32 &prompt.root; zfs list tank @@ -608,15 +615,15 @@ Filesystem Size Used Avail Cap It is possible to set user-defined properties in ZFS. - They become part of the pool configuration and can be used to - provide additional information about the pool or it's - contents. To distnguish these custom properties from the ones - supplied by ZFS by default, the colon (:) - is used in the property name. + They become part of the dataset configuration and can be used + to provide additional information about the dataset or its + contents. To distnguish these custom properties from the + ones supplied as part of ZFS, a colon (:) + is used to create a custom namespace for the property. &prompt.root; zfs set custom:costcenter=1234 &prompt.root; zfs get custom:costcenter -NAME PROPERTY VALUE SOURCE +NAME PROPERTY VALUE SOURCE tank custom:costcenter 1234 local @@ -780,11 +787,52 @@ tank custom:costcenter 1234 local + - - Delegated Administration + + Delegated Administration - + ZFS features a comprehensive delegation system to assign + permissions to performs the various ZFS administration functions + to a regular user. For example, if each users' home directory + is a dataset, then each user could be delegated permission to + create and destroy snapshots of their home directory. A backup + user could be assigned the permissions required to make use of + the ZFS replication features without requiring root access, or + isolate a usage collection script to run as an unprivledged user + with access to only the space utilization data of all users. It + is even possible to delegate the ability to delegate + permissions. It is possible to delegate permissions over each + ZFS subcommand and most ZFS properties. + + + Delegating Dataset Creation + + Using the zfs allow + someuser create + mydataset command will + give the indicated user the required permissions to create + child datasets under the selected parent dataset. There is + a caveat, creating a new dataset involves mouting it, which + requires the vfs.usermount sysctl be + enabled in order to allow non-root users to mount a + filesystem. There is the further restriction that non-root + users must own the directory they are mounting the filesystem + to, in order to prevent abuse. + + + + Delegating Permission Delegation + + Using the zfs allow + someuser allow + mydataset command will + give the indicated user the ability to assign any permission + they have on the target dataset (or its children) to other + users. If a user has the snapshot + permission and the allow permission that + user can then grant the snapshot permission to some other + users. @@ -1062,7 +1110,7 @@ vfs.zfs.vdev.cache.size="5M"In a RAID-Z3 configuration with 8 disks of 1 TB, the volume would provide 5 TB of usable space and still be - able to operate with three faulted disks. Sun + able to operate with three faulted disks. &sun; recommends no more than 9 disks in a single vdev. If the configuration has more disks, it is recommended to divide them into separate vdevs and From owner-svn-doc-projects@FreeBSD.ORG Wed Oct 2 18:00:47 2013 Return-Path: Delivered-To: svn-doc-projects@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id 618FA625; Wed, 2 Oct 2013 18:00:47 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 4EAA72D57; Wed, 2 Oct 2013 18:00:47 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r92I0lZt070938; Wed, 2 Oct 2013 18:00:47 GMT (envelope-from bcr@svn.freebsd.org) Received: (from bcr@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r92I0lIc070936; Wed, 2 Oct 2013 18:00:47 GMT (envelope-from bcr@svn.freebsd.org) Message-Id: <201310021800.r92I0lIc070936@svn.freebsd.org> From: Benedict Reuschling Date: Wed, 2 Oct 2013 18:00:47 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-projects@freebsd.org Subject: svn commit: r42808 - projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs X-SVN-Group: doc-projects MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-projects@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for doc projects trees List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 02 Oct 2013 18:00:47 -0000 Author: bcr Date: Wed Oct 2 18:00:46 2013 New Revision: 42808 URL: http://svnweb.freebsd.org/changeset/doc/42808 Log: Just whitespace fixes. More updates will be coming soon. Modified: projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Modified: projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml ============================================================================== --- projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Wed Oct 2 17:53:48 2013 (r42807) +++ projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Wed Oct 2 18:00:46 2013 (r42808) @@ -812,8 +812,8 @@ tank custom:costcenter 1234 localsomeuser create mydataset command will give the indicated user the required permissions to create - child datasets under the selected parent dataset. There is - a caveat, creating a new dataset involves mouting it, which + child datasets under the selected parent dataset. There is a + caveat, creating a new dataset involves mouting it, which requires the vfs.usermount sysctl be enabled in order to allow non-root users to mount a filesystem. There is the further restriction that non-root From owner-svn-doc-projects@FreeBSD.ORG Wed Oct 2 21:00:07 2013 Return-Path: Delivered-To: svn-doc-projects@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id C4CBD2AC; Wed, 2 Oct 2013 21:00:07 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id B22912989; Wed, 2 Oct 2013 21:00:07 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r92L07c2038969; Wed, 2 Oct 2013 21:00:07 GMT (envelope-from bcr@svn.freebsd.org) Received: (from bcr@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r92L07qP038968; Wed, 2 Oct 2013 21:00:07 GMT (envelope-from bcr@svn.freebsd.org) Message-Id: <201310022100.r92L07qP038968@svn.freebsd.org> From: Benedict Reuschling Date: Wed, 2 Oct 2013 21:00:07 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-projects@freebsd.org Subject: svn commit: r42810 - projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs X-SVN-Group: doc-projects MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-projects@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for doc projects trees List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 02 Oct 2013 21:00:07 -0000 Author: bcr Date: Wed Oct 2 21:00:07 2013 New Revision: 42810 URL: http://svnweb.freebsd.org/changeset/doc/42810 Log: Add a section on deduplication. This needs some more work and warnings about huge memory requirements for the DDT. But the basic instructions are there on how to activate it, along with an example that shows the dedup ratio and a simulation run with zdb. Modified: projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Modified: projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml ============================================================================== --- projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Wed Oct 2 20:02:02 2013 (r42809) +++ projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Wed Oct 2 21:00:07 2013 (r42810) @@ -518,7 +518,7 @@ errors: No known data errors how much I/O bandwidth are currently utilized for read and write operations. By default, all pools in the system will be monitored and displayed. A pool name can be provided to just - monitor one pool. A basic example is provided below: + monitor one pool. A basic example is provided below: &prompt.root; zpool iostat capacity operations bandwidth @@ -617,7 +617,7 @@ Filesystem Size Used Avail Cap It is possible to set user-defined properties in ZFS. They become part of the dataset configuration and can be used to provide additional information about the dataset or its - contents. To distnguish these custom properties from the + contents. To distinguish these custom properties from the ones supplied as part of ZFS, a colon (:) is used to create a custom namespace for the property. @@ -646,7 +646,7 @@ tank custom:costcenter 1234 local - Dataset, User and Group Quotes + Dataset, User and Group Quotas To enforce a dataset quota of 10 GB for storage/home/bob, use the @@ -786,6 +786,92 @@ tank custom:costcenter 1234 localDeduplication + + To activate deduplication, you simply need to set the + following property on the target pool. + + &prompt.root; zfs set dedup=on pool + + it is important to mention that only new data being + written to the pool will be deduplicated. Data that is + already residing on the pool will not be deduplicated by + activating this option. As such, a pool with a freshly + activated deduplication property will look something like this + example. + + &prompt.root; zpool list +NAME SIZE ALLOC FREE CAP DEDUP HEALTH ALTROOT +pool 2.84G 2.19M 2.83G 0% 1.00x ONLINE - + + The DEDUP column shows the actual rate + of deduplication for that pool. A value of + 1.00x that no data has been deduplicated + due to insufficient duplicate data. In the following example, + the ports tree is copied three times into different + directories on the deduplicated pool above to provide + redundancy. + + &prompt.root; zpool list +for d in dir1 dir2 dir3; do +for> mkdir $d && cp -R /usr/ports $d & +for> done + + Now that redundant data has been created, ZFS detects that + and makes sure that the data is not taking up additional + space. + + &prompt.root; zpool list +NAME SIZE ALLOC FREE CAP DEDUP HEALTH ALTROOT +pool 2.84G 20.9M 2.82G 0% 3.00x ONLINE - + + The DEDUP column does now contain the + value 3.00x. This indicates that ZFS + detected the copies of the ports tree data and was able to + deduplicate it at a ratio of 1/3. The space savings that this + yields can be enormous, but only when there is enough memory + available to keep track of the deduplicated blocks. + + Deduplication is not always beneficial, especially when + there is not much redundant data on a ZFS pool. To see how + much space could be saved by deduplication for a given set of + data that is already stored in a pool, ZFS can simulate the + effects that deduplication would have. To do that, the + following command can be invoked on the pool. + + &prompt.root; zdb -S pool +Simulated DDT histogram: + +bucket allocated referenced +______ ______________________________ ______________________________ +refcnt blocks LSIZE PSIZE DSIZE blocks LSIZE PSIZE DSIZE +------ ------ ----- ----- ----- ------ ----- ----- ----- + 1 2.58M 289G 264G 264G 2.58M 289G 264G 264G + 2 206K 12.6G 10.4G 10.4G 430K 26.4G 21.6G 21.6G + 4 37.6K 692M 276M 276M 170K 3.04G 1.26G 1.26G + 8 2.18K 45.2M 19.4M 19.4M 20.0K 425M 176M 176M + 16 174 2.83M 1.20M 1.20M 3.33K 48.4M 20.4M 20.4M + 32 40 2.17M 222K 222K 1.70K 97.2M 9.91M 9.91M + 64 9 56K 10.5K 10.5K 865 4.96M 948K 948K + 128 2 9.50K 2K 2K 419 2.11M 438K 438K + 256 5 61.5K 12K 12K 1.90K 23.0M 4.47M 4.47M + 1K 2 1K 1K 1K 2.98K 1.49M 1.49M 1.49M + Total 2.82M 303G 275G 275G 3.20M 319G 287G 287G + +dedup = 1.05, compress = 1.11, copies = 1.00, dedup * compress / copies = 1.16 + + After zdb -S finished analyzing the + pool, it outputs a summary that shows the ratio that would + result in activating deduplication. In this case, + 1.16 is a very poor rate that is mostly + influenced by compression. Activating deduplication on this + pool would not save any significant amount of space. Keeping + the formula dedup * compress / copies = deduplication + ratio in mind, a system administrator can plan the + storage allocation more towards having multiple copies of data + or by having a decent compression rate in order to utilize the + space savings that deduplication provides. As a rule of + thumb, compression should be used first before deduplication + due to the lower memory requirements. From owner-svn-doc-projects@FreeBSD.ORG Thu Oct 3 02:40:21 2013 Return-Path: Delivered-To: svn-doc-projects@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id 8ECD5C37; Thu, 3 Oct 2013 02:40:21 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 7D6312B14; Thu, 3 Oct 2013 02:40:21 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r932eLmV038497; Thu, 3 Oct 2013 02:40:21 GMT (envelope-from gjb@svn.freebsd.org) Received: (from gjb@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r932eLb5038496; Thu, 3 Oct 2013 02:40:21 GMT (envelope-from gjb@svn.freebsd.org) Message-Id: <201310030240.r932eLb5038496@svn.freebsd.org> From: Glen Barber Date: Thu, 3 Oct 2013 02:40:21 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-projects@freebsd.org Subject: svn commit: r42811 - projects/relnotes-glue X-SVN-Group: doc-projects MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-projects@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for doc projects trees List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 03 Oct 2013 02:40:21 -0000 Author: gjb Date: Thu Oct 3 02:40:21 2013 New Revision: 42811 URL: http://svnweb.freebsd.org/changeset/doc/42811 Log: New branch to glue together the doc/ repository and the base/*/release/doc/ bits, specifically related to release notes. The end result of this branch will be that the release notes will be decoupled from the src/ release process, permanently separating the src/ tree from the release notes, and reducing confusion over where and when appropriate changes can be made to the online release notes. Approved by: doceng (implicit), re (implicit) Sponsored by: The FreeBSD Foundation Added: projects/relnotes-glue/ - copied from r42810, head/ From owner-svn-doc-projects@FreeBSD.ORG Thu Oct 3 03:15:15 2013 Return-Path: Delivered-To: svn-doc-projects@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id 84025443; Thu, 3 Oct 2013 03:15:15 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from dmz-mailsec-scanner-6.mit.edu (dmz-mailsec-scanner-6.mit.edu [18.7.68.35]) by mx1.freebsd.org (Postfix) with ESMTP id 295CE2CEE; Thu, 3 Oct 2013 03:15:14 +0000 (UTC) X-AuditID: 12074423-b7fc98e0000009a2-35-524ce00f61ad Received: from mailhub-auth-2.mit.edu ( [18.7.62.36]) by dmz-mailsec-scanner-6.mit.edu (Symantec Messaging Gateway) with SMTP id B9.8C.02466.F00EC425; Wed, 2 Oct 2013 23:10:08 -0400 (EDT) Received: from outgoing.mit.edu (outgoing-auth-1.mit.edu [18.9.28.11]) by mailhub-auth-2.mit.edu (8.13.8/8.9.2) with ESMTP id r933A6dS010292; Wed, 2 Oct 2013 23:10:07 -0400 Received: from multics.mit.edu (system-low-sipb.mit.edu [18.187.2.37]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.8/8.12.4) with ESMTP id r933A4or004217 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Wed, 2 Oct 2013 23:10:05 -0400 Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id r933A4sm023622; Wed, 2 Oct 2013 23:10:04 -0400 (EDT) Date: Wed, 2 Oct 2013 23:10:04 -0400 (EDT) From: Benjamin Kaduk To: freebsd@allanjude.com Subject: Re: svn commit: r42807 - projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs In-Reply-To: <201310021753.r92HrmFV064157@svn.freebsd.org> Message-ID: References: <201310021753.r92HrmFV064157@svn.freebsd.org> User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFvrEIsWRmVeSWpSXmKPExsUixG6noivwwCfI4OcpJosfHw8xWZw+cpnZ YuGZ1cwOzB4f3v1n9JjxaT5LAFMUl01Kak5mWWqRvl0CV8bzDfvZCo7yVbR+mc7YwPibu4uR k0NCwESiff8mZghbTOLCvfVsXYxcHEIC+xglTq1byg7hbGCUWP79CxOEc5BJ4uuEnawgLUIC 9RKLJh9kB7FZBLQkvrzaBRZnE1CRmPlmIxuILSIgKbHm93awFcwCNhITHiwAqxcWSJDY+vkL WA2ngJXE1v3XwGxeAUeJ5vtfGCHmW0psffQPzBYV0JFYvX8KC0SNoMTJmU9YIGZaSpz7c51t AqPgLCSpWUhSCxiZVjHKpuRW6eYmZuYUpybrFicn5uWlFuma6eVmluilppRuYgQHrYvyDsY/ B5UOMQpwMCrx8Boq+QQJsSaWFVfmHmKU5GBSEuVdfw8oxJeUn1KZkVicEV9UmpNafIhRgoNZ SYR38UqgHG9KYmVValE+TEqag0VJnPcWh32QkEB6YklqdmpqQWoRTFaGg0NJgnfyfaBGwaLU 9NSKtMycEoQ0EwcnyHAeoOHqIDW8xQWJucWZ6RD5U4yKUuK82SAJAZBERmkeXC8sqbxiFAd6 RZi3AaSKB5iQ4LpfAQ1mAhr8eoknyOCSRISUVAOj/4QPf6MqNzzdkPYw0LZr42Y+PvkMldNz dgowby/zOHJugqm78IO42alcRwxcXV9VrEh4ueWJ+Qw/C9YNl0IMahWP6X8TWzp7WYabiNDf bW335hoo//Ltkvoj8E1hg0mKc7d27XNuXo4H7k//BK8+NnvqSbefJRd/zhDbEM7c+Xgf07G6 g15nlFiKMxINtZiLihMBRG+dAAUDAAA= Cc: svn-doc-projects@freebsd.org, doc-committers@freebsd.org X-BeenThere: svn-doc-projects@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for doc projects trees List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 03 Oct 2013 03:15:15 -0000 On Wed, 2 Oct 2013, Benedict Reuschling wrote: > Author: bcr > Date: Wed Oct 2 17:53:48 2013 > New Revision: 42807 > URL: http://svnweb.freebsd.org/changeset/doc/42807 > > Log: > Add basic information about ZFS delegation and small corrections to other > parts. > > Submitted by: Allan Jude > > Modified: > projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml > > Modified: projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml > ============================================================================== > --- projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Wed Oct 2 16:19:37 2013 (r42806) > +++ projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Wed Oct 2 17:53:48 2013 (r42807) > A volume can be formatted with any filesystem on top of > - it. This will appear to the user as if they are working with > - that specific filesystem and not ZFS. This way, it can be > - used to augment non-ZFS filesystems with ZFS features that > - they do not have. For example, combining the ZFS compression > - property together with a 250 MB volume allows to create a > - compressed FAT filesystem. > + it. This will appear to the user as if they are working with > + a regular disk using that specific filesystem and not ZFS. > + In this way, non-ZFS file systems can be augmented with > + ZFS features that they would not normally have. For example, > + combining the ZFS compression property together with a > + 250 MB volume allows to create a compressed FAT > + filesystem. This last sentence seems to be incorrect grammar, as the verb "allows" requires a direct object, as in "allows the user to create". It's probably better to just rewrite it as "allows creation of", though. -Ben From owner-svn-doc-projects@FreeBSD.ORG Thu Oct 3 10:44:05 2013 Return-Path: Delivered-To: svn-doc-projects@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id 4B024711; Thu, 3 Oct 2013 10:44:05 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 38BD82791; Thu, 3 Oct 2013 10:44:05 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r93Ai5qI094569; Thu, 3 Oct 2013 10:44:05 GMT (envelope-from bcr@svn.freebsd.org) Received: (from bcr@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r93Ai5TJ094567; Thu, 3 Oct 2013 10:44:05 GMT (envelope-from bcr@svn.freebsd.org) Message-Id: <201310031044.r93Ai5TJ094567@svn.freebsd.org> From: Benedict Reuschling Date: Thu, 3 Oct 2013 10:44:05 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-projects@freebsd.org Subject: svn commit: r42813 - projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs X-SVN-Group: doc-projects MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-projects@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for doc projects trees List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 03 Oct 2013 10:44:05 -0000 Author: bcr Date: Thu Oct 3 10:44:04 2013 New Revision: 42813 URL: http://svnweb.freebsd.org/changeset/doc/42813 Log: Grammar fix. Submitted by: Benjamin Kaduk Modified: projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Modified: projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml ============================================================================== --- projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Thu Oct 3 02:42:10 2013 (r42812) +++ projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Thu Oct 3 10:44:04 2013 (r42813) @@ -587,7 +587,7 @@ data 288G 1.53T In this way, non-ZFS file systems can be augmented with ZFS features that they would not normally have. For example, combining the ZFS compression property together with a - 250 MB volume allows to create a compressed FAT + 250 MB volume allows creation of a compressed FAT filesystem. &prompt.root; zfs create -V 250m -o compression=on tank/fat32 From owner-svn-doc-projects@FreeBSD.ORG Thu Oct 3 15:44:44 2013 Return-Path: Delivered-To: svn-doc-projects@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id 2EA39899; Thu, 3 Oct 2013 15:44:44 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from dmz-mailsec-scanner-2.mit.edu (dmz-mailsec-scanner-2.mit.edu [18.9.25.13]) by mx1.freebsd.org (Postfix) with ESMTP id 9E2192CDB; Thu, 3 Oct 2013 15:44:43 +0000 (UTC) X-AuditID: 1209190d-b7f528e0000009b4-7e-524d90eabb1a Received: from mailhub-auth-2.mit.edu ( [18.7.62.36]) by dmz-mailsec-scanner-2.mit.edu (Symantec Messaging Gateway) with SMTP id B0.A8.02484.AE09D425; Thu, 3 Oct 2013 11:44:42 -0400 (EDT) Received: from outgoing.mit.edu (outgoing-auth-1.mit.edu [18.9.28.11]) by mailhub-auth-2.mit.edu (8.13.8/8.9.2) with ESMTP id r93FifwD018827; Thu, 3 Oct 2013 11:44:41 -0400 Received: from multics.mit.edu (system-low-sipb.mit.edu [18.187.2.37]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.8/8.12.4) with ESMTP id r93FidAv023123 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Thu, 3 Oct 2013 11:44:40 -0400 Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id r93FidfY029688; Thu, 3 Oct 2013 11:44:39 -0400 (EDT) Date: Thu, 3 Oct 2013 11:44:38 -0400 (EDT) From: Benjamin Kaduk To: Benedict Reuschling Subject: Re: svn commit: r42810 - projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs In-Reply-To: <201310022100.r92L07qP038968@svn.freebsd.org> Message-ID: References: <201310022100.r92L07qP038968@svn.freebsd.org> User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFnrNIsWRmVeSWpSXmKPExsUixG6novtqgm+Qwd9PYhbnj6hb/Ph4iMli 4ZnVzA7MHjM+zWcJYIzisklJzcksSy3St0vgynjesYqtYJNgxaz9zSwNjNP4uhg5OSQETCR2 7P3NDGGLSVy4t56ti5GLQ0hgH6PEmU097CAJIYENjBLLdnhCJA4ySUx8tYkVIlEv0f92CyOI zSKgJTH70ikmEJtNQEVi5puNbCC2iICmxOy21WBxZgEbiQkPFoANFRZIkJj9D2Izp4CVxLqL /WBxXgFHiTcr7kPNt5R4svgmmC0qoCOxev8UFogaQYmTM5+wQMy0lPi39hfrBEbBWUhSs5Ck FjAyrWKUTcmt0s1NzMwpTk3WLU5OzMtLLdI10svNLNFLTSndxAgKU05J3h2M7w4qHWIU4GBU 4uFlyPcNEmJNLCuuzD3EKMnBpCTKm98LFOJLyk+pzEgszogvKs1JLT7EKMHBrCTCy1YFlONN SaysSi3Kh0lJc7AoifPe5LAPEhJITyxJzU5NLUgtgsnKcHAoSfDyA+NRSLAoNT21Ii0zpwQh zcTBCTKcB2j4u36Q4cUFibnFmekQ+VOMilLivBogzQIgiYzSPLheWBp5xSgO9Iow7x+Qdh5g CoLrfgU0mAlocJQE2OCSRISUVANjStRkqWpjqfDzW90NTdW3SF66c6U0bVfW3Rdbp574sI01 ab7uw19L0o9WcNrGWa+sWXDYzHGL1U638gzVM20ZlgFbj1ntV/D9ueRD2aJ3649wm31uLn92 6P7bx0s/Rl5vfc3aaVJxa9ZiYaW1u55nC06MmXNNUfbC/aorKo+nL/8tEBB9IV+YR4mlOCPR UIu5qDgRAK7kkx7+AgAA Cc: svn-doc-projects@freebsd.org, doc-committers@freebsd.org X-BeenThere: svn-doc-projects@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for doc projects trees List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 03 Oct 2013 15:44:44 -0000 On Wed, 2 Oct 2013, Benedict Reuschling wrote: > Author: bcr > Date: Wed Oct 2 21:00:07 2013 > New Revision: 42810 > URL: http://svnweb.freebsd.org/changeset/doc/42810 > > Log: > Add a section on deduplication. This needs some more work and warnings about > huge memory requirements for the DDT. But the basic instructions are there on > how to activate it, along with an example that shows the dedup ratio and > a simulation run with zdb. > > Modified: projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml > ============================================================================== > --- projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Wed Oct 2 20:02:02 2013 (r42809) > +++ projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Wed Oct 2 21:00:07 2013 (r42810) > + > + The DEDUP column shows the actual rate > + of deduplication for that pool. A value of > + 1.00x that no data has been deduplicated > + due to insufficient duplicate data. In the following example, > + the ports tree is copied three times into different > + directories on the deduplicated pool above to provide > + redundancy. I'm not sure that this is the best way to talk about an example use-case where deduplication would come into play. If the user actually wants redundancy (that is, to ensure that there is a reliable/correct copy of the ports tree around in the event of hardware issues), deduplication is not the right tool, 'zfs set -o copies=3' would be more appropriate. The whole point of the deduplication is that there is only one actual copy on disk. It would probably be a better example to talk about copying the ports tree three different times for testing different configurations or something like that. -Ben > + &prompt.root; zpool list > +for d in dir1 dir2 dir3; do > +for> mkdir $d && cp -R /usr/ports $d & > +for> done > + > + Now that redundant data has been created, ZFS detects that > + and makes sure that the data is not taking up additional > + space.