Manual Pages for UNIX Operating System command usage for man virtinfo

System Administration Commands                       virtinfo(1M)



NAME
     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 stan-
     dard 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 from
           the system.


     -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.




SunOS 5.11          Last change: 20 Jul 2010                    1






System Administration Commands                       virtinfo(1M)



           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


     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.





SunOS 5.11          Last change: 20 Jul 2010                    2






System Administration Commands                       virtinfo(1M)



     Example 2 Viewing All Information


     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 In a Parsable Format


     The following example shows all available information  about
     the domain in a parsable 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  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcsu                     |
    |_____________________________|_____________________________|
    | Interface Stability         | Uncommitted                 |
    |_____________________________|_____________________________|


SEE ALSO
     libuuid(3LIB), libv12n(3LIB)





SunOS 5.11          Last change: 20 Jul 2010                    3