virtinfo(1m) - Virtual environment information

[mountaing]

System Administration Commands                                    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  sys-
             tem.


       -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  environ-
           ment the following fields are displayed:

           name        Environment name


           class       Environment  class.  It can be current, parent, or sup-
                       ported.


           -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  avail-
               able  properties  and environments may vary with machine archi-
               tecture.

               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)



SunOS 5.11                        18 Nov 2013                     virtinfo(1M)