virtinfo

- virtualization domain information

Synopsis

virtinfo [ -acdpstu ]

Description

The virtinfo utility provides virtualization information returned by libv12n(3LIB) about the current domain. When options are specified, symbols that represent one or more virtualization domain characteristics are written to standard output. If no options are specified, virtinfo shows only the virtualization domain type.

Options

The virtinfo command supports the following options:

-a

Shows all information that is currently available about the domain.

-c

Shows the network node name of the control domain. This name is identical to the string shown by running the uname -n command on the control domain.

-d

Shows the domain name for this virtual domain.

-p

Shows information in a parseable format.

The parseable output for Logical Domains (LDoms) has the following format:

VERSION 1.0
DOMAINROLE|impl=LDoms|control={true|false}|
    io={true|false}|service={true|false}|
    root={true|false}
DOMAINNAME|name=domain-name
DOMAINUUID|uuid=uuid
DOMAINCONTROL|name=control-domain-nodename
DOMAINCHASSIS|serialno=serial-no

-s

Shows the platform serial number.

-t

Shows the domain type.

The domain type for Logical Domains is a string of one or more of the following blank-separated values:

LDoms

LDoms implementation

control

Control domain

guest

Guest domain

I/O

I/O domain

service

Service domain

root

Root I/O domain

Note that the control and guest values are mutually exclusive.

-u

Shows the universally unique identifier (UUID) of the domain. See the libuuid(3LIB) man page.

Exit Status

The following exit values are returned:

0

Successful completion.

>0

An error occurred.

Examples

Example 1 Viewing Default Information About a Domain

The following example shows the default information about the domain:

$ virtinfo
Domain role: LDoms control I/O service root

The current domain is the control domain, which is also an
I/O domain, the service domain and a root I/O domain.

Example 2 Viewing All Information About a Domain

The following example shows all available information about the domain:

$ virtinfo -a
Domain role: LDoms control I/O service root
Domain name: primary
Domain UUID: 8e0d6ec5-cd55-e57f-ae9f-b4cc050999a4
Control domain: san-t2k-6
Chassis serial#: 0704RB0280

Example 3 Viewing All Information About a Domain in a Parseable Format

The following example shows all available information about the domain in a parseable format:

$ virtinfo -ap
VERSION 1.0
DOMAINROLE|impl=LDoms|control=true|io=true|service=true|root=true
DOMAINNAME|name=primary
DOMAINUUID|uuid=8e0d6ec5-cd55-e57f-ae9f-b4cc050999a4
DOMAINCONTROL|name=san-t2k-6
DOMAINCHASSIS|serialno=0704RB0280

Attributes

See attributes(5) for descriptions of the following attributes:

See Also

libuuid(3LIB), libv12n(3LIB)