accept iodevices as NACs as well

Assignable PCIe devices have a root complex path and a more descriptive
I/O slot path; example output from a T4-2:

# ldomctl list-io | head -n2
PATH NAME
/@400/@2/@0/@8 /SYS/MB/PCIE0

ldom.conf(5) `iodevice' currently accepts PATH values, which are cryptic and
completely hardware specific, whereas NAME values are obvious (partially
same across machines) and match physical slot labels ("0 PCIe2 x8") besides
information from ILOM:
/System/PCI_Devices/Add-on/Device_0 location = PCIE0 (PCIe Slot 0).

Make ldom.conf `iodevice' accept either value; internally nothing changes.

Rename struct iodev's path member to dev to clarify this further.

OK kettenis

man pages: add missing commas between subordinate and main clauses

jmc@ dislikes a comma before "then" in a conditional, so leave those
untouched.

ok jmc@

Clarify BUGS wrt. reserving memory for the hypervisor

The previous wording might be understood as "leave memory unused in the
primary domain", which is precisely what causes the hypervisor to reject
the configuration since ldomctl(8) would implicitly allocate all remaining
memory for the primary domain.

Make sure that primary domain memory should be assigned explicitly so the
total amount of allocated memory is less than physically available, i.e.
the hypervisor will have even more memory available and configurations can
boot again.

OK stsp

Explain vcpu strides, provide example

Quite a few users and developers (including me) were confused by how
virtual CPU strides would work.

Initial diff together with stsp, final feedback from kettenis

Briefly document default boot disk behaviour

Support devaliases for vnet

vnet devalias=netboot

Creates a device alias to be used in OBP:

{ok} boot netboot

This helps navigating inside guests without remembering
device paths or rather their order as specified in the config.

OK kettenis

Support devaliases for vdisk

vdisk "/var/ldom/miniroot.fs" devalias=miniroot

Creates a device alias to be used in OBP:

{ok} devlias
miniroot /virutal-devices@100/...

This helps navigating inside guests without remembering
device paths or rather their order as specified in the config.

OK kettenis

vnet does not take curly braces

The manual lies and all options ought to be provided space
separated, on the same line as the vnet keyword.

OK kettenis

Add BUGS section for hypervisor memory requirement

The hypervisor transparently allocates memory it needs, but the specific
amount is machine dependent and not always documented or known.

Mention these details to prevent users from overcommitting memroy in their
configuration.

"variable name=value" can be used multiple times

Add create-vdisk command

Analogue to amd64's vmctl create, this command creates sparse disk image
files of the given size.

This is less error prone than creating full files with dd(1), but comes
with other caveats - still, it is worth having around.

Further refinements yet to come; vmctl and ldomctl should also behave more
alike in the future, as briefly discussed with kettenis and deraadt.

Use scan_scaled(3) for memory in ldom.conf

Replace the hand-written routing with a proper library allowing even more
formats.

Since ldomctl's local util.h conflicts with the now used global util.h from
libutil, rename it to ldom_util.h.

Manual wording from amd64's vm.conf(5).

OK kettenis

Allow an optional stride in the vcpu specification. This makes it possible
to allocate virtual CPUs but not assign them to domains. This way you
can give domains exclusive access to a core without assigning all threads
of that core to the domain.

minor markup polishing and typo fixes; OK kn@

Document the iodevice keyword.

Add missing article, use Dq not literal "

Use imperative present tense consistently

Move ldom.conf.5 to ldomctl

ldomctl(8)/ldomd(8) differs from the usual control/daemon setup since
ldom.conf(5) is never read by the daemon itself but the control program
only, so put it where it belongs.

While here, mention eeprom(8) for a list of OpenPROM variables.

Move prompted by kettenis
Positive feedback deraadt, "go ahead" kettenis

man pages: add missing commas between subordinate and main clauses

jmc@ dislikes a comma before "then" in a conditional, so leave those
untouched.

ok jmc@

Clarify BUGS wrt. reserving memory for the hypervisor

The previous wording might be understood as "leave memory unused in the
primary domain", which is precisely what causes the hypervisor to reject
the configuration since ldomctl(8) would implicitly allocate all remaining
memory for the primary domain.

Make sure that primary domain memory should be assigned explicitly so the
total amount of allocated memory is less than physically available, i.e.
the hypervisor will have even more memory available and configurations can
boot again.

OK stsp

Explain vcpu strides, provide example

Quite a few users and developers (including me) were confused by how
virtual CPU strides would work.

Initial diff together with stsp, final feedback from kettenis

Briefly document default boot disk behaviour

Support devaliases for vnet

vnet devalias=netboot

Creates a device alias to be used in OBP:

{ok} boot netboot

This helps navigating inside guests without remembering
device paths or rather their order as specified in the config.

OK kettenis

Support devaliases for vdisk

vdisk "/var/ldom/miniroot.fs" devalias=miniroot

Creates a device alias to be used in OBP:

{ok} devlias
miniroot /virutal-devices@100/...

This helps navigating inside guests without remembering
device paths or rather their order as specified in the config.

OK kettenis

vnet does not take curly braces

The manual lies and all options ought to be provided space
separated, on the same line as the vnet keyword.

OK kettenis

Add BUGS section for hypervisor memory requirement

The hypervisor transparently allocates memory it needs, but the specific
amount is machine dependent and not always documented or known.

Mention these details to prevent users from overcommitting memroy in their
configuration.

"variable name=value" can be used multiple times

Add create-vdisk command

Analogue to amd64's vmctl create, this command creates sparse disk image
files of the given size.

This is less error prone than creating full files with dd(1), but comes
with other caveats - still, it is worth having around.

Further refinements yet to come; vmctl and ldomctl should also behave more
alike in the future, as briefly discussed with kettenis and deraadt.

Use scan_scaled(3) for memory in ldom.conf

Replace the hand-written routing with a proper library allowing even more
formats.

Since ldomctl's local util.h conflicts with the now used global util.h from
libutil, rename it to ldom_util.h.

Manual wording from amd64's vm.conf(5).

OK kettenis

Allow an optional stride in the vcpu specification. This makes it possible
to allocate virtual CPUs but not assign them to domains. This way you
can give domains exclusive access to a core without assigning all threads
of that core to the domain.

minor markup polishing and typo fixes; OK kn@

Document the iodevice keyword.

Add missing article, use Dq not literal "

Use imperative present tense consistently

Move ldom.conf.5 to ldomctl

ldomctl(8)/ldomd(8) differs from the usual control/daemon setup since
ldom.conf(5) is never read by the daemon itself but the control program
only, so put it where it belongs.

While here, mention eeprom(8) for a list of OpenPROM variables.

Move prompted by kettenis
Positive feedback deraadt, "go ahead" kettenis

Clarify BUGS wrt. reserving memory for the hypervisor

The previous wording might be understood as "leave memory unused in the
primary domain", which is precisely what causes the hypervisor to reject
the configuration since ldomctl(8) would implicitly allocate all remaining
memory for the primary domain.

Make sure that primary domain memory should be assigned explicitly so the
total amount of allocated memory is less than physically available, i.e.
the hypervisor will have even more memory available and configurations can
boot again.

OK stsp

Explain vcpu strides, provide example

Quite a few users and developers (including me) were confused by how
virtual CPU strides would work.

Initial diff together with stsp, final feedback from kettenis

Briefly document default boot disk behaviour

Support devaliases for vnet

vnet devalias=netboot

Creates a device alias to be used in OBP:

{ok} boot netboot

This helps navigating inside guests without remembering
device paths or rather their order as specified in the config.

OK kettenis

Support devaliases for vdisk

vdisk "/var/ldom/miniroot.fs" devalias=miniroot

Creates a device alias to be used in OBP:

{ok} devlias
miniroot /virutal-devices@100/...

This helps navigating inside guests without remembering
device paths or rather their order as specified in the config.

OK kettenis

vnet does not take curly braces

The manual lies and all options ought to be provided space
separated, on the same line as the vnet keyword.

OK kettenis

Add BUGS section for hypervisor memory requirement

The hypervisor transparently allocates memory it needs, but the specific
amount is machine dependent and not always documented or known.

Mention these details to prevent users from overcommitting memroy in their
configuration.

"variable name=value" can be used multiple times

Add create-vdisk command

Analogue to amd64's vmctl create, this command creates sparse disk image
files of the given size.

This is less error prone than creating full files with dd(1), but comes
with other caveats - still, it is worth having around.

Further refinements yet to come; vmctl and ldomctl should also behave more
alike in the future, as briefly discussed with kettenis and deraadt.

Use scan_scaled(3) for memory in ldom.conf

Replace the hand-written routing with a proper library allowing even more
formats.

Since ldomctl's local util.h conflicts with the now used global util.h from
libutil, rename it to ldom_util.h.

Manual wording from amd64's vm.conf(5).

OK kettenis

Allow an optional stride in the vcpu specification. This makes it possible
to allocate virtual CPUs but not assign them to domains. This way you
can give domains exclusive access to a core without assigning all threads
of that core to the domain.

minor markup polishing and typo fixes; OK kn@

Document the iodevice keyword.

Add missing article, use Dq not literal "

Use imperative present tense consistently

Move ldom.conf.5 to ldomctl

ldomctl(8)/ldomd(8) differs from the usual control/daemon setup since
ldom.conf(5) is never read by the daemon itself but the control program
only, so put it where it belongs.

While here, mention eeprom(8) for a list of OpenPROM variables.

Move prompted by kettenis
Positive feedback deraadt, "go ahead" kettenis

Explain vcpu strides, provide example

Quite a few users and developers (including me) were confused by how
virtual CPU strides would work.

Initial diff together with stsp, final feedback from kettenis

Briefly document default boot disk behaviour

Support devaliases for vnet

vnet devalias=netboot

Creates a device alias to be used in OBP:

{ok} boot netboot

This helps navigating inside guests without remembering
device paths or rather their order as specified in the config.

OK kettenis

Support devaliases for vdisk

vdisk "/var/ldom/miniroot.fs" devalias=miniroot

Creates a device alias to be used in OBP:

{ok} devlias
miniroot /virutal-devices@100/...

This helps navigating inside guests without remembering
device paths or rather their order as specified in the config.

OK kettenis

vnet does not take curly braces

The manual lies and all options ought to be provided space
separated, on the same line as the vnet keyword.

OK kettenis

Add BUGS section for hypervisor memory requirement

The hypervisor transparently allocates memory it needs, but the specific
amount is machine dependent and not always documented or known.

Mention these details to prevent users from overcommitting memroy in their
configuration.

"variable name=value" can be used multiple times

Add create-vdisk command

Analogue to amd64's vmctl create, this command creates sparse disk image
files of the given size.

This is less error prone than creating full files with dd(1), but comes
with other caveats - still, it is worth having around.

Further refinements yet to come; vmctl and ldomctl should also behave more
alike in the future, as briefly discussed with kettenis and deraadt.

Use scan_scaled(3) for memory in ldom.conf

Replace the hand-written routing with a proper library allowing even more
formats.

Since ldomctl's local util.h conflicts with the now used global util.h from
libutil, rename it to ldom_util.h.

Manual wording from amd64's vm.conf(5).

OK kettenis

Allow an optional stride in the vcpu specification. This makes it possible
to allocate virtual CPUs but not assign them to domains. This way you
can give domains exclusive access to a core without assigning all threads
of that core to the domain.

minor markup polishing and typo fixes; OK kn@

Document the iodevice keyword.

Add missing article, use Dq not literal "

Use imperative present tense consistently

Move ldom.conf.5 to ldomctl

ldomctl(8)/ldomd(8) differs from the usual control/daemon setup since
ldom.conf(5) is never read by the daemon itself but the control program
only, so put it where it belongs.

While here, mention eeprom(8) for a list of OpenPROM variables.

Move prompted by kettenis
Positive feedback deraadt, "go ahead" kettenis

Briefly document default boot disk behaviour

Support devaliases for vnet

vnet devalias=netboot

Creates a device alias to be used in OBP:

{ok} boot netboot

This helps navigating inside guests without remembering
device paths or rather their order as specified in the config.

OK kettenis

Support devaliases for vdisk

vdisk "/var/ldom/miniroot.fs" devalias=miniroot

Creates a device alias to be used in OBP:

{ok} devlias
miniroot /virutal-devices@100/...

This helps navigating inside guests without remembering
device paths or rather their order as specified in the config.

OK kettenis

vnet does not take curly braces

The manual lies and all options ought to be provided space
separated, on the same line as the vnet keyword.

OK kettenis

Add BUGS section for hypervisor memory requirement

The hypervisor transparently allocates memory it needs, but the specific
amount is machine dependent and not always documented or known.

Mention these details to prevent users from overcommitting memroy in their
configuration.

"variable name=value" can be used multiple times

Add create-vdisk command

Analogue to amd64's vmctl create, this command creates sparse disk image
files of the given size.

This is less error prone than creating full files with dd(1), but comes
with other caveats - still, it is worth having around.

Further refinements yet to come; vmctl and ldomctl should also behave more
alike in the future, as briefly discussed with kettenis and deraadt.

Use scan_scaled(3) for memory in ldom.conf

Replace the hand-written routing with a proper library allowing even more
formats.

Since ldomctl's local util.h conflicts with the now used global util.h from
libutil, rename it to ldom_util.h.

Manual wording from amd64's vm.conf(5).

OK kettenis

Allow an optional stride in the vcpu specification. This makes it possible
to allocate virtual CPUs but not assign them to domains. This way you
can give domains exclusive access to a core without assigning all threads
of that core to the domain.

minor markup polishing and typo fixes; OK kn@

Document the iodevice keyword.

Add missing article, use Dq not literal "

Use imperative present tense consistently

Move ldom.conf.5 to ldomctl

ldomctl(8)/ldomd(8) differs from the usual control/daemon setup since
ldom.conf(5) is never read by the daemon itself but the control program
only, so put it where it belongs.

While here, mention eeprom(8) for a list of OpenPROM variables.

Move prompted by kettenis
Positive feedback deraadt, "go ahead" kettenis

Support devaliases for vnet

vnet devalias=netboot

Creates a device alias to be used in OBP:

{ok} boot netboot

This helps navigating inside guests without remembering
device paths or rather their order as specified in the config.

OK kettenis

Support devaliases for vdisk

vdisk "/var/ldom/miniroot.fs" devalias=miniroot

Creates a device alias to be used in OBP:

{ok} devlias
miniroot /virutal-devices@100/...

This helps navigating inside guests without remembering
device paths or rather their order as specified in the config.

OK kettenis

vnet does not take curly braces

The manual lies and all options ought to be provided space
separated, on the same line as the vnet keyword.

OK kettenis

Add BUGS section for hypervisor memory requirement

The hypervisor transparently allocates memory it needs, but the specific
amount is machine dependent and not always documented or known.

Mention these details to prevent users from overcommitting memroy in their
configuration.

"variable name=value" can be used multiple times

Add create-vdisk command

Analogue to amd64's vmctl create, this command creates sparse disk image
files of the given size.

This is less error prone than creating full files with dd(1), but comes
with other caveats - still, it is worth having around.

Further refinements yet to come; vmctl and ldomctl should also behave more
alike in the future, as briefly discussed with kettenis and deraadt.

Use scan_scaled(3) for memory in ldom.conf

Replace the hand-written routing with a proper library allowing even more
formats.

Since ldomctl's local util.h conflicts with the now used global util.h from
libutil, rename it to ldom_util.h.

Manual wording from amd64's vm.conf(5).

OK kettenis

Allow an optional stride in the vcpu specification. This makes it possible
to allocate virtual CPUs but not assign them to domains. This way you
can give domains exclusive access to a core without assigning all threads
of that core to the domain.

minor markup polishing and typo fixes; OK kn@

Document the iodevice keyword.

Add missing article, use Dq not literal "

Use imperative present tense consistently

Move ldom.conf.5 to ldomctl

ldomctl(8)/ldomd(8) differs from the usual control/daemon setup since
ldom.conf(5) is never read by the daemon itself but the control program
only, so put it where it belongs.

While here, mention eeprom(8) for a list of OpenPROM variables.

Move prompted by kettenis
Positive feedback deraadt, "go ahead" kettenis

Support devaliases for vdisk

vdisk "/var/ldom/miniroot.fs" devalias=miniroot

Creates a device alias to be used in OBP:

{ok} devlias
miniroot /virutal-devices@100/...

This helps navigating inside guests without remembering
device paths or rather their order as specified in the config.

OK kettenis

vnet does not take curly braces

The manual lies and all options ought to be provided space
separated, on the same line as the vnet keyword.

OK kettenis

Add BUGS section for hypervisor memory requirement

The hypervisor transparently allocates memory it needs, but the specific
amount is machine dependent and not always documented or known.

Mention these details to prevent users from overcommitting memroy in their
configuration.

"variable name=value" can be used multiple times

Add create-vdisk command

Analogue to amd64's vmctl create, this command creates sparse disk image
files of the given size.

This is less error prone than creating full files with dd(1), but comes
with other caveats - still, it is worth having around.

Further refinements yet to come; vmctl and ldomctl should also behave more
alike in the future, as briefly discussed with kettenis and deraadt.

Use scan_scaled(3) for memory in ldom.conf

Replace the hand-written routing with a proper library allowing even more
formats.

Since ldomctl's local util.h conflicts with the now used global util.h from
libutil, rename it to ldom_util.h.

Manual wording from amd64's vm.conf(5).

OK kettenis

Allow an optional stride in the vcpu specification. This makes it possible
to allocate virtual CPUs but not assign them to domains. This way you
can give domains exclusive access to a core without assigning all threads
of that core to the domain.

minor markup polishing and typo fixes; OK kn@

Document the iodevice keyword.

Add missing article, use Dq not literal "

Use imperative present tense consistently

Move ldom.conf.5 to ldomctl

ldomctl(8)/ldomd(8) differs from the usual control/daemon setup since
ldom.conf(5) is never read by the daemon itself but the control program
only, so put it where it belongs.

While here, mention eeprom(8) for a list of OpenPROM variables.

Move prompted by kettenis
Positive feedback deraadt, "go ahead" kettenis

Add BUGS section for hypervisor memory requirement

The hypervisor transparently allocates memory it needs, but the specific
amount is machine dependent and not always documented or known.

Mention these details to prevent users from overcommitting memroy in their
configuration.

"variable name=value" can be used multiple times

Add create-vdisk command

Analogue to amd64's vmctl create, this command creates sparse disk image
files of the given size.

This is less error prone than creating full files with dd(1), but comes
with other caveats - still, it is worth having around.

Further refinements yet to come; vmctl and ldomctl should also behave more
alike in the future, as briefly discussed with kettenis and deraadt.

Use scan_scaled(3) for memory in ldom.conf

Replace the hand-written routing with a proper library allowing even more
formats.

Since ldomctl's local util.h conflicts with the now used global util.h from
libutil, rename it to ldom_util.h.

Manual wording from amd64's vm.conf(5).

OK kettenis

Allow an optional stride in the vcpu specification. This makes it possible
to allocate virtual CPUs but not assign them to domains. This way you
can give domains exclusive access to a core without assigning all threads
of that core to the domain.

minor markup polishing and typo fixes; OK kn@

Document the iodevice keyword.

Add missing article, use Dq not literal "

Use imperative present tense consistently

Move ldom.conf.5 to ldomctl

ldomctl(8)/ldomd(8) differs from the usual control/daemon setup since
ldom.conf(5) is never read by the daemon itself but the control program
only, so put it where it belongs.

While here, mention eeprom(8) for a list of OpenPROM variables.

Move prompted by kettenis
Positive feedback deraadt, "go ahead" kettenis

"variable name=value" can be used multiple times

Add create-vdisk command

Analogue to amd64's vmctl create, this command creates sparse disk image
files of the given size.

This is less error prone than creating full files with dd(1), but comes
with other caveats - still, it is worth having around.

Further refinements yet to come; vmctl and ldomctl should also behave more
alike in the future, as briefly discussed with kettenis and deraadt.

Use scan_scaled(3) for memory in ldom.conf

Replace the hand-written routing with a proper library allowing even more
formats.

Since ldomctl's local util.h conflicts with the now used global util.h from
libutil, rename it to ldom_util.h.

Manual wording from amd64's vm.conf(5).

OK kettenis

Allow an optional stride in the vcpu specification. This makes it possible
to allocate virtual CPUs but not assign them to domains. This way you
can give domains exclusive access to a core without assigning all threads
of that core to the domain.

minor markup polishing and typo fixes; OK kn@

Document the iodevice keyword.

Add missing article, use Dq not literal "

Use imperative present tense consistently

Move ldom.conf.5 to ldomctl

ldomctl(8)/ldomd(8) differs from the usual control/daemon setup since
ldom.conf(5) is never read by the daemon itself but the control program
only, so put it where it belongs.

While here, mention eeprom(8) for a list of OpenPROM variables.

Move prompted by kettenis
Positive feedback deraadt, "go ahead" kettenis

Add create-vdisk command

Analogue to amd64's vmctl create, this command creates sparse disk image
files of the given size.

This is less error prone than creating full files with dd(1), but comes
with other caveats - still, it is worth having around.

Further refinements yet to come; vmctl and ldomctl should also behave more
alike in the future, as briefly discussed with kettenis and deraadt.

Use scan_scaled(3) for memory in ldom.conf

Replace the hand-written routing with a proper library allowing even more
formats.

Since ldomctl's local util.h conflicts with the now used global util.h from
libutil, rename it to ldom_util.h.

Manual wording from amd64's vm.conf(5).

OK kettenis

Allow an optional stride in the vcpu specification. This makes it possible
to allocate virtual CPUs but not assign them to domains. This way you
can give domains exclusive access to a core without assigning all threads
of that core to the domain.

minor markup polishing and typo fixes; OK kn@

Document the iodevice keyword.

Add missing article, use Dq not literal "

Use imperative present tense consistently

Move ldom.conf.5 to ldomctl

ldomctl(8)/ldomd(8) differs from the usual control/daemon setup since
ldom.conf(5) is never read by the daemon itself but the control program
only, so put it where it belongs.

While here, mention eeprom(8) for a list of OpenPROM variables.

Move prompted by kettenis
Positive feedback deraadt, "go ahead" kettenis

Use scan_scaled(3) for memory in ldom.conf

Replace the hand-written routing with a proper library allowing even more
formats.

Since ldomctl's local util.h conflicts with the now used global util.h from
libutil, rename it to ldom_util.h.

Manual wording from amd64's vm.conf(5).

OK kettenis

Allow an optional stride in the vcpu specification. This makes it possible
to allocate virtual CPUs but not assign them to domains. This way you
can give domains exclusive access to a core without assigning all threads
of that core to the domain.

minor markup polishing and typo fixes; OK kn@

Document the iodevice keyword.

Add missing article, use Dq not literal "

Use imperative present tense consistently

Move ldom.conf.5 to ldomctl

ldomctl(8)/ldomd(8) differs from the usual control/daemon setup since
ldom.conf(5) is never read by the daemon itself but the control program
only, so put it where it belongs.

While here, mention eeprom(8) for a list of OpenPROM variables.

Move prompted by kettenis
Positive feedback deraadt, "go ahead" kettenis

Allow an optional stride in the vcpu specification. This makes it possible
to allocate virtual CPUs but not assign them to domains. This way you
can give domains exclusive access to a core without assigning all threads
of that core to the domain.

minor markup polishing and typo fixes; OK kn@

Document the iodevice keyword.

Add missing article, use Dq not literal "

Use imperative present tense consistently

Move ldom.conf.5 to ldomctl

ldomctl(8)/ldomd(8) differs from the usual control/daemon setup since
ldom.conf(5) is never read by the daemon itself but the control program
only, so put it where it belongs.

While here, mention eeprom(8) for a list of OpenPROM variables.

Move prompted by kettenis
Positive feedback deraadt, "go ahead" kettenis