Extend documentation (was: Re: Issue getting my first Xen domU up)

[Andrew Daugherity]

> On Feb 6, 2019, at 11:17 AM, Roger Pau Monné <roger.pau at citrix.com> 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:

- 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.

- 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…

- 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?

- 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?


It’s nice to see Xen support in FreeBSD continue to improve!  (Even if I I’ve only run it as a DomU so far…)


Cheers,
Andrew