Bug 233230 - [bhyve] [patch] usage() doesn't list -G debug server option
Summary: [bhyve] [patch] usage() doesn't list -G debug server option
Status: New
Alias: None
Product: Base System
Classification: Unclassified
Component: bin (show other bugs)
Version: CURRENT
Hardware: Any Any
: --- Affects Only Me
Assignee: freebsd-bugs mailing list
URL:
Keywords: patch
Depends on:
Blocks:
 
Reported: 2018-11-14 21:16 UTC by Rob
Modified: 2018-12-06 20:34 UTC (History)
2 users (show)

See Also:


Attachments
add -G, the debug server port option to bhyve usage message (476 bytes, patch)
2018-11-14 21:16 UTC, Rob
no flags Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Rob 2018-11-14 21:16:33 UTC
Created attachment 199244 [details]
add -G, the debug server port option to bhyve usage message

The debug server option, -G, is documented in bhyve(8) but not shown in usage message:

Usage: bhyve [-abehuwxACHPSWY]
             [-c [[cpus=]numcpus][,sockets=n][,cores=n][,threads=n]]
             [-g <gdb port>] [-l <lpc>]
             [-m mem] [-p vcpu:hostcpu] [-s <pci>] [-U uuid] <vm>
       -a: local apic is in xAPIC mode (deprecated)
       -A: create ACPI tables
       -c: number of cpus and/or topology specification
       -C: include guest memory in core file
       -e: exit on unhandled I/O access
       -g: gdb port
       -h: help
       -H: vmexit from the guest on hlt
       -l: LPC device configuration
       -m: memory size in MB
       -p: pin 'vcpu' to 'hostcpu'
       -P: vmexit from the guest on pause
       -s: <slot,driver,configinfo> PCI slot config
       -S: guest memory cannot be swapped
       -u: RTC keeps UTC time
       -U: uuid
       -w: ignore unimplemented MSRs
       -W: force virtio to use single-vector MSI
       -x: local apic is in x2APIC mode
       -Y: disable MPtable generation

Attached patch adds the -G option to bhyve usage message - patch is based off r340424 (HEAD).
Comment 1 Ed Maste freebsd_committer 2018-12-04 16:40:32 UTC
Text should maybe be "Hypervisor debug server port" or similar - AIUI both -g and -G specify a debug server port, -g is passed through to the guest debug server while -G is the debug server running in bhyve itself.
Comment 2 Rob 2018-12-06 20:34:33 UTC
Yea, I see what you're saying. Maybe the -g option should be more specific?

-g <remote gdb port>
    starts a server that relays connections to a guest gdb stub

-G <local debug server port>
    starts a server, intended for debugging purposes, for the bhyve instance.

If the -g option is documented as being a remote connection to the guest, perhaps the description 'debug server port' would suffice for the -G option. If not, I think adding 'local' or 'hypervisor' to the -G option would get the point across.