Bug 286582

Summary:	xen(4) man page needs update
Product:	Documentation	Reporter:	Stephen Walker-Weinshenker <freebsd>
Component:	Manual Pages	Assignee:	Roger Pau Monné <royger>
Status:	Closed FIXED
Severity:	Affects Many People	CC:	carlavilla, cperciva, doc, mhorne, royger, skaltar, ziaee
Priority:	---
Version:	Latest
Hardware:	Any
OS:	Any

Description Stephen Walker-Weinshenker 2025-05-04 17:43:22 UTC

The xen(4) man page Bugs section needs to be updated to specify that FreeBSD has supported being a xen host since 11.0 and supported UEFI booting since 14.0 per the documentation.

This was noticed on version 14.2-RELEASE-p1.

Comment 1 Jaime Corchado 2025-05-15 02:47:01 UTC

## Notes on the documentation to setup Xen on FreeBSD.

1. BSD documentation says `echo 'vm.max_wired=1' >>/etc/sysctl.conf` when the prompt from the program suggests `vm.max_user_wired=-1` since it is FreeBSD 13 or newer.

2. The installation package writes an entry for Xen. The instructions as-written would duplicate a config line.

3. The context is not obvious enough that `sysrc` is a program to run as admin.

4. The network device file to use instead of em0 is known by the user after running ifconfig. I confused the instructions and replaced bridge0 instead of em0.

Comment 2 Alexander Ziaee freebsd_committer

2025-05-19 04:11:48 UTC

^Triage: This doc was fixed 14 months ago in 82126ef92fdb3c13a67 but was never merged to stable. Can we MFC this for the release? If I get the okays I'd be happy to do it if everyone is busy.

Comment 3 Roger Pau Monné freebsd_committer

2025-05-19 08:40:38 UTC

I've MFC'ed to stable/{13,14} waiting for approval to MFC to releng/14.3

Comment 4 Alexander Ziaee freebsd_committer

2025-05-19 08:53:16 UTC

> I've MFC'ed to stable/{13,14} waiting for approval to MFC to releng/14.3

You're awesome, thank you!

Comment 5 Roger Pau Monné freebsd_committer

2025-05-19 17:21:39 UTC

The man page update has been committed to releng/14.3.  I'm closing this.