Project

General

Profile

Actions

Bug #14544

closed

bhyve(1M) uses -A in EXAMPLES but doesn't otherwise document it

Added by Rich Lowe 7 months ago. Updated 7 months ago.

Status:
Closed
Priority:
Low
Assignee:
-
Category:
manpage - manual pages
Start date:
Due date:
% Done:

100%

Estimated time:
Difficulty:
Bite-size
Tags:
Gerrit CR:
External Bug:

Description

bhyve(1M) contains examples such as

           bhyve -c 2 -s 0,hostbridge -s 1,lpc -s 2,virtio-blk,/my/image \
             -l com1,stdio -A -H -P -m 1G vm1

But doesn't otherwise document -A, either in general or in SYNOPSIS


Related issues

Related to illumos gate - Feature #13764: bhyve could reduce privileges(5)ClosedAndy Fiddaman

Actions
Actions #1

Updated by Andy Fiddaman 7 months ago

The -A option generates ACPI tables on the fly (by calling out to iasl) and puts them in memory somewhere - just below the bootrom I think. These tables are not used at all by the illumos C userland, the bootrom has built-in tables which are used instead. The -A option in FreeBSD is for bhyveload/grub2-bhyve (direct kernel booting) which we don't have.

As part of the privileges work I dropped -A from the manual, and made it a no-op (or intended too, since otherwise I would need to have granted fork/exec privileges).

I'll clean up these other mentions too.

Actions #2

Updated by Andy Fiddaman 7 months ago

Actions #3

Updated by Electric Monk 7 months ago

  • Gerrit CR set to 2056
Actions #4

Updated by Andy Fiddaman 7 months ago

I also fixed the fbuf example to include the (currently) necessary vga=off.

Viewed the updated man pages with mandoc, checked that the -A option no longer has any effect using the config.dump option to check the resulting configuration.

Actions #5

Updated by Electric Monk 7 months ago

  • Status changed from New to Closed
  • % Done changed from 0 to 100

git commit 2c4fdd8fb33adc5c98677c7d5c87687c405be868

commit  2c4fdd8fb33adc5c98677c7d5c87687c405be868
Author: Andy Fiddaman <omnios@citrus-it.co.uk>
Date:   2022-03-01T23:03:30.000Z

    14544 bhyve(1M) uses -A in EXAMPLES but doesn't otherwise document it
    Reviewed by: Robert Mustacchi <rm+illumos@fingolfin.org>
    Approved by: Rich Lowe <richlowe@richlowe.net>

Actions

Also available in: Atom PDF