man pages section 1M: System Administration Commands

Exit Print View

Updated: July 2014
 
 

virtinfo(1M)

Name

virtinfo - Virtual environment information

Synopsis

virtinfo [[-c <class>[,...] | all] <subcommand>] list [[-H] -o <field>[,...]] [<environment>] ... 
get  [[-H] -o <field>[,...]] all | <property>[,...] [<environment>] ... help property | environment

Description

The virtinfo utility provides virtualization information returned by libv12n (3LIB) about the current environment, parent environment and a list of supported environments. If no options are specified, virtinfo performs the equivalent of "virtinfo list".

Options

The virtinfo command supports the following options:

–a

Shows all information that is currently available from the system.

–c

The class of virtual environment: current, parent, or supported.

Sub Commands

The virtinfo command supports the following subcommands:

list [[-–H] –o < field>[,...]] [<environment>] ...

Lists the current, parent, and supported environments. The list can be limited by listing environments of interest. For each environment the following fields are displayed:

name

Environment name

class

Environment class. It can be current, parent, or supported.

–H

Used for scripting mode. This option does not print headers and separates fields by a single tab instead of arbitrary white space.

–o field

Displays a comma-separated list of fields.

get [[–H] –o < field>[,...]] all | <property>[,...] [<environment>] ...

Retrieve a property of an environment. Properties are environment and class specific. For example an LDoms supported environment may support different properties to an LDoms current environment. The environment list to query can be limited by listing environments of interest.

For each property the following fields are displayed:

name

Environment name

class

Environment class

property

Property name

value

Property value

–H

Used for scripting mode. This option does not print headers and separates fields by a single tab instead of arbitrary white space.

–o field

Displays a comma-separated list of fields.

help property | environment

List all the property or environment names. The list of available properties and environments may vary with machine architecture.

If a property value is not available, due to lack of sufficient privileges, "-" is displayed in its place.

Exit Status

The following exit values are returned:

0

Successful completion.

>0

An error occurred.

Examples

Example 1 Viewing Default Information

The following example shows the default output:

$ virtinfo
				 NAME            CLASS      
        logical-domain  current   
        non-global-zone supported 
        kernel-zone     supported
The current domain is an LDoms guest domain. Both non-global 
zones and kernel-zone are supported as guests. The parent 
virtual environment class could not be determined.
Example 2 Check to see if Kernel Zones are Supported

The following example shows how to check if the current environment is capable of supporting a Kernel Zone:

$ virtinfo -c supported list kernel-zone
NAME          CLASS
kernel-zone   supported
Example 3 Viewing All LDoms Properties in a Parsable Format

The following example shows all available information about an LDoms environment in a parsable format:

$ virtinfo -c current get -H -o property,value all logical-domain

control-role	true
io-role	true
root-role	true
service-role	true
domain-name	primary
uuid	da64f9b8-3e37-688e-cc3f-e90a59db1ad
control-name	leftarrow
chassis-serial-number	1228BDY5D4

Attributes

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

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Availability
system/library/libv12n
Interface Stability
Uncommitted

See also

libuuid(3LIB), libv12n(3LIB)