Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

ovmtprop (8)

Name

ovmtprop - show Oracle VM for SPARC templates properties

Synopsis

/opt/ovmtutils/bin/ovmtprop get-prop -a [-h] [-q] [-V]

/opt/ovmtutils/bin/ovmtprop get-prop -k name[,name,...] [-h] [-q] [-V]

/opt/ovmtutils/bin/ovmtprop get-prop -K name[,name,...] [-h] [-q] [-V]

/opt/ovmtutils/bin/ovmtprop set-prop prop-name=prop-value,...] [-h] [-q] [-V] domain-name

Description

ovmtprop(8)                  System Administration                 ovmtprop(8)



NAME
       ovmtprop - show Oracle VM for SPARC templates properties

SYNOPSIS
       /opt/ovmtutils/bin/ovmtprop get-prop -a [-h] [-q] [-V]

       /opt/ovmtutils/bin/ovmtprop get-prop -k name[,name,...] [-h] [-q] [-V]

       /opt/ovmtutils/bin/ovmtprop get-prop -K name[,name,...] [-h] [-q] [-V]

       /opt/ovmtutils/bin/ovmtprop set-prop prop-name=prop-value,...] [-h] [-q] [-V] domain-name

DESCRIPTION
       The  ovmtprop  command  enables  you  to view and set Oracle Solaris OS
       properties. The property and value is specified as a  name-value  pair.
       View property values by using the ovmtprop get-prop command, and create
       properties by using the ovmtprop set-prop and ovmtconfig -v commands.


       Do not perform ovmtprop get-prop and ovmtprop set-prop commands  simul-
       taneously.


       To  set  property values for domains, run the ovmtprop set-prop command
       as superuser on the control domain. It is best to use a fully qualified
       namespace  to specify a name-value pair to avoid clashes between appli-
       cation properties.


       To view properties and their values, run the ovmtprop get-prop  command
       on  the domain for which you want to retrieve property information. You
       do not need to be superuser to view property information.


       To view all properties, use the -k or -K  option  to  specify  property
       search criteria or use the -a option with no arguments. You can specify
       search criteria by domain to return  hierarchical  properties  such  as
       listing all properties for a single application.


       The ovmtprop command includes the following options:

       -a

           Shows  all  property names and values, each on a separate line. You
           cannot use this option with the -k option.


       -h

           Prints the usage statement.


       -k name[,name,...] [all]

           Specifies a comma-separated list of property names to  query.  Each
           property  name  and  property  value  is output on a separate line.
           Specifying the -k all option is the same as using the -a option.


       -K name

           Specifies a property name to query and outputs  only  the  property
           value.


       -q

           Shows  only  the  specified property and property values, each on a
           separate line. The order in which the properties are shown  matches
           the  order  in  which  the  properties are specified on the command
           line. The copyright banner and error strings are suppressed.


       -V

           Prints the version.


EXAMPLES
       Example 1 Setting the com.oracle.solaris.system.computer-name  Property
       on a Guest Domain



       This  example  shows how to set the com.oracle.solaris.system.computer-
       name property to solaris11 on the ldg0 domain.


         primary# /opt/ovmtutils/bin/ovmtprop set-prop com.oracle.solaris.system.computer-name=solaris11 ldg0


       Example 2 Viewing the com.oracle.solaris.system.computer-name  Property
       and Property Value



       This   example   shows   how   to  view  the  value  for  the  com.ora-
       cle.solaris.system.computer-name property. The output  shows  both  the
       property name and the property value.


         $ /opt/ovmtutils/bin/ovmtprop get-prop -k com.oracle.solaris.system.computer-name
         com.oracle.solaris.system.computer-name=s11


       Example 3 Viewing Multiple Hierarchical Properties



       This  example  shows  how to view the properties and their values under
       com.oracle.solaris property.


         $ /opt/ovmtutils/bin/ovmtprop get-prop -k com.oracle.solaris
         solaris.system.computer-name=s11
         solaris.network.ipaddr.0=192.168.0.1


       Example 4 Retrieving All Property Values



       This example shows how to retrieve the  property  values  for  all  the
       properties.  The  output  shows both the property name and the property
       value.


         $ /opt/ovmtutils/bin/ovmtprop get-prop -a
         com.oracle.solaris.system.computer-name=s11
         com.oracle.solaris.network.ipaddr.0=192.168.0.1
         ...


EXIT STATUS
       The following exit values are returned:

       0            Successful completion.


       1            An error occurred. Property value not set or property  not
                    found.


       2            A usage error occurred.


ATTRIBUTES
       See  the  attributes(7)  man  page  for  a description of the following
       attributes.


       +-----------------------------------------------------------+
       |Attribute Type                Attribute Value              |
       +-----------------------------------------------------------+
       |Availability                  pkg:/system/ldoms/ovmtutils  |
       +-----------------------------------------------------------+
       |Interface Stability           Uncommitted                  |
       +-----------------------------------------------------------+

SEE ALSO
         attributes(7),  ovmtadm(8),  ovmtconfig(8),  ovmtcreate(8),   ovmtde-
       ploy(8), ovmtlibrary(8)


       Oracle VM Server for SPARC 3.6 Developer's Guide



                                  August 2018                      ovmtprop(8)