From owner-freebsd-doc@FreeBSD.ORG Sun Nov 20 03:17:14 2011 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id B4A6B106566B; Sun, 20 Nov 2011 03:17:14 +0000 (UTC) (envelope-from jotawski@gmail.com) Received: from mail-bw0-f54.google.com (mail-bw0-f54.google.com [209.85.214.54]) by mx1.freebsd.org (Postfix) with ESMTP id DA8118FC15; Sun, 20 Nov 2011 03:17:13 +0000 (UTC) Received: by bkbzs8 with SMTP id zs8so6817834bkb.13 for ; Sat, 19 Nov 2011 19:17:12 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type; bh=0Lft5aroG4G8xJetvS+slMKHY9EYd1J1ag396FFURGo=; b=jvzuhxg7huroR9SRKj9n2j3FTHPmz2D0BD5VAQnYB+eyKlHPkKmvTBdYDIjPCut0k2 LW2HbbUho7cNOl2HZPoiiz8WO8/7V4Cw/UL14k/Z78rQbchrZVLrhgyBFbYttM9OJIkz qJXp5O1c7yoU8tMu+ZFWEh1dkqAR7SgftVcWk= MIME-Version: 1.0 Received: by 10.205.135.129 with SMTP id ig1mr9211034bkc.106.1321759022664; Sat, 19 Nov 2011 19:17:02 -0800 (PST) Received: by 10.205.123.140 with HTTP; Sat, 19 Nov 2011 19:17:02 -0800 (PST) In-Reply-To: <20111120.085346.193783891.ryusuke@jp.FreeBSD.org> References: <4EB716A4.2020600@FreeBSD.org> <20111120.085346.193783891.ryusuke@jp.FreeBSD.org> Date: Sun, 20 Nov 2011 10:17:02 +0700 Message-ID: From: Mniyardfa Jotawski To: Ryusuke SUZUKI Content-Type: text/plain; charset=UTF-8 X-Content-Filtered-By: Mailman/MimeDel 2.1.5 Cc: freebsd-doc@freebsd.org, Doug Barton Subject: Re: handbook translation X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 20 Nov 2011 03:17:14 -0000 On Sun, Nov 20, 2011 at 6:53 AM, Ryusuke SUZUKI wrote: > Hi, > > Did you understand how to set up CVSup for translating the FreeBSD > handbook? > > Hi, I did these 1) cvsup to the most fastest cvsup site nearest to my country with cvs-supfile supplied with OS and put them to /kaitag/ncvs, (prefix), and regularly cvsup from time to time. 2) at my home directory, I set up cvsupd and check out from the above repository. I follow http://www.cvsup.org/faq.html in setting up cvsupd at my home and put all doc set from the above repository into ~/doc 3) import ~/doc to ~Repository-${USER}, and checked them out for doing translation with mkdir -p ~/doc cd ~/doc setenv CVSROOT ~/Repository-${USER} cvs import doc psr start cd rmdir doc cvs checkout doc and sure ${USER} is motorc cvs-supfile using in 1) above is as follow *default host=CHANGE_THIS.FreeBSD.org *default base=/kaitag/db *default prefix=/kaitag/ncvs *default release=cvs *default delete use-rel-suffix *default compress src-all ports-all doc-all www projects-all cvsroot-all of course I replace CHANGE_THIS to whatever fastest_cvsup gave me. and a supfile for using in 2) is *default host=localhost *default prefix=/home/motorc *default base=/home/motorc/db *default release=cvs tag=. *default delete use-rel-suffix *default compress doc and list files for cvsupd for using with 2) above are motorc@[dell] ~/base/sup/doc> ll total 4 -rw-r--r-- 1 motorc motorc 13 Nov 15 06:48 list.cvs -rw-r--r-- 1 motorc motorc 38 Nov 14 07:26 releases motorc@[dell] ~/base/sup/doc> the contents of each file, single line for each, are motorc@[dell] ~/base/sup/doc> cat list.cvs upgrade doc motorc@[dell] ~/base/sup/doc> cat releases cvs list=list.cvs prefix=/kaitag/ncvs I started cvsupd with cvsupd -b /home/motorc/base and I retrieve doc set from 1) above via this well known command cvsup -g -L 2 supfile I have written this to my blog, http://makham.blogspot.com/2011/11/fdp-cvsup.html , but in thai and hoping that some thai will be helping me. I am now translating ~/doc/en_US.ISO8859-1/books/handbook/book.sgml. Many thanks indeed for your times and apologized me for my bad english. > Ryusuke > > From: Mniyardfa Jotawski > Subject: Re: handbook translation > Date: Wed, 9 Nov 2011 12:47:44 +0700 > > > hi sirs, > > > > > > On Mon, Nov 7, 2011 at 6:22 AM, Doug Barton wrote: > > > > > On 11/05/2011 17:55, Mniyardfa Jotawski wrote: > > > > Hi sirs, > > > > > > > > > > > > I would like to know if I wanted to translate FreeBSD handbook from > > > English > > > > into Thai, do I need to translate a file > > > > /usr/doc/en_US.ISO8859-1/book.sgml ? > > > > > > You're going to want to read > > > http://www.freebsd.org/doc/en/books/fdp-primer/, particularly the > > > chapter on translations. Good luck. :) > > > > > > > > I am reading > > > http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/overview-before.htmland > > have a question about 'using > > *CVSup* to download just a *checked-out* copy' in that chapter. Does > that > > mean some thing similar to the following command > > > > # cvsup -g -L 2 -h > cvsup2.jp.freebsd.org/usr/share/examples/cvsup/doc-supfile > > > > Actually, I know how to setup CVSROOT, check-in, check-out from my local > > reporsitory. > > > > Would you please clarify my understanding about the text in the manual > > above ? > > > > Many thanks in advance for any hints and helps. > > > > > > > Doug > > > > > > -- > > > > > > "We could put the whole Internet into a book." > > > "Too practical." > > > > > > Breadth of IT experience, and depth of knowledge in the DNS. > > > Yours for the right price. :) http://SupersetSolutions.com/ > > > > > > > > > > with best regards, > > psr > > _______________________________________________ > > freebsd-doc@freebsd.org mailing list > > http://lists.freebsd.org/mailman/listinfo/freebsd-doc > > To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org" > with best regards, psr From owner-freebsd-doc@FreeBSD.ORG Sun Nov 20 19:40:10 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 08BC31065673 for ; Sun, 20 Nov 2011 19:40:09 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id CE09E8FC16 for ; Sun, 20 Nov 2011 19:40:09 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id pAKJe9nc055887 for ; Sun, 20 Nov 2011 19:40:09 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id pAKJe9N5055886; Sun, 20 Nov 2011 19:40:09 GMT (envelope-from gnats) Resent-Date: Sun, 20 Nov 2011 19:40:09 GMT Resent-Message-Id: <201111201940.pAKJe9N5055886@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Chris Rees Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 599C91065670 for ; Sun, 20 Nov 2011 19:35:54 +0000 (UTC) (envelope-from crees@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id EE9678FC0C for ; Sun, 20 Nov 2011 19:35:53 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id pAKJZrIs055601 for ; Sun, 20 Nov 2011 19:35:53 GMT (envelope-from crees@freefall.freebsd.org) Received: (from crees@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id pAKJZroO055600; Sun, 20 Nov 2011 19:35:53 GMT (envelope-from crees) Message-Id: <201111201935.pAKJZroO055600@freefall.freebsd.org> Date: Sun, 20 Nov 2011 19:35:53 GMT From: Chris Rees To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/162699: Handbook/Upgrading instructions: should mention delete-old in order X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Chris Rees List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 20 Nov 2011 19:40:10 -0000 >Number: 162699 >Category: docs >Synopsis: Handbook/Upgrading instructions: should mention delete-old in order >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sun Nov 20 19:40:09 UTC 2011 >Closed-Date: >Last-Modified: >Originator: Chris Rees >Release: FreeBSD 8.2-STABLE i386 >Organization: >Environment: System: FreeBSD freefall.freebsd.org 8.2-STABLE FreeBSD 8.2-STABLE #4 r220774: Mon Apr 18 13:56:14 UTC 2011 simon@freefall.freebsd.org:/usr/obj/usr/src/sys/FREEFALL i386 >Description: [1] describes a case where the system has been upgraded wrongly, presumably because the Handbook doesn't make it clear how important the make delete-old stages are, although they are documented in src/Makefile. The attached moves the section on make delete-old and delete-old-libs into the main upgrading section, and adds the steps to the instructions. Rendered at: http://www.bayofrum.net/~crees/rendered/makeworld.html [1] http://www.freebsd.org/cgi/cvsweb.cgi/ports/shells/zsh/files/patch-Src_watch.c >How-To-Repeat: >Fix: I understand it's usually better practice to make two diffs; one moving the section and the other with the content changes; I'm happy to provide those if the change is OK. --- makeworld.diff begins here --- Index: cutting-edge/chapter.sgml =================================================================== RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml,v retrieving revision 1.255 diff -u -r1.255 chapter.sgml --- cutting-edge/chapter.sgml 23 Aug 2011 18:40:43 -0000 1.255 +++ cutting-edge/chapter.sgml 20 Nov 2011 19:29:07 -0000 @@ -1967,6 +1967,16 @@ + make delete-old + + This target deletes old (obsolete) files. This is important + because sometimes they cause problems if left on the disk, for + example the presence of the old utmp.h causes + problems in some ports when the new + utmpx.h is installed. + + + mergemaster Now you can update the remaining configuration files, since @@ -1979,6 +1989,14 @@ A full machine reboot is needed now to load the new kernel and new world with new configuration files. + + + make delete-old-libs + + Remove any obsolete libraries to avoid conflicts with newer + ones. Make sure that all ports have been rebuilt to use the new + libraries before you delete the old ones. + Note that if you're upgrading from one release of the same &os; @@ -2034,8 +2052,10 @@ &prompt.root; mergemaster -p &prompt.root; cd /usr/src &prompt.root; make installworld +&prompt.root; make delete-old &prompt.root; mergemaster -&prompt.root; reboot +&prompt.root; reboot +&prompt.root; make delete-old-libs Read Further Explanations @@ -2471,6 +2491,70 @@ + + + + + Anton + Shterenlikht + Based on notes provided by + + + + + Deleting obsolete files and directories + + + Deleting obsolete files and directories + + + As a part of the &os; development lifecycle, it happens from time + to time that files and their contents become obsolete. This may be + because their functionality is implemented elsewhere, the version number + of the library has changed or it was removed from the system entirely. + This includes old files, libraries and directories, which should + be removed when updating the system. The benefit for the user is that + the system is not cluttered with old files which take up unnecessary + space on the storage (and backup) medium. Additionally, if the old + library had a security or stability issue, you should update to the + newer library to keep your system safe and prevent crashes caused by + the old library implementation. The files, directories, and libraries + that are considered obsolete are listed in + /usr/src/ObsoleteFiles.inc. The following + instructions will help you removing these obsolete files during the + system upgrade process. + + After the make + installworld and the subsequent + mergemaster commands have finished successfully, you + should check for obsolete files and libraries as follows: + + &prompt.root; cd /usr/src +&prompt.root; make check-old + + If any obsolete files are found, they can be deleted using the + following commands: + + &prompt.root; make delete-old + + + See /usr/src/Makefile + for more targets of interest. + + + A prompt is displayed before deleting each obsolete file. You can + skip the prompt and let the system remove these files automatically by + using the BATCH_DELETE_OLD_FILES make-variable as + follows: + + &prompt.root; make -DBATCH_DELETE_OLD_FILES delete-old + + You can also achieve the same goal by piping these commands through + yes like this: + + &prompt.root; yes|make delete-old + + Update Files Not Updated by <command>make installworld</command> @@ -2725,13 +2809,56 @@ Rebooting - You are now done. After you have verified that everything appears - to be in the right place you can reboot the system. A simple + You are now almost done. After you have verified that everything + appears to be in the right place you can reboot the system. A simple &man.shutdown.8; should do it: &prompt.root; shutdown -r now + + Deleting obsolete libraries + + + Warning + + Deleting obsolete files will break applications that still + depend on those obsolete files. This is especially true for old + libraries. In most cases, you need to recompile the programs, ports, + or libraries that used the old library before make + delete-old-libs is executed. + + + Utilities for checking shared library dependencies are available + from the Ports Collection in sysutils/libchk or sysutils/bsdadminscripts. + + Obsolete shared libraries can conflict with newer libraries, + causing messages like these: + + /usr/bin/ld: warning: libz.so.4, needed by /usr/local/lib/libtiff.so, may conflict with libz.so.5 +/usr/bin/ld: warning: librpcsvc.so.4, needed by /usr/local/lib/libXext.so, may conflict with librpcsvc.so.5 + + To solve these problems, determine which port installed the + library: + + &prompt.root; pkg_info -W /usr/local/lib/libtiff.so + /usr/local/lib/libtiff.so was installed by package tiff-3.9.4 + &prompt.root; pkg_info -W /usr/local/lib/libXext.so + /usr/local/lib/libXext.so was installed by package libXext-1.1.1,1 + + Then deinstall, rebuild and reinstall the port. The ports-mgmt/portmaster and ports-mgmt/portupgrade utilities can be used + to automate this process. After you've made sure that all ports are + rebuilt and do not use the old libraries anymore, you can delete them + using the + following command: + + &prompt.root; make delete-old-libs + + Finished @@ -3020,106 +3147,6 @@ - - - - - Anton - Shterenlikht - Based on notes provided by - - - - Deleting obsolete files, directories and libraries - - Deleting obsolete files, directories and libraries - - - As a part of the &os; development lifecycle, it happens from time - to time that files and their contents become obsolete. This may be - because their functionality is implemented elsewhere, the version number - of the library has changed or it was removed from the system entirely. - This includes old files, libraries and directories, which should - be removed when updating the system. The benefit for the user is that - the system is not cluttered with old files which take up unnecessary - space on the storage (and backup) medium. Additionally, if the old - library had a security or stability issue, you should update to the - newer library to keep your system safe and prevent crashes caused by - the old library implementation. The files, directories, and libraries - that are considered obsolete are listed in - /usr/src/ObsoleteFiles.inc. The following - instructions will help you removing these obsolete files during the - system upgrade process. - - We assume you are following the steps outlined in . After the make - installworld and the subsequent - mergemaster commands have finished successfully, you - should check for obsolete files and libraries as follows: - - &prompt.root; cd /usr/src -&prompt.root; make check-old - - If any obsolete files are found, they can be deleted using the - following commands: - - &prompt.root; make delete-old - - - See /usr/src/Makefile - for more targets of interest. - - - A prompt is displayed before deleting each obsolete file. You can - skip the prompt and let the system remove these files automatically by - using the BATCH_DELETE_OLD_FILES make-variable as - follows: - - &prompt.root; make -DBATCH_DELETE_OLD_FILES delete-old - - You can also achieve the same goal by piping these commands through - yes like this: - - &prompt.root; yes|make delete-old - - - Warning - Deleting obsolete files will break applications that still - depend on those obsolete files. This is especially true for old - libraries. In most cases, you need to recompile the programs, ports, - or libraries that used the old library before make - delete-old-libs is executed. - - - Utilities for checking shared library dependencies are available from - the Ports Collection in sysutils/libchk or sysutils/bsdadminscripts. - - Obsolete shared libraries can conflict with newer libraries, - causing messages like these: - - /usr/bin/ld: warning: libz.so.4, needed by /usr/local/lib/libtiff.so, may conflict with libz.so.5 -/usr/bin/ld: warning: librpcsvc.so.4, needed by /usr/local/lib/libXext.so, may conflict with librpcsvc.so.5 - - To solve these problems, determine which port installed the - library: - - &prompt.root; pkg_info -W /usr/local/lib/libtiff.so -/usr/local/lib/libtiff.so was installed by package tiff-3.9.4 -&prompt.root; pkg_info -W /usr/local/lib/libXext.so -/usr/local/lib/libXext.so was installed by package libXext-1.1.1,1 - - Then deinstall, rebuild and reinstall the port. The ports-mgmt/portmaster and ports-mgmt/portupgrade utilities can be used to - automate this process. After you've made sure that all ports are rebuilt - and do not use the old libraries anymore, you can delete them using the - following command: - - &prompt.root; make delete-old-libs - - --- makeworld.diff ends here --- >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Mon Nov 21 06:40:13 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 7DFC4106566B for ; Mon, 21 Nov 2011 06:40:13 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 6D5648FC0C for ; Mon, 21 Nov 2011 06:40:13 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id pAL6eDq4073133 for ; Mon, 21 Nov 2011 06:40:13 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id pAL6eDEc073132; Mon, 21 Nov 2011 06:40:13 GMT (envelope-from gnats) Date: Mon, 21 Nov 2011 06:40:13 GMT Message-Id: <201111210640.pAL6eDEc073132@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Benjamin Kaduk Cc: Subject: Re: docs/162699: Handbook/Upgrading instructions: should mention delete-old in order X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Benjamin Kaduk List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 21 Nov 2011 06:40:13 -0000 The following reply was made to PR docs/162699; it has been noted by GNATS. From: Benjamin Kaduk To: Chris Rees Cc: FreeBSD-gnats-submit@freebsd.org Subject: Re: docs/162699: Handbook/Upgrading instructions: should mention delete-old in order Date: Mon, 21 Nov 2011 01:36:45 -0500 (EST) On Sun, 20 Nov 2011, Chris Rees wrote: > I understand it's usually better practice to make two diffs; one moving > the section and the other with the content changes; I'm happy to provide those > if the change is OK. A smaller diff with just the content changes is easier to review. That said, a quick once-over on the full diff seems okay. Thanks for putting it together. -Ben Kaduk From owner-freebsd-doc@FreeBSD.ORG Mon Nov 21 10:00:32 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 9D112106566B for ; Mon, 21 Nov 2011 10:00:32 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 8C6B38FC16 for ; Mon, 21 Nov 2011 10:00:32 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id pALA0WnU086122 for ; Mon, 21 Nov 2011 10:00:32 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id pALA0Wd0086119; Mon, 21 Nov 2011 10:00:32 GMT (envelope-from gnats) Date: Mon, 21 Nov 2011 10:00:32 GMT Message-Id: <201111211000.pALA0Wd0086119@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Chris Rees Cc: Subject: Re: docs/162699: Handbook/Upgrading instructions: should mention delete-old in order X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Chris Rees List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 21 Nov 2011 10:00:32 -0000 The following reply was made to PR docs/162699; it has been noted by GNATS. From: Chris Rees To: Benjamin Kaduk , bug-followup@freebsd.org Cc: Subject: Re: docs/162699: Handbook/Upgrading instructions: should mention delete-old in order Date: Mon, 21 Nov 2011 09:58:10 +0000 On 21 November 2011 06:36, Benjamin Kaduk wrote: > On Sun, 20 Nov 2011, Chris Rees wrote: > >> =A0 =A0 =A0 =A0I understand it's usually better practice to make two dif= fs; one >> moving >> the section and the other with the content changes; I'm happy to provide >> those >> if the change is OK. > > A smaller diff with just the content changes is easier to review. > > That said, a quick once-over on the full diff seems okay. =A0Thanks for > putting it together. Yeah, I'll make another diff then when I get back home. Should be a few ho= urs. Thanks for the review. Chris From owner-freebsd-doc@FreeBSD.ORG Mon Nov 21 11:06:08 2011 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 440F2106567A for ; Mon, 21 Nov 2011 11:06:08 +0000 (UTC) (envelope-from owner-bugmaster@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 325248FC17 for ; Mon, 21 Nov 2011 11:06:08 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id pALB68xt052777 for ; Mon, 21 Nov 2011 11:06:08 GMT (envelope-from owner-bugmaster@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id pALB67Zb052773 for freebsd-doc@FreeBSD.org; Mon, 21 Nov 2011 11:06:07 GMT (envelope-from owner-bugmaster@FreeBSD.org) Date: Mon, 21 Nov 2011 11:06:07 GMT Message-Id: <201111211106.pALB67Zb052773@freefall.freebsd.org> X-Authentication-Warning: freefall.freebsd.org: gnats set sender to owner-bugmaster@FreeBSD.org using -f From: FreeBSD bugmaster To: FreeBSD doc list Cc: Subject: Current unassigned doc problem reports X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 21 Nov 2011 11:06:08 -0000 (Note: an HTML version of this report is available at http://www.freebsd.org/cgi/query-pr-summary.cgi?category=doc .) The following is a listing of current problems submitted by FreeBSD users. These represent problem reports covering all versions including experimental development code and obsolete releases. S Tracker Resp. Description -------------------------------------------------------------------------------- o docs/162699 doc Handbook/Upgrading instructions: should mention delete o docs/162494 doc books/porters-handbook,handbook: follow deprecatation o docs/162433 doc [handbook] QEMU instructions for FreeBSD guests o docs/162419 doc [request] please document (new) zfs and zpool cmdline o docs/162404 doc [handbook] IPv6 link-local address compared with IPv4 o docs/162380 doc Documentation lacking for getfacl/setfacl o docs/162354 doc Improve wording in rc.conf(5) regarding network-interf o docs/162343 doc typo in kdc(8) man page p docs/162265 doc [Patch] ipfw.8: Documentation clarity o docs/162172 doc rctl manpage erroneously lists nproc a docs/161808 doc Missing documentation critical to correct usage of uui o docs/161804 doc New documentation: French translation for building-pro o docs/161754 doc-bugs p4tcc(4), est(4) and qpi(4) are not documented o docs/161588 doc Missing "-l name" option from pw(8) USER section o docs/161496 doc zfs(1): Please document that sysctl vfs.usermount must o docs/161057 doc [handbook] Error in section 18.17.4 of the handbook o docs/160698 doc Remove outdated FreeBSD Jumpstart guide o docs/160491 doc [patch] reaper of the dead: remove ancient FAQ entries o docs/160460 doc [handbook] Network setup guide suggestion o docs/160447 doc [handbook] Developer's Handbook contains some outdated o docs/160446 doc [handbook] Handbook sound setup seems outdated o docs/160445 doc [handbook] Handbook does not mention ACL o docs/160399 doc Man page for re(4) missing jumbo frames info o docs/160269 doc [patch] Handbook wireless section: sand off some rough o docs/159898 doc [patch] libusb.3 whitespace, markup, grammar fixes o docs/159897 doc [handbook] [patch] improve HAST section of Handbook o docs/159854 doc [patch] grammar updates for carp.4 o docs/159551 doc [patch] ports(7) makes no mention of LOCALBASE o docs/159307 doc [patch] lpd smm chapter unconditionally installed o docs/159298 doc [handbook] document Konqueror with Webkit support to i o docs/158813 doc [patch] grammar updates for jme(4) o docs/158388 doc Incorrect documentation of LOCAL_SCRIPT in release(7) o docs/158387 doc The tree(3) man should mention the RB_FOREACH_SAFE() A o docs/158378 doc cpio/bsdcpio(1) man page does not document -0 and --nu o docs/157908 doc [handbook] Description of post-install should include o docs/157698 doc [patch] gpart(8) man page contains old/incorrect size o docs/157453 doc [patch] document 16-fib cap in setfib.2 o docs/157452 doc [patch] grammar and style nits in ipfw.8 o docs/157337 doc [handbook] [patch] Indentation changes to network serv o docs/157316 doc [patch] update devstat(9) man page o docs/157234 doc [patch] nullfs(5): //proc/curproc/file returns "unknow o docs/157049 doc FreeBSD Handbook: Chapter 14 (Security) Inaccuracy o docs/156955 doc bug in share/man/man2/setsockopt.2 a docs/156920 doc isspecial(3) is not helpful o docs/156815 doc chmod(1): manpage should describe that chmod kicks +t o docs/156689 doc stf(4) output-only documentation gives bad configurati f docs/156187 doc [handbook] [patch] Add bsnmpd to handbook o docs/156081 doc troff falls with troff.core with UTF-8 man with incorr o docs/155989 doc [patch] Fix offset in boot.config(5) o docs/155982 doc [handbook] reaper of the dead: remove reference to flo o docs/155773 doc dialog(1): dialog manpages not updated o docs/155149 doc [patch] don't encourage using xorg.conf outside of PRE o docs/154838 doc update cvs-tags information on releng_* to reflect sup o docs/153958 doc ksu man-page documented, but not installed o docs/153738 doc [patch] Docuement requirement to alter some sysctls wh a docs/153012 doc [patch] iostat(8) requires an argument to -c option o docs/151752 doc pw.conf(5) doesn't define format for file clearly o docs/150991 doc [patch] Install upgtfw using pkg_add as advised in upg o docs/150917 doc [patch] icmp.4, wrong description of icmplim and icmpl o docs/150877 doc ambiguity in newsyslog(8) man page about zfs with comp o docs/150365 doc [make.conf] [patch] remove BDECFLAGS from make.conf(5) o docs/150255 doc dtrace description should mention makeoptions DEBUG=-g o docs/150219 doc zfs(8) manual page misses jail/unjail o docs/149574 doc [patch] update mi_switch(9) man page o docs/149522 doc Russian network article: incorrect translation about n o docs/149051 doc [request] No document for clang or clang++ o docs/149047 doc [patch] tcsh(1) bears no mention of brace expansion in o docs/148987 doc [patch] {MD[245]|SHA_|SHA1_|SHA256_}{End|File|FileChun o docs/148984 doc [handbook] Mistake in section 16.15.4 of the handbook o docs/148680 doc [sysctl][patch] Document some sys/kern sysctls o docs/148071 doc Failover mode between wired and wireless interfaces o docs/147995 doc elf.5 man page has has missing reference o docs/146958 doc bad link to "XaQti XMAC II datasheet" in sk(4) manual o docs/146521 doc [handbook] Update IPv6 system handbook section to ment o docs/145719 doc [patch] 7.3 relnotes erroneously describes new getpage o docs/145699 doc hexdump(1) mutes all format qualifier output following o docs/145644 doc Add artical about creating manpage from scratch o docs/145069 doc Dialup firewalling with FreeBSD article out dated. o docs/145066 doc Update for new uart dev names for serial port. s docs/144818 doc all mailinglist archives dated 19970101 contain traili o docs/144630 doc [patch] domainname(1) manpage contains old information o docs/144537 doc Missing _mdconfig_list and _mdconfig2_list explanation o docs/144515 doc [handbook] Expand handbook Table of contents o docs/144488 doc share/examples/etc/make.conf: contains dangerous examp o docs/143850 doc procfs(5) manpage for status > controlling terminal is o docs/143416 doc [handbook] IPFW handbook page issues o docs/143408 doc man filedesc(9) is missing o docs/142168 doc [patch] ld(1): ldd(1) not mentioned in ld(1) manpage o docs/141032 doc misleading documentation for rtadvd.conf(5) raflags se s docs/140847 doc [request] add documentation on ECMP and new route args p docs/140457 doc [patch] Grammar fix for isspace(3) o docs/140444 doc [patch] New Traditional Chinese translation of custom- o docs/140375 doc [UPDATE] Updated zh_TW.Big5/articles/nanobsd o docs/139336 doc [request] ZFS documentation suggestion o docs/139165 doc gssapi.3 man page out of sync with between crypto and o docs/139018 doc translation of submitting.sgml from docproj/submitting o docs/138845 doc Exceeding kern.ipc.maxpipekva refers to tuning(7) whic o docs/138663 doc system(3) man page confuses users about "return value o docs/138485 doc bpf(4) and ip(4) man pages missing important corner ca o docs/136712 doc [handbook] [patch] draft new section on gmirror per pa o docs/136666 doc [handbook] Configure serial port for remote kernel deb o docs/136035 doc ftpchroot(5) omits an important option o docs/135516 doc [patch] pax(1) manual not mentioning chflags unawarene o docs/135475 doc [patch] jot(1) manpage and behaviour differ o docs/134123 doc The RUNQUEUE(9) man page is out of date o docs/132839 doc [patch] Fix example script in ldap-auth article o docs/132718 doc [handbook] Information about adding a new mirror is ou o docs/132260 doc dhcpd(8) pid not stored in documented location o docs/132190 doc EPERM explanation for send(2), sendto(2), and sendmsg( o docs/131918 doc [patch] Fixes for the BPF(4) man page o docs/131626 doc [patch] dump(8) "recommended" cache option confusing o docs/130238 doc nfs.lockd man page doesn't mention NFSLOCKD option or o docs/129671 doc New TCP chapter for Developer's Handbook (from rwatson o docs/129464 doc using packages system o docs/129095 doc ipfw(8): Can not check that packet originating/destine s docs/128356 doc [request] add Firefox plugin for FreeBSD manual pages o docs/127908 doc [patch] readdir(3) error documentation s docs/127844 doc Example code skeleton_capture_n.c in meteor(4) manpage o docs/126590 doc [patch] Write routine called forever in Sample Echo Ps o docs/126484 doc libc function res-zonscut2 is not documented o docs/125921 doc lpd(8) talks about blocks in minfree while it is KB in f docs/122052 doc minor update on handbook section 20.7.1 o docs/121952 doc Handbook chapter on Network Address Translation wrong o docs/121585 doc [handbook] Wrong multicast specification s docs/121541 doc [request] no man pages for wlan_scan_ap o docs/121312 doc RELNOTES_LANG breaks release if not en_US.ISO8859-1 o docs/121173 doc [patch] mq_getattr(2): mq_flags mistakenly described a s docs/120917 doc [request]: Man pages mising for thr_xxx syscalls o docs/120539 doc Inconsistent ipfw's man page o docs/120125 doc [patch] Installing FreeBSD 7.0 via serial console and o docs/120024 doc resolver(5) and hosts(5) need updated for IPv6 o docs/119545 doc books/arch-handbook/usb/chapter.sgml formatting o docs/118902 doc [patch] wrong signatures in d2i_RSAPublicKey man pages o docs/118214 doc close(2) error returns incomplete o docs/118020 doc ipfilter(4): man pages query for man 4 ipfilter return o docs/116116 doc mktemp (3) re/move note o docs/116080 doc PREFIX is documented, but not the more important LOCAL p docs/115065 doc [patch] sync ps.1 with p_flag and keywords o docs/114371 doc [patch] [ip6] rtadvd.con(5) should show how to adverti o docs/114139 doc mbuf(9) has misleading comments on M_DONTWAIT and M_TR o docs/113194 doc [patch] [request] crontab.5: handling of day-in-month o docs/112804 doc groff(1) command should be called to explicitly use "p o docs/112682 doc Handbook GEOM_GPT explanation does not provide accurat o docs/111425 doc Missing chunks of text in historical manpages o docs/111265 doc [request] Clarify how to set common shell variables o docs/111147 doc hostapd.conf is not documented o docs/110999 doc carp(4) should document unsupported interface types o docs/110692 doc wi(4) man page doesn't say WPA is not supported o docs/110376 doc [patch] add some more explanations for the iwi/ipw fir o docs/110253 doc [patch] rtprio(1): remove processing starvation commen o docs/110062 doc [patch] mount_nfs(8) fails to mention a failure condit p docs/110061 doc [patch] tuning(7) missing reference to vfs.read_max o docs/109981 doc No manual entry for post-grohtml o docs/109977 doc No manual entry for ksu o docs/109973 doc No manual entry for c++filt o docs/109972 doc No manual entry for zless/bzless f docs/109226 doc [request] No manual entry for sntp o docs/109201 doc [request]: manual for callbootd a docs/108980 doc list of missing man pages o docs/106135 doc [request] articles/vinum needs to be updated o docs/105608 doc fdc(4) debugging description staled o docs/104879 doc Howto: Listen to IMA ADPCM .wav files on FreeBSD box o docs/102719 doc [patch] ng_bpf(4) example leads to unneeded promiscuos o docs/100196 doc man login.conf does explain not "unlimited" o docs/99506 doc FreeBSD Handbook addition: IPv6 Server Settings o docs/98974 doc Missing tunables in loader(8) manpage o docs/98115 doc Missing parts after rendering handbook to RTF format o docs/96207 doc Comments of a sockaddr_un structure could confuse one o docs/94625 doc [patch] growfs man page -- document "panic: not enough o docs/92626 doc jail manpage should mention disabling some periodic sc o docs/91506 doc ndis(4) man page should be more specific about support o docs/91149 doc read(2) can return EINVAL for unaligned access to bloc o docs/88512 doc [patch] mount_ext2fs(8) man page has no details on lar o docs/87936 doc Handbook chapter on NIS/YP lacks good information on a o docs/87857 doc ifconfig(8) wireless options order matters o docs/85128 doc [patch] loader.conf(5) autoboot_delay incompletly desc o docs/84956 doc [patch] intro(5) manpage doesn't mention API coverage o docs/84932 doc new document: printing with an Epson ALC-3000N on Free o docs/84670 doc [patch] tput(1) manpage missing ENVIRONMENT section wi o docs/84317 doc fdp-primer doesn't show class=USERNAME distinctively o docs/84271 doc [patch] compress(1) doesn't warn about nasty link hand o docs/83820 doc getino(3) manpage not installed o docs/81611 doc [patch] natd runs with -same_ports by default o docs/78480 doc Networked printer setup unnecessarily complex in handb o docs/61605 doc [request] Improve documentation for i386 disk geometry o docs/61301 doc [patch] Manpage patch for aue(4) to enable HomePNA fun o docs/59835 doc ipfw(8) man page does not warn about accepted but mean o docs/59477 doc Outdated Info Documents at http://docs.freebsd.org/inf o docs/59044 doc [patch] doc.docbook.mk does not properly handle a sour o docs/57298 doc [patch] add using compact flash cards info to handbook s docs/54752 doc bus_dma explained in ISA section in Handbook: should b o docs/53751 doc bus_dma(9) incorrectly documents BUS_DMA_ALLOCNOW o docs/53596 doc Updates to mt(1) manual page o docs/53271 doc bus_dma(9) fails to document alignment restrictions o docs/51480 doc Multiple undefined references in the FreeBSD manual pa o docs/50211 doc [patch] doc.docbook.mk: fix textfile creation o docs/48101 doc [patch] Add documentation on the fixit disk o docs/43823 doc [patch] update to environ(7) manpage o docs/41089 doc pax(1) -B option does not mention interaction with -z o docs/40423 doc Keyboard(4)'s definition of parameters to GETFKEY/SETF o docs/38982 doc [patch] developers-handbook/Jail fix o docs/38556 doc EPS file of beastie, as addition to existing examples s docs/35678 doc docproj Makefiles for web are broken for paths with sp s docs/33589 doc [patch] to doc.docbook.mk to post process .tex files. a docs/30008 doc [patch] French softupdates document should be translat o docs/27605 doc [patch] Cross-document references () o docs/26286 doc *printf(3) etc should gain format string warnings o docs/24786 doc missing FILES descriptions in sa(4) s docs/20028 doc ASCII docs should reflect tags in the sourc 209 problems total. From owner-freebsd-doc@FreeBSD.ORG Mon Nov 21 13:40:10 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 4A489106566B for ; Mon, 21 Nov 2011 13:40:10 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id C98708FC13 for ; Mon, 21 Nov 2011 13:40:09 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id pALDe9xl098171 for ; Mon, 21 Nov 2011 13:40:09 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id pALDe958098170; Mon, 21 Nov 2011 13:40:09 GMT (envelope-from gnats) Resent-Date: Mon, 21 Nov 2011 13:40:09 GMT Resent-Message-Id: <201111211340.pALDe958098170@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Niclas Zeising Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 2E547106566C for ; Mon, 21 Nov 2011 13:37:56 +0000 (UTC) (envelope-from zeising@daemonic.se) Received: from mail.lysator.liu.se (mail.lysator.liu.se [IPv6:2001:6b0:17:f0a0::3]) by mx1.freebsd.org (Postfix) with ESMTP id 9FD318FC0C for ; Mon, 21 Nov 2011 13:37:54 +0000 (UTC) Received: from mail.lysator.liu.se (localhost [127.0.0.1]) by mail.lysator.liu.se (Postfix) with ESMTP id 260914000E for ; Mon, 21 Nov 2011 14:37:53 +0100 (CET) Received: by mail.lysator.liu.se (Postfix, from userid 1004) id 1AE3840010; Mon, 21 Nov 2011 14:37:53 +0100 (CET) Received: from mx.daemonic.se (mx.daemonic.se [IPv6:2001:470:dca9:0:1::3]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by mail.lysator.liu.se (Postfix) with ESMTPSA id 319964000E for ; Mon, 21 Nov 2011 14:37:48 +0100 (CET) Received: from mailscanner.daemonic.se (mailscanner.daemonic.se [IPv6:2001:470:dca9:0:1::6]) by mx.daemonic.se (Postfix) with ESMTPS id C9479119D3D for ; Mon, 21 Nov 2011 14:37:47 +0100 (CET) Received: from mx.daemonic.se ([IPv6:2001:470:dca9:0:1::3]) (using TLS with cipher CAMELLIA256-SHA) by mailscanner.daemonic.se (mailscanner.daemonic.se [2001:470:dca9:0:1::6]) (amavisd-new, port 10025) with ESMTPS id NP0GV1gqi_R3 for ; Mon, 21 Nov 2011 14:37:42 +0100 (CET) Received: from mail.daemonic.se (mail.daemonic.se [IPv6:2001:470:dca9:0:1::4]) by mx.daemonic.se (Postfix) with ESMTPS id 32EDF119D3C for ; Mon, 21 Nov 2011 14:37:42 +0100 (CET) Received: from tifa.daemonic.se (b-76-220.eduroam.liu.se [130.236.76.220]) by mail.daemonic.se (Postfix) with ESMTPSA id 17F4412B209 for ; Mon, 21 Nov 2011 14:37:41 +0100 (CET) Received: by tifa.daemonic.se (Postfix, from userid 1001) id 512DF3B; Mon, 21 Nov 2011 14:37:41 +0100 (CET) Message-Id: <20111121133741.512DF3B@tifa.daemonic.se> Date: Mon, 21 Nov 2011 14:37:41 +0100 (CET) From: Niclas Zeising To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/162719: [PATCH] add setsockopt to history section of getsockopt.2 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Niclas Zeising List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 21 Nov 2011 13:40:10 -0000 >Number: 162719 >Category: docs >Synopsis: [PATCH] add setsockopt to history section of getsockopt.2 >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Mon Nov 21 13:40:09 UTC 2011 >Closed-Date: >Last-Modified: >Originator: Niclas Zeising >Release: FreeBSD 10.0-CURRENT amd64 >Organization: >Environment: System: FreeBSD tifa.daemonic.se 10.0-CURRENT FreeBSD 10.0-CURRENT #0 r227447: Fri Nov 11 12:08:39 CET 2011 root@tifa.daemonic.se:/usr/obj/usr/src/sys/TIFA amd64 >Description: the getsockopt.2 manual page covers both getsockopt() and setsockopt() but only getsockopt() is mentioned in the history section. # As a side note, this manual should probably have a STANDARDS section as well, but I can not determine if our implementation confirms to POSIX. >How-To-Repeat: >Fix: Attached patch adds setsockopt() to the history. I assume that they were added as a pair at the same time. --- getsockopt.2.diff begins here --- Index: head/lib/libc/sys/getsockopt.2 =================================================================== --- head/lib/libc/sys/getsockopt.2 (revision 227787) +++ head/lib/libc/sys/getsockopt.2 (working copy) @@ -533,7 +533,9 @@ .Sh HISTORY The .Fn getsockopt -system call appeared in +and +.Fn setsockopt +system calls appeared in .Bx 4.2 . .Sh BUGS Several of the socket options should be handled at lower levels of the system. --- getsockopt.2.diff ends here --- >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Mon Nov 21 14:31:13 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 94AED106566C; Mon, 21 Nov 2011 14:31:13 +0000 (UTC) (envelope-from pluknet@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 6CD3D8FC08; Mon, 21 Nov 2011 14:31:13 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id pALEVDrl047760; Mon, 21 Nov 2011 14:31:13 GMT (envelope-from pluknet@freefall.freebsd.org) Received: (from pluknet@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id pALEVD9X047756; Mon, 21 Nov 2011 14:31:13 GMT (envelope-from pluknet) Date: Mon, 21 Nov 2011 14:31:13 GMT Message-Id: <201111211431.pALEVD9X047756@freefall.freebsd.org> To: pluknet@FreeBSD.org, freebsd-doc@FreeBSD.org, pluknet@FreeBSD.org From: pluknet@FreeBSD.org Cc: Subject: Re: docs/162719: [PATCH] add setsockopt to history section of getsockopt.2 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 21 Nov 2011 14:31:13 -0000 Synopsis: [PATCH] add setsockopt to history section of getsockopt.2 Responsible-Changed-From-To: freebsd-doc->pluknet Responsible-Changed-By: pluknet Responsible-Changed-When: Mon Nov 21 14:30:56 UTC 2011 Responsible-Changed-Why: Take. http://www.freebsd.org/cgi/query-pr.cgi?pr=162719 From owner-freebsd-doc@FreeBSD.ORG Mon Nov 21 16:30:09 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 7535E1065674 for ; Mon, 21 Nov 2011 16:30:09 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 2FAE88FC1F for ; Mon, 21 Nov 2011 16:30:09 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id pALGU9Dq051812 for ; Mon, 21 Nov 2011 16:30:09 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id pALGU97p051811; Mon, 21 Nov 2011 16:30:09 GMT (envelope-from gnats) Resent-Date: Mon, 21 Nov 2011 16:30:09 GMT Resent-Message-Id: <201111211630.pALGU97p051811@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Michael W Lucas Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 5D5E2106564A for ; Mon, 21 Nov 2011 16:20:06 +0000 (UTC) (envelope-from mwlucas@bewilderbeast.blackhelicopters.org) Received: from bewilderbeast.blackhelicopters.org (mwlucas-2-pt.tunnel.tserv9.chi1.ipv6.he.net [IPv6:2001:470:1f10:b9c::2]) by mx1.freebsd.org (Postfix) with ESMTP id 19B148FC1D for ; Mon, 21 Nov 2011 16:20:05 +0000 (UTC) Received: from bewilderbeast.blackhelicopters.org (localhost [127.0.0.1]) by bewilderbeast.blackhelicopters.org (8.14.4/8.14.5) with ESMTP id pALGK38P090926 for ; Mon, 21 Nov 2011 11:20:04 -0500 (EST) (envelope-from mwlucas@bewilderbeast.blackhelicopters.org) Received: (from mwlucas@localhost) by bewilderbeast.blackhelicopters.org (8.14.4/8.14.5/Submit) id pALGK3YQ090925; Mon, 21 Nov 2011 11:20:03 -0500 (EST) (envelope-from mwlucas) Message-Id: <201111211620.pALGK3YQ090925@bewilderbeast.blackhelicopters.org> Date: Mon, 21 Nov 2011 11:20:03 -0500 (EST) From: Michael W Lucas To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/162723: gmirror handbook instructions ate my disk X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Michael W Lucas List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 21 Nov 2011 16:30:09 -0000 >Number: 162723 >Category: docs >Synopsis: gmirror handbook instructions ate my disk >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Mon Nov 21 16:30:08 UTC 2011 >Closed-Date: >Last-Modified: >Originator: Michael W Lucas >Release: FreeBSD 9.0-BETA2 amd64 >Organization: none >Environment: System: FreeBSD bewilderbeast.blackhelicopters.org 9.0-BETA2 FreeBSD 9.0-BETA2 #12: Wed Sep 7 03:29:55 EDT 2011 mwlucas@bewilderbeast.blackhelicopters.org:/usr/obj/usr/src/sys/GENERIC amd64 Installed 9.0-RC1/i386 from CD, built & installed RC2. >Description: Tried to mirror my root drive as per http://www.freebsd.org/doc/handbook/geom-mirror.html System did not recover from reboot, failing with: GEOM: mirror/gm0: corrupt or invalid GPT detected. GEOM: mirror/gm0: GPT rejected -- may not be recoverable Further research shows that this is expected, and is a result of our new GPT overlords >How-To-Repeat: >Fix: Could we get a warning at the top of the page that says "For FreeBSD 8 and earlier. Do not use on FreeBSD 9." ? We need updated docs, yes, but a warning in the directions would reduce user annoyance. >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Mon Nov 21 17:38:54 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 132C7106564A; Mon, 21 Nov 2011 17:38:54 +0000 (UTC) (envelope-from manolis@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id DFADF8FC0A; Mon, 21 Nov 2011 17:38:53 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id pALHcrR1018588; Mon, 21 Nov 2011 17:38:53 GMT (envelope-from manolis@freefall.freebsd.org) Received: (from manolis@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id pALHcrxG018584; Mon, 21 Nov 2011 17:38:53 GMT (envelope-from manolis) Date: Mon, 21 Nov 2011 17:38:53 GMT Message-Id: <201111211738.pALHcrxG018584@freefall.freebsd.org> To: manolis@FreeBSD.org, freebsd-doc@FreeBSD.org, manolis@FreeBSD.org From: manolis@FreeBSD.org Cc: Subject: Re: docs/162723: gmirror handbook instructions ate my disk X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 21 Nov 2011 17:38:54 -0000 Synopsis: gmirror handbook instructions ate my disk Responsible-Changed-From-To: freebsd-doc->manolis Responsible-Changed-By: manolis Responsible-Changed-When: Mon Nov 21 17:38:28 UTC 2011 Responsible-Changed-Why: Over to me http://www.freebsd.org/cgi/query-pr.cgi?pr=162723 From owner-freebsd-doc@FreeBSD.ORG Mon Nov 21 19:40:12 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id EA6AA106566C for ; Mon, 21 Nov 2011 19:40:12 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id C09B58FC14 for ; Mon, 21 Nov 2011 19:40:12 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id pALJeC2q028395 for ; Mon, 21 Nov 2011 19:40:12 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id pALJeCrw028394; Mon, 21 Nov 2011 19:40:12 GMT (envelope-from gnats) Date: Mon, 21 Nov 2011 19:40:12 GMT Message-Id: <201111211940.pALJeCrw028394@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: "Johannes Totz" Cc: Subject: Re: docs/162419: [request] please document (new) zfs and zpool cmdline options X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Johannes Totz List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 21 Nov 2011 19:40:13 -0000 The following reply was made to PR docs/162419; it has been noted by GNATS. From: "Johannes Totz" To: Cc: Subject: Re: docs/162419: [request] please document (new) zfs and zpool cmdline options Date: Mon, 21 Nov 2011 19:38:23 -0000 I think r227794 on head just sorted this. Please close. From owner-freebsd-doc@FreeBSD.ORG Mon Nov 21 23:22:33 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id E833E106566B; Mon, 21 Nov 2011 23:22:33 +0000 (UTC) (envelope-from arundel@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id BFBEB8FC0C; Mon, 21 Nov 2011 23:22:33 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id pALNMX2w038096; Mon, 21 Nov 2011 23:22:33 GMT (envelope-from arundel@freefall.freebsd.org) Received: (from arundel@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id pALNMXop038092; Mon, 21 Nov 2011 23:22:33 GMT (envelope-from arundel) Date: Mon, 21 Nov 2011 23:22:33 GMT Message-Id: <201111212322.pALNMXop038092@freefall.freebsd.org> To: arundel@FreeBSD.org, freebsd-doc@FreeBSD.org, arundel@FreeBSD.org From: arundel@FreeBSD.org Cc: Subject: Re: docs/150365: [make.conf] [patch] remove BDECFLAGS from make.conf(5) manual and change their description in share/examples/etc/make.conf X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 21 Nov 2011 23:22:34 -0000 Synopsis: [make.conf] [patch] remove BDECFLAGS from make.conf(5) manual and change their description in share/examples/etc/make.conf Responsible-Changed-From-To: freebsd-doc->arundel Responsible-Changed-By: arundel Responsible-Changed-When: Mon Nov 21 23:21:53 UTC 2011 Responsible-Changed-Why: Assign to me. Although i don't have commit rights to src, i'm working on this issue atm. http://www.freebsd.org/cgi/query-pr.cgi?pr=150365 From owner-freebsd-doc@FreeBSD.ORG Tue Nov 22 20:47:22 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id F1D30106566C; Tue, 22 Nov 2011 20:47:22 +0000 (UTC) (envelope-from arundel@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id C9D758FC0C; Tue, 22 Nov 2011 20:47:22 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id pAMKlMdS060227; Tue, 22 Nov 2011 20:47:22 GMT (envelope-from arundel@freefall.freebsd.org) Received: (from arundel@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id pAMKlMrN060223; Tue, 22 Nov 2011 20:47:22 GMT (envelope-from arundel) Date: Tue, 22 Nov 2011 20:47:22 GMT Message-Id: <201111222047.pAMKlMrN060223@freefall.freebsd.org> To: arundel@FreeBSD.org, freebsd-bugs@FreeBSD.org, freebsd-doc@FreeBSD.org From: arundel@FreeBSD.org Cc: Subject: Re: kern/162765: [patch] lseek(2) may return successful although no seek operation was actually performed X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 22 Nov 2011 20:47:23 -0000 Synopsis: [patch] lseek(2) may return successful although no seek operation was actually performed Responsible-Changed-From-To: freebsd-bugs->freebsd-doc Responsible-Changed-By: arundel Responsible-Changed-When: Tue Nov 22 20:45:29 UTC 2011 Responsible-Changed-Why: Over to maintainer(s). http://www.freebsd.org/cgi/query-pr.cgi?pr=162765 From owner-freebsd-doc@FreeBSD.ORG Tue Nov 22 22:00:14 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 5EB5F1065688 for ; Tue, 22 Nov 2011 22:00:14 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 24E3C8FC08 for ; Tue, 22 Nov 2011 22:00:14 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id pAMM0EQN024293 for ; Tue, 22 Nov 2011 22:00:14 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id pAMM0DAo024292; Tue, 22 Nov 2011 22:00:13 GMT (envelope-from gnats) Date: Tue, 22 Nov 2011 22:00:13 GMT Message-Id: <201111222200.pAMM0DAo024292@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Alexander Best Cc: Subject: Re: kern/162765: [patch] lseek(2) may return successful although no seek operation was actually performed X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Alexander Best List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 22 Nov 2011 22:00:14 -0000 The following reply was made to PR kern/162765; it has been noted by GNATS. From: Alexander Best To: bug-followup@freebsd.org Cc: Subject: Re: kern/162765: [patch] lseek(2) may return successful although no seek operation was actually performed Date: Tue, 22 Nov 2011 21:52:56 +0000 --fdj2RfSjLxBAspz7 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline here's a revised patch (comma removed after "confirm"), as suggested by warren block. thanks. :) cheers. alex --fdj2RfSjLxBAspz7 Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="lseek.2.diff3" diff --git a/lib/libc/sys/lseek.2 b/lib/libc/sys/lseek.2 index 874c523..1db5891 100644 --- a/lib/libc/sys/lseek.2 +++ b/lib/libc/sys/lseek.2 @@ -28,7 +28,7 @@ .\" @(#)lseek.2 8.3 (Berkeley) 4/19/94 .\" $FreeBSD$ .\" -.Dd April 5, 2007 +.Dd November 21, 2011 .Dt LSEEK 2 .Os .Sh NAME @@ -113,10 +113,9 @@ of the existing end-of-file of the file. If data is later written at this point, subsequent reads of the data in the gap return bytes of zeros (until data is actually written into the gap). -.Pp -Some devices are incapable of seeking. -The value of the pointer -associated with such a device is undefined. +However, the +.Fn lseek +system call does not, by itself, extend the size of a file. .Pp A .Qq hole @@ -197,13 +196,43 @@ is associated with a pipe, socket, or FIFO. The .Fn lseek system call is expected to conform to -.St -p1003.1-90 . +.St -p1003.1-2008 . +.Pp +The +.Dv SEEK_HOLE +and +.Dv SEEK_DATA +directives, along with the +.Er ENXIO +error, are extensions to that specification. .Sh HISTORY The .Fn lseek function appeared in .At v7 . .Sh BUGS +If the +.Fn lseek +system call is operating on a device which is incapable of seeking, +it will request the seek operation and return successfully, +even though no seek was performed. +Because the +.Ar offset +argument will be stored unconditionally in the file descriptor of that device, +there is no way to confirm if the seek operation succeeded or not +(e.g. using the +.Fn ftell +function). +Device types which are known to be incapable of seeking include +tape drives. +.Pp +The +.Fn lseek +system call will not detect whether media are present in changeable +media devices such as DVD or Blu-ray devices. +A requested seek operation will therefore return sucessfully when no +medium is present. +.Pp This document's use of .Fa whence is incorrect English, but is maintained for historical reasons. --fdj2RfSjLxBAspz7-- From owner-freebsd-doc@FreeBSD.ORG Tue Nov 22 22:50:03 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id EA2F4106566B for ; Tue, 22 Nov 2011 22:50:03 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id D64ED8FC0C for ; Tue, 22 Nov 2011 22:50:03 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id pAMMo3Ei070831 for ; Tue, 22 Nov 2011 22:50:03 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id pAMMo3dI070830; Tue, 22 Nov 2011 22:50:03 GMT (envelope-from gnats) Date: Tue, 22 Nov 2011 22:50:03 GMT Message-Id: <201111222250.pAMMo3dI070830@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Freddie Cash Cc: Subject: Re: docs/139336: [request] ZFS documentation suggestion X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Freddie Cash List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 22 Nov 2011 22:50:04 -0000 The following reply was made to PR docs/139336; it has been noted by GNATS. From: Freddie Cash To: bug-followup@FreeBSD.org Cc: zdbs@lif.de Subject: Re: docs/139336: [request] ZFS documentation suggestion Date: Tue, 22 Nov 2011 14:40:59 -0800 --20cf307abf2f4b4ade04b25a7fd1 Content-Type: text/plain; charset=UTF-8 Using ZFS compression on filesystems with binaries, executables, shared libraries, and/or static libraries works without issues. Been using it here since ZFSv6 with both lzjb and gzip-9 compression without any issues. And have also been using it with deduplication enabled without issues. FreeBSD 7.2 through to 9.0-RC2 (and all versions in between). ZFSv6 through ZFSv28 (and all versions in between). -- Freddie Cash fjwcash@gmail.com --20cf307abf2f4b4ade04b25a7fd1 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Using ZFS compression on filesystems with binaries, executables, shared lib= raries, and/or static libraries works without issues. =C2=A0Been using it h= ere since ZFSv6 with both lzjb and gzip-9 compression without any issues. = =C2=A0And have also been using it with deduplication enabled without issues= .

FreeBSD 7.2 through to 9.0-RC2 (and all versions in between)= .
ZFSv6 through ZFSv28 (and all versions in between).

--
Freddie Cash
fjwcash@gmail.com
--20cf307abf2f4b4ade04b25a7fd1-- From owner-freebsd-doc@FreeBSD.ORG Tue Nov 22 23:10:04 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id F1FAF106564A for ; Tue, 22 Nov 2011 23:10:04 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id DC9A78FC15 for ; Tue, 22 Nov 2011 23:10:04 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id pAMNA4iJ088197 for ; Tue, 22 Nov 2011 23:10:04 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id pAMNA4PD088196; Tue, 22 Nov 2011 23:10:04 GMT (envelope-from gnats) Date: Tue, 22 Nov 2011 23:10:04 GMT Message-Id: <201111222310.pAMNA4PD088196@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Freddie Cash Cc: Subject: Re: docs/162419: [request] please document (new) zfs and zpool cmdline options X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Freddie Cash List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 22 Nov 2011 23:10:05 -0000 The following reply was made to PR docs/162419; it has been noted by GNATS. From: Freddie Cash To: bug-followup@freebsd.org Cc: johannes@jo-t.de Subject: Re: docs/162419: [request] please document (new) zfs and zpool cmdline options Date: Tue, 22 Nov 2011 14:35:32 -0800 --bcaec54eecd8cac2f104b25a6b5a Content-Type: text/plain; charset=UTF-8 Not sure if this should be a separate PR or not, but the -m option to "zpool import" is not documented in FreeBSD 9.0-RC2 r227826. This option just rescued a large pool where the cache device had died, and "zpool import" kept complaining about "one or more devices are missing". -m allows you to import pools by skipping over the missing devices. There's lots of information on -m here: http://docs.oracle.com/cd/E19963-01/html/821-1448/gbchy.html -- Freddie Cash fjwcash@gmail.com --bcaec54eecd8cac2f104b25a6b5a Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Not sure if this should be a separate PR or not, but the -m option to "= ;zpool import" is not documented in FreeBSD 9.0-RC2=C2=A0r227826. =C2= =A0This option just rescued a large pool where the cache device had died, a= nd "zpool import" kept complaining about "one or more device= s are missing". =C2=A0-m allows you to import pools by skipping over t= he missing devices.

There's lots of information on -m here:
--
Freddie Cash
fjwca= sh@gmail.com
--bcaec54eecd8cac2f104b25a6b5a-- From owner-freebsd-doc@FreeBSD.ORG Tue Nov 22 23:50:01 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id B47AC106564A for ; Tue, 22 Nov 2011 23:50:01 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 8B5288FC18 for ; Tue, 22 Nov 2011 23:50:01 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id pAMNo15d026114 for ; Tue, 22 Nov 2011 23:50:01 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id pAMNo1OQ026113; Tue, 22 Nov 2011 23:50:01 GMT (envelope-from gnats) Resent-Date: Tue, 22 Nov 2011 23:50:01 GMT Resent-Message-Id: <201111222350.pAMNo1OQ026113@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Garrett Cooper Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 3D9E61065670 for ; Tue, 22 Nov 2011 23:45:21 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22]) by mx1.freebsd.org (Postfix) with ESMTP id 2DDFA8FC13 for ; Tue, 22 Nov 2011 23:45:21 +0000 (UTC) Received: from red.freebsd.org (localhost [127.0.0.1]) by red.freebsd.org (8.14.4/8.14.4) with ESMTP id pAMNjKFo029181 for ; Tue, 22 Nov 2011 23:45:20 GMT (envelope-from nobody@red.freebsd.org) Received: (from nobody@localhost) by red.freebsd.org (8.14.4/8.14.4/Submit) id pAMNjKJM029180; Tue, 22 Nov 2011 23:45:20 GMT (envelope-from nobody) Message-Id: <201111222345.pAMNjKJM029180@red.freebsd.org> Date: Tue, 22 Nov 2011 23:45:20 GMT From: Garrett Cooper To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/162775: Document some undocumented zpool import options X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 22 Nov 2011 23:50:01 -0000 >Number: 162775 >Category: docs >Synopsis: Document some undocumented zpool import options >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Tue Nov 22 23:50:01 UTC 2011 >Closed-Date: >Last-Modified: >Originator: Garrett Cooper >Release: 10-CURRENT >Organization: iXsystems, Inc. >Environment: FreeBSD streetfighter.ixsystems.com 10.0-CURRENT FreeBSD 10.0-CURRENT #0: Mon Oct 24 12:46:00 PDT 2011 root@streetfighter.ixsystems.com:/usr/obj/usr/src/sys/STREETFIGHTER amd64 >Description: There are a few options that aren't documented in the import section of the zpool manpage (at least not in the one that we have with the additional updates, and potentially not in the OpenSolaris manpage either). They are [according to the out of date comment above cddl/contrib/opensolaris/cmd/zpool/zpool_do_import()]: case 'F': do_rewind = B_TRUE; break; case 'm': flags |= ZFS_IMPORT_MISSING_LOG; break; case 'N': flags |= ZFS_IMPORT_ONLY; break; case 'T': errno = 0; txg = strtoull(optarg, &endptr, 10); if (errno != 0 || *endptr != '\0') { (void) fprintf(stderr, gettext("invalid txg value\n")); usage(B_FALSE); } rewind_policy = ZPOOL_DO_REWIND | ZPOOL_EXTREME_REWIND; break; case 'V': flags |= ZFS_IMPORT_VERBATIM; break; case 'X': xtreme_rewind = B_TRUE; break; >How-To-Repeat: >Fix: >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Fri Nov 25 00:20:08 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 523B2106564A for ; Fri, 25 Nov 2011 00:20:08 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 2AC428FC12 for ; Fri, 25 Nov 2011 00:20:08 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id pAP0K8qC091776 for ; Fri, 25 Nov 2011 00:20:08 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id pAP0K8gB091775; Fri, 25 Nov 2011 00:20:08 GMT (envelope-from gnats) Resent-Date: Fri, 25 Nov 2011 00:20:08 GMT Resent-Message-Id: <201111250020.pAP0K8gB091775@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, pirat sriyotha Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 55B70106566B for ; Fri, 25 Nov 2011 00:16:03 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22]) by mx1.freebsd.org (Postfix) with ESMTP id 2C6388FC16 for ; Fri, 25 Nov 2011 00:16:03 +0000 (UTC) Received: from red.freebsd.org (localhost [127.0.0.1]) by red.freebsd.org (8.14.4/8.14.4) with ESMTP id pAP0G2H0017807 for ; Fri, 25 Nov 2011 00:16:02 GMT (envelope-from nobody@red.freebsd.org) Received: (from nobody@localhost) by red.freebsd.org (8.14.4/8.14.4/Submit) id pAP0G2kX017806; Fri, 25 Nov 2011 00:16:02 GMT (envelope-from nobody) Message-Id: <201111250016.pAP0G2kX017806@red.freebsd.org> Date: Fri, 25 Nov 2011 00:16:02 GMT From: pirat sriyotha To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/162862: DESTDIR environment variable setting is not correct for apache22 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 25 Nov 2011 00:20:08 -0000 >Number: 162862 >Category: docs >Synopsis: DESTDIR environment variable setting is not correct for apache22 >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: sw-bug >Submitter-Id: current-users >Arrival-Date: Fri Nov 25 00:20:07 UTC 2011 >Closed-Date: >Last-Modified: >Originator: pirat sriyotha >Release: FreeBSD dell.jes.or.th 8.2-RELEASE-p0 FreeBSD 8.2-RELEASE-p0 #1: Sun May 29 15:21:52 ICT 2011 root@jotawski.tint.or.th:/usr/obj/usr/src/sys/JOTAWSKI amd64 >Organization: - >Environment: FreeBSD dell.jes.or.th 8.2-RELEASE-p0 FreeBSD 8.2-RELEASE-p0 #1: Sun May 29 15:21:52 ICT 2011 root@jotawski.tint.or.th:/usr/obj/usr/src/sys/JOTAWSKI amd64 >Description: in chapter 8 of FDP primer section 8.3 bullet 2 wrote that DESTDIR environment variable must be given in order to install into local servers and the value is /usr/local/www Nowaday, for apache2 web server, this value is quite far from real situation. The most appropriate value for apache2 should be /usr/local/www/apache22 as in # env DESTDIR=/usr/local/www/apache22 make install >How-To-Repeat: open your web browser and point to http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/the-website-install.html >Fix: change command line from # env DESTDIR=/usr/local/www make install to # env DESTDIR=/usr/local/www/apache22 make install a patch for chapter.sgml at books/fdp-primer/the-website is attached Patch attached with submission follows: Index: chapter.sgml =================================================================== RCS file: /home/motorc/Repository-motorc/doc/en_US.ISO8859-1/books/fdp-primer/the-website/chapter.sgml,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- chapter.sgml 15 Nov 2011 07:30:08 -0000 1.1 +++ chapter.sgml 24 Nov 2011 23:57:34 -0000 1.2 @@ -289,7 +289,7 @@ setting the DESTDIR variable to the name of the directory you want to install the files to. - &prompt.root; env DESTDIR=/usr/local/www make install + &prompt.root; env DESTDIR=/usr/local/www/apache22 make install >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Fri Nov 25 15:30:17 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id A7480106566B for ; Fri, 25 Nov 2011 15:30:17 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 96BC68FC1B for ; Fri, 25 Nov 2011 15:30:17 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id pAPFUHoT064684 for ; Fri, 25 Nov 2011 15:30:17 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id pAPFUHcT064679; Fri, 25 Nov 2011 15:30:17 GMT (envelope-from gnats) Date: Fri, 25 Nov 2011 15:30:17 GMT Message-Id: <201111251530.pAPFUHcT064679@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Manolis Kiagias Cc: Subject: Re: docs/162862: DESTDIR environment variable setting is not correct for apache22 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Manolis Kiagias List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 25 Nov 2011 15:30:17 -0000 The following reply was made to PR docs/162862; it has been noted by GNATS. From: Manolis Kiagias To: pirat sriyotha Cc: bug-followup@FreeBSD.org Subject: Re: docs/162862: DESTDIR environment variable setting is not correct for apache22 Date: Fri, 25 Nov 2011 17:25:32 +0200 Hi, The example is not specific to apache22 or in fact any specific web server. You don't have to use apache to serve FreeBSD web pages. The /usr/local/www is used as a common preference (or hint) as /usr is the largest partition on most FreeBSD systems following the default installation scheme. You are supposed to know how to install / configure a web server and adapt these instructions to your specific installation. IMHO, if we add apache specific information to this section we will also have to add more sections describing basic configuration for serving the pages (like setting DocumentRoot, encoding etc.). I believe these are out of scope for this document. Best, Manolis From owner-freebsd-doc@FreeBSD.ORG Fri Nov 25 23:07:05 2011 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id DC984106566C for ; Fri, 25 Nov 2011 23:07:04 +0000 (UTC) (envelope-from jotawski@gmail.com) Received: from mail-bw0-f54.google.com (mail-bw0-f54.google.com [209.85.214.54]) by mx1.freebsd.org (Postfix) with ESMTP id 6C1A48FC08 for ; Fri, 25 Nov 2011 23:07:04 +0000 (UTC) Received: by bkbzs8 with SMTP id zs8so6406420bkb.13 for ; Fri, 25 Nov 2011 15:07:03 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type; bh=wl85KsJxPb493wxgZJOYjhFMFS54lex8ppT14PAefRQ=; b=J1ul00Gsixhx+k7apOX9MzSUytNKAJx/uSTrSpURhZA0LzzX9o7Hfs8CSbLC+0NnY9 DTOwtpIArZuDXOZGTeI8dE/qMoJYLbY9+GnJWxRlLgeuAWg9cZdx7GgkKV3xPH7pTooL RERqIf7jQ902X8LRA8yTJIjlZ6i2sm3mLIYM0= MIME-Version: 1.0 Received: by 10.205.135.6 with SMTP id ie6mr8046262bkc.69.1322262423381; Fri, 25 Nov 2011 15:07:03 -0800 (PST) Received: by 10.204.35.194 with HTTP; Fri, 25 Nov 2011 15:07:03 -0800 (PST) In-Reply-To: <4ECFB36C.5060309@gmail.com> References: <201111250016.pAP0G2kX017806@red.freebsd.org> <4ECFB36C.5060309@gmail.com> Date: Sat, 26 Nov 2011 06:07:03 +0700 Message-ID: From: Mniyardfa Jotawski To: Manolis Kiagias Content-Type: text/plain; charset=UTF-8 X-Content-Filtered-By: Mailman/MimeDel 2.1.5 Cc: freebsd-doc@freebsd.org Subject: Re: docs/162862: DESTDIR environment variable setting is not correct for apache22 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 25 Nov 2011 23:07:05 -0000 2011/11/25 Manolis Kiagias > Hi, > > Hi, > The example is not specific to apache22 or in fact any specific web > server. You don't have to use apache to serve FreeBSD web pages. The > /usr/local/www is used as a common preference (or hint) as /usr is the > largest partition on most FreeBSD systems following the default > installation scheme. You are supposed to know how to install / configure a > web server and adapt these instructions to your specific installation. > IMHO, if we add apache specific information to this section we will also > have to add more sections describing basic configuration for serving the > pages (like setting DocumentRoot, encoding etc.). I believe these are out > of scope for this document. > > I did agree with your opinion but since I specifically aimed to apache2, as I wrote in my Problem Description: , that requires that documents to serve should be in (or under) DocumentRoot which is /usr/local/www/apache22. But once I follow suggestion in FDP Primer chapter 8.3, that installs all documents to /usr/local/www/data. In this case, I have to create apache22 subdirectory under what DESTDIR environment variable points to and mv all data/ into that in order for my apache2 to start quietly. Anyway, I also see that there will be an endless Notes to mention to the readers if we wrote to a specific web-server like apache as you said me. May be that we put a few words to mention further works after ``make all install'' for some specific server or all documents will have to be installed to ~/public_html/data otherwise. Many thanks indeed for your time. Apologized me for disturbing and apologized me for my English too. Best, > Manolis > With best regards, psr. From owner-freebsd-doc@FreeBSD.ORG Sat Nov 26 06:50:10 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 06C27106566C for ; Sat, 26 Nov 2011 06:50:10 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id B89FD8FC1F for ; Sat, 26 Nov 2011 06:50:09 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id pAQ6o9tk026960 for ; Sat, 26 Nov 2011 06:50:09 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id pAQ6o9RP026959; Sat, 26 Nov 2011 06:50:09 GMT (envelope-from gnats) Resent-Date: Sat, 26 Nov 2011 06:50:09 GMT Resent-Message-Id: <201111260650.pAQ6o9RP026959@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Oliver Hartmann Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id A35341065670 for ; Sat, 26 Nov 2011 06:47:32 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22]) by mx1.freebsd.org (Postfix) with ESMTP id 91F698FC0C for ; Sat, 26 Nov 2011 06:47:32 +0000 (UTC) Received: from red.freebsd.org (localhost [127.0.0.1]) by red.freebsd.org (8.14.4/8.14.4) with ESMTP id pAQ6lWWu062664 for ; Sat, 26 Nov 2011 06:47:32 GMT (envelope-from nobody@red.freebsd.org) Received: (from nobody@localhost) by red.freebsd.org (8.14.4/8.14.4/Submit) id pAQ6lWHP062663; Sat, 26 Nov 2011 06:47:32 GMT (envelope-from nobody) Message-Id: <201111260647.pAQ6lWHP062663@red.freebsd.org> Date: Sat, 26 Nov 2011 06:47:32 GMT From: Oliver Hartmann To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/162890: periodic.conf: daily_scrub_zfs_default_threshold: defaults to 35 in script, is mentioned to have default 30 in doc X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 26 Nov 2011 06:50:10 -0000 >Number: 162890 >Category: docs >Synopsis: periodic.conf: daily_scrub_zfs_default_threshold: defaults to 35 in script, is mentioned to have default 30 in doc >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sat Nov 26 06:50:09 UTC 2011 >Closed-Date: >Last-Modified: >Originator: Oliver Hartmann >Release: FreeBSD 10.0-CURRENT/amd64 >Organization: FU Berlin >Environment: >Description: Script config file /etc/defaults/periodic.conf has for daily_scrub_zfs_default_threshold a value of 35. The manpage for periodic.conf mentions 30 as the default value. >How-To-Repeat: compare /etc/defaults/periodic.conf and those values mentioned to be default as given by the manpage periodic.conf. >Fix: >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Sat Nov 26 08:40:11 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 32A04106564A for ; Sat, 26 Nov 2011 08:40:10 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id DBEDD8FC08 for ; Sat, 26 Nov 2011 08:40:10 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id pAQ8eASs056578 for ; Sat, 26 Nov 2011 08:40:10 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id pAQ8eAMD056577; Sat, 26 Nov 2011 08:40:10 GMT (envelope-from gnats) Date: Sat, 26 Nov 2011 08:40:10 GMT Message-Id: <201111260840.pAQ8eAMD056577@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Niclas Zeising Cc: Subject: Re: docs/162890: periodic.conf: daily_scrub_zfs_default_threshold: defaults to 35 in script, is mentioned to have default 30 in doc X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Niclas Zeising List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 26 Nov 2011 08:40:11 -0000 The following reply was made to PR docs/162890; it has been noted by GNATS. From: Niclas Zeising To: Oliver Hartmann Cc: freebsd-gnats-submit@FreeBSD.org Subject: Re: docs/162890: periodic.conf: daily_scrub_zfs_default_threshold: defaults to 35 in script, is mentioned to have default 30 in doc Date: Sat, 26 Nov 2011 09:34:49 +0100 This is a multi-part message in MIME format. --------------060502000207000700060706 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Here is a patch for that change. Regards! -- Niclas --------------060502000207000700060706 Content-Type: text/plain; name="periodic.conf.5.diff" Content-Transfer-Encoding: 7bit Content-Disposition: attachment; filename="periodic.conf.5.diff" Index: share/man/man5/periodic.conf.5 =================================================================== --- share/man/man5/periodic.conf.5 (revision 227991) +++ share/man/man5/periodic.conf.5 (working copy) @@ -631,7 +631,7 @@ .It Va daily_scrub_zfs_default_threshold .Pq Vt int Number of days between a scrub if no pool-specific threshold is set. -The default value if no value is set is 30. +The default value if no value is set is 35, which corresponds to 5 weeks. .It Va daily_scrub_zfs_ Ns Ao Ar poolname Ac Ns Va _threshold .Pq Vt int The same as --------------060502000207000700060706-- From owner-freebsd-doc@FreeBSD.ORG Sat Nov 26 11:09:29 2011 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 845F4106564A for ; Sat, 26 Nov 2011 11:09:29 +0000 (UTC) (envelope-from sonic2000gr@gmail.com) Received: from mail-bw0-f54.google.com (mail-bw0-f54.google.com [209.85.214.54]) by mx1.freebsd.org (Postfix) with ESMTP id 0F5548FC14 for ; Sat, 26 Nov 2011 11:09:28 +0000 (UTC) Received: by mail-bw0-f54.google.com with SMTP id zs8so7047868bkb.13 for ; Sat, 26 Nov 2011 03:09:28 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=message-id:date:from:user-agent:mime-version:to:cc:subject :references:in-reply-to:content-type; bh=4fvnkmcwT2hRxAqj7gTFsTkdvvcep/wlbG2/KzUUx5g=; b=KGbbALCXjC5eAyuogBhvJ/6YOVALCCGYnHWtwVS1+y4zkJ7Q0ALMWyHn2UnXVD1NBd 3h6EQ+cTn8U9CYPDJG1NQeAV3c/vfixAdlC1nMX2k7VmKJZdeTjnoaSvB5bfLGthtnzU DTt7mPcA9dPw3dUzdyV0MU/uF82hH+Ala8pCY= Received: by 10.204.130.85 with SMTP id r21mr36859587bks.38.1322305768546; Sat, 26 Nov 2011 03:09:28 -0800 (PST) Received: from [192.168.0.150] (athedsl-4364788.home.otenet.gr. [79.130.9.228]) by mx.google.com with ESMTPS id l26sm31728982fad.17.2011.11.26.03.09.26 (version=TLSv1/SSLv3 cipher=OTHER); Sat, 26 Nov 2011 03:09:27 -0800 (PST) Message-ID: <4ED0C8E8.4080409@gmail.com> Date: Sat, 26 Nov 2011 13:09:28 +0200 From: Manolis Kiagias User-Agent: Mozilla/5.0 (Windows; U; Windows NT 6.1; en-US; rv:1.9.2.18) Gecko/20110616 Thunderbird/3.1.11 MIME-Version: 1.0 To: Mniyardfa Jotawski References: <201111250016.pAP0G2kX017806@red.freebsd.org> <4ECFB36C.5060309@gmail.com> In-Reply-To: Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit X-Content-Filtered-By: Mailman/MimeDel 2.1.5 Cc: freebsd-doc@freebsd.org Subject: Re: docs/162862: DESTDIR environment variable setting is not correct for apache22 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 26 Nov 2011 11:09:29 -0000 On 26/11/2011 1:07 πμ, Mniyardfa Jotawski wrote: > 2011/11/25 Manolis Kiagias > > > Hi, > > > Hi, > > The example is not specific to apache22 or in fact any specific > web server. You don't have to use apache to serve FreeBSD web > pages. The /usr/local/www is used as a common preference (or hint) > as /usr is the largest partition on most FreeBSD systems following > the default installation scheme. You are supposed to know how to > install / configure a web server and adapt these instructions to > your specific installation. > IMHO, if we add apache specific information to this section we > will also have to add more sections describing basic > configuration for serving the pages (like setting DocumentRoot, > encoding etc.). I believe these are out of scope for this document. > > > I did agree with your opinion but since I specifically aimed to > apache2, as I wrote in my Problem Description: , that requires that > documents to serve should be in (or under) DocumentRoot which is > /usr/local/www/apache22. But once I follow suggestion in FDP Primer > chapter 8.3, that installs all documents to /usr/local/www/data. In > this case, I have to create apache22 subdirectory under what DESTDIR > environment variable points to and mv all data/ into that in order for > my apache2 to start quietly. What you would really need to do is change the DESTDIR shown in the example to: env DESTDIR=/usr/local/www/apache22 make install As I said, the example is not to be taken literally. DESTDIR should be set to your own DocumentRoot (or whatever is called by the web server used) and not copied directly from fdp-primer. > > Anyway, I also see that there will be an endless Notes to mention to > the readers if we wrote to a specific web-server like apache as you > said me. > > May be that we put a few words to mention further works after ``make > all install'' for some specific server or all documents will have to > be installed to ~/public_html/data otherwise. > Not necessary if DESTDIR is set correctly beforehand > Many thanks indeed for your time. > > Apologized me for disturbing and apologized me for my English too. > > > You are not disturbing, you are trying to make FreeBSD better! Thanks!