Managing Information in the Service Configuration Repository

There are many ways to view, modify, or delete information by using SMF. This section discusses which methods are best for which uses.

Viewing SMF Information

You can use the svccfg and svcprop commands to view information in the service configuration repository. For a complete description of these commands, see the svccfg(1M) and svcprop(1) man pages.

• svcprop – Lists the values assigned to property groups or properties in running snapshot. Because this command combines data for the service, and service instance, it provides a comprehensive or “composed” view of the data.

• svccfg listpg – Lists information about property groups in the selected service, service instance, or snapshot. All property group names, types, and flags are listed.

• svccfg listprop – Lists information about properties and property group in the selected service, service instance, or snapshot. For property groups, the names, types and flags are listed. For properties, the names, types and values are listed.

  • -l layer_name – Lists the properties and property groups within the named layer in a service or service instance. Using all as a layer name lists all of the layers and properties for that service. Note that each service and service instance is displayed separately.

  • -f – Lists the file name that a property came from.

  • -o – Selects the fields to display.

• svccfg listcust – Lists any site customizations in the site-profile or admin layer. Also listed are any masked entries for the selected service or service instance.

  • -M – Lists only masked entities.

  • -L – Shows all local customizations, which includes both administrative customizations and site profile customizations.

Modifying SMF Information

You can modify information about a service or service instance by using a manifest, or a profile, or by using the svccfg command. Any changes you make with the svccfg command are recorded in the admin layer. The following list includes some of the options that you can use to modify information by using the svccfg command:

• addpg – Adds a property group to the selected service or service instance

• addpropvalue – Assigns an additional value to a existing property

• setenv – Sets an environment variable for a service or service instance

• setprop – Sets the value of a named property in the selected service

• setnotify – Sets notification parameters for software events and FMA event classes

Deleting SMF Information

You can delete information about a service or service instance by using the svccfg command. The following list includes some of the options that you can use to remove information by using the svccfg command:

• delcust – Deletes any administrative customizations for the selected service

• delpropvalue – Deletes all property values that match the given string

• unsetenv – Removes an environment variable for a service or service instance

When you delete information from the repository one of two things happen, either the entity will be masked or the entity will be removed. Any information that has been defined only in the admin layer will be removed. Any information from a manifest or profile will be masked, so that the standard commands will not display the information. The information is masked so that if you need to undo the deletion, you readily will have the information available.