virsh: domifaddr: clarify description of --full option

Option --full will always display the name and MAC address of the
the interface. Both virsh help and virsh man page didn't mention that.

Signed-off-by: Chen Hanxiao <chenhanxiao@gmail.com>
This commit is contained in:
Chen Hanxiao 2017-10-16 14:53:22 +08:00 committed by John Ferlan
parent 15a37cdf88
commit b3aaff56db
2 changed files with 9 additions and 5 deletions

View File

@ -2153,7 +2153,7 @@ static const vshCmdOptDef opts_domifaddr[] = {
{.name = "full",
.type = VSH_OT_BOOL,
.flags = VSH_OFLAG_NONE,
.help = N_("display full fields")},
.help = N_("always display names and MACs of interfaces")},
{.name = "source",
.type = VSH_OT_STRING,
.flags = VSH_OFLAG_NONE,

View File

@ -766,10 +766,14 @@ addresses, or limited output just for one interface if I<interface> is
specified. Note that I<interface> can be driver dependent, it can be the name
within guest OS or the name you would see in domain XML. Moreover, the whole
command may require a guest agent to be configured for the queried domain under
some drivers, notably qemu. If I<--full> is specified, the interface name is
always displayed when the interface has multiple addresses or alias, otherwise
it only displays the interface name for the first address, and "-" for the
others. The I<--source> argument specifies what data source to use for the
some hypervisors, notably QEMU.
If I<--full> is specified, the interface name and MAC address is always
displayed when the interface has multiple IP addresses or aliases; otherwise,
only the interface name and MAC address is displayed for the first name and
MAC address with "-" for the others using the same name and MAC address.
The I<--source> argument specifies what data source to use for the
addresses, currently one of 'lease' to read DHCP leases, or 'agent' to query
the guest OS via an agent. If unspecified, 'lease' is the default.