From owner-freebsd-xen@freebsd.org Thu Feb 7 12:57:19 2019 Return-Path: Delivered-To: freebsd-xen@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id B2AFD14D9781 for ; Thu, 7 Feb 2019 12:57:19 +0000 (UTC) (envelope-from freebsd-rwg@pdx.rh.CN85.dnsmgr.net) Received: from pdx.rh.CN85.dnsmgr.net (br1.CN84in.dnsmgr.net [69.59.192.140]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 99B3B8E732; Thu, 7 Feb 2019 12:57:18 +0000 (UTC) (envelope-from freebsd-rwg@pdx.rh.CN85.dnsmgr.net) Received: from pdx.rh.CN85.dnsmgr.net (localhost [127.0.0.1]) by pdx.rh.CN85.dnsmgr.net (8.13.3/8.13.3) with ESMTP id x17Cv7VV050494; Thu, 7 Feb 2019 04:57:07 -0800 (PST) (envelope-from freebsd-rwg@pdx.rh.CN85.dnsmgr.net) Received: (from freebsd-rwg@localhost) by pdx.rh.CN85.dnsmgr.net (8.13.3/8.13.3/Submit) id x17Cv7TZ050493; Thu, 7 Feb 2019 04:57:07 -0800 (PST) (envelope-from freebsd-rwg) From: "Rodney W. Grimes" Message-Id: <201902071257.x17Cv7TZ050493@pdx.rh.CN85.dnsmgr.net> Subject: Re: Extend documentation (was: Re: Issue getting my first Xen domU up) In-Reply-To: <20190207114342.by4kz3jkdltquh5x@mac> To: "Roger Pau Monn?" Date: Thu, 7 Feb 2019 04:57:07 -0800 (PST) CC: Andrew Daugherity , "freebsd-xen@freebsd.org" , Benedict Reuschling X-Mailer: ELM [version 2.4ME+ PL121h (25)] MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Content-Type: text/plain; charset=UNKNOWN-8BIT X-Rspamd-Queue-Id: 99B3B8E732 X-Spamd-Bar: ++ Authentication-Results: mx1.freebsd.org X-Spamd-Result: default: False [2.82 / 15.00]; ARC_NA(0.00)[]; TO_DN_EQ_ADDR_SOME(0.00)[]; FROM_HAS_DN(0.00)[]; RCPT_COUNT_THREE(0.00)[4]; TO_DN_SOME(0.00)[]; NEURAL_SPAM_SHORT(0.95)[0.948,0]; MIME_GOOD(-0.10)[text/plain]; RCVD_TLS_LAST(0.00)[]; DMARC_NA(0.00)[dnsmgr.net]; AUTH_NA(1.00)[]; NEURAL_SPAM_MEDIUM(0.42)[0.419,0]; RCVD_COUNT_THREE(0.00)[3]; TO_MATCH_ENVRCPT_SOME(0.00)[]; MX_GOOD(-0.01)[cached: pdx.rh.CN85.dnsmgr.net]; NEURAL_SPAM_LONG(0.58)[0.579,0]; R_SPF_NA(0.00)[]; FROM_EQ_ENVFROM(0.00)[]; R_DKIM_NA(0.00)[]; MIME_TRACE(0.00)[0:+]; ASN(0.00)[asn:13868, ipnet:69.59.192.0/19, country:US]; MID_RHS_MATCH_FROM(0.00)[]; IP_SCORE(-0.01)[ip: (0.02), ipnet: 69.59.192.0/19(0.01), asn: 13868(-0.02), country: US(-0.07)] X-BeenThere: freebsd-xen@freebsd.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Discussion of the freebsd port to xen - implementation and usage List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 07 Feb 2019 12:57:20 -0000 > On Wed, Feb 06, 2019 at 11:45:35PM +0000, Andrew Daugherity wrote: > > > On Feb 6, 2019, at 11:17 AM, Roger Pau Monn? wrote: > > > > > > Adding Benedict who wrote the Xen handbook documentation, and > > > hopefully would be able to fix it :). > > > > > > I suggest the following is added to the handbook: > > > [?] > > > > > > > > While you?re at it, I think some other updates to that handbook page are in order. I just read it again for the first time in a good while and the following things caught my eye: > > Thanks for the feedback! > > > - 21.8.2 mentions using Xen 4.7 on FreeBSD 11 and Xen 4.11 on FreeBSD-CURRENT >= r336475. As 12.0 has been released, that merits a mention here? while "FreeBSD 12.0-RELEASE r341666 GENERIC" does have a higher rev number, I?m not sure whether or not it contains the necessary stuff for Xen 4.11. > > FreeBSD 12.0 or FreeBSD-HEAD are all capable of using Xen 4.11. > > > - The /var/log/xen dir is created (and owned) by the xen-tools4{7,11} packages, so no need to manually create it. > > > > - Wouldn?t 'onifpresent' be a better setting for xc0 in /etc/ttys? Then if you booted back to a vanilla kernel, it won?t try (and fail) to start a getty for a nonexistent device. > > > > - The DomU example creates a FreeBSD 10.3 VM. Probably better to showcase a supported release? > > Right, let me see about this. > > > - Seeing "Xen(TM)" sprinkled throughout the document interrupts the reading flow. Surely it?s enough to use the trademark symbol for the first mention and then simply "Xen" thereafter? > > I don't have an opinion here, I don't know whether using Xen^TM is > mandatory. Using Trademark Symbols Preferred Usage: In press releases and business writing, it is recommended to use the trademark symbol [superscript ® or TM] on the first instance only or with the most prominent use of the mark. ... Possible Exceptions: If the first instance is in the title, then can use the symbol on the first instance in the text. So I would summarize we can safely remove all but 2 of the TM's since it probably appears in the title of the page. > > > - Is it really necessary to 'xl destroy' the DomU after shutting it down? Once it?s shut down, it shouldn?t be in the list any more, and you just 'xl create' with the new config, right? > > I don't see the manual suggesting to perform an `xl shutdown ...`, am > I missing something? > > It suggests to destroy the domain after install is finished, there's > no need to perform a graceful shutdown of the installer. > > Thanks, Roger. -- Rod Grimes rgrimes@freebsd.org