From owner-freebsd-doc@FreeBSD.ORG Sun Nov 15 05:23:49 2009 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 82EDC1065670 for ; Sun, 15 Nov 2009 05:23:49 +0000 (UTC) (envelope-from Rhubbell@iHubbell.com) Received: from hapkido.dreamhost.com (hapkido.dreamhost.com [66.33.216.122]) by mx1.freebsd.org (Postfix) with ESMTP id 714698FC0A for ; Sun, 15 Nov 2009 05:23:49 +0000 (UTC) Received: from homiemail-a20.g.dreamhost.com (caiajhbdcagg.dreamhost.com [208.97.132.66]) by hapkido.dreamhost.com (Postfix) with ESMTP id C054517B4B5 for ; Sat, 14 Nov 2009 20:59:45 -0800 (PST) Received: from 127.1 (ip68-6-52-111.sb.sd.cox.net [68.6.52.111]) by homiemail-a20.g.dreamhost.com (Postfix) with ESMTPA id 6D3687EC060 for ; Sat, 14 Nov 2009 20:59:33 -0800 (PST) Date: Sat, 14 Nov 2009 20:59:23 -0800 From: rhubbell To: doc@FreeBSD.org Message-Id: <20091114205923.9f624320.Rhubbell@iHubbell.com> X-Mailer: Mail-2.1 Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Cc: Subject: no US anoncvs 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, 15 Nov 2009 05:23:49 -0000 Seems like this docs needs to be revised, unless it's a coincidence that both US anoncvs servers are down http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/anoncvs.html I tried these, but have resorted to using the fr server. anoncvs.FreeBSD.org anoncvs1.FreeBSD.org From owner-freebsd-doc@FreeBSD.ORG Sun Nov 15 12:30:54 2009 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 69DAD1065670 for ; Sun, 15 Nov 2009 12:30:54 +0000 (UTC) (envelope-from dennylin93@cnmc32.hs.ntnu.edu.tw) Received: from mx.hs.ntnu.edu.tw (mx.hs.ntnu.edu.tw [140.131.149.2]) by mx1.freebsd.org (Postfix) with ESMTP id 3B2CF8FC20 for ; Sun, 15 Nov 2009 12:30:53 +0000 (UTC) Received: by mx.hs.ntnu.edu.tw (Postfix, from userid 1002) id 0B1A36FC462; Sun, 15 Nov 2009 20:11:13 +0800 (CST) Date: Sun, 15 Nov 2009 20:11:13 +0800 From: Denny Lin To: freebsd-doc@freebsd.org Message-ID: <20091115121113.GA21434@mx.hs.ntnu.edu.tw> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline User-Agent: Mutt/1.4.2.3i Subject: Translation of FreeBSD Documentation 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, 15 Nov 2009 12:30:54 -0000 Hi, I intend to work on the Traditional Chinese translations of the FreeBSD documentation, and I'm wondering if anyone else is working on it at the moment. It seems to be inactive since the last commits were roughly 2 to 3 years ago. I have a few questions regarding the Traditional Chinese translations, so I thought it might be better to ask before starting. -- Denny Lin From owner-freebsd-doc@FreeBSD.ORG Sun Nov 15 13:00:05 2009 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 482521065692 for ; Sun, 15 Nov 2009 13:00:05 +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 0EA9C8FC1B for ; Sun, 15 Nov 2009 13:00:05 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id nAFD03l8032088 for ; Sun, 15 Nov 2009 13:00:03 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id nAFD03N7032087; Sun, 15 Nov 2009 13:00:03 GMT (envelope-from gnats) Resent-Date: Sun, 15 Nov 2009 13:00:03 GMT Resent-Message-Id: <200911151300.nAFD03N7032087@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, Denny Lin Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 3DD07106566C for ; Sun, 15 Nov 2009 12:51:57 +0000 (UTC) (envelope-from dennylin93@cnmc32.hs.ntnu.edu.tw) Received: from mx.hs.ntnu.edu.tw (mx.hs.ntnu.edu.tw [140.131.149.2]) by mx1.freebsd.org (Postfix) with ESMTP id 0E4488FC0C for ; Sun, 15 Nov 2009 12:51:56 +0000 (UTC) Received: by mx.hs.ntnu.edu.tw (Postfix, from userid 1002) id 3615D6FC450; Sun, 15 Nov 2009 20:51:56 +0800 (CST) Message-Id: <20091115125156.3615D6FC450@mx.hs.ntnu.edu.tw> Date: Sun, 15 Nov 2009 20:51:56 +0800 (CST) From: Denny Lin To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/140568: [UPDATE] Outdated Perl info in Developers' Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Denny Lin List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 15 Nov 2009 13:00:05 -0000 >Number: 140568 >Category: docs >Synopsis: [UPDATE] Outdated Perl info in Developers' Handbook >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: update >Submitter-Id: current-users >Arrival-Date: Sun Nov 15 13:00:03 UTC 2009 >Closed-Date: >Last-Modified: >Originator: Denny Lin >Release: FreeBSD 7.2-RELEASE-p4 amd64 >Organization: >Environment: System: FreeBSD cnmc32.hs.ntnu.edu.tw 7.2-RELEASE-p4 FreeBSD 7.2-RELEASE-p4 #0: Mon Oct 26 19:41:45 CST 2009 root@cnmc32.hs.ntnu.edu.tw:/usr/obj/usr/src/sys/CNMC32 amd64 >Description: The Perl port (lang/perl5) specified in the Developers' Handbook no longer exists. It should be replaced with lang/perl5.8, the current default version of Perl. >How-To-Repeat: >Fix: Patch (sed 's/perl5/perl5.8/g'). --- developers-handbook-tools-chapter.sgml.patch begins here --- --- doc/en_US.ISO8859-1/books/developers-handbook/tools/chapter.sgml.orig 2009-11-15 20:45:01.744614861 +0800 +++ doc/en_US.ISO8859-1/books/developers-handbook/tools/chapter.sgml 2009-11-15 20:45:15.176791625 +0800 @@ -184,7 +184,7 @@ writing CGI scripts. Perl is available in the Ports Collection as - lang/perl5 for all + lang/perl5.8 for all &os; releases, and is installed as /usr/bin/perl in the base system 4.X releases. --- developers-handbook-tools-chapter.sgml.patch ends here --- >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Sun Nov 15 13:10:02 2009 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 132AA106566B for ; Sun, 15 Nov 2009 13:10:02 +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 CE15F8FC1B for ; Sun, 15 Nov 2009 13:10:01 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id nAFDA1jc040167 for ; Sun, 15 Nov 2009 13:10:01 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id nAFDA1K4040166; Sun, 15 Nov 2009 13:10:01 GMT (envelope-from gnats) Resent-Date: Sun, 15 Nov 2009 13:10:01 GMT Resent-Message-Id: <200911151310.nAFDA1K4040166@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, Denny Lin Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 2DAFF106568F for ; Sun, 15 Nov 2009 13:00:05 +0000 (UTC) (envelope-from dennylin93@cnmc32.hs.ntnu.edu.tw) Received: from mx.hs.ntnu.edu.tw (mx.hs.ntnu.edu.tw [140.131.149.2]) by mx1.freebsd.org (Postfix) with ESMTP id F25448FC19 for ; Sun, 15 Nov 2009 13:00:04 +0000 (UTC) Received: by mx.hs.ntnu.edu.tw (Postfix, from userid 1002) id 4CA396FC450; Sun, 15 Nov 2009 21:00:04 +0800 (CST) Message-Id: <20091115130004.4CA396FC450@mx.hs.ntnu.edu.tw> Date: Sun, 15 Nov 2009 21:00:04 +0800 (CST) From: Denny Lin To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/140569: [UPDATE] Updated info about Tcl in Developers' Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Denny Lin List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 15 Nov 2009 13:10:02 -0000 >Number: 140569 >Category: docs >Synopsis: [UPDATE] Updated info about Tcl in Developers' Handbook >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: update >Submitter-Id: current-users >Arrival-Date: Sun Nov 15 13:10:01 UTC 2009 >Closed-Date: >Last-Modified: >Originator: Denny Lin >Release: FreeBSD 7.2-RELEASE-p4 amd64 >Organization: >Environment: System: FreeBSD cnmc32.hs.ntnu.edu.tw 7.2-RELEASE-p4 FreeBSD 7.2-RELEASE-p4 #0: Mon Oct 26 19:41:45 CST 2009 root@cnmc32.hs.ntnu.edu.tw:/usr/obj/usr/src/sys/CNMC32 amd64 >Description: Sorry, I should have included this in the previous PR I sent about Perl, but I didn't notice this problem until the PR had already been sent. The latest stable of version is now Tcl 8.5. >How-To-Repeat: >Fix: Patch. --- tcl.patch begins here --- --- doc/en_US.ISO8859-1/books/developers-handbook/tools/chapter.sgml.orig 2009-11-15 20:55:53.412210016 +0800 +++ doc/en_US.ISO8859-1/books/developers-handbook/tools/chapter.sgml 2009-11-15 20:56:09.544424044 +0800 @@ -284,8 +284,8 @@ programs. Various versions of Tcl are available as ports - for &os;. The latest version, Tcl 8.4, can be found in - lang/tcl84. + for &os;. The latest version, Tcl 8.5, can be found in + lang/tcl85. --- tcl.patch ends here --- >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Sun Nov 15 19:40:02 2009 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 390BA106568D for ; Sun, 15 Nov 2009 19:40:02 +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 EE19D8FC0C for ; Sun, 15 Nov 2009 19:40:01 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id nAFJe178076001 for ; Sun, 15 Nov 2009 19:40:01 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id nAFJe1nW076000; Sun, 15 Nov 2009 19:40:01 GMT (envelope-from gnats) Resent-Date: Sun, 15 Nov 2009 19:40:01 GMT Resent-Message-Id: <200911151940.nAFJe1nW076000@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, Jason Helfman Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 9DECF106566C for ; Sun, 15 Nov 2009 19:34:53 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id 8BDC68FC0C for ; Sun, 15 Nov 2009 19:34:53 +0000 (UTC) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.3/8.14.3) with ESMTP id nAFJYrkq098112 for ; Sun, 15 Nov 2009 19:34:53 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.14.3/8.14.3/Submit) id nAFJYr16098111; Sun, 15 Nov 2009 19:34:53 GMT (envelope-from nobody) Message-Id: <200911151934.nAFJYr16098111@www.freebsd.org> Date: Sun, 15 Nov 2009 19:34:53 GMT From: Jason Helfman To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/140581: Link to Poly link doesn't work. Found a suitable replacement and named the full University. Go Poly. 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, 15 Nov 2009 19:40:02 -0000 >Number: 140581 >Category: docs >Synopsis: Link to Poly link doesn't work. Found a suitable replacement and named the full University. Go Poly. >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 15 19:40:01 UTC 2009 >Closed-Date: >Last-Modified: >Originator: Jason Helfman >Release: FreeBSD 7.2-RELEASE-p4 >Organization: Experts Exchange >Environment: FreeBSD 7.2-RELEASE-p4 >Description: A bad reference link. >How-To-Repeat: >Fix: Patch attached with submission follows: --- en_US.ISO8859-1/books/handbook/mirrors/chapter.sgml.old 2009-11-15 11:15:51.000000000 -0800 +++ en_US.ISO8859-1/books/handbook/mirrors/chapter.sgml 2009-11-15 11:19:20.000000000 -0800 @@ -483,7 +483,7 @@ CVS Tutorial from Cal Poly. + url="http://users.csc.calpoly.edu/~gfisher/classes/205/handouts/cvs-basics.html">CVS Tutorial from California Polytechnic State University. >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Sun Nov 15 21:46:39 2009 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 580331065670 for ; Sun, 15 Nov 2009 21:46:39 +0000 (UTC) (envelope-from jhelfman@e-e.com) Received: from mail.experts-exchange.com (mail.experts-exchange.com [64.156.132.251]) by mx1.freebsd.org (Postfix) with ESMTP id 4489D8FC1C for ; Sun, 15 Nov 2009 21:46:39 +0000 (UTC) Received: from eggman.experts-exchange.com (adsl-75-15-122-174.dsl.snlo01.sbcglobal.net [75.15.122.174]) by mail.experts-exchange.com (Postfix) with ESMTP id 49CFF4A306CD for ; Sun, 15 Nov 2009 12:52:05 -0800 (PST) Received: by eggman.experts-exchange.com (sSMTP sendmail emulation); Sun, _d Nov 2009 13:46:38 -0800 Date: Sun, 15 Nov 2009 13:46:38 -0800 From: Jason To: doc@freebsd.org Message-ID: <20091115214610.GA17485@jason-helfmans-macbook-pro.local> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii; format=flowed Content-Disposition: inline X-Operating-System: Darwin 9.8.0 X-Living-The-Dream: I love the SLO Life! User-Agent: Mutt/1.5.20 (2009-06-14) Cc: Subject: bsdmag.org link placement 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, 15 Nov 2009 21:46:39 -0000 Hi I was wondering where a link I would like to submit for BSD Magazine, would be most appropriate? It isn't specifically FreeBSD, however it is specific to all BSD's, so I was thinking of putting under "International book & Magazines" found here: http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/bibliography.html#BIBLIOGRAPHY-FREEBSD or perhaps, here: http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/bibliography-journals.html Beyond this, I don't see the need for that latter link, as it could be condensed into the first, and renamed. That is another path, though. Any thoughts? Thanks, Jason From owner-freebsd-doc@FreeBSD.ORG Sun Nov 15 23:09:33 2009 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 92EF91065694; Sun, 15 Nov 2009 23:09:33 +0000 (UTC) (envelope-from gabor@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 68D708FC1A; Sun, 15 Nov 2009 23:09:33 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id nAFN9X8d055796; Sun, 15 Nov 2009 23:09:33 GMT (envelope-from gabor@freefall.freebsd.org) Received: (from gabor@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id nAFN9XR1055792; Sun, 15 Nov 2009 23:09:33 GMT (envelope-from gabor) Date: Sun, 15 Nov 2009 23:09:33 GMT Message-Id: <200911152309.nAFN9XR1055792@freefall.freebsd.org> To: "ds atukrhubdotnet"@chaos.ukrhub.net, gabor@FreeBSD.org, freebsd-doc@FreeBSD.org, gabor@FreeBSD.org From: gabor@FreeBSD.org Cc: Subject: Re: docs/140418: [patch] articles/custom-gcc: russian translation is missing 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, 15 Nov 2009 23:09:33 -0000 Synopsis: [patch] articles/custom-gcc: russian translation is missing State-Changed-From-To: open->closed State-Changed-By: gabor State-Changed-When: Sun Nov 15 23:09:13 UTC 2009 State-Changed-Why: Committed, thanks. Responsible-Changed-From-To: freebsd-doc->gabor Responsible-Changed-By: gabor Responsible-Changed-When: Sun Nov 15 23:09:13 UTC 2009 Responsible-Changed-Why: Committed, thanks. http://www.freebsd.org/cgi/query-pr.cgi?pr=140418 From owner-freebsd-doc@FreeBSD.ORG Mon Nov 16 06:00:07 2009 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 3DBB11065676 for ; Mon, 16 Nov 2009 06:00:07 +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 0130C8FC13 for ; Mon, 16 Nov 2009 06:00:07 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id nAG6061e012998 for ; Mon, 16 Nov 2009 06:00:06 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id nAG606KS012997; Mon, 16 Nov 2009 06:00:06 GMT (envelope-from gnats) Resent-Date: Mon, 16 Nov 2009 06:00:06 GMT Resent-Message-Id: <200911160600.nAG606KS012997@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, dirk.meyer@dinoex.sub.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id D81DC1065672 for ; Mon, 16 Nov 2009 05:56:48 +0000 (UTC) (envelope-from dm@home3.dinoex.sub.de) Received: from uucp.dinoex.sub.de (uucp.dinoex.sub.de [194.45.71.2]) by mx1.freebsd.org (Postfix) with ESMTP id 64AAA8FC12 for ; Mon, 16 Nov 2009 05:56:48 +0000 (UTC) Received: from home3.dinoex.sub.de (home3.dinoex.sub.de [194.45.71.20]) by uucp.dinoex.sub.de (8.14.3/8.14.2) with ESMTP id nAG5uC4l047331 for ; Mon, 16 Nov 2009 06:56:28 +0100 (CET) (envelope-from dm@home3.dinoex.sub.de) Received: (from dm@localhost) by home3.dinoex.sub.de (8.14.3/8.14.3/Submit) id nAG5uCec061860; Mon, 16 Nov 2009 06:56:12 +0100 (CET) (envelope-from dm) Message-Id: <200911160556.nAG5uCec061860@home3.dinoex.sub.de> Date: Mon, 16 Nov 2009 06:56:12 +0100 (CET) From: dirk.meyer@dinoex.sub.org To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/140594: getprogname.3 misleading X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: dirk.meyer@dinoex.sub.org List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 16 Nov 2009 06:00:07 -0000 >Number: 140594 >Category: docs >Synopsis: getprogname.3 misleading >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 16 06:00:06 UTC 2009 >Closed-Date: >Last-Modified: >Originator: Dirk Meyer >Release: FreeBSD 8.0-PRERELEASE >Organization: privat >Environment: FreeBSD libc manpage section 3. >Description: The manpage of getprogname seemms to contain an error. [...] In FreeBSD, the name of the program is set by the start-up code that is run before main(); thus, running setprogname() is not necessary. Pro- grams that desire maximum portability should still call it; on another operating system, these functions may be implemented in a portability library. Calling setprogname() allows the aforementioned library to learn the program name without modifications to the start-up code. [...] I think the last part should be: Calling getprogname() allows ... >How-To-Repeat: http://www.freebsd.org/cgi/cvsweb.cgi/src/lib/libc/gen/getprogname.3 man getprogname >Fix: >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Mon Nov 16 11:06:07 2009 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 E5AEB1065670 for ; Mon, 16 Nov 2009 11:06:07 +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 D3B128FC15 for ; Mon, 16 Nov 2009 11:06:07 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id nAGB67dx010481 for ; Mon, 16 Nov 2009 11:06:07 GMT (envelope-from owner-bugmaster@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id nAGB670Q010479 for freebsd-doc@FreeBSD.org; Mon, 16 Nov 2009 11:06:07 GMT (envelope-from owner-bugmaster@FreeBSD.org) Date: Mon, 16 Nov 2009 11:06:07 GMT Message-Id: <200911161106.nAGB670Q010479@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, 16 Nov 2009 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/140594 doc getprogname.3 misleading o docs/140581 doc [mirrors] [patch] Link to Poly link doesn't work. Foun o docs/140569 doc [UPDATE] Updated info about Tcl in Developers' Handboo o docs/140568 doc [UPDATE] Outdated Perl info in Developers' Handbook o docs/140495 doc [patch] /etc/rc.conf.d is not documented in rc.conf(5) o docs/140494 doc [patch] Man page fix for getc(3) o docs/140474 doc signal(3) missing reference to NSIG o docs/140459 doc [patch] Grammar fix for nl_langinfo(3) o docs/140458 doc [patch] Grammar fix for to{upper,lower}(3) o docs/140457 doc [patch] Grammar fix for isspace(3) o docs/140444 doc [patch] New Traditional Chinese translation of custom- o docs/140435 doc man ls, section STANDARD: the -A is exception from POS o docs/140375 doc [UPDATE] Updated zh_TW.Big5/articles/nanobsd o docs/140369 doc [patch] src/contrib/pf/man/pf.4 o docs/140082 doc handbook/jails: russian translation is missing o docs/140075 doc release notes: missing word "NOT", which changes all t o docs/139682 doc [PATCH] dialog(1) man page does not mention radiolist o docs/139603 doc [patch] Clarify subpixel smoothing for fonts in Handbo p docs/139370 doc [PATCH] de(4) manual page typo o docs/139336 doc ZFS documentation suggestion o docs/139165 doc gssapi.3 man page out of sync with between crypto and o docs/139153 doc the hier(7) man page needs to be updated o docs/139018 doc translation of submitting.sgml from docproj/submitting o docs/138887 doc manpage ports(7) incorrect 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/138206 doc [patch] ntp(1): not enabled function, and false manual o docs/137762 doc [handbook] proposed: mention "make delete-old" in sec o docs/137171 doc [patch] replacement of k8temp(4) by amdtemp(4) isn't r o docs/136918 doc [patch] grammar fixes to locking.9 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/136100 doc change FreeBSD Ports distfiles survey's url to portsco o docs/136035 doc ftpchroot(5) omits an important option p docs/136029 doc MALLOC_PRODUCTION knob should be mentioned somewhere, o docs/135999 doc Netgear GS105v3 should be added to list of switches th o docs/135676 doc FAQ About The FreeBSD Mailing Lists doesn't mention ma o docs/135516 doc pax(1) manual not mentioning chflags unawareness o docs/135475 doc [patch] jot(1) manpage and behaviour differ o docs/135165 doc [patch] make(1) fixes: punctuation, typos, tweaks o docs/134376 doc pthread(3): pthread manpages don't mention that PTHREA o docs/134226 doc /usr/share/examples/ftpd/ftpd.conf does not exist. o docs/134222 doc installation failure of japanese docs o docs/134123 doc The RUNQUEUE(9) man page is out of date o docs/134074 doc [patch] locking.9 man page slight enhancements o docs/133567 doc [patch] doc/Makefile switch to csup o docs/133245 doc french handbook 27.3.5 amd.map amd.conf o docs/133228 doc handbook 23.3.5 screenmap section is confusing o docs/133186 doc [patch] powerd(8) man page errors o docs/133118 doc [patch] Error in getopt (1) manual EXAMPLES section o docs/132959 doc [patch] description mismatches on xterm/termcap, fortu o docs/132884 doc [request] No manpage for SYSINIT and SYSUNINIT 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/132311 doc [patch] man5/nsmb.conf.5 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/132113 doc [handbook] Update handbook jails creation o docs/131918 doc [patch] Fixes for the BPF(4) man page o docs/131684 doc [patch] articles/linux-comparison: replace Addenda by o docs/131590 doc [patch] whitespace-only change of developers-handbook/ o docs/130895 doc [patch] No man page installed for padlock(4) on amd64 o docs/130364 doc Man page for top needs explanation of CPU states 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/129095 doc ipfw(8): Can not check that packet originating/destine o docs/128524 doc No geom documentation for loading gjournal(8) 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 o docs/125751 doc man 3 pthread_getschedparam section ERRORS incomplete 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/121871 doc ftpd does not interpret configuration files as documen o docs/121585 doc [handbook] Wrong multicast specification o docs/121565 doc dhcp-options(5) manpage incorrectly formatted omitting s docs/121541 doc [request] no man pages for wlan_scan_ap o bin/121424 doc [patch] [ipfw] Rectify ambiguous English in manual 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/120456 doc ath(4) needs to specify requirement on wlan_scan_sta 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 a docs/119536 doc a few typos in French handbook (basics) o docs/118902 doc [patch] wrong signatures in d2i_RSAPublicKey man pages o docs/118332 doc man page for top does not describe STATE column wait e 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/117747 doc 'break' system call needs a man page o docs/116480 doc sysctl(3) description of kern.file no longer applies s o docs/116116 doc mktemp (3) re/move note o 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/114184 doc [patch] [ndis]: add info to man 4 ndis 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 o 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/108101 doc /boot/default/loader.conf contains an incorrect commen o docs/107924 docs [usb67] usbd(8) does not call detach 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/101464 doc sync ru_RU.KOI8-R/articles/portbuild/article.html with 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/91174 doc [REQUEST] Handbook: Addition of Oracle 9i installation 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/86342 doc bikeshed entry of Handbook is wrong 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/78480 doc Networked printer setup unnecessarily complex in handb o docs/63570 doc [patch] Language cleanup for the Handbook's DNS sectio 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 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/50211 doc [patch] doc.docbook.mk: fix textfile creation o docs/48101 doc [patch] add documentation on the fixit disk to the FAQ 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 174 problems total. From owner-freebsd-doc@FreeBSD.ORG Mon Nov 16 14:34:26 2009 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 EB19D1065693; Mon, 16 Nov 2009 14:34:26 +0000 (UTC) (envelope-from brueffer@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id C21248FC16; Mon, 16 Nov 2009 14:34:26 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id nAGEYQwl097465; Mon, 16 Nov 2009 14:34:26 GMT (envelope-from brueffer@freefall.freebsd.org) Received: (from brueffer@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id nAGEYQ82097461; Mon, 16 Nov 2009 15:34:26 +0100 (CET) (envelope-from brueffer) Date: Mon, 16 Nov 2009 15:34:26 +0100 (CET) Message-Id: <200911161434.nAGEYQ82097461@freefall.freebsd.org> To: Jeremyhu@apple.com, brueffer@FreeBSD.org, freebsd-doc@FreeBSD.org, brueffer@FreeBSD.org From: brueffer@FreeBSD.org Cc: Subject: Re: docs/140459: [patch] Grammar fix for nl_langinfo(3) 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, 16 Nov 2009 14:34:27 -0000 Synopsis: [patch] Grammar fix for nl_langinfo(3) State-Changed-From-To: open->patched State-Changed-By: brueffer State-Changed-When: Mon Nov 16 15:33:41 CET 2009 State-Changed-Why: Committed, thanks! Responsible-Changed-From-To: freebsd-doc->brueffer Responsible-Changed-By: brueffer Responsible-Changed-When: Mon Nov 16 15:33:41 CET 2009 Responsible-Changed-Why: MFC reminder. http://www.freebsd.org/cgi/query-pr.cgi?pr=140459 From owner-freebsd-doc@FreeBSD.ORG Mon Nov 16 16:11:38 2009 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 BF6C41065670; Mon, 16 Nov 2009 16:11:38 +0000 (UTC) (envelope-from brueffer@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 967F78FC0C; Mon, 16 Nov 2009 16:11:38 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id nAGGBcB2081479; Mon, 16 Nov 2009 16:11:38 GMT (envelope-from brueffer@freefall.freebsd.org) Received: (from brueffer@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id nAGGBcOf081475; Mon, 16 Nov 2009 17:11:38 +0100 (CET) (envelope-from brueffer) Date: Mon, 16 Nov 2009 17:11:38 +0100 (CET) Message-Id: <200911161611.nAGGBcOf081475@freefall.freebsd.org> To: dirk.meyer@dinoex.sub.org, brueffer@FreeBSD.org, freebsd-doc@FreeBSD.org From: brueffer@FreeBSD.org Cc: Subject: Re: docs/140594: getprogname.3 misleading 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, 16 Nov 2009 16:11:38 -0000 Synopsis: getprogname.3 misleading State-Changed-From-To: open->closed State-Changed-By: brueffer State-Changed-When: Mon Nov 16 17:06:40 CET 2009 State-Changed-Why: After consulting with kib, the manpage is correct. The sentence you're citing means that calling setprogname() even though it is not needed on FreeBSD allows getprogname() implementations on other systems to retrieve and return the program name in any case. http://www.freebsd.org/cgi/query-pr.cgi?pr=140594 From owner-freebsd-doc@FreeBSD.ORG Mon Nov 16 18:23:18 2009 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id A1FA0106566B for ; Mon, 16 Nov 2009 18:23:18 +0000 (UTC) (envelope-from jhelfman@e-e.com) Received: from mail.experts-exchange.com (mail.experts-exchange.com [64.156.132.251]) by mx1.freebsd.org (Postfix) with ESMTP id 89F0C8FC14 for ; Mon, 16 Nov 2009 18:23:18 +0000 (UTC) Received: from eggman.experts-exchange.com (unknown [72.29.180.81]) by mail.experts-exchange.com (Postfix) with ESMTP id 042474A2DF5B for ; Mon, 16 Nov 2009 09:04:50 -0800 (PST) Received: by eggman.experts-exchange.com (sSMTP sendmail emulation); Mon, 16 Nov 2009 10:22:15 -0800 Resent-From: Jason Resent-Date: Mon, 16 Nov 2009 10:22:15 -0800 Resent-Message-ID: <20091116182215.GB36953@eggman.experts-exchange.com> Resent-To: doc@freebsd.org Date: Sun, 15 Nov 2009 13:46:37 -0800 From: Jason To: doc@freebsd.org Message-ID: <20091115214610.GA17485@jason-helfmans-macbook-pro.local> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii; format=flowed Content-Disposition: inline X-Operating-System: Darwin 9.8.0 X-Living-The-Dream: I love the SLO Life! User-Agent: Mutt/1.5.20 (2009-06-14) Cc: Subject: bsdmag.org link placement 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, 16 Nov 2009 18:23:18 -0000 Hi I was wondering where a link I would like to submit for BSD Magazine, would be most appropriate? It isn't specifically FreeBSD, however it is specific to all BSD's, so I was thinking of putting under "International book & Magazines" found here: http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/bibliography.html#BIBLIOGRAPHY-FREEBSD or perhaps, here: http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/bibliography-journals.html Beyond this, I don't see the need for that latter link, as it could be condensed into the first, and renamed. That is another path, though. Any thoughts? Thanks, Jason From owner-freebsd-doc@FreeBSD.ORG Mon Nov 16 18:26:01 2009 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 AD296106566B for ; Mon, 16 Nov 2009 18:26:01 +0000 (UTC) (envelope-from jhelfman@e-e.com) Received: from mail.experts-exchange.com (mail.experts-exchange.com [64.156.132.251]) by mx1.freebsd.org (Postfix) with ESMTP id 999548FC25 for ; Mon, 16 Nov 2009 18:26:01 +0000 (UTC) Received: from eggman.experts-exchange.com (unknown [72.29.180.81]) by mail.experts-exchange.com (Postfix) with ESMTP id 7CF364A30BBA for ; Mon, 16 Nov 2009 09:07:00 -0800 (PST) Received: by eggman.experts-exchange.com (sSMTP sendmail emulation); Mon, 16 Nov 2009 10:24:57 -0800 Date: Mon, 16 Nov 2009 10:24:57 -0800 From: Jason To: freebsd-doc@freebsd.org Message-ID: <20091116182457.GC36953@eggman.experts-exchange.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii; format=flowed Content-Disposition: inline X-Operating-System: FreeBSD 7.2-RELEASE-p4 X-Living-The-Dream: I love the SLO Life! User-Agent: Mutt/1.5.20 (2009-06-14) Subject: bsdmag.org link placement 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, 16 Nov 2009 18:26:01 -0000 Hi I was wondering where a link I would like to submit for BSD Magazine, would be most appropriate? It isn't specifically FreeBSD, however it is specific to all BSD's, so I was thinking of putting under "International book & Magazines" found here: http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/bibliography.html#BIBLIOGRAPHY-FREEBSD or perhaps, here: http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/bibliography-journals.html Beyond this, I don't see the need for that latter link, as it could be condensed into the first, and renamed. That is another path, though. Any thoughts? Thanks, Jason From owner-freebsd-doc@FreeBSD.ORG Mon Nov 16 21:13:41 2009 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 4F8161065670; Mon, 16 Nov 2009 21:13:41 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 2574E8FC0C; Mon, 16 Nov 2009 21:13:41 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id nAGLDf7s040236; Mon, 16 Nov 2009 21:13:41 GMT (envelope-from bcr@freefall.freebsd.org) Received: (from bcr@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id nAGLDfpv040232; Mon, 16 Nov 2009 21:13:41 GMT (envelope-from bcr) Date: Mon, 16 Nov 2009 21:13:41 GMT Message-Id: <200911162113.nAGLDfpv040232@freefall.freebsd.org> To: bcr@FreeBSD.org, freebsd-doc@FreeBSD.org, bcr@FreeBSD.org From: bcr@FreeBSD.org Cc: Subject: Re: docs/140581: [mirrors] [patch] Link to Poly link doesn't work. Found a suitable replacement and named the full University. Go Poly. 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, 16 Nov 2009 21:13:41 -0000 Synopsis: [mirrors] [patch] Link to Poly link doesn't work. Found a suitable replacement and named the full University. Go Poly. Responsible-Changed-From-To: freebsd-doc->bcr Responsible-Changed-By: bcr Responsible-Changed-When: Mon Nov 16 21:11:44 UTC 2009 Responsible-Changed-Why: I take care of that. http://www.freebsd.org/cgi/query-pr.cgi?pr=140581 From owner-freebsd-doc@FreeBSD.ORG Mon Nov 16 22:47:38 2009 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id C12B21065672 for ; Mon, 16 Nov 2009 22:47:38 +0000 (UTC) (envelope-from r.c.ladan@gmail.com) Received: from ey-out-2122.google.com (ey-out-2122.google.com [74.125.78.27]) by mx1.freebsd.org (Postfix) with ESMTP id 4AF5A8FC15 for ; Mon, 16 Nov 2009 22:47:37 +0000 (UTC) Received: by ey-out-2122.google.com with SMTP id 9so1928889eyd.9 for ; Mon, 16 Nov 2009 14:47:37 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:sender:message-id:date:from :organization:user-agent:mime-version:to:subject:x-enigmail-version :content-type; bh=q+SYpJU6CZCpjso4qojGeC/qb44v4pt5Pyo+TpyUVgg=; b=Ogast+df3zKBwdb0cK/yttaIsrvx6O7Alt2yPcuGL5iZHkXkfDhXXRRiFTY5Hkbw9g SPCrpfqW8TxuNxiYSzrZrnsZ9ItkseMayU1YqxVwskk2aXPbEBr+nug/IDgUzWbxKtgw WX6Se3GFtR6WdIPhllYyMu0PfUNKnntEtDK2Y= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=sender:message-id:date:from:organization:user-agent:mime-version:to :subject:x-enigmail-version:content-type; b=Bcp+tYRFCLwyI0u8AutSW4RkQ1T5swNS2lCMKsp3PNFpLDTd65iNTIqGur/1JFRfr6 O/WU+tGsfsLtYdL4Y+GsbLRVPLjrMpC0ApJQ40z+w7NFXEdq+TXnANfqpBts5iAOr3Da cwTZhPh8QRSxHDHfc5oMesbSGbsG0wI48IzJw= Received: by 10.213.109.156 with SMTP id j28mr2072810ebp.79.1258411656252; Mon, 16 Nov 2009 14:47:36 -0800 (PST) Received: from self.rene-ladan.nl (ip4da3ae31.direct-adsl.nl [77.163.174.49]) by mx.google.com with ESMTPS id 24sm6304762eyx.5.2009.11.16.14.47.35 (version=TLSv1/SSLv3 cipher=RC4-MD5); Mon, 16 Nov 2009 14:47:35 -0800 (PST) Sender: Rene Ladan Message-ID: <4B01D5C9.4080207@freebsd.org> Date: Mon, 16 Nov 2009 23:44:25 +0100 From: Rene Ladan Organization: The FreeBSD Project User-Agent: Thunderbird 2.0.0.23 (X11/20090826) MIME-Version: 1.0 To: "doc@FreeBSD.org" X-Enigmail-Version: 0.95.6 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="------------enigA24CE0F4F79B7318097A72BD" Cc: Subject: [RFC] [patch] Clang section for Porters Handbook 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, 16 Nov 2009 22:47:38 -0000 This is an OpenPGP/MIME signed message (RFC 2440 and 3156) --------------enigA24CE0F4F79B7318097A72BD Content-Type: multipart/mixed; boundary="------------070207010900080605070008" This is a multi-part message in MIME format. --------------070207010900080605070008 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: quoted-printable Hi list, attached is a patch for the Porters Handbook listing some extra rules to = keep in mind when writing ports against the future Clang compiler (see=20 also http://wiki.freebsd.org/BuildingFreeBSDWithClang ). It has already been reviewed by some members of The Clang Team and some=20 doc people. Comments/suggestions/approvals are welcome. Regards, Rene --=20 http://www.rene-ladan.nl/ GPG fingerprint =3D ADBC ECCD EB5F A6B4 549F 600D 8C9E 647A E564 2BFC=20 (subkeys.pgp.net) --------------070207010900080605070008 Content-Type: text/plain; name="phb-clang.diff" Content-Transfer-Encoding: quoted-printable Content-Disposition: inline; filename="phb-clang.diff" =3D=3D=3D=3D //depot/projects/docproj_nl/en_US.ISO8859-1/books/porters-ha= ndbook/book.sgml#49 - /home/rene/freebsd/p4/doc/en_US.ISO8859-1/books/por= ters-handbook/book.sgml =3D=3D=3D=3D 13604a13605,13693 > > Clang: new C/C++ compiler >=20 > A future version of &os; will likely have the Clang C/C++ > compiler as its base compiler. Some modifications to the Ports > Collection are necessary. In general, these are write proper= > ports and write proper source code. More > specifically: >=20 > > > Respect the CC and CXX= > variables. Do not use any of the programs cc, > c99, gcc, > c++, or g++ in a port > directly. > >=20 > > Respect LD, do not use > ld in a port directly. > >=20 > > Do not use cpp for reformatting manual > pages or shell scripts. Try to use something more suitable > instead, possibly falling back to CPP.= > > >=20 > > Clang uses the gnu99 standard by default, while GCC uses the= > gnu89 standard by default. Therefore, if there are any linker > errors caused by the different semantics of > inline, compiler errors caused by the use of > reserved C99 keywords (i.e. restrict) or calls to unimplemented > ISO C99 math routines try to add USE_CSTD=3Dgnu89 > to the port Makefile. > >=20 > > The -traditional option is not supported,= > so existing occurences have to be removed. No concensus has yet= > been reached on ports abusing this option to preserve white spac= e > in text formatting. Note that the Clang preprocessor does not > preserve white space. > >=20 > > Explicit type indication of variables must be used in > built-in assembler code. > >=20 > > The main function must be properly declared as: >=20 > int main(int argc, char **argv) >=20 > or, if there are no parameters, as: >=20 > int main(void) > >=20 > > The maximum useable optimization level is 3. Level 4 is > reserved for link-time optimization for the Clang backend. > >=20 > > >=20 > Some temporary hacks that might be used if all else fails: >=20 > > > Adding -fheinous-gnu-extensions. Note > that this option is already deprecated. > >=20 > > Reducing the warning level by adding > --diasable-werror or > --disable-strict, or by disabling > --warn-common or > -Werror. > > > >=20 --------------070207010900080605070008-- --------------enigA24CE0F4F79B7318097A72BD Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.13 (FreeBSD) Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org iEYEARECAAYFAksB1oYACgkQjJ5keuVkK/zNBQCgzj7x1q4EkfMuzBRQicyANoyi SW0AmQE0ICNbfeNdNzzLIxMAgeMXHIz9 =+xTV -----END PGP SIGNATURE----- --------------enigA24CE0F4F79B7318097A72BD-- From owner-freebsd-doc@FreeBSD.ORG Mon Nov 16 23:10:01 2009 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 B245F1065670 for ; Mon, 16 Nov 2009 23:10: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 90B248FC13 for ; Mon, 16 Nov 2009 23:10:01 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id nAGNA13I034431 for ; Mon, 16 Nov 2009 23:10:01 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id nAGNA1RR034430; Mon, 16 Nov 2009 23:10:01 GMT (envelope-from gnats) Resent-Date: Mon, 16 Nov 2009 23:10:01 GMT Resent-Message-Id: <200911162310.nAGNA1RR034430@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, Andrius Morkunas Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 10ED3106566B for ; Mon, 16 Nov 2009 23:04:09 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id 00F8F8FC13 for ; Mon, 16 Nov 2009 23:04:09 +0000 (UTC) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.3/8.14.3) with ESMTP id nAGN48fE044471 for ; Mon, 16 Nov 2009 23:04:08 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.14.3/8.14.3/Submit) id nAGN48Mn044470; Mon, 16 Nov 2009 23:04:08 GMT (envelope-from nobody) Message-Id: <200911162304.nAGN48Mn044470@www.freebsd.org> Date: Mon, 16 Nov 2009 23:04:08 GMT From: Andrius Morkunas To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/140615: [patch] Typo in queue(3) 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, 16 Nov 2009 23:10:01 -0000 >Number: 140615 >Category: docs >Synopsis: [patch] Typo in queue(3) >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 16 23:10:00 UTC 2009 >Closed-Date: >Last-Modified: >Originator: Andrius Morkunas >Release: 9-CURRENT >Organization: >Environment: >Description: queue(3) manual has a sentence beginning with "Each elements", where it should be "Each element". >How-To-Repeat: >Fix: Patch attached. Patch attached with submission follows: --- share/man/man3/queue.3 (revision 199338) +++ share/man/man3/queue.3 (working copy) @@ -233,7 +233,7 @@ However: .Bl -enum -compact -offset indent .It -Each elements requires two pointers rather than one. +Each element requires two pointers rather than one. .It Code size and execution time of operations (except for removal) is about twice that of the singly-linked data-structures. >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Mon Nov 16 23:29:55 2009 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 544C91065679 for ; Mon, 16 Nov 2009 23:29:55 +0000 (UTC) (envelope-from linimon@lonesome.com) Received: from mail.soaustin.net (lefty.soaustin.net [66.135.55.46]) by mx1.freebsd.org (Postfix) with ESMTP id 324348FC19 for ; Mon, 16 Nov 2009 23:29:55 +0000 (UTC) Received: by mail.soaustin.net (Postfix, from userid 502) id 9F35D8C068; Mon, 16 Nov 2009 17:29:54 -0600 (CST) Date: Mon, 16 Nov 2009 17:29:54 -0600 From: Mark Linimon To: Rene Ladan Message-ID: <20091116232954.GA6511@lonesome.com> References: <4B01D5C9.4080207@freebsd.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <4B01D5C9.4080207@freebsd.org> User-Agent: Mutt/1.5.18 (2008-05-17) Cc: doc@FreeBSD.org Subject: Re: [RFC] [patch] Clang section for Porters Handbook 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, 16 Nov 2009 23:29:55 -0000 Looks nice. Here are some ideas. > A future version of &os; will likely have the Clang C/C++ > compiler as its base compiler. Some modifications to the Ports > Collection are necessary. In general, these are write proper > ports and write proper source code. To me, this last sentence is worded a little awkwardly (partly because of the tense). How about: In general, these involve generalizing the port and making the source code portable. > so existing occurences have to be removed. No concensus has yet consensus > The maximum useable optimization level is 3. Level 4 is usable (don't feel bad, I had to look it up) > Some temporary hacks that might be used if all else fails: I'm almost wondering if the c89 hack might be moved to here, but I'm not sure. mcl From owner-freebsd-doc@FreeBSD.ORG Tue Nov 17 07:07:15 2009 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 404511065787; Tue, 17 Nov 2009 07:07:15 +0000 (UTC) (envelope-from brueffer@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 170938FC19; Tue, 17 Nov 2009 07:07:15 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id nAH77EJ8055468; Tue, 17 Nov 2009 07:07:14 GMT (envelope-from brueffer@freefall.freebsd.org) Received: (from brueffer@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id nAH77EBh055464; Tue, 17 Nov 2009 08:07:14 +0100 (CET) (envelope-from brueffer) Date: Tue, 17 Nov 2009 08:07:14 +0100 (CET) Message-Id: <200911170707.nAH77EBh055464@freefall.freebsd.org> To: hinokind@gmail.com, brueffer@FreeBSD.org, freebsd-doc@FreeBSD.org, brueffer@FreeBSD.org From: brueffer@FreeBSD.org Cc: Subject: Re: docs/140615: [patch] Typo in queue(3) 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, 17 Nov 2009 07:07:15 -0000 Synopsis: [patch] Typo in queue(3) State-Changed-From-To: open->patched State-Changed-By: brueffer State-Changed-When: Tue Nov 17 08:06:47 CET 2009 State-Changed-Why: Committed, thanks! Responsible-Changed-From-To: freebsd-doc->brueffer Responsible-Changed-By: brueffer Responsible-Changed-When: Tue Nov 17 08:06:47 CET 2009 Responsible-Changed-Why: MFC reminder. http://www.freebsd.org/cgi/query-pr.cgi?pr=140615 From owner-freebsd-doc@FreeBSD.ORG Tue Nov 17 07:11:10 2009 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 10171106566B for ; Tue, 17 Nov 2009 07:11:10 +0000 (UTC) (envelope-from noreply@eyeofdubai.com) Received: from eyeofdubai.com (eyeofdubai.com [213.42.18.62]) by mx1.freebsd.org (Postfix) with ESMTP id 6C3078FC17 for ; Tue, 17 Nov 2009 07:11:08 +0000 (UTC) Received: from eyeofdubai ([10.4.95.4]) by eyeofdubai.com with Microsoft SMTPSVC(6.0.3790.3959); Tue, 17 Nov 2009 11:11:02 +0400 From: "Jumeirah Bab Al Shams Desert Resort & Spa" To: freebsd-doc@FreeBSD.org Date: Tue, 17 Nov 2009 11:11:02 +0400 Message-ID: <20091117-11110239-16c0@eyeofdubai> X-OriginalArrivalTime: 17 Nov 2009 07:11:02.0390 (UTC) FILETIME=[1F06C960:01CA6755] MIME-Version: 1.0 Content-Type: text/plain X-Content-Filtered-By: Mailman/MimeDel 2.1.5 Cc: Subject: Exclusive Eid Festivities at Jumeirah Bab Al Shams Desert Resort & Spa 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, 17 Nov 2009 07:11:10 -0000 Kindly [1]click here, If you are not able to view the content of this e-mail. [2]Bab Al Shams Resort & Spa [3]Bab Al Shams Resort & Spa [_space.gif] Jumeirah Bab Al Shams Desert Resort & Spa is offering an array of endless activities to get your pulse racing during the time of Eid Al Adha. We have everything from camel riding and desert tours to a magnificent fireworks display, not to mention all the treatments at the Spa and the leisure activities around the pool area. How you spend your days at Jumeirah Bab Al Shams is completely up to you, the beauty of it, is that you can be as lazy or as active as you want. [4]CLICK HERE TO VIEW OUR OFFERS THIS EID AL ADHA To make a booking or for more information please contact us on: Tel: +971 4 8096100 Email:[5]JBASinfo@jumeirah.com [_space.gif] [_space.gif] PO Box 8168, Al Qudra Road, Dubai, UAE Tel: +971 4 809 6100 Fax: +971 4 809 6698 Email: [6]JBASinfo@jumeirah.com [7]Stay Different [_space.gif] The information in this email is private & confidential. It is intended only for the use of the person(s) named. If you are not the intended recipient, you are notified that any dissemination or copying of this communication is prohibited and kindly requested to notify the sender and to then delete this message. Jumeirah International LLC gives no representation or guarantee with respect to the integrity of any emails or attached files. We respect your online time and privacy and promise not to abuse this medium. To view Jumeirah's privacy policy please visit: [8]www.jumeirah.com/privacy_policy/ [9]Unsubscribe from Eyeofdubai.com mailing list You are currently subscribed to receive emails/newsletters from Eyeofdubai.com. You can modify your subscription settings at any time. [10]Eyeofdubai.com respects your privacy and does not share any information about you with other parties. References 1. http://www.eyeofdubai.com/emails/babshams.html 2. http://www.eyeofdubai.com/bannerm/abmc.asp?b=545&z=17 3. http://www.eyeofdubai.com/bannerm/abmc.asp?b=546&z=17 4. http://www.eyeofdubai.com/bannerm/abmc.asp?b=547&z=17 5. mailto:JBASinfo@jumeirah.com 6. mailto:JBASinfo@jumeirah.com 7. http://www.eyeofdubai.com/bannerm/abmc.asp?b=548&z=17 8. http://www.jumeirah.com/privacy_policy/ 9. http://eyeofdubai.com/en/newsletter/unsubscribe.asp?email=freebsd-doc@FreeBSD.org&emailid=322756 10. http://eyeofdubai.com/v1/about/privacy.asp From owner-freebsd-doc@FreeBSD.ORG Tue Nov 17 12:03:26 2009 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 3CC9D10656CB for ; Tue, 17 Nov 2009 12:03:26 +0000 (UTC) (envelope-from r.c.ladan@gmail.com) Received: from mail-bw0-f220.google.com (mail-bw0-f220.google.com [209.85.218.220]) by mx1.freebsd.org (Postfix) with ESMTP id 85D938FC34 for ; Tue, 17 Nov 2009 12:03:18 +0000 (UTC) Received: by mail-bw0-f220.google.com with SMTP id 20so6817677bwz.14 for ; Tue, 17 Nov 2009 04:03:18 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:mime-version:sender:received:in-reply-to :references:date:x-google-sender-auth:message-id:subject:from:to:cc :content-type:content-transfer-encoding; bh=q68svT+av6rq8yw8ubHvCgJxbBiAwDwuPB19mhbhTkQ=; b=ifPaWhLJmHPmEK2T98B7NeMzPN0EmkZXuy8jlVTtVsz1Qunpj9a8yl9kYPv6sVfgPf JDC9nsQtcRr/oZEkey4m2sWNC/JrRaxDeMqAsfKaibL+/idUKt4F6Wl8QtWbhzW19hyS wHGR9NyodkjRRduyI/UASgdjoVyAyGC7n7gVs= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=mime-version:sender:in-reply-to:references:date :x-google-sender-auth:message-id:subject:from:to:cc:content-type :content-transfer-encoding; b=Ey2/CkTAhKRtLoDGtlBThIM8LnAguSNX8r1pOYX2XMR+fXkomCLirgMHNyAB8fEhbq oQrdGybCGtkRfaxmGbeY0e9aD+nmyUUGZbr0tNkPkEARKeRGGz30/JKyxUv5D7E85ONg wfrxNR0Z6G7iDWsZCPzQ/RrLmXwEV6vz17/WM= MIME-Version: 1.0 Sender: r.c.ladan@gmail.com Received: by 10.239.168.230 with SMTP id l38mr941982hbe.37.1258459394986; Tue, 17 Nov 2009 04:03:14 -0800 (PST) In-Reply-To: <20091116232954.GA6511@lonesome.com> References: <4B01D5C9.4080207@freebsd.org> <20091116232954.GA6511@lonesome.com> Date: Tue, 17 Nov 2009 13:03:14 +0100 X-Google-Sender-Auth: 0bb43d2b5ccebc75 Message-ID: From: Rene Ladan To: Mark Linimon Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable Cc: "doc@FreeBSD.org" Subject: Re: [RFC] [patch] Clang section for Porters Handbook 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, 17 Nov 2009 12:03:30 -0000 2009/11/17 Mark Linimon : > Looks nice. =A0Here are some ideas. > >> =A0 =A0 =A0 A future version of &os; will likely have the Clang C/= C++ >> =A0 =A0 =A0 =A0 compiler as its base compiler. =A0Some modifications to = the Ports >> =A0 =A0 =A0 =A0 Collection are necessary. =A0In general, these are write proper >> =A0 =A0 =A0 =A0 =A0 ports and write proper source code. > > To me, this last sentence is worded a little awkwardly (partly because > of the tense). =A0How about: > > =A0In general, these involve generalizing the port and > =A0making the source code portable. > This indeeds sounds better. >> =A0 =A0 =A0 =A0 =A0 =A0 so existing occurences have to be removed. =A0No= concensus has yet > > =A0consensus > aspell also found 'occurrences', I should have spell checked it earlier ... >> =A0 =A0 =A0 =A0 =A0 The maximum useable optimization level is 3. = =A0Level 4 is > > =A0usable (don't feel bad, I had to look it up) > >> =A0 =A0 =A0 Some temporary hacks that might be used if all else fa= ils: > > I'm almost wondering if the c89 hack might be moved to here, but I'm not = sure. > Isn't this more like a flag to be able to compile old code? In this case the c89 flag is not a hack, given that the code is following the standard (here gnu89). See p4 revision 170700 Regards, Rene From owner-freebsd-doc@FreeBSD.ORG Tue Nov 17 17:46:56 2009 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 997B51065693 for ; Tue, 17 Nov 2009 17:46:56 +0000 (UTC) (envelope-from ray.kinsella@intel.com) Received: from mga03.intel.com (mga03.intel.com [143.182.124.21]) by mx1.freebsd.org (Postfix) with ESMTP id 6CFD88FC2A for ; Tue, 17 Nov 2009 17:46:56 +0000 (UTC) Content-Type: multipart/mixed; boundary="===============0253730127==" X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="4.44,759,1249282800"; d="p7s'?scan'208";a="212531979" Received: from irsmsx502.ger.corp.intel.com ([163.33.7.249]) by irsmsx601.ger.corp.intel.com ([163.33.7.164]) with mapi; Tue, 17 Nov 2009 17:17:51 +0000 From: "Kinsella, Ray" To: "doc@FreeBSD.org" Date: Tue, 17 Nov 2009 17:17:50 +0000 Thread-Topic: Programmers' Guides Thread-Index: AcpnfhUahylc8TNZSVedV93RbhHMigAKi6iw Message-ID: References: <4B01D5C9.4080207@freebsd.org> <20091116232954.GA6511@lonesome.com> In-Reply-To: Accept-Language: en-US X-MS-Has-Attach: yes X-MS-TNEF-Correlator: acceptlanguage: en-US MIME-Version: 1.0 Cc: Subject: Programmers' Guides 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, 17 Nov 2009 17:46:56 -0000 --===============0253730127== MIME-Version: 1.0 Content-Language: en-US Content-Type: multipart/signed; micalg=SHA1; protocol="application/x-pkcs7-signature"; boundary="----=_NextPart_000_00C1_01CA67A9.E3CDA6C0" ------=_NextPart_000_00C1_01CA67A9.E3CDA6C0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Hi all, I am the author of two practical papers on debugging FreeBSD Kernel code. The first paper was presented at EuroBSD Con 2009. The second is published on the Intel website (oss.intel.com). Both papers are available on oss.intel.com, and are both substantial pieces of work. The first paper Profiling and Debugging the FreeBSD* Kernel deals with resolving performance problems in FreeBSD Kernel code. This will be of practical interest to anyone creating FreeBSD Kernel code. I give a practical example of a misbehaving driver and show how to resolve the problem with FreeBSD's Pmcstat and supporting tools. http://software.intel.com/sites/oss/pdfs/profiling_debugging_freebsd_kernel_ 321772.pdf The second paper, Debugging Buffer Overruns in the FreeBSD Kernel deals with memory overruns in FreeBSD Kernel code. Again this will be of practical use to anyone developing FreeBSD Kernel code. I give practical examples of debugging buffer overruns on the stack and on the heap, and show how to resolve them with tools built into the FreeBSD Kernel. http://software.intel.com/sites/oss/pdfs/debugging_buffer_overruns_322486.pd f Would it be possible to add these papers to the FreeBSD Handbook's Programmers' Guides section? Thanks Ray Kinsella ------=_NextPart_000_00C1_01CA67A9.E3CDA6C0 Content-Type: application/x-pkcs7-signature; name="smime.p7s" Content-Transfer-Encoding: base64 Content-Disposition: attachment; filename="smime.p7s" MIAGCSqGSIb3DQEHAqCAMIACAQExCzAJBgUrDgMCGgUAMIAGCSqGSIb3DQEHAQAAoIIRzzCCAyAw ggKJoAMCAQICBDXe9M8wDQYJKoZIhvcNAQEFBQAwTjELMAkGA1UEBhMCVVMxEDAOBgNVBAoTB0Vx dWlmYXgxLTArBgNVBAsTJEVxdWlmYXggU2VjdXJlIENlcnRpZmljYXRlIEF1dGhvcml0eTAeFw05 ODA4MjIxNjQxNTFaFw0xODA4MjIxNjQxNTFaME4xCzAJBgNVBAYTAlVTMRAwDgYDVQQKEwdFcXVp ZmF4MS0wKwYDVQQLEyRFcXVpZmF4IFNlY3VyZSBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkwgZ8wDQYJ KoZIhvcNAQEBBQADgY0AMIGJAoGBAMFdsVhnCGLuoJotHwhtkRRomAoe/toEbxOEYiHD0XzOnwXg uAHwTjTs4oqVBGSs8WtTXwWzy2eAv0ICjv7dAQns4QAUT/z78AzdQ7pbK+EfgHCZFVeTFvEPl2q3 wmgjHMxNWTCsUR47ryvW7mNFe8XZX1DS41APOojnvxT94Me5AgMBAAGjggEJMIIBBTBwBgNVHR8E aTBnMGWgY6BhpF8wXTELMAkGA1UEBhMCVVMxEDAOBgNVBAoTB0VxdWlmYXgxLTArBgNVBAsTJEVx dWlmYXggU2VjdXJlIENlcnRpZmljYXRlIEF1dGhvcml0eTENMAsGA1UEAxMEQ1JMMTAaBgNVHRAE EzARgQ8yMDE4MDgyMjE2NDE1MVowCwYDVR0PBAQDAgEGMB8GA1UdIwQYMBaAFEjmaPkr0rKV10fY IyAQTzOYkJ/UMB0GA1UdDgQWBBRI5mj5K9KylddH2CMgEE8zmJCf1DAMBgNVHRMEBTADAQH/MBoG CSqGSIb2fQdBAAQNMAsbBVYzLjBjAwIGwDANBgkqhkiG9w0BAQUFAAOBgQBYzinq/Pfetc4CuRe1 hdG54+CVzCUxDQCmkm5/tpJjnlCV0Zpv5BHeY4VumO6o/1rI01WyZnFX3sAh6z0qpyNJAQSGQnv8 7n+iFlK1Z2fTQNs7JliyKHc9rhR3Ydb6KmYnoA36p3Nc6nDxlCFlRF/6/O8paKmih3nvee9PrAd3 ODCCAz0wggKmoAMCAQICAwWw/zANBgkqhkiG9w0BAQUFADBOMQswCQYDVQQGEwJVUzEQMA4GA1UE ChMHRXF1aWZheDEtMCsGA1UECxMkRXF1aWZheCBTZWN1cmUgQ2VydGlmaWNhdGUgQXV0aG9yaXR5 MB4XDTA2MDIxNjE4MDEzMFoXDTE2MDIxOTE4MDEzMFowUjELMAkGA1UEBhMCVVMxGjAYBgNVBAoT EUludGVsIENvcnBvcmF0aW9uMScwJQYDVQQDEx5JbnRlbCBFeHRlcm5hbCBCYXNpYyBQb2xpY3kg Q0EwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDBpd/XOb9QVqEZ8mQ1042TdOIq3ATD IsV2xDyt30yLyMR5Wjtus0bn3B+he89BiNO/LP6+rFzEwlD55PlX+HLGIKeNNG97dqyc30FElEUj ZzTZFq2N4e3kVJ/XAEEgANzV8v9qp7qWwxugPgfc3z9BkYot+CifozexHLb/hEZj+yISCU61kRZv uSQ0E11yYL4dRgcglJeaHo3oX57rvIckaLsYV5/1Aj+R8DM1Ppk965XQAKsHfnyT7C4S50T4lVn4 lz36wOdNZn/zegG1zp41lnoTFfT4KuKVJH5x7YD1p6KbgJCKLovnujGuohquBNfdXKpZkvz6pGv+ iC1HawJdAgMBAAGjgaAwgZ0wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBQaxgxKxEdvqNutK/D0 Vgaj7TdUDDA6BgNVHR8EMzAxMC+gLaArhilodHRwOi8vY3JsLmdlb3RydXN0LmNvbS9jcmxzL3Nl Y3VyZWNhLmNybDAfBgNVHSMEGDAWgBRI5mj5K9KylddH2CMgEE8zmJCf1DAPBgNVHRMBAf8EBTAD AQH/MA0GCSqGSIb3DQEBBQUAA4GBABMQOK2kVKVIlUWwLTdywJ+e2O+PC/uQltK2F3lRyrPfBn69 tOkIP4SgDJOfsxyobIrPLe75kBLw+Dom13OBDp/EMZJZ1CglQfVV8co9mT3aZMjSGGQiMgkJLR3j Mfr900fXZKj5XeqCJ+JP0mEhJGEdVCY+FFlksJjV86fDrq1QMIIFYzCCBEugAwIBAgIKYSyl/gAA AAAABjANBgkqhkiG9w0BAQUFADBSMQswCQYDVQQGEwJVUzEaMBgGA1UEChMRSW50ZWwgQ29ycG9y YXRpb24xJzAlBgNVBAMTHkludGVsIEV4dGVybmFsIEJhc2ljIFBvbGljeSBDQTAeFw0wNjAzMjIy MjIyNDdaFw0xMjAzMjIyMjMyNDdaMFYxCzAJBgNVBAYTAlVTMRowGAYDVQQKExFJbnRlbCBDb3Jw b3JhdGlvbjErMCkGA1UEAxMiSW50ZWwgRXh0ZXJuYWwgQmFzaWMgSXNzdWluZyBDQSAzQjCCASIw DQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMDoHJYUGvcdR4k0Qv8/RrwNX4+vEe5PN2LnGn4x fIWwdUbk5+zvrRy1HjoKdG/AShZfxAuFoVyNIah5GJLpiS/vGbsDYKK+EZcIcmtPfvbB9Yg09EnQ 0OpsZ2ORRd5lYUfMUU+zkpgL96vKFdkiG+eeHEwnSS3VikGVrF7UDdKfvxZwRwQCx6rEHAFPCjBD VfGYZuYT1EDhSDvzEiU7KzBsxrdBCFU4RYL7kh+do+vyMDlBzpw3WKvMVbf3s5lxYiY7AjEhU8OS yZEQlgtK8PNyifHjmyrSaeJrPshM3PuLFG4d3gm1UJEiGNzxcHGb6YLP29IQAwY5mAk8j+UOVcsC AwEAAaOCAjUwggIxMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFG/DcREooZ0ZV/VnV8/ZKSaI 1aWiMAsGA1UdDwQEAwIBhjAQBgkrBgEEAYI3FQEEAwIBADAZBgkrBgEEAYI3FAIEDB4KAFMAdQBi AEMAQTAfBgNVHSMEGDAWgBQaxgxKxEdvqNutK/D0Vgaj7TdUDDCBvQYDVR0fBIG1MIGyMIGvoIGs oIGphk5odHRwOi8vd3d3LmludGVsLmNvbS9yZXBvc2l0b3J5L0NSTC9JbnRlbCUyMEV4dGVybmFs JTIwQmFzaWMlMjBQb2xpY3klMjBDQS5jcmyGV2h0dHA6Ly9jZXJ0aWZpY2F0ZXMuaW50ZWwuY29t L3JlcG9zaXRvcnkvQ1JML0ludGVsJTIwRXh0ZXJuYWwlMjBCYXNpYyUyMFBvbGljeSUyMENBLmNy bDCB4wYIKwYBBQUHAQEEgdYwgdMwYwYIKwYBBQUHMAKGV2h0dHA6Ly93d3cuaW50ZWwuY29tL3Jl cG9zaXRvcnkvY2VydGlmaWNhdGVzL0ludGVsJTIwRXh0ZXJuYWwlMjBCYXNpYyUyMFBvbGljeSUy MENBLmNydDBsBggrBgEFBQcwAoZgaHR0cDovL2NlcnRpZmljYXRlcy5pbnRlbC5jb20vcmVwb3Np dG9yeS9jZXJ0aWZpY2F0ZXMvSW50ZWwlMjBFeHRlcm5hbCUyMEJhc2ljJTIwUG9saWN5JTIwQ0Eu Y3J0MA0GCSqGSIb3DQEBBQUAA4IBAQBAiWWHL6T21QXFZDyaUIye0jh7f40GXqi75Ro5JbpROtlZ BqyRq6oPMAG6Igxd5Bd9TMtNkOvguknFnK1y17UdMhLOl+FuInE+FAWk803aRW27OsX+ot0KmPio KnZ3L1K5qcQS3tp6or7AaZzd0w0qFitm4UfP9nnTXQtY9XM5QJ07IKFDE3tlOlamKhjbiJV3FKig CVesPZSx9h2G7Ve4irEfz915Vks26AJHGZagEHNxM9exkgem4ENsG+t0vYqn9x7YsqJ6fmbOSyrz jzb3CYeEfyE5SL+f3Vx9uMsQDyb8LVCDBXQtxLEHnFEBPrRSSF9kPmyjavx4UqFdPEyCMIIF/zCC BOegAwIBAgIKSPUYwwAAAAA15TANBgkqhkiG9w0BAQUFADBWMQswCQYDVQQGEwJVUzEaMBgGA1UE ChMRSW50ZWwgQ29ycG9yYXRpb24xKzApBgNVBAMTIkludGVsIEV4dGVybmFsIEJhc2ljIElzc3Vp bmcgQ0EgM0IwHhcNMDkwMzI1MDkyNTMzWhcNMTIwMzIyMjIzMjQ3WjA/MRYwFAYDVQQDEw1LaW5z ZWxsYSwgUmF5MSUwIwYJKoZIhvcNAQkBFhZyYXkua2luc2VsbGFAaW50ZWwuY29tMIIBIjANBgkq hkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAoT7HNPtxQpHOg60SRT1ceJ2CrDJwUAv57pZG0q3Um2QZ H6RBUqM8yi1ZEmmRSIK9XRsDUxa5i+GD1aeGUHRSK2S7nU9RFp900Mga82JkdPWoV4qA1nrpMv2V X0hLMJVEeOXLK9UBmtejhZO+0LwoWrkacnJI8nhYM5YVTWD+KA5eSz8UTxsDkeFysWKthuFdLk9K DgLNP6nW9a2oBqN52zbupe5smH5nVIwBuAxICYDywuSvrqtMW20YbLqgsT/lYpDUkOWgq7mCPoEv 8BVf/pVqq6cWyubj24qmfbYtZbWiVXZMa5P59dx45P4Ah7uG+ddLylCOHpGw4e9ddXtezQIDAQAB o4IC5DCCAuAwCwYDVR0PBAQDAgeAMB0GA1UdDgQWBBQfHQ4yND0z7mUztWvswOmnwFpuWzA8Bgkr BgEEAYI3FQcELzAtBiUrBgEEAYI3FQiGw4x1hJnlUYP9gSiFjp9TgpHACWeB3r05lfBDAgFkAgEG MB8GA1UdIwQYMBaAFG/DcREooZ0ZV/VnV8/ZKSaI1aWiMIHJBgNVHR8EgcEwgb4wgbuggbiggbWG VGh0dHA6Ly93d3cuaW50ZWwuY29tL3JlcG9zaXRvcnkvQ1JML0ludGVsJTIwRXh0ZXJuYWwlMjBC YXNpYyUyMElzc3VpbmclMjBDQSUyMDNCLmNybIZdaHR0cDovL2NlcnRpZmljYXRlcy5pbnRlbC5j b20vcmVwb3NpdG9yeS9DUkwvSW50ZWwlMjBFeHRlcm5hbCUyMEJhc2ljJTIwSXNzdWluZyUyMENB JTIwM0IuY3JsMIHvBggrBgEFBQcBAQSB4jCB3zBpBggrBgEFBQcwAoZdaHR0cDovL3d3dy5pbnRl bC5jb20vcmVwb3NpdG9yeS9jZXJ0aWZpY2F0ZXMvSW50ZWwlMjBFeHRlcm5hbCUyMEJhc2ljJTIw SXNzdWluZyUyMENBJTIwM0IuY3J0MHIGCCsGAQUFBzAChmZodHRwOi8vY2VydGlmaWNhdGVzLmlu dGVsLmNvbS9yZXBvc2l0b3J5L2NlcnRpZmljYXRlcy9JbnRlbCUyMEV4dGVybmFsJTIwQmFzaWMl MjBJc3N1aW5nJTIwQ0ElMjAzQi5jcnQwHwYDVR0lBBgwFgYIKwYBBQUHAwQGCisGAQQBgjcKAwww KQYJKwYBBAGCNxUKBBwwGjAKBggrBgEFBQcDBDAMBgorBgEEAYI3CgMMMEkGA1UdEQRCMECgJgYK KwYBBAGCNxQCA6AYDBZyYXkua2luc2VsbGFAaW50ZWwuY29tgRZyYXkua2luc2VsbGFAaW50ZWwu Y29tMA0GCSqGSIb3DQEBBQUAA4IBAQCeR8WwK2VmUnnYGt6w8YIBqfFwMckAuUBKHhg0shlO52Fg Jf0S90dIaBNarrdfEb/CRlknj13BHYhxQTK1j21dTn+uArfQd8q18OMdF4IqeXL5U3W4QvzkfxzL L7C2dsKQ9v1nYVi6wT8xIc/RvuH5WrnBmvStK3xn0TWacP8LV0C/9JLWXfnRtST07EfctCeinDAY c3CXO9HO9omhCm6xquaKnnKSkHypDSUtVOtKUEQX3o0BfhYYtTKkGvKPPVMem4BYqgDCTVvWzQdN i+ocogtTmhjBE9gGWLwV1ouF7DQ1EcBwV60hIAXYyxgQr30OzpiWAxqZFwF0kdFdXsD7MYICETCC Ag0CAQEwZDBWMQswCQYDVQQGEwJVUzEaMBgGA1UEChMRSW50ZWwgQ29ycG9yYXRpb24xKzApBgNV BAMTIkludGVsIEV4dGVybmFsIEJhc2ljIElzc3VpbmcgQ0EgM0ICCkj1GMMAAAAANeUwCQYFKw4D AhoFAKCBgzAYBgkqhkiG9w0BCQMxCwYJKoZIhvcNAQcBMBwGCSqGSIb3DQEJBTEPFw0wOTExMTcx NzE3NTBaMCMGCSqGSIb3DQEJBDEWBBRAYNL83fyCl6/dd6WoMPaVSaBOKTAkBgkqhkiG9w0BCQ8x FzAVMAcGBSsOAwIaMAoGCCqGSIb3DQIFMA0GCSqGSIb3DQEBAQUABIIBACZ8Y4ywdtFreBvuuxGa YshbvcC4qRkfxcypDNI0XhOHuBpOORWyqeQppyNG7W75rVwaDXQhMYUwN7fgwSNVOPkh3+FD+t30 CbNF6zvJXaMAcmX4Xo9Y9Njkh8wKP1P+3gPL3bAukjNRPumgARHVqSMNJI/u4ul9z3dc7NuWuNYV Tmvq9s1gxa6EWEsI2hhYomQN8sa/o4N1/781IfmI67AJYD4b6yCWklLG0in6UVQUpPxWgeGwaIaC NLYNqorqoxJTipWKtQmzbOeBKurLhwjLH6MMjUaKB5cbzxYXxZ1U/ad1BEX5AymPjLpm4adRamzN 2zksDYxuP2oU9tUyKLQAAAAAAAA= ------=_NextPart_000_00C1_01CA67A9.E3CDA6C0-- --===============0253730127== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Disposition: inline -------------------------------------------------------------- Intel Shannon Limited Registered in Ireland Registered Office: Collinstown Industrial Park, Leixlip, County Kildare Registered Number: 308263 Business address: Dromore House, East Park, Shannon, Co. Clare This e-mail and any attachments may contain confidential material for the s= ole use of the intended recipient(s). Any review or distribution by others = is strictly prohibited. If you are not the intended recipient, please conta= ct the sender and delete all copies. --===============0253730127==-- From owner-freebsd-doc@FreeBSD.ORG Tue Nov 17 20:10:02 2009 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 5066B1065670 for ; Tue, 17 Nov 2009 20:10:02 +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 157E18FC08 for ; Tue, 17 Nov 2009 20:10:02 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id nAHKA165060204 for ; Tue, 17 Nov 2009 20:10:01 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id nAHKA1U7060203; Tue, 17 Nov 2009 20:10:01 GMT (envelope-from gnats) Resent-Date: Tue, 17 Nov 2009 20:10:01 GMT Resent-Message-Id: <200911172010.nAHKA1U7060203@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, Jason Helfman Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id EF68A106568B for ; Tue, 17 Nov 2009 20:04:02 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id DF1A98FC12 for ; Tue, 17 Nov 2009 20:04:02 +0000 (UTC) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.3/8.14.3) with ESMTP id nAHK42dc054561 for ; Tue, 17 Nov 2009 20:04:02 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.14.3/8.14.3/Submit) id nAHK42dR054560; Tue, 17 Nov 2009 20:04:02 GMT (envelope-from nobody) Message-Id: <200911172004.nAHK42dR054560@www.freebsd.org> Date: Tue, 17 Nov 2009 20:04:02 GMT From: Jason Helfman To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/140644: Add BSD Magazine to Bibliography 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, 17 Nov 2009 20:10:02 -0000 >Number: 140644 >Category: docs >Synopsis: Add BSD Magazine to Bibliography >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Tue Nov 17 20:10:01 UTC 2009 >Closed-Date: >Last-Modified: >Originator: Jason Helfman >Release: 7.2-RELEASE-p4 >Organization: Experts Exchange >Environment: FreeBSD eggman.experts-exchange.com 7.2-RELEASE-p4 FreeBSD 7.2-RELEASE-p4 #0: Fri Oct 2 12:21:39 UTC 2009 root@i386-builder.daemonology.net:/usr/obj/usr/src/sys/GENERIC i386 >Description: Add BSD Magazine to Bibliography >How-To-Repeat: >Fix: Patch attached with submission follows: --- en_US.ISO8859-1/books/handbook/bibliography/chapter.sgml.orig 2009-11-17 11:51:45.000000000 -0800 +++ en_US.ISO8859-1/books/handbook/bibliography/chapter.sgml 2009-11-17 12:01:05.000000000 -0800 @@ -209,6 +209,12 @@ ISBN: 0072224096 + + BSD Magazine, published + by Software Press Sp. z o.o. SK, + ISSN 1898-9144 + + >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Tue Nov 17 20:30:03 2009 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 A52C41065676 for ; Tue, 17 Nov 2009 20:30: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 94DC78FC1A for ; Tue, 17 Nov 2009 20:30:03 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id nAHKU3px077580 for ; Tue, 17 Nov 2009 20:30:03 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id nAHKU3sI077577; Tue, 17 Nov 2009 20:30:03 GMT (envelope-from gnats) Date: Tue, 17 Nov 2009 20:30:03 GMT Message-Id: <200911172030.nAHKU3sI077577@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Jason Helfman Cc: Subject: Re: docs/140644: Add BSD Magazine to Bibliography X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Jason Helfman List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 17 Nov 2009 20:30:03 -0000 The following reply was made to PR docs/140644; it has been noted by GNATS. From: Jason Helfman To: bug-followup@FreeBSD.org, jhelfman@e-e.com Cc: Subject: Re: docs/140644: Add BSD Magazine to Bibliography Date: Tue, 17 Nov 2009 12:22:15 -0800 This is a multi-part message in MIME format. --------------030602060206090802080504 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit The "SK," should be a "SK." Go with this patch, please. Thank you, Jason --------------030602060206090802080504 Content-Type: text/plain; name="patch.txt" Content-Transfer-Encoding: 7bit Content-Disposition: inline; filename="patch.txt" --- en_US.ISO8859-1/books/handbook/bibliography/chapter.sgml.orig 2009-11-17 11:51:45.000000000 -0800 +++ en_US.ISO8859-1/books/handbook/bibliography/chapter.sgml 2009-11-17 12:01:05.000000000 -0800 @@ -209,6 +209,12 @@ ISBN: 0072224096 + + BSD Magazine, published + by Software Press Sp. z o.o. SK. + ISSN 1898-9144 + + --------------030602060206090802080504-- From owner-freebsd-doc@FreeBSD.ORG Tue Nov 17 22:13:14 2009 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 8075F1065670; Tue, 17 Nov 2009 22:13:14 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 58ED98FC08; Tue, 17 Nov 2009 22:13:14 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id nAHMDE5V072396; Tue, 17 Nov 2009 22:13:14 GMT (envelope-from bcr@freefall.freebsd.org) Received: (from bcr@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id nAHMDELt072390; Tue, 17 Nov 2009 22:13:14 GMT (envelope-from bcr) Date: Tue, 17 Nov 2009 22:13:14 GMT Message-Id: <200911172213.nAHMDELt072390@freefall.freebsd.org> To: jhelfman@e-e.com, bcr@FreeBSD.org, freebsd-doc@FreeBSD.org, bcr@FreeBSD.org From: bcr@FreeBSD.org Cc: Subject: Re: docs/140644: Add BSD Magazine to Bibliography 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, 17 Nov 2009 22:13:14 -0000 Synopsis: Add BSD Magazine to Bibliography State-Changed-From-To: open->analyzed State-Changed-By: bcr State-Changed-When: Tue Nov 17 22:06:04 UTC 2009 State-Changed-Why: I'll look into it. Responsible-Changed-From-To: freebsd-doc->bcr Responsible-Changed-By: bcr Responsible-Changed-When: Tue Nov 17 22:06:04 UTC 2009 Responsible-Changed-Why: http://www.freebsd.org/cgi/query-pr.cgi?pr=140644 From owner-freebsd-doc@FreeBSD.ORG Wed Nov 18 02:00:10 2009 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 B3909106568F for ; Wed, 18 Nov 2009 02:00: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 6EED78FC12 for ; Wed, 18 Nov 2009 02:00:10 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id nAI202K8061834 for ; Wed, 18 Nov 2009 02:00:02 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id nAI202jj061833; Wed, 18 Nov 2009 02:00:02 GMT (envelope-from gnats) Resent-Date: Wed, 18 Nov 2009 02:00:02 GMT Resent-Message-Id: <200911180200.nAI202jj061833@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, Ben Kelly Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id A92A71065676 for ; Wed, 18 Nov 2009 01:52:31 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id 9820A8FC12 for ; Wed, 18 Nov 2009 01:52:31 +0000 (UTC) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.3/8.14.3) with ESMTP id nAI1qU0L042970 for ; Wed, 18 Nov 2009 01:52:30 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.14.3/8.14.3/Submit) id nAI1qULT042968; Wed, 18 Nov 2009 01:52:30 GMT (envelope-from nobody) Message-Id: <200911180152.nAI1qULT042968@www.freebsd.org> Date: Wed, 18 Nov 2009 01:52:30 GMT From: Ben Kelly To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/140649: bad WITHOUT_MODULES example in handbook 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: Wed, 18 Nov 2009 02:00:10 -0000 >Number: 140649 >Category: docs >Synopsis: bad WITHOUT_MODULES example in handbook >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: Wed Nov 18 02:00:01 UTC 2009 >Closed-Date: >Last-Modified: >Originator: Ben Kelly >Release: CURRENT >Organization: >Environment: FreeBSD ianto.in.wanderview.com 9.0-CURRENT FreeBSD 9.0-CURRENT #0 r254M: Fri Nov 13 23:26:25 UTC 2009 root@ianto.in.wanderview.com:/usr/obj/usr/src/sys/SERVER i386 >Description: The handbook currently incorrectly suggests you can specify module subdirectories in WITHOUT_MODULES. See the second tip on this page: http://www.freebsd.org/doc/en/books/handbook/kernelconfig-building.html This is incorrect because the WITHOUT_MODULES logic in /usr/src/sys/modules/Makefile will only exclude items in the original SUBDIRS list. Only the top level module directories are included in this list. >How-To-Repeat: Add the following to your /etc/make.conf: WITHOUT_MODULES=sound/driver/emu10k1 Build the kernel and see the emu10k1 module get built anyway. >Fix: >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Wed Nov 18 03:50:02 2009 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 E09C71065670 for ; Wed, 18 Nov 2009 03:50:02 +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 B5D518FC15 for ; Wed, 18 Nov 2009 03:50:02 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id nAI3o2j1056634 for ; Wed, 18 Nov 2009 03:50:02 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id nAI3o2fu056633; Wed, 18 Nov 2009 03:50:02 GMT (envelope-from gnats) Date: Wed, 18 Nov 2009 03:50:02 GMT Message-Id: <200911180350.nAI3o2fu056633@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Ben Kelly Cc: Subject: Re: docs/140649: bad WITHOUT_MODULES example in handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Ben Kelly List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 18 Nov 2009 03:50:03 -0000 The following reply was made to PR docs/140649; it has been noted by GNATS. From: Ben Kelly To: bug-followup@FreeBSD.org Cc: Subject: Re: docs/140649: bad WITHOUT_MODULES example in handbook Date: Tue, 17 Nov 2009 22:19:44 -0500 I forgot to mention this was initially reported by Gonzalo Nemmi. = (gnemmi gmail com)= From owner-freebsd-doc@FreeBSD.ORG Wed Nov 18 09:12:11 2009 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id CF1BE106566B for ; Wed, 18 Nov 2009 09:12:11 +0000 (UTC) (envelope-from ale@FreeBSD.org) Received: from andxor.it (relay.andxor.it [195.223.2.3]) by mx1.freebsd.org (Postfix) with SMTP id 17F218FC1A for ; Wed, 18 Nov 2009 09:12:10 +0000 (UTC) Received: (qmail 95720 invoked from network); 18 Nov 2009 08:45:30 -0000 Received: from unknown (HELO ale.andxor.it) (192.168.2.5) by andxor.it with SMTP; 18 Nov 2009 08:45:30 -0000 Message-ID: <4B03B429.8040605@FreeBSD.org> Date: Wed, 18 Nov 2009 09:45:29 +0100 From: Alex Dupre User-Agent: Thunderbird 2.0.0.22 (X11/20090624) MIME-Version: 1.0 To: "Kinsella, Ray" References: <4B01D5C9.4080207@freebsd.org> <20091116232954.GA6511@lonesome.com> In-Reply-To: Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Cc: "doc@FreeBSD.org" Subject: Re: Programmers' Guides 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: Wed, 18 Nov 2009 09:12:11 -0000 Kinsella, Ray ha scritto: > Would it be possible to add these papers to the FreeBSD Handbook's > Programmers' Guides section? To begin with, I can add them to the "On other web sites - Articles" section of the following page: http://www.freebsd.org/docs/books.html -- Alex Dupre From owner-freebsd-doc@FreeBSD.ORG Wed Nov 18 09:38:33 2009 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 746CE1065694; Wed, 18 Nov 2009 09:38:33 +0000 (UTC) (envelope-from ray.kinsella@intel.com) Received: from mga01.intel.com (mga01.intel.com [192.55.52.88]) by mx1.freebsd.org (Postfix) with ESMTP id C7BA38FC19; Wed, 18 Nov 2009 09:38:32 +0000 (UTC) Content-Type: multipart/mixed; boundary="===============0274280986==" X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="4.44,764,1249282800"; d="p7s'?scan'208";a="748110040" Received: from irsmsx502.ger.corp.intel.com ([163.33.7.249]) by irsmsx602.ger.corp.intel.com ([163.33.3.242]) with mapi; Wed, 18 Nov 2009 09:36:30 +0000 From: "Kinsella, Ray" To: Alex Dupre Date: Wed, 18 Nov 2009 09:36:28 +0000 Thread-Topic: Programmers' Guides Thread-Index: AcpoK5ssE9N7g/9UTWKxH2Z/q9XDrgABu5rg Message-ID: References: <4B01D5C9.4080207@freebsd.org> <20091116232954.GA6511@lonesome.com> <4B03B429.8040605@FreeBSD.org> In-Reply-To: <4B03B429.8040605@FreeBSD.org> Accept-Language: en-US X-MS-Has-Attach: yes X-MS-TNEF-Correlator: acceptlanguage: en-US MIME-Version: 1.0 Cc: "doc@FreeBSD.org" Subject: RE: Programmers' Guides 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: Wed, 18 Nov 2009 09:38:33 -0000 --===============0274280986== MIME-Version: 1.0 Content-Language: en-US Content-Type: multipart/signed; protocol="application/x-pkcs7-signature"; micalg=SHA1; boundary="----=_NextPart_000_002B_01CA6832.9ABA8910" ------=_NextPart_000_002B_01CA6832.9ABA8910 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit That sounds great, thanks Alex. Regards Ray Kinsella -----Original Message----- From: Alex Dupre [mailto:ale@FreeBSD.org] Sent: 18 November 2009 08:45 To: Kinsella, Ray Cc: doc@FreeBSD.org Subject: Re: Programmers' Guides Kinsella, Ray ha scritto: > Would it be possible to add these papers to the FreeBSD Handbook's > Programmers' Guides section? To begin with, I can add them to the "On other web sites - Articles" section of the following page: http://www.freebsd.org/docs/books.html -- Alex Dupre ------=_NextPart_000_002B_01CA6832.9ABA8910 Content-Type: application/x-pkcs7-signature; name="smime.p7s" Content-Transfer-Encoding: base64 Content-Disposition: attachment; filename="smime.p7s" MIAGCSqGSIb3DQEHAqCAMIACAQExCzAJBgUrDgMCGgUAMIAGCSqGSIb3DQEHAQAAoIIRzzCCAyAw ggKJoAMCAQICBDXe9M8wDQYJKoZIhvcNAQEFBQAwTjELMAkGA1UEBhMCVVMxEDAOBgNVBAoTB0Vx dWlmYXgxLTArBgNVBAsTJEVxdWlmYXggU2VjdXJlIENlcnRpZmljYXRlIEF1dGhvcml0eTAeFw05 ODA4MjIxNjQxNTFaFw0xODA4MjIxNjQxNTFaME4xCzAJBgNVBAYTAlVTMRAwDgYDVQQKEwdFcXVp ZmF4MS0wKwYDVQQLEyRFcXVpZmF4IFNlY3VyZSBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkwgZ8wDQYJ KoZIhvcNAQEBBQADgY0AMIGJAoGBAMFdsVhnCGLuoJotHwhtkRRomAoe/toEbxOEYiHD0XzOnwXg uAHwTjTs4oqVBGSs8WtTXwWzy2eAv0ICjv7dAQns4QAUT/z78AzdQ7pbK+EfgHCZFVeTFvEPl2q3 wmgjHMxNWTCsUR47ryvW7mNFe8XZX1DS41APOojnvxT94Me5AgMBAAGjggEJMIIBBTBwBgNVHR8E aTBnMGWgY6BhpF8wXTELMAkGA1UEBhMCVVMxEDAOBgNVBAoTB0VxdWlmYXgxLTArBgNVBAsTJEVx dWlmYXggU2VjdXJlIENlcnRpZmljYXRlIEF1dGhvcml0eTENMAsGA1UEAxMEQ1JMMTAaBgNVHRAE EzARgQ8yMDE4MDgyMjE2NDE1MVowCwYDVR0PBAQDAgEGMB8GA1UdIwQYMBaAFEjmaPkr0rKV10fY IyAQTzOYkJ/UMB0GA1UdDgQWBBRI5mj5K9KylddH2CMgEE8zmJCf1DAMBgNVHRMEBTADAQH/MBoG CSqGSIb2fQdBAAQNMAsbBVYzLjBjAwIGwDANBgkqhkiG9w0BAQUFAAOBgQBYzinq/Pfetc4CuRe1 hdG54+CVzCUxDQCmkm5/tpJjnlCV0Zpv5BHeY4VumO6o/1rI01WyZnFX3sAh6z0qpyNJAQSGQnv8 7n+iFlK1Z2fTQNs7JliyKHc9rhR3Ydb6KmYnoA36p3Nc6nDxlCFlRF/6/O8paKmih3nvee9PrAd3 ODCCAz0wggKmoAMCAQICAwWw/zANBgkqhkiG9w0BAQUFADBOMQswCQYDVQQGEwJVUzEQMA4GA1UE ChMHRXF1aWZheDEtMCsGA1UECxMkRXF1aWZheCBTZWN1cmUgQ2VydGlmaWNhdGUgQXV0aG9yaXR5 MB4XDTA2MDIxNjE4MDEzMFoXDTE2MDIxOTE4MDEzMFowUjELMAkGA1UEBhMCVVMxGjAYBgNVBAoT EUludGVsIENvcnBvcmF0aW9uMScwJQYDVQQDEx5JbnRlbCBFeHRlcm5hbCBCYXNpYyBQb2xpY3kg Q0EwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDBpd/XOb9QVqEZ8mQ1042TdOIq3ATD IsV2xDyt30yLyMR5Wjtus0bn3B+he89BiNO/LP6+rFzEwlD55PlX+HLGIKeNNG97dqyc30FElEUj ZzTZFq2N4e3kVJ/XAEEgANzV8v9qp7qWwxugPgfc3z9BkYot+CifozexHLb/hEZj+yISCU61kRZv uSQ0E11yYL4dRgcglJeaHo3oX57rvIckaLsYV5/1Aj+R8DM1Ppk965XQAKsHfnyT7C4S50T4lVn4 lz36wOdNZn/zegG1zp41lnoTFfT4KuKVJH5x7YD1p6KbgJCKLovnujGuohquBNfdXKpZkvz6pGv+ iC1HawJdAgMBAAGjgaAwgZ0wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBQaxgxKxEdvqNutK/D0 Vgaj7TdUDDA6BgNVHR8EMzAxMC+gLaArhilodHRwOi8vY3JsLmdlb3RydXN0LmNvbS9jcmxzL3Nl Y3VyZWNhLmNybDAfBgNVHSMEGDAWgBRI5mj5K9KylddH2CMgEE8zmJCf1DAPBgNVHRMBAf8EBTAD AQH/MA0GCSqGSIb3DQEBBQUAA4GBABMQOK2kVKVIlUWwLTdywJ+e2O+PC/uQltK2F3lRyrPfBn69 tOkIP4SgDJOfsxyobIrPLe75kBLw+Dom13OBDp/EMZJZ1CglQfVV8co9mT3aZMjSGGQiMgkJLR3j Mfr900fXZKj5XeqCJ+JP0mEhJGEdVCY+FFlksJjV86fDrq1QMIIFYzCCBEugAwIBAgIKYSyl/gAA AAAABjANBgkqhkiG9w0BAQUFADBSMQswCQYDVQQGEwJVUzEaMBgGA1UEChMRSW50ZWwgQ29ycG9y YXRpb24xJzAlBgNVBAMTHkludGVsIEV4dGVybmFsIEJhc2ljIFBvbGljeSBDQTAeFw0wNjAzMjIy MjIyNDdaFw0xMjAzMjIyMjMyNDdaMFYxCzAJBgNVBAYTAlVTMRowGAYDVQQKExFJbnRlbCBDb3Jw b3JhdGlvbjErMCkGA1UEAxMiSW50ZWwgRXh0ZXJuYWwgQmFzaWMgSXNzdWluZyBDQSAzQjCCASIw DQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMDoHJYUGvcdR4k0Qv8/RrwNX4+vEe5PN2LnGn4x fIWwdUbk5+zvrRy1HjoKdG/AShZfxAuFoVyNIah5GJLpiS/vGbsDYKK+EZcIcmtPfvbB9Yg09EnQ 0OpsZ2ORRd5lYUfMUU+zkpgL96vKFdkiG+eeHEwnSS3VikGVrF7UDdKfvxZwRwQCx6rEHAFPCjBD VfGYZuYT1EDhSDvzEiU7KzBsxrdBCFU4RYL7kh+do+vyMDlBzpw3WKvMVbf3s5lxYiY7AjEhU8OS yZEQlgtK8PNyifHjmyrSaeJrPshM3PuLFG4d3gm1UJEiGNzxcHGb6YLP29IQAwY5mAk8j+UOVcsC AwEAAaOCAjUwggIxMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFG/DcREooZ0ZV/VnV8/ZKSaI 1aWiMAsGA1UdDwQEAwIBhjAQBgkrBgEEAYI3FQEEAwIBADAZBgkrBgEEAYI3FAIEDB4KAFMAdQBi AEMAQTAfBgNVHSMEGDAWgBQaxgxKxEdvqNutK/D0Vgaj7TdUDDCBvQYDVR0fBIG1MIGyMIGvoIGs oIGphk5odHRwOi8vd3d3LmludGVsLmNvbS9yZXBvc2l0b3J5L0NSTC9JbnRlbCUyMEV4dGVybmFs JTIwQmFzaWMlMjBQb2xpY3klMjBDQS5jcmyGV2h0dHA6Ly9jZXJ0aWZpY2F0ZXMuaW50ZWwuY29t L3JlcG9zaXRvcnkvQ1JML0ludGVsJTIwRXh0ZXJuYWwlMjBCYXNpYyUyMFBvbGljeSUyMENBLmNy bDCB4wYIKwYBBQUHAQEEgdYwgdMwYwYIKwYBBQUHMAKGV2h0dHA6Ly93d3cuaW50ZWwuY29tL3Jl cG9zaXRvcnkvY2VydGlmaWNhdGVzL0ludGVsJTIwRXh0ZXJuYWwlMjBCYXNpYyUyMFBvbGljeSUy MENBLmNydDBsBggrBgEFBQcwAoZgaHR0cDovL2NlcnRpZmljYXRlcy5pbnRlbC5jb20vcmVwb3Np dG9yeS9jZXJ0aWZpY2F0ZXMvSW50ZWwlMjBFeHRlcm5hbCUyMEJhc2ljJTIwUG9saWN5JTIwQ0Eu Y3J0MA0GCSqGSIb3DQEBBQUAA4IBAQBAiWWHL6T21QXFZDyaUIye0jh7f40GXqi75Ro5JbpROtlZ BqyRq6oPMAG6Igxd5Bd9TMtNkOvguknFnK1y17UdMhLOl+FuInE+FAWk803aRW27OsX+ot0KmPio KnZ3L1K5qcQS3tp6or7AaZzd0w0qFitm4UfP9nnTXQtY9XM5QJ07IKFDE3tlOlamKhjbiJV3FKig CVesPZSx9h2G7Ve4irEfz915Vks26AJHGZagEHNxM9exkgem4ENsG+t0vYqn9x7YsqJ6fmbOSyrz jzb3CYeEfyE5SL+f3Vx9uMsQDyb8LVCDBXQtxLEHnFEBPrRSSF9kPmyjavx4UqFdPEyCMIIF/zCC BOegAwIBAgIKSPUYwwAAAAA15TANBgkqhkiG9w0BAQUFADBWMQswCQYDVQQGEwJVUzEaMBgGA1UE ChMRSW50ZWwgQ29ycG9yYXRpb24xKzApBgNVBAMTIkludGVsIEV4dGVybmFsIEJhc2ljIElzc3Vp bmcgQ0EgM0IwHhcNMDkwMzI1MDkyNTMzWhcNMTIwMzIyMjIzMjQ3WjA/MRYwFAYDVQQDEw1LaW5z ZWxsYSwgUmF5MSUwIwYJKoZIhvcNAQkBFhZyYXkua2luc2VsbGFAaW50ZWwuY29tMIIBIjANBgkq hkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAoT7HNPtxQpHOg60SRT1ceJ2CrDJwUAv57pZG0q3Um2QZ H6RBUqM8yi1ZEmmRSIK9XRsDUxa5i+GD1aeGUHRSK2S7nU9RFp900Mga82JkdPWoV4qA1nrpMv2V X0hLMJVEeOXLK9UBmtejhZO+0LwoWrkacnJI8nhYM5YVTWD+KA5eSz8UTxsDkeFysWKthuFdLk9K DgLNP6nW9a2oBqN52zbupe5smH5nVIwBuAxICYDywuSvrqtMW20YbLqgsT/lYpDUkOWgq7mCPoEv 8BVf/pVqq6cWyubj24qmfbYtZbWiVXZMa5P59dx45P4Ah7uG+ddLylCOHpGw4e9ddXtezQIDAQAB o4IC5DCCAuAwCwYDVR0PBAQDAgeAMB0GA1UdDgQWBBQfHQ4yND0z7mUztWvswOmnwFpuWzA8Bgkr BgEEAYI3FQcELzAtBiUrBgEEAYI3FQiGw4x1hJnlUYP9gSiFjp9TgpHACWeB3r05lfBDAgFkAgEG MB8GA1UdIwQYMBaAFG/DcREooZ0ZV/VnV8/ZKSaI1aWiMIHJBgNVHR8EgcEwgb4wgbuggbiggbWG VGh0dHA6Ly93d3cuaW50ZWwuY29tL3JlcG9zaXRvcnkvQ1JML0ludGVsJTIwRXh0ZXJuYWwlMjBC YXNpYyUyMElzc3VpbmclMjBDQSUyMDNCLmNybIZdaHR0cDovL2NlcnRpZmljYXRlcy5pbnRlbC5j b20vcmVwb3NpdG9yeS9DUkwvSW50ZWwlMjBFeHRlcm5hbCUyMEJhc2ljJTIwSXNzdWluZyUyMENB JTIwM0IuY3JsMIHvBggrBgEFBQcBAQSB4jCB3zBpBggrBgEFBQcwAoZdaHR0cDovL3d3dy5pbnRl bC5jb20vcmVwb3NpdG9yeS9jZXJ0aWZpY2F0ZXMvSW50ZWwlMjBFeHRlcm5hbCUyMEJhc2ljJTIw SXNzdWluZyUyMENBJTIwM0IuY3J0MHIGCCsGAQUFBzAChmZodHRwOi8vY2VydGlmaWNhdGVzLmlu dGVsLmNvbS9yZXBvc2l0b3J5L2NlcnRpZmljYXRlcy9JbnRlbCUyMEV4dGVybmFsJTIwQmFzaWMl MjBJc3N1aW5nJTIwQ0ElMjAzQi5jcnQwHwYDVR0lBBgwFgYIKwYBBQUHAwQGCisGAQQBgjcKAwww KQYJKwYBBAGCNxUKBBwwGjAKBggrBgEFBQcDBDAMBgorBgEEAYI3CgMMMEkGA1UdEQRCMECgJgYK KwYBBAGCNxQCA6AYDBZyYXkua2luc2VsbGFAaW50ZWwuY29tgRZyYXkua2luc2VsbGFAaW50ZWwu Y29tMA0GCSqGSIb3DQEBBQUAA4IBAQCeR8WwK2VmUnnYGt6w8YIBqfFwMckAuUBKHhg0shlO52Fg Jf0S90dIaBNarrdfEb/CRlknj13BHYhxQTK1j21dTn+uArfQd8q18OMdF4IqeXL5U3W4QvzkfxzL L7C2dsKQ9v1nYVi6wT8xIc/RvuH5WrnBmvStK3xn0TWacP8LV0C/9JLWXfnRtST07EfctCeinDAY c3CXO9HO9omhCm6xquaKnnKSkHypDSUtVOtKUEQX3o0BfhYYtTKkGvKPPVMem4BYqgDCTVvWzQdN i+ocogtTmhjBE9gGWLwV1ouF7DQ1EcBwV60hIAXYyxgQr30OzpiWAxqZFwF0kdFdXsD7MYICETCC Ag0CAQEwZDBWMQswCQYDVQQGEwJVUzEaMBgGA1UEChMRSW50ZWwgQ29ycG9yYXRpb24xKzApBgNV BAMTIkludGVsIEV4dGVybmFsIEJhc2ljIElzc3VpbmcgQ0EgM0ICCkj1GMMAAAAANeUwCQYFKw4D AhoFAKCBgzAYBgkqhkiG9w0BCQMxCwYJKoZIhvcNAQcBMBwGCSqGSIb3DQEJBTEPFw0wOTExMTgw OTM2MjhaMCMGCSqGSIb3DQEJBDEWBBSW5w5BCrgRdaHVNaNOAg+VZxTiwjAkBgkqhkiG9w0BCQ8x FzAVMAcGBSsOAwIaMAoGCCqGSIb3DQIFMA0GCSqGSIb3DQEBAQUABIIBAIGS32aN72tr1SmA57cV IBx9NSZw2UCy4ePmKwobmI8nySOLlfdArrcpkK1HW9Ak2145LxsUwEFqDFzE9Dy4ATswzAUZYsLX PsCr47wDjeUL4dPu1YgOaJpKhWmpRB6TQpcHWY2oy0WXuEMYQ3/m0oVBiSfU9RDGrvtPgtLXuV5d BKbAYMwho9ztJYUxTfQo22guLkTV0Q3HMiZkPSYiRwwSnUYfyOU3Ab0fZE16klZaYBAbi/P36zuk ClRl1lZHB2AqMUThs+GkOi4/F3G2ubmEF3xnvp0Oet803XkqIPaHLCjeMQ7mEKMPon1AG3SqL+7N OjRpy6lL/p3A1/LS3Q8AAAAAAAA= ------=_NextPart_000_002B_01CA6832.9ABA8910-- --===============0274280986== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Disposition: inline -------------------------------------------------------------- Intel Shannon Limited Registered in Ireland Registered Office: Collinstown Industrial Park, Leixlip, County Kildare Registered Number: 308263 Business address: Dromore House, East Park, Shannon, Co. Clare This e-mail and any attachments may contain confidential material for the s= ole use of the intended recipient(s). Any review or distribution by others = is strictly prohibited. If you are not the intended recipient, please conta= ct the sender and delete all copies. --===============0274280986==-- From owner-freebsd-doc@FreeBSD.ORG Wed Nov 18 12:30:04 2009 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 61634106566B for ; Wed, 18 Nov 2009 12:30: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 3730F8FC1E for ; Wed, 18 Nov 2009 12:30:04 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id nAICU4Wf042973 for ; Wed, 18 Nov 2009 12:30:04 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id nAICU3Jo042968; Wed, 18 Nov 2009 12:30:03 GMT (envelope-from gnats) Date: Wed, 18 Nov 2009 12:30:03 GMT Message-Id: <200911181230.nAICU3Jo042968@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Ben Kelly Cc: Subject: Re: docs/140649: [handbook] bad WITHOUT_MODULES example in handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Ben Kelly List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 18 Nov 2009 12:30:04 -0000 The following reply was made to PR docs/140649; it has been noted by GNATS. From: Ben Kelly To: bug-followup@FreeBSD.org Cc: Subject: Re: docs/140649: [handbook] bad WITHOUT_MODULES example in handbook Date: Wed, 18 Nov 2009 07:23:10 -0500 On current@ on 11/17/2009 Doug Barton suggested that WITHOUT_MODULES and = MODULES_OVERRIDE should be documented in srcs.conf instead of make.conf: "You can add to the mix the fact that options like modules_override and without_modules are documented in make.conf(5) instead of in src.conf(5) which is where (arguably) they should be."= From owner-freebsd-doc@FreeBSD.ORG Wed Nov 18 21:25:06 2009 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 0DDC1106566C for ; Wed, 18 Nov 2009 21:25:06 +0000 (UTC) (envelope-from leslie@eskk.nu) Received: from mx1.bjare.net (mx1.bjare.net [212.31.160.3]) by mx1.freebsd.org (Postfix) with ESMTP id C04D68FC19 for ; Wed, 18 Nov 2009 21:25:05 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by mx1.bjare.net (Postfix) with ESMTP id F288E5E29F for ; Wed, 18 Nov 2009 22:06:11 +0100 (CET) X-Virus-Scanned: Debian amavisd-new at mx1.bjare.net X-Spam-Flag: NO X-Spam-Score: -2.17 X-Spam-Level: X-Spam-Status: No, score=-2.17 tagged_above=-999 required=5 tests=[AWL=0.430, BAYES_00=-2.599, SPF_PASS=-0.001] Received: from mx1.bjare.net ([127.0.0.1]) by localhost (mx1.bjare.net [127.0.0.1]) (amavisd-new, port 10024) with LMTP id hiwG14nFs--K for ; Wed, 18 Nov 2009 22:06:04 +0100 (CET) X-BN-MX1: ja X-BN-MailInfo: BjareNet Received: from [172.17.0.18] (c-195-216-040-164.static.bjare.net [195.216.40.164]) by mx1.bjare.net (Postfix) with ESMTP id 715394B2065 for ; Wed, 18 Nov 2009 21:46:25 +0100 (CET) Message-ID: <4B045D2F.2080906@eskk.nu> Date: Wed, 18 Nov 2009 21:46:39 +0100 From: Leslie Jensen User-Agent: Mozilla/5.0 (Windows; U; Windows NT 6.1; sv-SE; rv:1.9.1.4pre) Gecko/20090915 Thunderbird/3.0b4 MIME-Version: 1.0 To: doc@FreeBSD.org Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 8bit Cc: Subject: Just a little correction 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: Wed, 18 Nov 2009 21:25:06 -0000 Hi On the page http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/network-dhcp.html Chapter 29.5.7.3 Configuring the DHCP Server It says: Then, you can proceed to start the server by issuing the following command: # /usr/local/etc/rc.d/isc-dhcpd.sh start I get an error with that command!! root@machine01~:/usr/local/etc/rc.d/isc-dhcpd.sh start /usr/local/etc/rc.d/isc-dhcpd.sh: Command not found. The following works: root@machine01~:/usr/local/etc/rc.d/isc-dhcpd start It's not a big thing but I think it should be corrected. -- Med vänlig hälsning / With Regards / Mit freundlichen grüßen ___________________________________________________________________ Leslie Jensen Liljegatan 26 SE-262 57 Ängelholm Telephone +46 (0)431 19370 Mobile phone +46 (0)70 572 44 57 This E-mail is sent from leslie@eskk.nu using http://www.mozilla.com/thunderbird/ http://www.spreadbsd.org/aff/162/3 ___________________________________________________________________ From owner-freebsd-doc@FreeBSD.ORG Wed Nov 18 22:19:11 2009 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id DF95C106566C for ; Wed, 18 Nov 2009 22:19:11 +0000 (UTC) (envelope-from pluknet@gmail.com) Received: from mail-fx0-f227.google.com (mail-fx0-f227.google.com [209.85.220.227]) by mx1.freebsd.org (Postfix) with ESMTP id 786538FC14 for ; Wed, 18 Nov 2009 22:19:11 +0000 (UTC) Received: by fxm27 with SMTP id 27so1808844fxm.3 for ; Wed, 18 Nov 2009 14:19:10 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:mime-version:received:in-reply-to:references :date:message-id:subject:from:to:cc:content-type; bh=AUbbl9qoKbYH9kXGCMQT45dFfLp06pAV4xBmc+8d04E=; b=BTN8cstjnwiiHNc4tF1vkkPo9eEePRwUeYvZO2dAKQM7PghCUvXdp/k8xwekXSbCC5 1sWur25WDJ1NIBlLui4Aa+14vhmsEI1f5d6r3u3q2dj87UWNE4s/tjNye2UKs0h+O8Vy cPT+Z4wG0OIIZTawKOnqni/g40P1XsPmL1WU4= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type; b=wRFSutgEXl74HW+kHD/9MIFj9Ol3kcNsmHlUxZ3d5dRCZlyiWpx2mF1KtFdMBrh3lD gHO4csdSNAWUPITCQ5AHs/vs22zM+6e/qLEOzHswsnJzUxFQ0rdd7WlYKBSK9QC8BvUW GjGV3ChwxQzHTZf8rEii87MBBTx3D8DDbUTrY= MIME-Version: 1.0 Received: by 10.204.141.3 with SMTP id k3mr2764290bku.177.1258581273577; Wed, 18 Nov 2009 13:54:33 -0800 (PST) In-Reply-To: <4B045D2F.2080906@eskk.nu> References: <4B045D2F.2080906@eskk.nu> Date: Thu, 19 Nov 2009 00:54:33 +0300 Message-ID: From: pluknet To: Leslie Jensen Content-Type: text/plain; charset=ISO-8859-1 Cc: doc@freebsd.org Subject: Re: Just a little correction 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: Wed, 18 Nov 2009 22:19:12 -0000 2009/11/18 Leslie Jensen : > Hi > > On the page > > http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/network-dhcp.html > > Chapter 29.5.7.3 Configuring the DHCP Server > > It says: > Then, you can proceed to start the server by issuing the following command: > > # /usr/local/etc/rc.d/isc-dhcpd.sh start > > I get an error with that command!! > > root@machine01~:/usr/local/etc/rc.d/isc-dhcpd.sh start > /usr/local/etc/rc.d/isc-dhcpd.sh: Command not found. > > The following works: > > root@machine01~:/usr/local/etc/rc.d/isc-dhcpd start > > > It's not a big thing but I think it should be corrected. > Also the leftovers from pre rcng are: 16.15.6 Testing the Configuration /usr/local/etc/rc.d/nagios.sh 30.5.9 Building the Rule Script with Symbolic Substitution /usr/local/etc/rc.d/ipf.loadrules.sh (not 100% sure) -- wbr, pluknet From owner-freebsd-doc@FreeBSD.ORG Thu Nov 19 12:24:21 2009 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id DA5BB1065670 for ; Thu, 19 Nov 2009 12:24:21 +0000 (UTC) (envelope-from eitanadlerlist@gmail.com) Received: from mail-fx0-f227.google.com (mail-fx0-f227.google.com [209.85.220.227]) by mx1.freebsd.org (Postfix) with ESMTP id 772E18FC1F for ; Thu, 19 Nov 2009 12:24:21 +0000 (UTC) Received: by fxm27 with SMTP id 27so2419748fxm.3 for ; Thu, 19 Nov 2009 04:24:20 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:mime-version:received:from:date:message-id :subject:to:content-type; bh=QujQiQH2O9XERJ7bfZOMpQjf9wlRMRWs8+DlnSZf4ks=; b=kSisHjdsl1btG/p68lTCt4b6aczWgbq4U88Ux4+uHE0PvEluMGUCHG8baWQ7T9in7R JdGnv/i7zy7N/ZbzYNIwB0J0RVa6eBro+fP6ds738geGUNwktTMix6ceeyoEGkE5cA4K mOX7XXgkFZXD8bzT+N967VYBJpdOhZ4I1znoI= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=mime-version:from:date:message-id:subject:to:content-type; b=ERgm+lhmZavptoho/svTwggbvhB3xuWtuxjz0gm2ODS2MvGeXVAP79vzoLUEUw+Tlk 1ZRPZ88v6QTeh1UPXTAGSpnsj2n6hPC+Iz+3XRNC+PiMMgPv6eAOzD2q/W2G/BfDTS80 duOlW10uFk2yIHql86kB0y9jprZjDJ8t/AguM= MIME-Version: 1.0 Received: by 10.239.143.227 with SMTP id l35mr1245454hba.164.1258631953155; Thu, 19 Nov 2009 03:59:13 -0800 (PST) From: Eitan Adler Date: Thu, 19 Nov 2009 13:58:53 +0200 Message-ID: To: doc@freebsd.org Content-Type: text/plain; charset=ISO-8859-1 Cc: Subject: Installing X11 - add xorg-minimal 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: Thu, 19 Nov 2009 12:24:21 -0000 I think it would be a good idea to include a reference to x11/xorg-minimal into the handbook. Perhaps under Note: The examples above will install the complete X11 distribution including the servers, clients, fonts etc. Separate packages and ports of X11 are also available. Something like: If you just want to get X up and running install x11/xorg-minimal instead Should be added. From owner-freebsd-doc@FreeBSD.ORG Thu Nov 19 14:30:04 2009 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 1F0561065676 for ; Thu, 19 Nov 2009 14:30: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 0F07F8FC22 for ; Thu, 19 Nov 2009 14:30:04 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id nAJEU3lM027483 for ; Thu, 19 Nov 2009 14:30:03 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id nAJEU3mR027478; Thu, 19 Nov 2009 14:30:03 GMT (envelope-from gnats) Date: Thu, 19 Nov 2009 14:30:03 GMT Message-Id: <200911191430.nAJEU3mR027478@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Denny Lin Cc: Subject: Re: docs/140444: [patch] New Traditional Chinese translation of custom-gcc X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Denny Lin List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 19 Nov 2009 14:30:04 -0000 The following reply was made to PR docs/140444; it has been noted by GNATS. From: Denny Lin To: bug-followup@FreeBSD.org, dennylin93@cnmc32.hs.ntnu.edu.tw Cc: Subject: Re: docs/140444: [patch] New Traditional Chinese translation of custom-gcc Date: Thu, 19 Nov 2009 22:28:01 +0800 --fUYQa+Pmc3FrFX/N Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Forgot to add new article to doc/zh_TW.Big5/articles/Makefile. --=20 Denny Lin --fUYQa+Pmc3FrFX/N Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.13 (FreeBSD) iEYEARECAAYFAksFVfEACgkQtYH0ykp1KDwSTwCeJ9KPfJb4WFhbMS1NlaZx48dR dK4An2h4ojwjzuzDdcuPZsQlDP//p4SY =kZ27 -----END PGP SIGNATURE----- --fUYQa+Pmc3FrFX/N-- From owner-freebsd-doc@FreeBSD.ORG Thu Nov 19 14:30:06 2009 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 475EF106566B for ; Thu, 19 Nov 2009 14:30:06 +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 372D08FC28 for ; Thu, 19 Nov 2009 14:30:06 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id nAJEU6o6027622 for ; Thu, 19 Nov 2009 14:30:06 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id nAJEU6u0027619; Thu, 19 Nov 2009 14:30:06 GMT (envelope-from gnats) Date: Thu, 19 Nov 2009 14:30:06 GMT Message-Id: <200911191430.nAJEU6u0027619@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Denny Lin Cc: Subject: Re: docs/140444: [patch] New Traditional Chinese translation of custom-gcc X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Denny Lin List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 19 Nov 2009 14:30:06 -0000 The following reply was made to PR docs/140444; it has been noted by GNATS. From: Denny Lin To: bug-followup@FreeBSD.org, dennylin93@cnmc32.hs.ntnu.edu.tw Cc: Subject: Re: docs/140444: [patch] New Traditional Chinese translation of custom-gcc Date: Thu, 19 Nov 2009 22:29:37 +0800 --ftEhullJWpWg/VHq Content-Type: multipart/mixed; boundary="KsGdsel6WgEHnImy" Content-Disposition: inline --KsGdsel6WgEHnImy Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Oops. Forgot to attach file. --=20 Denny Lin --KsGdsel6WgEHnImy Content-Type: text/x-diff; charset=utf-8 Content-Disposition: attachment; filename="zh_TW-articles-Makefile.patch" Content-Transfer-Encoding: quoted-printable --- doc/zh_TW.Big5/articles/Makefile.orig 2009-11-19 22:22:57.650325047 +08= 00 +++ doc/zh_TW.Big5/articles/Makefile 2009-11-19 22:23:33.914787810 +0800 @@ -2,6 +2,7 @@ =20 SUBDIR =3D SUBDIR+=3D contributing +SUBDIR+=3D custom-gcc SUBDIR+=3D cvs-freebsd SUBDIR+=3D freebsd-questions SUBDIR+=3D hubs --KsGdsel6WgEHnImy-- --ftEhullJWpWg/VHq Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.13 (FreeBSD) iEYEARECAAYFAksFVlEACgkQtYH0ykp1KDwMKgCgk+xrybLnKKXgiKhQDjUZGKSk RxcAn0r6/ylsUvhSK2bFgVwh/JYPFAW1 =UiKU -----END PGP SIGNATURE----- --ftEhullJWpWg/VHq-- From owner-freebsd-doc@FreeBSD.ORG Thu Nov 19 18:50:03 2009 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 2A9ED1065697 for ; Thu, 19 Nov 2009 18: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 E19608FC17 for ; Thu, 19 Nov 2009 18:50:02 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id nAJIo2qV051950 for ; Thu, 19 Nov 2009 18:50:02 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id nAJIo2tc051949; Thu, 19 Nov 2009 18:50:02 GMT (envelope-from gnats) Resent-Date: Thu, 19 Nov 2009 18:50:02 GMT Resent-Message-Id: <200911191850.nAJIo2tc051949@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, Jason Helfman Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 7F9FE106566B for ; Thu, 19 Nov 2009 18:46:35 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id 6E99A8FC17 for ; Thu, 19 Nov 2009 18:46:35 +0000 (UTC) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.3/8.14.3) with ESMTP id nAJIkZqN038111 for ; Thu, 19 Nov 2009 18:46:35 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.14.3/8.14.3/Submit) id nAJIkZTB038110; Thu, 19 Nov 2009 18:46:35 GMT (envelope-from nobody) Message-Id: <200911191846.nAJIkZTB038110@www.freebsd.org> Date: Thu, 19 Nov 2009 18:46:35 GMT From: Jason Helfman To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/140703: add xorg-minimal as alternative for X11 Distribution installation 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: Thu, 19 Nov 2009 18:50:03 -0000 >Number: 140703 >Category: docs >Synopsis: add xorg-minimal as alternative for X11 Distribution installation >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Thu Nov 19 18:50:02 UTC 2009 >Closed-Date: >Last-Modified: >Originator: Jason Helfman >Release: 7.2-RELEASE >Organization: Experts Exchange >Environment: FreeBSD eggman.experts-exchange.com 7.2-RELEASE-p4 FreeBSD 7.2-RELEASE-p4 #0: Fri Oct 2 12:21:39 UTC 2009 root@i386-builder.daemonology.net:/usr/obj/usr/src/sys/GENERIC i386 >Description: add xorg-minimal as alternative for X11 Distribution installation -suggestion per maintainer of port Attempted to fix this particular portion of document per standards I believe I met. >How-To-Repeat: >Fix: Patch attached with submission follows: --- en_US.ISO8859-1/books/handbook/x11/chapter.sgml.orig 2009-11-19 10:33:01.000000000 -0800 +++ en_US.ISO8859-1/books/handbook/x11/chapter.sgml 2009-11-19 10:42:19.000000000 -0800 @@ -339,11 +339,18 @@ &prompt.root; pkg_add -r xorg - The examples above will install the complete + + The examples above will install the complete X11 distribution including the servers, clients, fonts etc. Separate packages and ports of X11 - are also - available. + are also available. + + To install an minimal X11 distribution you can + alternatively install x11/xorg-minimal + . + + + The rest of this chapter will explain how to configure X11, and how to set up a productive desktop >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Thu Nov 19 19:30:04 2009 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 2B93C106566B for ; Thu, 19 Nov 2009 19:30: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 001608FC25 for ; Thu, 19 Nov 2009 19:30:03 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id nAJJU3XD085713 for ; Thu, 19 Nov 2009 19:30:03 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id nAJJU39i085709; Thu, 19 Nov 2009 19:30:03 GMT (envelope-from gnats) Date: Thu, 19 Nov 2009 19:30:03 GMT Message-Id: <200911191930.nAJJU39i085709@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Marc Fonvieille Cc: Subject: Re: docs/140703: add xorg-minimal as alternative for X11 Distribution installation X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Marc Fonvieille List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 19 Nov 2009 19:30:04 -0000 The following reply was made to PR docs/140703; it has been noted by GNATS. From: Marc Fonvieille To: Jason Helfman Cc: freebsd-gnats-submit@FreeBSD.org Subject: Re: docs/140703: add xorg-minimal as alternative for X11 Distribution installation Date: Thu, 19 Nov 2009 20:26:20 +0100 On Thu, Nov 19, 2009 at 06:46:35PM +0000, Jason Helfman wrote: > > >Description: > add xorg-minimal as alternative for X11 Distribution installation > > -suggestion per maintainer of port > > Attempted to fix this particular portion of document per standards I believe I met. [...] Hello, Most of time we avoid to mix content and whitespace changes. > > --- en_US.ISO8859-1/books/handbook/x11/chapter.sgml.orig 2009-11-19 10:33:01.000000000 -0800 > +++ en_US.ISO8859-1/books/handbook/x11/chapter.sgml 2009-11-19 10:42:19.000000000 -0800 > @@ -339,11 +339,18 @@ > > &prompt.root; pkg_add -r xorg > > - The examples above will install the complete > + > + The examples above will install the complete > X11 distribution including the > servers, clients, fonts etc. Separate packages and ports of X11 > - are also > - available. > + are also available. All above are whitespace/wrapping/layout changes. > + > + To install an minimal X11 distribution you can > + alternatively install x11/xorg-minimal > + . the closing should directly follow x11/xorg-minimal, i.e., x11/xorg-minimal. You can break the tags like this: blahblahblah blah blahblahblahblahblahblah x11/xorg-minimal but not like: blahblahblah blahblahblah x11/xorg-minimal -- Marc From owner-freebsd-doc@FreeBSD.ORG Thu Nov 19 19:30:06 2009 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 53B3C106566C for ; Thu, 19 Nov 2009 19:30:06 +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 291C78FC28 for ; Thu, 19 Nov 2009 19:30:06 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id nAJJU6YV085870 for ; Thu, 19 Nov 2009 19:30:06 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id nAJJU6LC085867; Thu, 19 Nov 2009 19:30:06 GMT (envelope-from gnats) Date: Thu, 19 Nov 2009 19:30:06 GMT Message-Id: <200911191930.nAJJU6LC085867@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Jason Helfman Cc: Subject: Re: docs/140703: add xorg-minimal as alternative for X11 Distribution installation X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Jason Helfman List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 19 Nov 2009 19:30:06 -0000 The following reply was made to PR docs/140703; it has been noted by GNATS. From: Jason Helfman To: bug-followup@FreeBSD.org, jhelfman@e-e.com Cc: Subject: Re: docs/140703: add xorg-minimal as alternative for X11 Distribution installation Date: Thu, 19 Nov 2009 11:28:14 -0800 That should be "a minimal..." not "an minimal..." -jgh From owner-freebsd-doc@FreeBSD.ORG Thu Nov 19 21:35:10 2009 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 0300B1065697; Thu, 19 Nov 2009 21:35:10 +0000 (UTC) (envelope-from manolis@FreeBSD.org) Received: from kane.otenet.gr (kane.otenet.gr [83.235.67.31]) by mx1.freebsd.org (Postfix) with ESMTP id 5A6C78FC0C; Thu, 19 Nov 2009 21:35:09 +0000 (UTC) Received: from pulstar.local (athedsl-4487278.home.otenet.gr [94.71.68.118]) by kane.otenet.gr (8.13.8/8.13.8/Debian-3) with ESMTP id nAJLZ2hX005337; Thu, 19 Nov 2009 23:35:02 +0200 Message-ID: <4B05BA06.3010303@FreeBSD.org> Date: Thu, 19 Nov 2009 23:35:02 +0200 From: Manolis Kiagias User-Agent: Thunderbird 2.0.0.23 (Macintosh/20090812) MIME-Version: 1.0 To: "doc@FreeBSD.org" X-Enigmail-Version: 0.96.0 Content-Type: text/plain; charset=ISO-8859-7 Content-Transfer-Encoding: 7bit Cc: Tom Rhodes , Gabor PALI , Gabor Kovesdan , Rene Ladan , Giorgos Keramidas Subject: [RFC] Article on freebsd-update-server 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: Thu, 19 Nov 2009 21:35:10 -0000 Hi all, I am sending this to my usual reviewers and the doc@ list, everyone is welcome to comment. Jason Helfman (jhelfman@e-e.com) is actively involved with our documentation set and you may have seen some of his patches. His initial contribution however is the article in this PR: http://www.freebsd.org/cgi/query-pr.cgi?pr=139095 I've been working on this article with Jason for quite some time, and we think it's about time it gets a broader review. The source is here: http://people.freebsd.org/~manolis/patches/freebsd-update-server/article.sgml.txt And the build: http://people.freebsd.org/~manolis/patches/freebsd-update-server/index.html Please send us any comments and suggestions on content, format or whatever! Thanks, manolis@ From owner-freebsd-doc@FreeBSD.ORG Fri Nov 20 16:07:16 2009 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id F23EA106568B; Fri, 20 Nov 2009 16:07:15 +0000 (UTC) (envelope-from keramida@ceid.upatras.gr) Received: from poseidon.ceid.upatras.gr (poseidon.ceid.upatras.gr [150.140.141.169]) by mx1.freebsd.org (Postfix) with ESMTP id 85CFA8FC19; Fri, 20 Nov 2009 16:07:14 +0000 (UTC) Received: from mail.ceid.upatras.gr (unknown [10.1.0.143]) by poseidon.ceid.upatras.gr (Postfix) with ESMTP id 9166EEB4838; Fri, 20 Nov 2009 18:07:13 +0200 (EET) Received: from localhost (europa.ceid.upatras.gr [127.0.0.1]) by mail.ceid.upatras.gr (Postfix) with ESMTP id 7543B452A4; Fri, 20 Nov 2009 18:07:13 +0200 (EET) X-Virus-Scanned: amavisd-new at ceid.upatras.gr Received: from mail.ceid.upatras.gr ([127.0.0.1]) by localhost (europa.ceid.upatras.gr [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id r7ulDXVTRK3u; Fri, 20 Nov 2009 18:07:13 +0200 (EET) Received: from kobe.laptop (ppp-94-64-253-167.home.otenet.gr [94.64.253.167]) by mail.ceid.upatras.gr (Postfix) with ESMTP id 1850D451B2; Fri, 20 Nov 2009 18:07:12 +0200 (EET) Received: from kobe.laptop (kobe.laptop [127.0.0.1]) by kobe.laptop (8.14.3/8.14.3) with ESMTP id nAKG7AZY088698 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Fri, 20 Nov 2009 18:07:11 +0200 (EET) (envelope-from keramida@kobe.laptop) Received: (from keramida@localhost) by kobe.laptop (8.14.3/8.14.3/Submit) id nAKG7AtV088693; Fri, 20 Nov 2009 18:07:10 +0200 (EET) (envelope-from keramida) From: Giorgos Keramidas To: Manolis Kiagias References: <4B05BA06.3010303@FreeBSD.org> Date: Fri, 20 Nov 2009 18:07:02 +0200 Message-ID: <87ws1luqmx.fsf@kobe.laptop> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.1.50 (berkeley-unix) MIME-Version: 1.0 Content-Type: multipart/signed; boundary="==-=-="; micalg=pgp-sha1; protocol="application/pgp-signature" Cc: Tom Rhodes , "doc@FreeBSD.org" , Gabor PALI , Gabor Kovesdan , Rene Ladan Subject: Re: [RFC] Article on freebsd-update-server 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, 20 Nov 2009 16:07:16 -0000 --==-=-= Content-Type: multipart/mixed; boundary="=-=-=" --=-=-= On Thu, 19 Nov 2009 23:35:02 +0200, Manolis Kiagias wrote: > Hi all, > > I am sending this to my usual reviewers and the doc@ list, everyone is > welcome to comment. > > Jason Helfman (jhelfman@e-e.com) is actively involved with our > documentation set and you may have seen some of his patches. > > His initial contribution however is the article in this PR: > > http://www.freebsd.org/cgi/query-pr.cgi?pr=139095 > > I've been working on this article with Jason for quite some time, and > we think it's about time it gets a broader review. > > The source is here: > > http://people.freebsd.org/~manolis/patches/freebsd-update-server/article.sgml.txt Some of the changes I made locally while reading the source are shown in diff format below. They are based on the latest revision of the article source at http://mercurial.dyndns.org/mercurial/freebsd-doc-el (the last change I pulled was 6d8923ea5ca3 from 2009-11-20 10:05:02 +0200). Some of the changes I made to the article are rewording, formatting, spell checking fixes, or other tiny nits I noticed. Others are merely adding inline SGML comments. Most of them are things we can fix before committing this to CVS. There are also a few that are probably ok to fix later. : diff -r 6d8923ea5ca3 en_US.ISO8859-1/articles/freebsd-update-server/article.sgml : --- a/en_US.ISO8859-1/articles/freebsd-update-server/article.sgml Fri Nov 20 10:05:02 2009 +0200 : +++ b/en_US.ISO8859-1/articles/freebsd-update-server/article.sgml Fri Nov 20 17:47:40 2009 +0200 : @@ -80,11 +80,11 @@ : : : : - An Apache : - web server, with over half of the space required for the : - build. For instance, our test builds total 4 GB, and the : - webserver space needed to distribute updates is 2.6 GB. : + A web server, like Apache, : + with over half of the space required for the build. For instance, : + our test builds total 4 GB, and the webserver space needed to : + distribute updates is 2.6 GB. : If freebsd-update can work with other HTTP servers, it is a good idea to avoid writing Apache-specific instructions. I know a few installations of FreeBSD that prefer lighttpd or nginx, for example. : Configuration: Installation & Setup : : - Download freebsd-update-server : + Download : + the freebsd-update-server : software. A tarball may be downloaded, or use &man.csup.1; and the Tiny nit. : : - This is where the subroutine fetchiso() : - declared in scripts/build.subr will contact : - the configured source for downloading the &os; ISO. This setting : - is not limited to ftp, it may also be : - a web (httpd) address as well. : - For our purposes, ISO's are on the same server as our internal : - http server that will be serving updates. The software has been : - configured to look in that location. For this setup, we have to : - alter the routine to fetch the ISO. By copying the source : - build.subr to : - scripts/RELEASE/ARCHITECTURE/build.subr this : - file will be sourced instead of the released source for : - build.subr. : + This is the location where ISO images are downloaded from (by : + the fetchiso() subroutine : + of scripts/build.subr). The location : + configured here is not limited to FTP URIs. Any URI scheme : + supported by the standard &man.fetch.1; utility should work fine. : + In our own setup the ISO images are on the same internal http : + server that will be serving the updates. : + : + Customizations to the fetchiso() code can : + be installed by copying the : + default build.subr script to the release- and : + architecture-specific area : + at scripts/RELEASE/ARCHITECTURE/build.subr : + and applying local edits. I tried to reword the original text here. If you like the new version, please feel free to keep it. If not, we have to find a good way to simplify the large sentences of the original. : BUILDHOSTNAME : : : - Host where software will be built. Coincidentally, this : - information will be displayed on updated systems when : - issuing: : + The name of the build host. This information will be : + displayed on updated systems when issuing: "Coincidentally" seems superfluous here. : SSHKEY : : : - Key used when uploading data to an update server which will : - provide patches or upgrades to clients. A key pair may be : - created using ssh-keygen -t dsa. Alteration : - of this parameter is not required as stadnard password : - authentication through ssh will be : - used. : + The SSH key for uploading files to : + the update server. A key pair can be created by : + typing ssh-keygen -t dsa. This parameter is : + optional; standard password authentication will be used as a : + fallback authentication method when SSHKEY is : + not defined. : : - &man.ssh-keygen.1; has more detailed information in creating : - a key pair. : + &man.ssh-keygen.1; has more detailed information : + about SSH and the appropriate steps for : + creating and using one. Another suggestion for rewording the text, writing smaller sentences, and other minor wording nits. : : - Account that files are uploaded to on remote system. : + Account that files are uploaded to on the update : + server. : : : : @@ -194,54 +197,68 @@ MASTERDIR=update-master.freebsd.orgMASTERDIR : : : - Directory where files are uploaded to on remote : - system. : + Directory where files are uploaded to on the update : + server. I think I like "update server" better than "remote system" here. The update server may be the same machine that builds the snapshots. By removing the unstated assumption that it is *not*, the text sounds more accurate. : : : : - Now that build directives are set, the installation files are : - configured for a build. For this example, we will use : - RELEASE-7.2 under amd64 : - architecture. Configuration files for &i386; : - architecture are available with downloaded source. : + The default build.conf file shipped with : + the freebsd-update-server sources are : + suitable for building &i386; releases of &os;. As an example of : + building an update server for other architectures we will show in : + the following paragraphs the configuration changes needed for an : + AMD64 update server: We haven't actually described *any* installation so far. So I changed this part to describe what freebsd-update-server defaults seem to be, and switched the rest of the section from alternating text and samples to a with separate steps: : - Create build environment directory under scripts/RELEASE-7.2/amd64. : + : + : + Create a build environment for AMD64: : : - : - &prompt.user; mkdir -p /usr/local/freebsd-update-server/scripts/RELEASE-7.2/amd64 : - : + : + &prompt.user; mkdir -p /usr/local/freebsd-update-server/scripts/RELEASE-7.2/amd64 : + : + : : - This is the build.conf file that should be : - placed in the directory just created. : + : : - # SHA256 hash of RELEASE disc1.iso image. : + Install a build.conf file in the : + newly created build directory. The build configuration : + options for &os; 7.2-RELEASE on AMD64 should be similar : + to: : + : + # SHA256 hash of RELEASE disc1.iso image. : export RELH=1ea1f6f652d7c5f5eab7ef9f8edbed50cb664b08ed761850f95f48e86cc71ef5 : : # Components of the world, source, and kernels : export WORLDPARTS="base catpages dict doc games info manpages proflibs lib32" : -export SOURCEPARTS="base bin contrib crypto etc games gnu include krb5 \ : - lib libexec release rescue sbin secure share sys tools \ : - ubin usbin cddl" : +export SOURCEPARTS="base bin contrib crypto etc games gnu include krb5 \ : + lib libexec release rescue sbin secure share sys tools \ : + ubin usbin cddl" : export KERNELPARTS="generic" : : # EOL date : export EOL=1275289200 : : - : - To generate the "End of Life" number for : - build.conf, refer to the "Estimated EOL" posted : - on the &os; : - Security Website. Based on this date, you can issue : - date -j -f '%Y%m%d-%H%M%S' '20090401-000000' +%s, : - and substitute actual date parameters for those stated by : - &os;. : + : + To generate the "End of Life" number for : + build.conf, refer to the "Estimated : + EOL" posted on : + the &os; : + Security Website. You can derive the value : + of EOL from the date listed on the web : + site, using the &man.date.1; utility, e.g.: : : - The &man.sha256.1; hash key for the desired release, is : - published within the respective release announcement . : - : + &prompt.user; date -j -f '%Y%m%d-%H%M%S' '20090401-000000' '+%s' : + : + : + : + The &man.sha256.1; hash key for the desired release, is : + published within the : + respective release : + announcement. : + : + : + : NOTE: The above can probably stand on their own, outside of the element. : : @@ -273,9 +290,9 @@ enter aes-256-cbc encryption password: : Verifying - enter aes-256-cbc encryption password: : : : - Note down the generated KeyPrint; this value is entered into : - /etc/freebsd-update.conf for binary : - updates. : + Keep a note of the generated key fingerpring. This value is : + entered into /etc/freebsd-update.conf for : + binary updates. : There are various places that the article refers to "KeyPrint". I think it means "key fingerpring", but I am not sure. If that's what the real meaning should be, please use "key fingerprint". : Mon Aug 24 17:54:07 PDT 2009 Extracting world+src for FreeBSD/amd64 7.2-RELEASE : @@ -411,10 +428,7 @@ to sign the release. : file named USAGE. Execute : scripts/approve.sh, as directed. This will sign : the release, and move components into a staging area suitable for : - uploading. It is important to make sure that your key is mounted : - during this process. A simple df will show if it : - is mounted. If not mounted, mount the key with the passphrase supplied : - when creating it earlier. : + uploading. I don't know where the key mounting bits come from. It seems to refer to those FreeBSD installations where PGP keys are stored in removable media, like a USB flash disk. Why do we have to explicitly mention this here? After all, we don't describe how gpg-agent(1) works, or how seahorse(1) integrates PGP with Gnome, or any other case of the dozens of PGP setups possible... : @@ -524,9 +547,11 @@ Wed Aug 26 12:50:07 PDT 2009 Cleaning st : : When running a patch level build, we are assuming that previous : patches are in place. When a patch build is run, it will run all : - patches less than or equal to the number specified. Beyond this, : - you will have to take appropriate measures to verify authenticity : - of the patch. : + patches less than or equal to the number specified. : + : + It is up to the administrator of the freebsd-update : + server to take appropriate measures to verify the authenticity of : + every patch. I think we ought to emphasize a bit the part about patch authenticity, but I am not sure if I chose the right way to do this. : - Follow the same process as noted before for appoving a build. : + Follow the same process as noted before for approving a build: Typo. There are more changes, in the attached patch. Most of them are attempts to improve the wording of various small parts of the article. Please see the attached diff for all of them. One more important detail. We are still discussing at doceng@ how we can bring the final article into CVS. So, please hold from committing this, until we have resolved all the remaining details. I'm sure that a lot of people will love reading an article that describes in detail how to set up a local freebsd-update server. Thanks for all the work done so far on what seems to be an excellent article! :-D --=-=-= Content-Type: text/x-diff Content-Disposition: attachment; filename=freebsd-update.6d8923ea5ca3.diff Content-Transfer-Encoding: quoted-printable Content-Description: Proposed changes and comments for freebsd-update-server rev. 6d8923ea5ca3 diff -r 6d8923ea5ca3 en_US.ISO8859-1/articles/freebsd-update-server/article= .sgml =2D-- a/en_US.ISO8859-1/articles/freebsd-update-server/article.sgml Fri Nov= 20 10:05:02 2009 +0200 +++ b/en_US.ISO8859-1/articles/freebsd-update-server/article.sgml Fri Nov 2= 0 17:48:23 2009 +0200 @@ -80,11 +80,11 @@ =20 =2D An Apache =2D web server, with over half of the space required for the =2D build. For instance, our test builds total 4 GB, and the =2D webserver space needed to distribute updates is 2.6 GB. + A web server, like Apache, + with over half of the space required for the build. For instance, + our test builds total 4 GB, and the webserver space needed to + distribute updates is 2.6 GB. =20 @@ -97,7 +97,8 @@ Configuration: Installation & Setup =20 =2D Download freebsd-update-server + Download + the freebsd-update-server software. A tarball may be downloaded, or use &man.csup.1; and the projects-all collection. =20 @@ -138,19 +139,20 @@ MASTERDIR=3Dupdate-master.freebsd.orgFTP =20 =2D This is where the subroutine fetchiso() =2D declared in scripts/build.subr will contact =2D the configured source for downloading the &os; ISO. This setting =2D is not limited to ftp, it may also be =2D a web (httpd) address as well. =2D For our purposes, ISO's are on the same server as our internal =2D http server that will be serving updates. The software has been =2D configured to look in that location. For this setup, we have to =2D alter the routine to fetch the ISO. By copying the source =2D build.subr to =2D scripts/RELEASE/ARCHITECTURE/build.subr this =2D file will be sourced instead of the released source for =2D build.subr. + This is the location where ISO images are downloaded from (by + the fetchiso() subroutine + of scripts/build.subr). The location + configured here is not limited to FTP URIs. Any URI scheme + supported by the standard &man.fetch.1; utility should work fine. + In our own setup the ISO images are on the same internal http + server that will be serving the updates. + + Customizations to the fetchiso() code can + be installed by copying the + default build.subr script to the release- and + architecture-specific area + at scripts/RELEASE/ARCHITECTURE/build.subr + and applying local edits. =20 @@ -158,9 +160,8 @@ MASTERDIR=3Dupdate-master.freebsd.orgBUILDHOSTNAME =20 =2D Host where software will be built. Coincidentally, this =2D information will be displayed on updated systems when =2D issuing: + The name of the build host. This information will be + displayed on updated systems when issuing: =20 &prompt.user; uname -v @@ -170,15 +171,16 @@ MASTERDIR=3Dupdate-master.freebsd.orgSSHKEY =20 =2D Key used when uploading data to an update server which will =2D provide patches or upgrades to clients. A key pair may be =2D created using ssh-keygen -t dsa. Alteration =2D of this parameter is not required as stadnard password =2D authentication through ssh will be =2D used. + The SSH key for uploading files to + the update server. A key pair can be created by + typing ssh-keygen -t dsa. This parameter is + optional; standard password authentication will be used as a + fallback authentication method when SSHKEY is + not defined. =20 =2D &man.ssh-keygen.1; has more detailed information in creating =2D a key pair. + &man.ssh-keygen.1; has more detailed information + about SSH and the appropriate steps for + creating and using one. =20 @@ -186,7 +188,8 @@ MASTERDIR=3Dupdate-master.freebsd.orgMASTERACCT =20 =2D Account that files are uploaded to on remote system. + Account that files are uploaded to on the update + server. =20 @@ -194,54 +197,68 @@ MASTERDIR=3Dupdate-master.freebsd.orgMASTERDIR =20 =2D Directory where files are uploaded to on remote =2D system. + Directory where files are uploaded to on the update + server. =20 =2D Now that build directives are set, the installation files are =2D configured for a build. For this example, we will use =2D RELEASE-7.2 under amd64 =2D architecture. Configuration files for &i386; =2D architecture are available with downloaded source. + The default build.conf file shipped with + the freebsd-update-server sources are + suitable for building &i386; releases of &os;. As an example of + building an update server for other architectures we will show in + the following paragraphs the configuration changes needed for an + AMD64 update server: =20 =2D Create build environment directory under scripts/RELEASE-7.2/amd64. + + + Create a build environment for AMD64: =20 =2D =2D &prompt.user; mkdir -p /usr/local/freebsd-updat= e-server/scripts/RELEASE-7.2/amd64 =2D + + &prompt.user; mkdir -p /usr/local/freebsd-upd= ate-server/scripts/RELEASE-7.2/amd64 + + =20 =2D This is the build.conf file that should be =2D placed in the directory just created. + =20 =2D # SHA256 hash of RELEASE disc1.iso image. + Install a build.conf file in the + newly created build directory. The build configuration + options for &os; 7.2-RELEASE on AMD64 should be similar + to: + + # SHA256 hash of RELEASE disc1.iso image. export RELH=3D1ea1f6f652d7c5f5eab7ef9f8edbed50cb664b08ed761850f95f48e86cc7= 1ef5 =20 # Components of the world, source, and kernels export WORLDPARTS=3D"base catpages dict doc games info manpages proflibs l= ib32" =2Dexport SOURCEPARTS=3D"base bin contrib crypto etc games gnu include krb5= \ =2D lib libexec release rescue sbin secure share sys tools \ =2D ubin usbin cddl" +export SOURCEPARTS=3D"base bin contrib crypto etc games gnu include krb5 \ + lib libexec release rescue sbin secure share sys tools \ + ubin usbin cddl" export KERNELPARTS=3D"generic" =20 # EOL date export EOL=3D1275289200 =20 =2D =2D To generate the "End of Life" number for =2D build.conf, refer to the "Estimated EOL" posted =2D on the &os; =2D Security Website. Based on this date, you can issue =2D date -j -f '%Y%m%d-%H%M%S' '20090401-000000' +%s, =2D and substitute actual date parameters for those stated by =2D &os;. + + To generate the "End of Life" number for + build.conf, refer to the "Estimated + EOL" posted on + the &os; + Security Website. You can derive the value + of EOL from the date listed on the web + site, using the &man.date.1; utility, e.g.: =20 =2D The &man.sha256.1; hash key for the desired release, is =2D published within the respective release announcement . =2D + &prompt.user; date -j -f '%Y%m%d-%H%M%S' '200= 90401-000000' '+%s' + + + + The &man.sha256.1; hash key for the desired release, is + published within the + respective release + announcement. + + + =20 @@ -273,9 +290,9 @@ enter aes-256-cbc encryption password: Verifying - enter aes-256-cbc encryption password: =20 =2D Note down the generated KeyPrint; this value is entered into =2D /etc/freebsd-update.conf for binary =2D updates. + Keep a note of the generated key fingerpring. This value is + entered into /etc/freebsd-update.conf for + binary updates. =20 At this point, we are ready to stage a build. @@ -330,8 +347,8 @@ world|base|/usr/lib/libalias_ftp.a =20 Then the build of the world is performed again, with world =2D patches. A more detailed explanation may be found in =2D scripts/build.subr. + patches. A more detailed explanation may be found + in scripts/build.subr. =20 Mon Aug 24 17:54:07 PDT 2009 Extracting world+src for FreeBSD/= amd64 7.2-RELEASE @@ -411,10 +428,7 @@ to sign the release. file named USAGE. Execute scripts/approve.sh, as directed. This will sign the release, and move components into a staging area suitable for =2D uploading. It is important to make sure that your key is mounted =2D during this process. A simple df will show if = it =2D is mounted. If not mounted, mount the key with the passphrase sup= plied =2D when creating it earlier. + uploading. =20 &prompt.root; cd /usr/local/freebsd-update-server= @@ -436,6 +450,8 @@ Wed Aug 26 12:50:07 PDT 2009 Cleaning st &prompt.root; sh scripts/upload.sh amd64 RELEASE-7= .2 =20 + The uploaded files will need to be in the DocumentRoot of the webserver in order for updates to be distributed. For further explanation, please refer to the @@ -443,6 +459,10 @@ Wed Aug 26 12:50:07 PDT 2009 Cleaning st url=3D"&url.books.handbook;/network-apache.html">Apache documentation. =20 + Updates for the current release of the &os; system you are updating, and what you want to upgrade to need @@ -453,11 +473,14 @@ Wed Aug 26 12:50:07 PDT 2009 Cleaning st &os; 7.2-RELEASE. =20 + Update client's KeyPrint and ServerName in /etc/freebsd-update.conf, and perform updates as instructed in the &os; Update + instructions in the Handbook. =20 For reference, here is the entire run of Building a Patch =20 =2D In the event a Every time a security advisory =2D is posted, a patch update can be built. + is announced, a patch update can be built. =20 For this example, we will be using 7.1-RELEASE. =20 @@ -487,8 +510,8 @@ Wed Aug 26 12:50:07 PDT 2009 Cleaning st =20 =2D Create patch directory under =2D /usr/local/freebsd-update-server/pat= ches/ for the respective release. + Create the patch directory of the respective release + under /usr/local/freebsd-update-server= /patches/. =20 &prompt.user; mkdir -p /usr/local/freebsd-update-= server/patches/RELEASE-7.1/ @@ -507,8 +530,8 @@ Wed Aug 26 12:50:07 PDT 2009 Cleaning st we can see it is called SA-09:12.bind. After downloading the file, it is required to rename the file to an appropriate patch level. It is suggested to keep this inline with =2D official &os; patch levels, however, this is just a suggestion. =2D For this build, let us follow the brief and call this + official &os; patch levels, but you are free to choose any name you = prefer. + For this build, let us follow the currently established practice of = &os; and call this p7. Rename the file: =20 @@ -524,9 +547,11 @@ Wed Aug 26 12:50:07 PDT 2009 Cleaning st When running a patch level build, we are assuming that previous patches are in place. When a patch build is run, it will run all =2D patches less than or equal to the number specified. Beyond this, =2D you will have to take appropriate measures to verify authenticity =2D of the patch. + patches less than or equal to the number specified. + + It is up to the administrator of the freebsd-update + server to take appropriate measures to verify the authenticity of + every patch. =20 You can also add your own patches to any build. Use the number zero, or any other number. @@ -642,7 +667,7 @@ files to confirm that they look sensible # sh -e approve.sh amd64 7.1-RELEASE to sign the build. =20 =2D Follow the same process as noted before for appoving a build.<= /para> + Follow the same process as noted before for approving a build: =20 &prompt.root; sh -e scripts/approve.sh amd64 7.1-RE= LEASE Wed Aug 26 12:50:06 PDT 2009 Signing build for FreeBSD/amd64 7.1-RELEASE @@ -657,7 +682,7 @@ ready to be uploaded. Remember to run to unmount the decrypted key once you have finished signing all the new builds. =20 =2D After approving the build, upload the software. + After approving the build, upload the software: =20 &prompt.root; cd /usr/local/freebsd-update-server= @@ -671,21 +696,40 @@ the new builds. Tips =20 + + If you build your own release using the native =2D make release, + make release procedure, the freebsd-update-server code will work + from your release. As an example, you may build a release without ports or documentation and add a custom kernel. After removing functionality pertaining to the documentation subroutine and =2D altering the buildworld() subroutine in =2D scripts/build.subr the + altering the buildworld() subroutine in + scripts/build.subr, the freebsd-update-code will successfully build update code on this release. =20 + Add make -j NUMBER to scripts/build.subr to speed up processing. Adding flags to anything other than @@ -695,6 +739,10 @@ the new builds. =20 + Create a firewall rule to block outgoing RST packets. Due to a bug noted in this posting, --=-=-=-- --==-=-= Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.11 (FreeBSD) iEYEARECAAYFAksGvq0ACgkQ1g+UGjGGA7ZWHwCcDcBO2CXgOdILU/XPsD8wsfmE m8UAoK0CDgSoic7TWEH1pcJ5c3bYrmuI =cY04 -----END PGP SIGNATURE----- --==-=-=-- From owner-freebsd-doc@FreeBSD.ORG Fri Nov 20 16:40:01 2009 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 A0A7C1065672 for ; Fri, 20 Nov 2009 16:40: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 64AB48FC0C for ; Fri, 20 Nov 2009 16:40:01 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id nAKGe1un099555 for ; Fri, 20 Nov 2009 16:40:01 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id nAKGe1dw099554; Fri, 20 Nov 2009 16:40:01 GMT (envelope-from gnats) Resent-Date: Fri, 20 Nov 2009 16:40:01 GMT Resent-Message-Id: <200911201640.nAKGe1dw099554@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, Fneufneu Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 17BC3106568B for ; Fri, 20 Nov 2009 16:32:47 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id E1A238FC1E for ; Fri, 20 Nov 2009 16:32:46 +0000 (UTC) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.3/8.14.3) with ESMTP id nAKGWkgv059922 for ; Fri, 20 Nov 2009 16:32:46 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.14.3/8.14.3/Submit) id nAKGWkkM059921; Fri, 20 Nov 2009 16:32:46 GMT (envelope-from nobody) Message-Id: <200911201632.nAKGWkkM059921@www.freebsd.org> Date: Fri, 20 Nov 2009 16:32:46 GMT From: Fneufneu To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/140725: wrong directory in ipnat(8) man page 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, 20 Nov 2009 16:40:01 -0000 >Number: 140725 >Category: docs >Synopsis: wrong directory in ipnat(8) man page >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: Fri Nov 20 16:40:01 UTC 2009 >Closed-Date: >Last-Modified: >Originator: Fneufneu >Release: FreeBSD 8-STABLE >Organization: >Environment: FreeBSD cg96.security-mail.net 8.0-PRERELEASE FreeBSD 8.0-PRERELEASE #1: Wed Nov 18 11:54:44 CET 2009 root@cg96.security-mail.net:/usr/obj/usr/src/sys/GENERIC amd64 >Description: in ipnat(8) man page, FILES part, the exemple directory is wrong: /usr/share/examples/ipf Directory with examples. should be: /usr/share/examples/ipfilter Directory with examples. >How-To-Repeat: >Fix: >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Fri Nov 20 16:52:30 2009 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id C5D3E106566B; Fri, 20 Nov 2009 16:52:30 +0000 (UTC) (envelope-from manolis@FreeBSD.org) Received: from kane.otenet.gr (kane.otenet.gr [83.235.67.31]) by mx1.freebsd.org (Postfix) with ESMTP id 3F52B8FC0C; Fri, 20 Nov 2009 16:52:29 +0000 (UTC) Received: from pulstar.local (athedsl-4487278.home.otenet.gr [94.71.68.118]) by kane.otenet.gr (8.13.8/8.13.8/Debian-3) with ESMTP id nAKGqQbL008375; Fri, 20 Nov 2009 18:52:26 +0200 Message-ID: <4B06C94A.30600@FreeBSD.org> Date: Fri, 20 Nov 2009 18:52:26 +0200 From: Manolis Kiagias User-Agent: Thunderbird 2.0.0.23 (Macintosh/20090812) MIME-Version: 1.0 To: Giorgos Keramidas References: <4B05BA06.3010303@FreeBSD.org> <87ws1luqmx.fsf@kobe.laptop> In-Reply-To: <87ws1luqmx.fsf@kobe.laptop> X-Enigmail-Version: 0.96.0 Content-Type: text/plain; charset=ISO-8859-7 Content-Transfer-Encoding: 7bit Cc: Tom Rhodes , "doc@FreeBSD.org" , Gabor PALI , Gabor Kovesdan , Rene Ladan , Manolis Kiagias Subject: Re: [RFC] Article on freebsd-update-server 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, 20 Nov 2009 16:52:30 -0000 Giorgos Keramidas wrote: > - All changes look fine up to this point > : > : - Note down the generated KeyPrint; this value is entered into > : - /etc/freebsd-update.conf for binary > : - updates. > : + Keep a note of the generated key fingerpring. This value is > : + entered into /etc/freebsd-update.conf for > : + binary updates. > : > > There are various places that the article refers to "KeyPrint". I think it > means "key fingerpring", but I am not sure. If that's what the real meaning > should be, please use "key fingerprint". > > Probably, but we need some input from Jason here. I assume you are right. > : Mon Aug 24 17:54:07 PDT 2009 Extracting world+src for FreeBSD/amd64 7.2-RELEASE > : @@ -411,10 +428,7 @@ to sign the release. > : file named USAGE. Execute > : scripts/approve.sh, as directed. This will sign > : the release, and move components into a staging area suitable for > : - uploading. It is important to make sure that your key is mounted > : - during this process. A simple df will show if it > : - is mounted. If not mounted, mount the key with the passphrase supplied > : - when creating it earlier. > : + uploading. > > I don't know where the key mounting bits come from. It seems to refer to > those FreeBSD installations where PGP keys are stored in removable media, like > a USB flash disk. Why do we have to explicitly mention this here? After all, > we don't describe how gpg-agent(1) works, or how seahorse(1) integrates PGP > with Gnome, or any other case of the dozens of PGP setups possible... > > Same here, I am not really sure what the key mounting refers to. > : @@ -524,9 +547,11 @@ Wed Aug 26 12:50:07 PDT 2009 Cleaning st > : > : When running a patch level build, we are assuming that previous > : patches are in place. When a patch build is run, it will run all > : - patches less than or equal to the number specified. Beyond this, > : - you will have to take appropriate measures to verify authenticity > : - of the patch. > : + patches less than or equal to the number specified. > : + > : + It is up to the administrator of the freebsd-update > : + server to take appropriate measures to verify the authenticity of > : + every patch. > > I think we ought to emphasize a bit the part about patch authenticity, but I > am not sure if I chose the right way to do this. > > Or maybe use around it? > : - Follow the same process as noted before for appoving a build. > : + Follow the same process as noted before for approving a build: > > Typo. > > There are more changes, in the attached patch. Most of them are attempts to > improve the wording of various small parts of the article. Please see the > attached diff for all of them. > > The patch has been applied, the new version is available in mercurial and also uploaded again to freefall. > One more important detail. We are still discussing at doceng@ how we can > bring the final article into CVS. So, please hold from committing this, until > we have resolved all the remaining details. > > Yes, I am aware of this. Jason has thought of something like this (copied from email): Afterword This FreeBSD Update article was originally published at Experts-Exchange. and I thought we could turn this into something like "Acknowledgements / Further Reading" section (will probably need to be expanded a bit). Does this make any sense? > I'm sure that a lot of people will love reading an article that describes in > detail how to set up a local freebsd-update server. Thanks for all the work > done so far on what seems to be an excellent article! :-D > And we thank you for the thorough review :) From owner-freebsd-doc@FreeBSD.ORG Fri Nov 20 18:17:40 2009 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id F2F891065670; Fri, 20 Nov 2009 18:17:40 +0000 (UTC) (envelope-from jhelfman@e-e.com) Received: from mail.experts-exchange.com (mail.experts-exchange.com [64.156.132.251]) by mx1.freebsd.org (Postfix) with ESMTP id 60E3C8FC1B; Fri, 20 Nov 2009 18:17:39 +0000 (UTC) Received: from eggman.experts-exchange.com (unknown [72.29.180.81]) by mail.experts-exchange.com (Postfix) with ESMTP id B1B0A48BE78E; Fri, 20 Nov 2009 10:17:34 -0800 (PST) Received: by eggman.experts-exchange.com (sSMTP sendmail emulation); Fri, 20 Nov 2009 10:16:34 -0800 Date: Fri, 20 Nov 2009 10:16:33 -0800 From: Jason To: Manolis Kiagias Message-ID: <20091120181631.GF6241@eggman.experts-exchange.com> References: <4B05BA06.3010303@FreeBSD.org> <87ws1luqmx.fsf@kobe.laptop> <4B06C94A.30600@FreeBSD.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii; format=flowed Content-Disposition: inline In-Reply-To: <4B06C94A.30600@FreeBSD.org> X-Operating-System: FreeBSD 7.2-RELEASE-p4 X-Living-The-Dream: I love the SLO Life! User-Agent: Mutt/1.5.20 (2009-06-14) Cc: Tom Rhodes , "doc@FreeBSD.org" , Gabor PALI , Gabor Kovesdan , Rene Ladan , Giorgos Keramidas Subject: Re: [RFC] Article on freebsd-update-server 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, 20 Nov 2009 18:17:41 -0000 On Fri, Nov 20, 2009 at 06:52:26PM +0200, Manolis Kiagias thus spake: >Giorgos Keramidas wrote: >> - All changes look fine up to this point >> : >> : - Note down the generated KeyPrint; this value is entered into >> : - /etc/freebsd-update.conf for binary >> : - updates. >> : + Keep a note of the generated key fingerpring. This value is >> : + entered into /etc/freebsd-update.conf for >> : + binary updates. >> : >> >> There are various places that the article refers to "KeyPrint". I think it >> means "key fingerpring", but I am not sure. If that's what the real meaning >> should be, please use "key fingerprint". That is correct. It is a "key fingerprint," in this case, and it becomes the KeyPrint value in /etc/freebsd-update.com >> >> > >Probably, but we need some input from Jason here. I assume you are right. > >> : Mon Aug 24 17:54:07 PDT 2009 Extracting world+src for FreeBSD/amd64 7.2-RELEASE >> : @@ -411,10 +428,7 @@ to sign the release. >> : file named USAGE. Execute >> : scripts/approve.sh, as directed. This will sign >> : the release, and move components into a staging area suitable for >> : - uploading. It is important to make sure that your key is mounted >> : - during this process. A simple df will show if it >> : - is mounted. If not mounted, mount the key with the passphrase supplied >> : - when creating it earlier. >> : + uploading. >> >> I don't know where the key mounting bits come from. It seems to refer to >> those FreeBSD installations where PGP keys are stored in removable media, like >> a USB flash disk. Why do we have to explicitly mention this here? After all, >> we don't describe how gpg-agent(1) works, or how seahorse(1) integrates PGP >> with Gnome, or any other case of the dozens of PGP setups possible... In order to a sign a release, the key generated at the beginning of the process needs to be mounted in order to properly approve the release and update to code so it will work for updates. If the key is not mounted, approving the release won't work, and then updates can't be uploaded. >> >> > >Same here, I am not really sure what the key mounting refers to. > >> : @@ -524,9 +547,11 @@ Wed Aug 26 12:50:07 PDT 2009 Cleaning st >> : >> : When running a patch level build, we are assuming that previous >> : patches are in place. When a patch build is run, it will run all >> : - patches less than or equal to the number specified. Beyond this, >> : - you will have to take appropriate measures to verify authenticity >> : - of the patch. >> : + patches less than or equal to the number specified. >> : + >> : + It is up to the administrator of the freebsd-update >> : + server to take appropriate measures to verify the authenticity of >> : + every patch. >> >> I think we ought to emphasize a bit the part about patch authenticity, but I >> am not sure if I chose the right way to do this. >> >> > >Or maybe use around it? > >> : - Follow the same process as noted before for appoving a build. >> : + Follow the same process as noted before for approving a build: >> >> Typo. >> >> There are more changes, in the attached patch. Most of them are attempts to >> improve the wording of various small parts of the article. Please see the >> attached diff for all of them. >> >> > >The patch has been applied, the new version is available in mercurial >and also uploaded again to freefall. > >> One more important detail. We are still discussing at doceng@ how we can >> bring the final article into CVS. So, please hold from committing this, until >> we have resolved all the remaining details. >> >> > >Yes, I am aware of this. >Jason has thought of something like this (copied from email): > > > Afterword > > This url="http://www.experts-exchange.com/articles/OS/Unix/BSD/FreeBSD/Build-Your-Own-FreeBSD-Update-Server.html">FreeBSD > >Update article was originally published at url="http://www.experts-exchange.com">Experts-Exchange. > > >and I thought we could turn this into something like "Acknowledgements >/ Further Reading" section (will probably need to be expanded a bit). >Does this make any sense? > >> I'm sure that a lot of people will love reading an article that describes in >> detail how to set up a local freebsd-update server. Thanks for all the work >> done so far on what seems to be an excellent article! :-D >> > >And we thank you for the thorough review :) > Thank you and I will take a look at the included file. Jason From owner-freebsd-doc@FreeBSD.ORG Fri Nov 20 20:27:53 2009 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 89FFB106566B; Fri, 20 Nov 2009 20:27:53 +0000 (UTC) (envelope-from jhelfman@e-e.com) Received: from mail.experts-exchange.com (mail.experts-exchange.com [64.156.132.251]) by mx1.freebsd.org (Postfix) with ESMTP id 5FF788FC1A; Fri, 20 Nov 2009 20:27:53 +0000 (UTC) Received: from eggman.experts-exchange.com (unknown [72.29.180.81]) by mail.experts-exchange.com (Postfix) with ESMTP id E69BE4A3085D; Fri, 20 Nov 2009 12:25:32 -0800 (PST) Received: by eggman.experts-exchange.com (sSMTP sendmail emulation); Fri, 20 Nov 2009 12:26:44 -0800 Date: Fri, 20 Nov 2009 12:26:44 -0800 From: Jason To: Giorgos Keramidas Message-ID: <20091120202642.GK6241@eggman.experts-exchange.com> References: <4B05BA06.3010303@FreeBSD.org> <87ws1luqmx.fsf@kobe.laptop> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="x4pBfXISqBoDm8sr" Content-Disposition: inline In-Reply-To: <87ws1luqmx.fsf@kobe.laptop> X-Operating-System: FreeBSD 7.2-RELEASE-p4 X-Living-The-Dream: I love the SLO Life! User-Agent: Mutt/1.5.20 (2009-06-14) Cc: Tom Rhodes , "doc@FreeBSD.org" , Gabor PALI , Gabor Kovesdan , Rene Ladan , Manolis Kiagias Subject: Re: [RFC] Article on freebsd-update-server 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, 20 Nov 2009 20:27:53 -0000 --x4pBfXISqBoDm8sr Content-Type: text/plain; charset=us-ascii; format=flowed Content-Disposition: inline Hi Everyone, I've made comments inline to the patch. I would not want to make any changes to the formatting, as I believe it is good as it stands now. I very much appreciate everyones input, time and comments on my article, and have learned so much in this process. I have attached the diff with comments. Thanks, again Jason On Fri, Nov 20, 2009 at 06:07:02PM +0200, Giorgos Keramidas thus spake: >On Thu, 19 Nov 2009 23:35:02 +0200, Manolis Kiagias wrote: >> Hi all, >> >> I am sending this to my usual reviewers and the doc@ list, everyone is >> welcome to comment. >> >> Jason Helfman (jhelfman@e-e.com) is actively involved with our >> documentation set and you may have seen some of his patches. >> >> His initial contribution however is the article in this PR: >> >> http://www.freebsd.org/cgi/query-pr.cgi?pr=139095 >> >> I've been working on this article with Jason for quite some time, and >> we think it's about time it gets a broader review. >> >> The source is here: >> >> http://people.freebsd.org/~manolis/patches/freebsd-update-server/article.sgml.txt > >Some of the changes I made locally while reading the source are shown in >diff format below. They are based on the latest revision of the article >source at http://mercurial.dyndns.org/mercurial/freebsd-doc-el (the last >change I pulled was 6d8923ea5ca3 from 2009-11-20 10:05:02 +0200). > >Some of the changes I made to the article are rewording, formatting, >spell checking fixes, or other tiny nits I noticed. Others are merely >adding inline SGML comments. Most of them are things we can fix before >committing this to CVS. There are also a few that are probably ok to >fix later. > >: diff -r 6d8923ea5ca3 en_US.ISO8859-1/articles/freebsd-update-server/article.sgml >: --- a/en_US.ISO8859-1/articles/freebsd-update-server/article.sgml Fri Nov 20 10:05:02 2009 +0200 >: +++ b/en_US.ISO8859-1/articles/freebsd-update-server/article.sgml Fri Nov 20 17:47:40 2009 +0200 >: @@ -80,11 +80,11 @@ >: >: >: >: - An : - url="&url.books.handbook;/network-apache.html">Apache >: - web server, with over half of the space required for the >: - build. For instance, our test builds total 4 GB, and the >: - webserver space needed to distribute updates is 2.6 GB. >: + A web server, like : + url="&url.books.handbook;/network-apache.html">Apache, >: + with over half of the space required for the build. For instance, >: + our test builds total 4 GB, and the webserver space needed to >: + distribute updates is 2.6 GB. >: > >If freebsd-update can work with other HTTP servers, it is a good idea to avoid >writing Apache-specific instructions. I know a few installations of FreeBSD >that prefer lighttpd or nginx, for example. > >: Configuration: Installation & Setup >: >: - Download freebsd-update-server >: + Download >: + the freebsd-update-server >: software. A tarball may be downloaded, or use &man.csup.1; and the > >Tiny nit. > >: >: - This is where the subroutine fetchiso() >: - declared in scripts/build.subr will contact >: - the configured source for downloading the &os; ISO. This setting >: - is not limited to ftp, it may also be >: - a web (httpd) address as well. >: - For our purposes, ISO's are on the same server as our internal >: - http server that will be serving updates. The software has been >: - configured to look in that location. For this setup, we have to >: - alter the routine to fetch the ISO. By copying the source >: - build.subr to >: - scripts/RELEASE/ARCHITECTURE/build.subr this >: - file will be sourced instead of the released source for >: - build.subr. >: + This is the location where ISO images are downloaded from (by >: + the fetchiso() subroutine >: + of scripts/build.subr). The location >: + configured here is not limited to FTP URIs. Any URI scheme >: + supported by the standard &man.fetch.1; utility should work fine. >: + In our own setup the ISO images are on the same internal http >: + server that will be serving the updates. >: + >: + Customizations to the fetchiso() code can >: + be installed by copying the >: + default build.subr script to the release- and >: + architecture-specific area >: + at scripts/RELEASE/ARCHITECTURE/build.subr >: + and applying local edits. > >I tried to reword the original text here. If you like the new version, please >feel free to keep it. If not, we have to find a good way to simplify the >large sentences of the original. > >: BUILDHOSTNAME >: >: >: - Host where software will be built. Coincidentally, this >: - information will be displayed on updated systems when >: - issuing: >: + The name of the build host. This information will be >: + displayed on updated systems when issuing: > >"Coincidentally" seems superfluous here. > >: SSHKEY >: >: >: - Key used when uploading data to an update server which will >: - provide patches or upgrades to clients. A key pair may be >: - created using ssh-keygen -t dsa. Alteration >: - of this parameter is not required as stadnard password >: - authentication through ssh will be >: - used. >: + The SSH key for uploading files to >: + the update server. A key pair can be created by >: + typing ssh-keygen -t dsa. This parameter is >: + optional; standard password authentication will be used as a >: + fallback authentication method when SSHKEY is >: + not defined. >: >: - &man.ssh-keygen.1; has more detailed information in creating >: - a key pair. >: + &man.ssh-keygen.1; has more detailed information >: + about SSH and the appropriate steps for >: + creating and using one. > >Another suggestion for rewording the text, writing smaller sentences, and >other minor wording nits. > >: >: - Account that files are uploaded to on remote system. >: + Account that files are uploaded to on the update >: + server. >: >: >: >: @@ -194,54 +197,68 @@ MASTERDIR=update-master.freebsd.org: MASTERDIR >: >: >: - Directory where files are uploaded to on remote >: - system. >: + Directory where files are uploaded to on the update >: + server. > >I think I like "update server" better than "remote system" here. The update >server may be the same machine that builds the snapshots. By removing the >unstated assumption that it is *not*, the text sounds more accurate. > >: >: >: >: - Now that build directives are set, the installation files are >: - configured for a build. For this example, we will use >: - RELEASE-7.2 under amd64 >: - architecture. Configuration files for &i386; >: - architecture are available with downloaded source. >: + The default build.conf file shipped with >: + the freebsd-update-server sources are >: + suitable for building &i386; releases of &os;. As an example of >: + building an update server for other architectures we will show in >: + the following paragraphs the configuration changes needed for an >: + AMD64 update server: > >We haven't actually described *any* installation so far. So I changed this >part to describe what freebsd-update-server defaults seem to be, and switched >the rest of the section from alternating text and samples to a > with separate steps: > >: - Create build environment directory under : - class="directory">scripts/RELEASE-7.2/amd64. >: + >: + >: + Create a build environment for AMD64: >: >: - >: - &prompt.user; mkdir -p /usr/local/freebsd-update-server/scripts/RELEASE-7.2/amd64 >: - >: + >: + &prompt.user; mkdir -p /usr/local/freebsd-update-server/scripts/RELEASE-7.2/amd64 >: + >: + >: >: - This is the build.conf file that should be >: - placed in the directory just created. >: + >: >: - # SHA256 hash of RELEASE disc1.iso image. >: + Install a build.conf file in the >: + newly created build directory. The build configuration >: + options for &os; 7.2-RELEASE on AMD64 should be similar >: + to: >: + >: + # SHA256 hash of RELEASE disc1.iso image. >: export RELH=1ea1f6f652d7c5f5eab7ef9f8edbed50cb664b08ed761850f95f48e86cc71ef5 >: >: # Components of the world, source, and kernels >: export WORLDPARTS="base catpages dict doc games info manpages proflibs lib32" >: -export SOURCEPARTS="base bin contrib crypto etc games gnu include krb5 \ >: - lib libexec release rescue sbin secure share sys tools \ >: - ubin usbin cddl" >: +export SOURCEPARTS="base bin contrib crypto etc games gnu include krb5 \ >: + lib libexec release rescue sbin secure share sys tools \ >: + ubin usbin cddl" >: export KERNELPARTS="generic" >: >: # EOL date >: export EOL=1275289200 >: >: - >: - To generate the "End of Life" number for >: - build.conf, refer to the "Estimated EOL" posted >: - on the &os; >: - Security Website. Based on this date, you can issue >: - date -j -f '%Y%m%d-%H%M%S' '20090401-000000' +%s, >: - and substitute actual date parameters for those stated by >: - &os;. >: + >: + To generate the "End of Life" number for >: + build.conf, refer to the "Estimated >: + EOL" posted on >: + the &os; >: + Security Website. You can derive the value >: + of EOL from the date listed on the web >: + site, using the &man.date.1; utility, e.g.: >: >: - The &man.sha256.1; hash key for the desired release, is >: - published within the respective : - url="&url.base;/releases/">release announcement . >: - >: + &prompt.user; date -j -f '%Y%m%d-%H%M%S' '20090401-000000' '+%s' >: + >: + >: + >: + The &man.sha256.1; hash key for the desired release, is >: + published within the >: + respective release >: + announcement. >: + >: + >: + >: > >NOTE: The above can probably stand on their own, outside of the > element. > >: >: @@ -273,9 +290,9 @@ enter aes-256-cbc encryption password: >: Verifying - enter aes-256-cbc encryption password: >: >: >: - Note down the generated KeyPrint; this value is entered into >: - /etc/freebsd-update.conf for binary >: - updates. >: + Keep a note of the generated key fingerpring. This value is >: + entered into /etc/freebsd-update.conf for >: + binary updates. >: > >There are various places that the article refers to "KeyPrint". I think it >means "key fingerpring", but I am not sure. If that's what the real meaning >should be, please use "key fingerprint". > >: Mon Aug 24 17:54:07 PDT 2009 Extracting world+src for FreeBSD/amd64 7.2-RELEASE >: @@ -411,10 +428,7 @@ to sign the release. >: file named USAGE. Execute >: scripts/approve.sh, as directed. This will sign >: the release, and move components into a staging area suitable for >: - uploading. It is important to make sure that your key is mounted >: - during this process. A simple df will show if it >: - is mounted. If not mounted, mount the key with the passphrase supplied >: - when creating it earlier. >: + uploading. > >I don't know where the key mounting bits come from. It seems to refer to >those FreeBSD installations where PGP keys are stored in removable media, like >a USB flash disk. Why do we have to explicitly mention this here? After all, >we don't describe how gpg-agent(1) works, or how seahorse(1) integrates PGP >with Gnome, or any other case of the dozens of PGP setups possible... > >: @@ -524,9 +547,11 @@ Wed Aug 26 12:50:07 PDT 2009 Cleaning st >: >: When running a patch level build, we are assuming that previous >: patches are in place. When a patch build is run, it will run all >: - patches less than or equal to the number specified. Beyond this, >: - you will have to take appropriate measures to verify authenticity >: - of the patch. >: + patches less than or equal to the number specified. >: + >: + It is up to the administrator of the freebsd-update >: + server to take appropriate measures to verify the authenticity of >: + every patch. > >I think we ought to emphasize a bit the part about patch authenticity, but I >am not sure if I chose the right way to do this. > >: - Follow the same process as noted before for appoving a build. >: + Follow the same process as noted before for approving a build: > >Typo. > >There are more changes, in the attached patch. Most of them are attempts to >improve the wording of various small parts of the article. Please see the >attached diff for all of them. > >One more important detail. We are still discussing at doceng@ how we can >bring the final article into CVS. So, please hold from committing this, until >we have resolved all the remaining details. > >I'm sure that a lot of people will love reading an article that describes in >detail how to set up a local freebsd-update server. Thanks for all the work >done so far on what seems to be an excellent article! :-D > >diff -r 6d8923ea5ca3 en_US.ISO8859-1/articles/freebsd-update-server/article.sgml >--- a/en_US.ISO8859-1/articles/freebsd-update-server/article.sgml Fri Nov 20 10:05:02 2009 +0200 >+++ b/en_US.ISO8859-1/articles/freebsd-update-server/article.sgml Fri Nov 20 17:48:23 2009 +0200 >@@ -80,11 +80,11 @@ > > > >- An - url="&url.books.handbook;/network-apache.html">Apache >- web server, with over half of the space required for the >- build. For instance, our test builds total 4 GB, and the >- webserver space needed to distribute updates is 2.6 GB. >+ A web server, like + url="&url.books.handbook;/network-apache.html">Apache, >+ with over half of the space required for the build. For instance, >+ our test builds total 4 GB, and the webserver space needed to >+ distribute updates is 2.6 GB. > > > >@@ -97,7 +97,8 @@ > > Configuration: Installation & Setup > >- Download freebsd-update-server >+ Download >+ the freebsd-update-server > software. A tarball may be downloaded, or use &man.csup.1; and the > projects-all collection. > >@@ -138,19 +139,20 @@ MASTERDIR=update-master.freebsd.org FTP > > >- This is where the subroutine fetchiso() >- declared in scripts/build.subr will contact >- the configured source for downloading the &os; ISO. This setting >- is not limited to ftp, it may also be >- a web (httpd) address as well. >- For our purposes, ISO's are on the same server as our internal >- http server that will be serving updates. The software has been >- configured to look in that location. For this setup, we have to >- alter the routine to fetch the ISO. By copying the source >- build.subr to >- scripts/RELEASE/ARCHITECTURE/build.subr this >- file will be sourced instead of the released source for >- build.subr. >+ This is the location where ISO images are downloaded from (by >+ the fetchiso() subroutine >+ of scripts/build.subr). The location >+ configured here is not limited to FTP URIs. Any URI scheme >+ supported by the standard &man.fetch.1; utility should work fine. >+ In our own setup the ISO images are on the same internal http >+ server that will be serving the updates. >+ >+ Customizations to the fetchiso() code can >+ be installed by copying the >+ default build.subr script to the release- and >+ architecture-specific area >+ at scripts/RELEASE/ARCHITECTURE/build.subr >+ and applying local edits. > > > >@@ -158,9 +160,8 @@ MASTERDIR=update-master.freebsd.org BUILDHOSTNAME > > >- Host where software will be built. Coincidentally, this >- information will be displayed on updated systems when >- issuing: >+ The name of the build host. This information will be >+ displayed on updated systems when issuing: > > &prompt.user; uname -v > >@@ -170,15 +171,16 @@ MASTERDIR=update-master.freebsd.org SSHKEY > > >- Key used when uploading data to an update server which will >- provide patches or upgrades to clients. A key pair may be >- created using ssh-keygen -t dsa. Alteration >- of this parameter is not required as stadnard password >- authentication through ssh will be >- used. >+ The SSH key for uploading files to >+ the update server. A key pair can be created by >+ typing ssh-keygen -t dsa. This parameter is >+ optional; standard password authentication will be used as a >+ fallback authentication method when SSHKEY is >+ not defined. > >- &man.ssh-keygen.1; has more detailed information in creating >- a key pair. >+ &man.ssh-keygen.1; has more detailed information >+ about SSH and the appropriate steps for >+ creating and using one. > > > >@@ -186,7 +188,8 @@ MASTERDIR=update-master.freebsd.org MASTERACCT > > >- Account that files are uploaded to on remote system. >+ Account that files are uploaded to on the update >+ server. > > > >@@ -194,54 +197,68 @@ MASTERDIR=update-master.freebsd.org MASTERDIR > > >- Directory where files are uploaded to on remote >- system. >+ Directory where files are uploaded to on the update >+ server. > > > > >- Now that build directives are set, the installation files are >- configured for a build. For this example, we will use >- RELEASE-7.2 under amd64 >- architecture. Configuration files for &i386; >- architecture are available with downloaded source. >+ The default build.conf file shipped with >+ the freebsd-update-server sources are >+ suitable for building &i386; releases of &os;. As an example of >+ building an update server for other architectures we will show in >+ the following paragraphs the configuration changes needed for an >+ AMD64 update server: > >- Create build environment directory under - class="directory">scripts/RELEASE-7.2/amd64. >+ >+ >+ Create a build environment for AMD64: > >- >- &prompt.user; mkdir -p /usr/local/freebsd-update-server/scripts/RELEASE-7.2/amd64 >- >+ >+ &prompt.user; mkdir -p /usr/local/freebsd-update-server/scripts/RELEASE-7.2/amd64 >+ >+ > >- This is the build.conf file that should be >- placed in the directory just created. >+ > >- # SHA256 hash of RELEASE disc1.iso image. >+ Install a build.conf file in the >+ newly created build directory. The build configuration >+ options for &os; 7.2-RELEASE on AMD64 should be similar >+ to: >+ >+ # SHA256 hash of RELEASE disc1.iso image. > export RELH=1ea1f6f652d7c5f5eab7ef9f8edbed50cb664b08ed761850f95f48e86cc71ef5 > > # Components of the world, source, and kernels > export WORLDPARTS="base catpages dict doc games info manpages proflibs lib32" >-export SOURCEPARTS="base bin contrib crypto etc games gnu include krb5 \ >- lib libexec release rescue sbin secure share sys tools \ >- ubin usbin cddl" >+export SOURCEPARTS="base bin contrib crypto etc games gnu include krb5 \ >+ lib libexec release rescue sbin secure share sys tools \ >+ ubin usbin cddl" > export KERNELPARTS="generic" > > # EOL date > export EOL=1275289200 > >- >- To generate the "End of Life" number for >- build.conf, refer to the "Estimated EOL" posted >- on the &os; >- Security Website. Based on this date, you can issue >- date -j -f '%Y%m%d-%H%M%S' '20090401-000000' +%s, >- and substitute actual date parameters for those stated by >- &os;. >+ >+ To generate the "End of Life" number for >+ build.conf, refer to the "Estimated >+ EOL" posted on >+ the &os; >+ Security Website. You can derive the value >+ of EOL from the date listed on the web >+ site, using the &man.date.1; utility, e.g.: > >- The &man.sha256.1; hash key for the desired release, is >- published within the respective - url="&url.base;/releases/">release announcement . >- >+ &prompt.user; date -j -f '%Y%m%d-%H%M%S' '20090401-000000' '+%s' >+ >+ >+ >+ The &man.sha256.1; hash key for the desired release, is >+ published within the >+ respective release >+ announcement. >+ >+ >+ > > > >@@ -273,9 +290,9 @@ enter aes-256-cbc encryption password: > Verifying - enter aes-256-cbc encryption password: > > >- Note down the generated KeyPrint; this value is entered into >- /etc/freebsd-update.conf for binary >- updates. >+ Keep a note of the generated key fingerpring. This value is >+ entered into /etc/freebsd-update.conf for >+ binary updates. > > > At this point, we are ready to stage a build. >@@ -330,8 +347,8 @@ world|base|/usr/lib/libalias_ftp.a > > > Then the build of the world is performed again, with world >- patches. A more detailed explanation may be found in >- scripts/build.subr. >+ patches. A more detailed explanation may be found >+ in scripts/build.subr. > > > Mon Aug 24 17:54:07 PDT 2009 Extracting world+src for FreeBSD/amd64 7.2-RELEASE >@@ -411,10 +428,7 @@ to sign the release. > file named USAGE. Execute > scripts/approve.sh, as directed. This will sign > the release, and move components into a staging area suitable for >- uploading. It is important to make sure that your key is mounted >- during this process. A simple df will show if it >- is mounted. If not mounted, mount the key with the passphrase supplied >- when creating it earlier. >+ uploading. > > > &prompt.root; cd /usr/local/freebsd-update-server >@@ -436,6 +450,8 @@ Wed Aug 26 12:50:07 PDT 2009 Cleaning st > &prompt.root; sh scripts/upload.sh amd64 RELEASE-7.2 > > >+ > The uploaded files will need to be in the > DocumentRoot of the webserver in order for updates > to be distributed. For further explanation, please refer to the >@@ -443,6 +459,10 @@ Wed Aug 26 12:50:07 PDT 2009 Cleaning st > url="&url.books.handbook;/network-apache.html">Apache > documentation. > >+ > > Updates for the current release of the &os; system you are > updating, and what you want to upgrade to need >@@ -453,11 +473,14 @@ Wed Aug 26 12:50:07 PDT 2009 Cleaning st > &os; 7.2-RELEASE. > > >+ > Update client's KeyPrint and > ServerName in > /etc/freebsd-update.conf, and perform updates as > instructed in the url="&url.books.handbook;/updating-freebsdupdate.html">&os; Update >+ > instructions in the Handbook. > > For reference, here is the entire run of @@ -467,9 +490,9 @@ Wed Aug 26 12:50:07 PDT 2009 Cleaning st > > Building a Patch > >- In the event a + Every time a url="&url.base;/security/advisories.html">security advisory >- is posted, a patch update can be built. >+ is announced, a patch update can be built. > > For this example, we will be using 7.1-RELEASE. > >@@ -487,8 +510,8 @@ Wed Aug 26 12:50:07 PDT 2009 Cleaning st > > > >- Create patch directory under >- /usr/local/freebsd-update-server/patches/ for the respective release. >+ Create the patch directory of the respective release >+ under /usr/local/freebsd-update-server/patches/. > > > &prompt.user; mkdir -p /usr/local/freebsd-update-server/patches/RELEASE-7.1/ >@@ -507,8 +530,8 @@ Wed Aug 26 12:50:07 PDT 2009 Cleaning st > we can see it is called SA-09:12.bind. After > downloading the file, it is required to rename the file to an > appropriate patch level. It is suggested to keep this inline with >- official &os; patch levels, however, this is just a suggestion. >- For this build, let us follow the brief and call this >+ official &os; patch levels, but you are free to choose any name you prefer. >+ For this build, let us follow the currently established practice of &os; and call this > p7. Rename the file: > > >@@ -524,9 +547,11 @@ Wed Aug 26 12:50:07 PDT 2009 Cleaning st > > When running a patch level build, we are assuming that previous > patches are in place. When a patch build is run, it will run all >- patches less than or equal to the number specified. Beyond this, >- you will have to take appropriate measures to verify authenticity >- of the patch. >+ patches less than or equal to the number specified. >+ >+ It is up to the administrator of the freebsd-update >+ server to take appropriate measures to verify the authenticity of >+ every patch. > > You can also add your own patches to any build. Use the number > zero, or any other number. >@@ -642,7 +667,7 @@ files to confirm that they look sensible > # sh -e approve.sh amd64 7.1-RELEASE > to sign the build. > >- Follow the same process as noted before for appoving a build. >+ Follow the same process as noted before for approving a build: > > &prompt.root; sh -e scripts/approve.sh amd64 7.1-RELEASE > Wed Aug 26 12:50:06 PDT 2009 Signing build for FreeBSD/amd64 7.1-RELEASE >@@ -657,7 +682,7 @@ ready to be uploaded. Remember to run > to unmount the decrypted key once you have finished signing all > the new builds. > >- After approving the build, upload the software. >+ After approving the build, upload the software: > > > &prompt.root; cd /usr/local/freebsd-update-server >@@ -671,21 +696,40 @@ the new builds. > > Tips > >+ >+ > > > If you build your own release using the native >- make release, >+ make release procedure, the > freebsd-update-server code will work >+ > from your release. As an example, you may build a release without > ports or documentation and add a custom kernel. After removing > functionality pertaining to the documentation subroutine and >- altering the buildworld() subroutine in >- scripts/build.subr the >+ altering the buildworld() subroutine in >+ scripts/build.subr, the > freebsd-update-code will successfully > build update code on this release. > > > >+ > Add make -j NUMBER > to scripts/build.subr to speed up processing. > Adding flags to anything other than >@@ -695,6 +739,10 @@ the new builds. > > > >+ > Create a firewall rule to block outgoing RST packets. Due to > a bug noted url="http://unix.derkeiler.com/Mailing-Lists/FreeBSD/stable/2009-04/msg00365.html">in this posting, -- i am a mutthead --x4pBfXISqBoDm8sr Content-Type: text/x-diff; charset=us-ascii Content-Disposition: attachment; filename="freebsd-update.6d8923ea5ca3.diff" I have made my notes and commments inline, and would rather not create another patch based on my thoughts. diff -r 6d8923ea5ca3 en_US.ISO8859-1/articles/freebsd-update-server/article.sgml --- a/en_US.ISO8859-1/articles/freebsd-update-server/article.sgml Fri Nov 20 10:05:02 2009 +0200 +++ b/en_US.ISO8859-1/articles/freebsd-update-server/article.sgml Fri Nov 20 17:48:23 2009 +0200 @@ -80,11 +80,11 @@ - An Apache - web server, with over half of the space required for the - build. For instance, our test builds total 4 GB, and the - webserver space needed to distribute updates is 2.6 GB. + A web server, like Apache, + with over half of the space required for the build. For instance, + our test builds total 4 GB, and the webserver space needed to + distribute updates is 2.6 GB. I agree with this, as Apache is a choice, however there are configuration files that are uploaded as part of the code that are Apache specific. I tried using lighttpd, however RST resets prevented updates. @@ -97,7 +97,8 @@ Configuration: Installation & Setup - Download freebsd-update-server + Download + the freebsd-update-server software. A tarball may be downloaded, or use &man.csup.1; and the projects-all collection. The word "the" really doesn't add any special clarity here, from what I can see. As an English and Journalism major, I was told that the word the is one of the most overused words in the language, and to use it as sparsely as possible. :) @@ -138,19 +139,20 @@ MASTERDIR=update-master.freebsd.orgFTP - This is where the subroutine fetchiso() - declared in scripts/build.subr will contact - the configured source for downloading the &os; ISO. This setting - is not limited to ftp, it may also be - a web (httpd) address as well. - For our purposes, ISO's are on the same server as our internal - http server that will be serving updates. The software has been - configured to look in that location. For this setup, we have to - alter the routine to fetch the ISO. By copying the source - build.subr to - scripts/RELEASE/ARCHITECTURE/build.subr this - file will be sourced instead of the released source for - build.subr. + This is the location where ISO images are downloaded from (by + the fetchiso() subroutine + of scripts/build.subr). The location + configured here is not limited to FTP URIs. Any URI scheme + supported by the standard &man.fetch.1; utility should work fine. + In our own setup the ISO images are on the same internal http + server that will be serving the updates. + + Customizations to the fetchiso() code can + be installed by copying the + default build.subr script to the release- and + architecture-specific area + at scripts/RELEASE/ARCHITECTURE/build.subr + and applying local edits. I agree with this change. A symlink can also work. @@ -158,9 +160,8 @@ MASTERDIR=update-master.freebsd.orgBUILDHOSTNAME - Host where software will be built. Coincidentally, this - information will be displayed on updated systems when - issuing: + The name of the build host. This information will be + displayed on updated systems when issuing: I agree with this. &prompt.user; uname -v @@ -170,15 +171,16 @@ MASTERDIR=update-master.freebsd.orgSSHKEY - Key used when uploading data to an update server which will - provide patches or upgrades to clients. A key pair may be - created using ssh-keygen -t dsa. Alteration - of this parameter is not required as stadnard password - authentication through ssh will be - used. + The SSH key for uploading files to + the update server. A key pair can be created by + typing ssh-keygen -t dsa. This parameter is + optional; standard password authentication will be used as a + fallback authentication method when SSHKEY is + not defined. - &man.ssh-keygen.1; has more detailed information in creating - a key pair. + &man.ssh-keygen.1; has more detailed information + about SSH and the appropriate steps for + creating and using one. @@ -186,7 +188,8 @@ MASTERDIR=update-master.freebsd.orgMASTERACCT - Account that files are uploaded to on remote system. + Account that files are uploaded to on the update + server. @@ -194,54 +197,68 @@ MASTERDIR=update-master.freebsd.orgMASTERDIR - Directory where files are uploaded to on remote - system. + Directory where files are uploaded to on the update + server. No need for the word "the," here. Good change. - Now that build directives are set, the installation files are - configured for a build. For this example, we will use - RELEASE-7.2 under amd64 - architecture. Configuration files for &i386; - architecture are available with downloaded source. + The default build.conf file shipped with + the freebsd-update-server sources are + suitable for building &i386; releases of &os;. As an example of + building an update server for other architectures we will show in + the following paragraphs the configuration changes needed for an + AMD64 update server: As note before, these are build directives, and other directives could be seen as release directives. - Create build environment directory under scripts/RELEASE-7.2/amd64. + + + Create a build environment for AMD64: - - &prompt.user; mkdir -p /usr/local/freebsd-update-server/scripts/RELEASE-7.2/amd64 - + + &prompt.user; mkdir -p /usr/local/freebsd-update-server/scripts/RELEASE-7.2/amd64 + + I like the "steps." Wasn't aware of this function. - This is the build.conf file that should be - placed in the directory just created. + - # SHA256 hash of RELEASE disc1.iso image. + Install a build.conf file in the + newly created build directory. The build configuration + options for &os; 7.2-RELEASE on AMD64 should be similar + to: + + # SHA256 hash of RELEASE disc1.iso image. export RELH=1ea1f6f652d7c5f5eab7ef9f8edbed50cb664b08ed761850f95f48e86cc71ef5 # Components of the world, source, and kernels export WORLDPARTS="base catpages dict doc games info manpages proflibs lib32" -export SOURCEPARTS="base bin contrib crypto etc games gnu include krb5 \ - lib libexec release rescue sbin secure share sys tools \ - ubin usbin cddl" +export SOURCEPARTS="base bin contrib crypto etc games gnu include krb5 \ + lib libexec release rescue sbin secure share sys tools \ + ubin usbin cddl" export KERNELPARTS="generic" # EOL date export EOL=1275289200 - - To generate the "End of Life" number for - build.conf, refer to the "Estimated EOL" posted - on the &os; - Security Website. Based on this date, you can issue - date -j -f '%Y%m%d-%H%M%S' '20090401-000000' +%s, - and substitute actual date parameters for those stated by - &os;. + + To generate the "End of Life" number for + build.conf, refer to the "Estimated + EOL" posted on + the &os; + Security Website. You can derive the value + of EOL from the date listed on the web + site, using the &man.date.1; utility, e.g.: - The &man.sha256.1; hash key for the desired release, is - published within the respective release announcement . - + &prompt.user; date -j -f '%Y%m%d-%H%M%S' '20090401-000000' '+%s' + + + + The &man.sha256.1; hash key for the desired release, is + published within the + respective release + announcement. + + + I like this modification. @@ -273,9 +290,9 @@ enter aes-256-cbc encryption password: Verifying - enter aes-256-cbc encryption password: - Note down the generated KeyPrint; this value is entered into - /etc/freebsd-update.conf for binary - updates. + Keep a note of the generated key fingerpring. This value is + entered into /etc/freebsd-update.conf for + binary updates. Typo. "fingerprint" At this point, we are ready to stage a build. @@ -330,8 +347,8 @@ world|base|/usr/lib/libalias_ftp.a Then the build of the world is performed again, with world - patches. A more detailed explanation may be found in - scripts/build.subr. + patches. A more detailed explanation may be found + in scripts/build.subr. Mon Aug 24 17:54:07 PDT 2009 Extracting world+src for FreeBSD/amd64 7.2-RELEASE @@ -411,10 +428,7 @@ to sign the release. file named USAGE. Execute scripts/approve.sh, as directed. This will sign the release, and move components into a staging area suitable for - uploading. It is important to make sure that your key is mounted - during this process. A simple df will show if it - is mounted. If not mounted, mount the key with the passphrase supplied - when creating it earlier. + uploading. Your build will not upload if it isn't approved, and it can't be approved if it isn't signed. It can't be signed if your key is not mounted. The key is essential for the building process. &prompt.root; cd /usr/local/freebsd-update-server @@ -436,6 +450,8 @@ Wed Aug 26 12:50:07 PDT 2009 Cleaning st &prompt.root; sh scripts/upload.sh amd64 RELEASE-7.2 + It may work, however there are specific files uploaded during the upload process that are for Apache. If the functionality can be adapted into other http servers, the end-user may choose to use another webserver. I experimented with lighttpd, however it did not work. Colin notes that Apache handles memory better in the source. The uploaded files will need to be in the DocumentRoot of the webserver in order for updates to be distributed. For further explanation, please refer to the @@ -443,6 +459,10 @@ Wed Aug 26 12:50:07 PDT 2009 Cleaning st url="&url.books.handbook;/network-apache.html">Apache documentation. + Updates for the current release of the &os; system you are updating, and what you want to upgrade to need @@ -453,11 +473,14 @@ Wed Aug 26 12:50:07 PDT 2009 Cleaning st &os; 7.2-RELEASE. I re-worded this for clarity, however I thought it was a good place to put it. Right after a build. If you want to update from 7.1 to 7.2, you will need to have build code on your update server for both releases. + KeyPrint is the key fingerprint that needs to be updated in /etc/freebsd-update.conf in order to install updates. Update client's KeyPrint and ServerName in /etc/freebsd-update.conf, and perform updates as instructed in the &os; Update + instructions in the Handbook. For reference, here is the entire run of Building a Patch - In the event a Every time a security advisory - is posted, a patch update can be built. + is announced, a patch update can be built. For this example, we will be using 7.1-RELEASE. @@ -487,8 +510,8 @@ Wed Aug 26 12:50:07 PDT 2009 Cleaning st - Create patch directory under - /usr/local/freebsd-update-server/patches/ for the respective release. + Create the patch directory of the respective release + under /usr/local/freebsd-update-server/patches/. &prompt.user; mkdir -p /usr/local/freebsd-update-server/patches/RELEASE-7.1/ @@ -507,8 +530,8 @@ Wed Aug 26 12:50:07 PDT 2009 Cleaning st we can see it is called SA-09:12.bind. After downloading the file, it is required to rename the file to an appropriate patch level. It is suggested to keep this inline with - official &os; patch levels, however, this is just a suggestion. - For this build, let us follow the brief and call this + official &os; patch levels, but you are free to choose any name you prefer. + For this build, let us follow the currently established practice of &os; and call this p7. Rename the file: @@ -524,9 +547,11 @@ Wed Aug 26 12:50:07 PDT 2009 Cleaning st When running a patch level build, we are assuming that previous patches are in place. When a patch build is run, it will run all - patches less than or equal to the number specified. Beyond this, - you will have to take appropriate measures to verify authenticity - of the patch. + patches less than or equal to the number specified. + + It is up to the administrator of the freebsd-update + server to take appropriate measures to verify the authenticity of + every patch. You can also add your own patches to any build. Use the number zero, or any other number. @@ -642,7 +667,7 @@ files to confirm that they look sensible # sh -e approve.sh amd64 7.1-RELEASE to sign the build. - Follow the same process as noted before for appoving a build. + Follow the same process as noted before for approving a build: &prompt.root; sh -e scripts/approve.sh amd64 7.1-RELEASE Wed Aug 26 12:50:06 PDT 2009 Signing build for FreeBSD/amd64 7.1-RELEASE @@ -657,7 +682,7 @@ ready to be uploaded. Remember to run to unmount the decrypted key once you have finished signing all the new builds. - After approving the build, upload the software. + After approving the build, upload the software: &prompt.root; cd /usr/local/freebsd-update-server @@ -671,21 +696,40 @@ the new builds. Tips + Agreed. + I agree with the above. If you build your own release using the native - make release, + make release procedure, the freebsd-update-server code will work + from your release. As an example, you may build a release without ports or documentation and add a custom kernel. After removing functionality pertaining to the documentation subroutine and - altering the buildworld() subroutine in - scripts/build.subr the + altering the buildworld() subroutine in + scripts/build.subr, the freebsd-update-code will successfully build update code on this release. This allows for you to maintain an update server with a custom and generic kernel, and a modified world, if you wish. + Add make -j NUMBER to scripts/build.subr to speed up processing. Adding flags to anything other than @@ -695,6 +739,10 @@ the new builds. It is safe to add it to the buildworld and obj process, but not others. Update code will fail on anything besides this. + Updates will fail if this isn't put in place. Create a firewall rule to block outgoing RST packets. Due to a bug noted in this posting, --x4pBfXISqBoDm8sr-- From owner-freebsd-doc@FreeBSD.ORG Sat Nov 21 03:30:02 2009 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 26BCF106566B for ; Sat, 21 Nov 2009 03:30:02 +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 DD5588FC26 for ; Sat, 21 Nov 2009 03:30:01 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id nAL3U19L060210 for ; Sat, 21 Nov 2009 03:30:01 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id nAL3U1Ae060206; Sat, 21 Nov 2009 03:30:01 GMT (envelope-from gnats) Resent-Date: Sat, 21 Nov 2009 03:30:01 GMT Resent-Message-Id: <200911210330.nAL3U1Ae060206@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, Glen Barber Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 950DC1065676 for ; Sat, 21 Nov 2009 03:27:24 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id 83B078FC2E for ; Sat, 21 Nov 2009 03:27:24 +0000 (UTC) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.3/8.14.3) with ESMTP id nAL3ROCl088198 for ; Sat, 21 Nov 2009 03:27:24 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.14.3/8.14.3/Submit) id nAL3RN4n088173; Sat, 21 Nov 2009 03:27:23 GMT (envelope-from nobody) Message-Id: <200911210327.nAL3RN4n088173@www.freebsd.org> Date: Sat, 21 Nov 2009 03:27:23 GMT From: Glen Barber To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/140733: [patch] Broken Link to "The Design and Implementation of the 4.4BSD Operating System" book 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, 21 Nov 2009 03:30:02 -0000 >Number: 140733 >Category: docs >Synopsis: [patch] Broken Link to "The Design and Implementation of the 4.4BSD Operating System" book >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 21 03:30:01 UTC 2009 >Closed-Date: >Last-Modified: >Originator: Glen Barber >Release: 8.0-PRERELEASE >Organization: >Environment: FreeBSD orion 8.0-PRERELEASE FreeBSD 8.0-PRERELEASE #2 r199595: Fri Nov 20 20:58:23 EST 2009 root@orion:/usr/obj/usr/src/sys/ORION amd64 >Description: Link to external resource for the book "The Design and Implementation of the 4.4BSD Operating System" is broken. http://www.freebsd.org/doc/en/books/design-44bsd/ >How-To-Repeat: >Fix: Patch attached with submission follows: --- books/design-44bsd/book.sgml.orig 2004-08-08 09:43:57.000000000 -0400 +++ books/design-44bsd/book.sgml 2009-11-20 22:20:32.000000000 -0500 @@ -50,9 +50,9 @@ may be further reproduced or distributed without the publisher's express written permission. The - rest of - the - book explores the concepts introduced in this chapter in + rest of + the book explores the concepts introduced in this chapter in incredible detail and is an excellent reference for anyone with an interest in BSD UNIX. More information about this book is available from the publisher, with whom you can also sign up to receive news >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Sat Nov 21 04:06:59 2009 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 0A526106566C; Sat, 21 Nov 2009 04:06:59 +0000 (UTC) (envelope-from trhodes@FreeBSD.org) Received: from gloomweaver.pittgoth.com (gloomweaver.pittgoth.com [205.134.165.107]) by mx1.freebsd.org (Postfix) with ESMTP id C24ED8FC0A; Sat, 21 Nov 2009 04:06:58 +0000 (UTC) Received: from localhost.fbsdsecure.org (net-ix.gw.ai.net [205.134.160.6]) (authenticated bits=0) by gloomweaver.pittgoth.com (8.14.3/8.14.3) with ESMTP id nAL470AH032091 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Fri, 20 Nov 2009 23:07:00 -0500 (EST) (envelope-from trhodes@FreeBSD.org) Date: Fri, 20 Nov 2009 23:06:50 -0500 From: Tom Rhodes To: Giorgos Keramidas Message-Id: <20091120230650.1bbc849e.trhodes@FreeBSD.org> In-Reply-To: <87ws1luqmx.fsf@kobe.laptop> References: <4B05BA06.3010303@FreeBSD.org> <87ws1luqmx.fsf@kobe.laptop> X-Mailer: Sylpheed version 1.0.6 (GTK+ 1.2.10; i386-portbld-freebsd8.0) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Cc: pgj@FreeBSD.org, doc@FreeBSD.org, gabor@FreeBSD.org, rene@FreeBSD.org, manolis@FreeBSD.org Subject: Re: [RFC] Article on freebsd-update-server 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, 21 Nov 2009 04:06:59 -0000 On Fri, 20 Nov 2009 18:07:02 +0200 Giorgos Keramidas wrote: [BIG SNIP]: Patch explanation, patch, review request, not in that order. :) > > One more important detail. We are still discussing at doceng@ how we can > bring the final article into CVS. So, please hold from committing this, until > we have resolved all the remaining details. This makes me feel funny. And not the kind of good funny that earns someone a candybar when it's all over, but a strange kind of decisions in the back room by a select few kind of funny ... > > I'm sure that a lot of people will love reading an article that describes in > detail how to set up a local freebsd-update server. Thanks for all the work > done so far on what seems to be an excellent article! :-D > > Several years ago, when the freebsd-update software came out, I investigated using it to distribute software and patches to a large cluster of machines. Unfortunately I didn't get that far because the internal bits were a closely guarded secret, Colin only asked why anyone would need to run one. That said, I think it's awesome we can do this now, and I'll definitely be trying out the article in the future. :) Cheers, -- Tom Rhodes From owner-freebsd-doc@FreeBSD.ORG Sat Nov 21 09:13:25 2009 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 5FEC610656A7; Sat, 21 Nov 2009 09:13:25 +0000 (UTC) (envelope-from miwi@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 357358FC17; Sat, 21 Nov 2009 09:13:25 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id nAL9DPec097079; Sat, 21 Nov 2009 09:13:25 GMT (envelope-from miwi@freefall.freebsd.org) Received: (from miwi@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id nAL9DOX1097075; Sat, 21 Nov 2009 09:13:25 GMT (envelope-from miwi) Date: Sat, 21 Nov 2009 09:13:25 GMT Message-Id: <200911210913.nAL9DOX1097075@freefall.freebsd.org> To: glen.j.barber@gmail.com, miwi@FreeBSD.org, freebsd-doc@FreeBSD.org From: miwi@FreeBSD.org Cc: Subject: Re: docs/140733: [patch] Broken Link to "The Design and Implementation of the 4.4BSD Operating System" book 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, 21 Nov 2009 09:13:25 -0000 Synopsis: [patch] Broken Link to "The Design and Implementation of the 4.4BSD Operating System" book State-Changed-From-To: open->closed State-Changed-By: miwi State-Changed-When: Sat Nov 21 09:13:24 UTC 2009 State-Changed-Why: Committed. Thanks! http://www.freebsd.org/cgi/query-pr.cgi?pr=140733 From owner-freebsd-doc@FreeBSD.ORG Sat Nov 21 09:20:05 2009 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 3C102106566B for ; Sat, 21 Nov 2009 09:20:05 +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 2AF918FC1E for ; Sat, 21 Nov 2009 09:20:05 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id nAL9K5u4097750 for ; Sat, 21 Nov 2009 09:20:05 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id nAL9K5in097749; Sat, 21 Nov 2009 09:20:05 GMT (envelope-from gnats) Date: Sat, 21 Nov 2009 09:20:05 GMT Message-Id: <200911210920.nAL9K5in097749@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: dfilter@FreeBSD.ORG (dfilter service) Cc: Subject: Re: docs/140733: commit references a PR X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: dfilter service List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 21 Nov 2009 09:20:05 -0000 The following reply was made to PR docs/140733; it has been noted by GNATS. From: dfilter@FreeBSD.ORG (dfilter service) To: bug-followup@FreeBSD.org Cc: Subject: Re: docs/140733: commit references a PR Date: Sat, 21 Nov 2009 09:12:39 +0000 (UTC) miwi 2009-11-21 09:12:25 UTC FreeBSD doc repository Modified files: en_US.ISO8859-1/books/design-44bsd book.sgml Log: - Fix a broken link PR: 140733 Submitted by: Glen Barber Revision Changes Path 1.9 +1 -1 doc/en_US.ISO8859-1/books/design-44bsd/book.sgml _______________________________________________ cvs-all@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/cvs-all To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org" From owner-freebsd-doc@FreeBSD.ORG Sat Nov 21 12:43:43 2009 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 9CA18106566B; Sat, 21 Nov 2009 12:43:43 +0000 (UTC) (envelope-from gabor@FreeBSD.org) Received: from server.mypc.hu (server.mypc.hu [87.229.73.95]) by mx1.freebsd.org (Postfix) with ESMTP id 47A6F8FC08; Sat, 21 Nov 2009 12:43:43 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by server.mypc.hu (Postfix) with ESMTP id A59D814D9C93; Sat, 21 Nov 2009 13:43:40 +0100 (CET) X-Virus-Scanned: amavisd-new at example.com Received: from server.mypc.hu ([127.0.0.1]) by localhost (server.mypc.hu [127.0.0.1]) (amavisd-new, port 10024) with LMTP id To5LY4LNJHpD; Sat, 21 Nov 2009 13:43:37 +0100 (CET) Received: from [192.168.1.105] (catv-89-132-179-104.catv.broadband.hu [89.132.179.104]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by server.mypc.hu (Postfix) with ESMTPSA id 8565714D2C30; Sat, 21 Nov 2009 13:43:37 +0100 (CET) Message-ID: <4B07E077.3010609@FreeBSD.org> Date: Sat, 21 Nov 2009 13:43:35 +0100 From: Gabor Kovesdan User-Agent: Thunderbird 2.0.0.23 (Windows/20090812) MIME-Version: 1.0 To: Jason References: <4B05BA06.3010303@FreeBSD.org> <87ws1luqmx.fsf@kobe.laptop> <4B06C94A.30600@FreeBSD.org> <20091120181631.GF6241@eggman.experts-exchange.com> In-Reply-To: <20091120181631.GF6241@eggman.experts-exchange.com> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: Tom Rhodes , "doc@FreeBSD.org" , Gabor PALI , Giorgos Keramidas , Rene Ladan , Manolis Kiagias Subject: Re: [RFC] Article on freebsd-update-server 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, 21 Nov 2009 12:43:43 -0000 >>> One more important detail. We are still discussing at doceng@ how >>> we can >>> bring the final article into CVS. So, please hold from committing >>> this, until >>> we have resolved all the remaining details. Could someone please elaborate what these details are? Why this case is different from the usual practice? (cvs add && cvs commit) -- Gabor Kovesdan FreeBSD Volunteer EMAIL: gabor@FreeBSD.org .:|:. gabor@kovesdan.org WEB: http://people.FreeBSD.org/~gabor .:|:. http://kovesdan.org From owner-freebsd-doc@FreeBSD.ORG Sat Nov 21 14:40:02 2009 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 8AA67106566B for ; Sat, 21 Nov 2009 14:40:02 +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 4BD9D8FC1D for ; Sat, 21 Nov 2009 14:40:02 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id nALEe1ag082715 for ; Sat, 21 Nov 2009 14:40:01 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id nALEe1DV082714; Sat, 21 Nov 2009 14:40:01 GMT (envelope-from gnats) Resent-Date: Sat, 21 Nov 2009 14:40:01 GMT Resent-Message-Id: <200911211440.nALEe1DV082714@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, Aldis Berjoza Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id CB156106566C for ; Sat, 21 Nov 2009 14:36:09 +0000 (UTC) (envelope-from killasmurf86@gmail.com) Received: from mail-ew0-f226.google.com (mail-ew0-f226.google.com [209.85.219.226]) by mx1.freebsd.org (Postfix) with ESMTP id 5C83C8FC08 for ; Sat, 21 Nov 2009 14:36:09 +0000 (UTC) Received: by ewy26 with SMTP id 26so541511ewy.3 for ; Sat, 21 Nov 2009 06:36:08 -0800 (PST) Received: by 10.213.2.82 with SMTP id 18mr1462305ebi.44.1258814168327; Sat, 21 Nov 2009 06:36:08 -0800 (PST) Received: from killasmurf86.pc (mpe-11-135.mpe.lv [83.241.11.135]) by mx.google.com with ESMTPS id 16sm58339ewy.2.2009.11.21.06.36.04 (version=TLSv1/SSLv3 cipher=RC4-MD5); Sat, 21 Nov 2009 06:36:07 -0800 (PST) Message-Id: <1258814165.3370@killasmurf86.pc> Date: Sat, 21 Nov 2009 16:36:05 +0200 From: Aldis Berjoza To: "FreeBSD gnats submit" X-Send-Pr-Version: gtk-send-pr 0.4.9 Cc: Subject: docs/140754: Bad example in handbook 18.5.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: Sat, 21 Nov 2009 14:40:02 -0000 >Number: 140754 >Category: docs >Synopsis: Bad example in handbook 18.5.2 >Confidential: no >Severity: serious >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sat Nov 21 14:40:01 UTC 2009 >Closed-Date: >Last-Modified: >Originator: Aldis Berjoza >Release: FreeBSD 8.0-RC3 i386 >Organization: >Environment: System: FreeBSD 8.0-RC3 #0: Fri Nov 13 16:14:51 EET 2009 killasmurf86@killasmurf86.pc:/usr/obj/usr/src/sys/ANTIGENERIC >Description: http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/usb-disks.html#AEN24782 Handbook: The final step is to create a directory where the file system is to be mounted. This directory needs to be owned by the user that is to mount the file system. One way to do that is for root to create a subdirectory owned by that user as /mnt/username (replace username by the login name of the actual user and usergroup by the user's primary group): # mkdir /mnt/username # chown username:usergroup /mnt/username This isn't good. Because in most cases /mnt is just directory on root partition, and noone will probably want to create new slice/partition for /mnt if it's not used. I think a much better example would be to recommed create ~/mnt instead: # mkdir /home/username/mnt # chown username:usergroup /home/username/mnt Because usually /home is on separate slice partition. Why original example is bad? Because if for some reason destination is not mounted (/mnt/username), user still can copy files there. This way user can make root ful (willingly or unwillingly) Since /home is usually on separate slice/partition user can do whatever he wants. I hope you understand what I'm trying to say >How-To-Repeat: >Fix: s/\/mnt\/username/\/home\/username\/mnt/ >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Sat Nov 21 22:56:49 2009 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 55109106566B for ; Sat, 21 Nov 2009 22:56:49 +0000 (UTC) (envelope-from bouncecarcls1@carproperty.com) Received: from mail.carproperty.com (mail.carproperty.com [207.230.28.89]) by mx1.freebsd.org (Postfix) with ESMTP id E3CF08FC0C for ; Sat, 21 Nov 2009 22:56:48 +0000 (UTC) Received: from mail.carproperty.com (mail2.carproperty.com [127.0.0.1]) by mail.carproperty.com (8.14.2/8.14.2) with ESMTP id nALMqIDd023242 for ; Sat, 21 Nov 2009 14:52:18 -0800 Received: (from root@localhost) by mail.carproperty.com (8.14.2/8.14.2/Submit) id nALMqIbk023237; Sat, 21 Nov 2009 14:52:18 -0800 To: Valued Member From: "CarProperty.com" Date: Sat, 21 Nov 2009 09:45:04 -0800 X-LibVersion: 3.3.1_4 MIME-Version: 1.0 X-Priority: 3 X-MSMail-Priority: Normal X-MimeOLE: Produced by SwiftMailer 3.3.1_4 X-mid: ZG9jQGZyZWVic2Qub3JnICwgbTIxOA== X-Mailer: AC Mailer Message-ID: <20091121225218.6008.1381523437.swift@mail.carproperty.com> Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Content-Filtered-By: Mailman/MimeDel 2.1.5 Cc: Subject: Ford 400 AD Sale - Save 35% until 11/30/2009 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, 21 Nov 2009 22:56:49 -0000 Use Promo Code: Ford400 ... to save 35% off all CarProperty.com listings ... this 0ffer expires November 30, 2009 @ 11:59pm PST GO HERE FOR THE FULL DETAILS: http://www.carproperty.com/page.php?id=33 Try the CarProperty.com Map Search at this link http://www.carproperty.com/mapsearch.php Your AD will show up on this incredible map searching tool and it will be very easy to find! We love these guys ... check them out: America's Car Show http://www.AmericasCarShow.com, broadcast live on Sirius XM Radio ... listen to it live on Sundays 10pm EST - 12AM EST .... this is the world's best automotive broadcast bar none!! New Monthly Feature: Car Tips, brought to you by Americas Car Show, hosted by Tom Torbjornsen and heard on Sirius 108 and XM 139 Read the full articles here http://eliteautorepairshops.wordpress.com Sports Car Market Magazine Family and Internet Resources http://www.sportscarmarket.com/family ________________________________________________________________________________________________________________________________ CarProperty.com sent this informational newsletter to doc@freebsd.org based on your CarProperty.com optional user preferences. Click here to update your profile http://letters.carproperty.com/p_m.php?mi=218&nl=4&ei=ZG9jQGZyZWVic2Qub3Jn&eid=MjQ1Nzc5. Send this to a friend http://letters.carproperty.com/p_f.php?mi=218&nl=4&ei=ZG9jQGZyZWVic2Qub3Jn&eid=MjQ1Nzc5 If you no longer wish to receive our non-system messages, you can remove yourself from our mailing list by clicking here http://letters.carproperty.com/box.php?funcml=unsub2&nl=4&mi=218&email=doc%40freebsd.org or mail your request to Car Property Group. 1620 Central Ave, Suite 202, Cheyenne, WY 82001(please allow 3 - 4 weeks using this unsubscribe method). Toll Free: 1-888-628-3683. If you received a forwarded copy of the Car Property News, you can subscribe by registering on www.CarProperty.com. Car Property News is sent from time to time but not on a set schedule. To help make sure you get our emails, please put our domain address of @carproperty.com in your email programs address book or safe senders list that monitors your inbox. You may have to forward this information to a systems administrator who runs your email systems so they can put us on your safe list. Please give them our domain address of @carproperty.com. If you need help putting our domain address in your email programs address book or safe senders list, please click on this link: How to Add an Address to Your Address Book or Safe Senders List CarProperty.com is a registered Trademark as are the phrases Car Property and Car Properties, by the Car Property Group. This notice is compliant with the US Governments regulations regarding emails. To Unsubscribe, please click here : http://letters.carproperty.com/box.php?funcml=unsub2&nl=4&mi=218&email=doc%40freebsd.org