NAME | SYNOPSIS | DESCRIPTION | SUBCOMMANDS | OPTIONS | OPERANDS | EXAMPLES | BUGS | ENVIRONMENT VARIABLES | EXIT STATUS | ATTRIBUTES | SEE ALSO | NOTES
The prodreg utility browses, unregisters, and uninstalls components in the Solaris Product Registry.
Some installers make use of the libwsreg(3LIB) interface to register information. The Solaris Product Registry contains information about this installed software.
The database associated with the Solaris Product Registry is relative to the root of the installed file system. Normally, this is the root of the file system (/). Sometimes, an alternate root, with a different Solaris Product Registry install database is used, as during live upgrade installation. See live_upgrade(5).
The Registry database informs installers about installed software. The Registry and the prodreg utility do not directly perform installation or deinstallation. prodreg supports installers which are executed externally and launched by the prodreg utility or other means.
Depending on the subcommand, the prodreg command offers equivalent functions from the command line or a GUI viewer. Two versions of the GUI viewer are available. The default is the Java Swing GUI. The other version, the Java awt GUI is provided for environments without Java Swing support.
The only feature which exists in the CLI which is not present in the GUI is the unregister subcommand. It is possible for the product registry to become corrupted, if for example, some software is removed manually instead of by means of an uninstaller program. These entries can confuse installers which are run subsequently. The unregister subcommand allows stale entries to be removed, even forcefully. Care should be exercised when unregistering software with the recursive or force options so that valid entries in the registry are not removed by mistake.
The prodreg command, whether it launches the GUI or the command line interface browser, displays the contents of the registry at that time only. If software is installed or unisntalled subsequent to or concurrent with launching either prodreg viewer, the view can be inconsistent with the Solaris Product Registry.
You can specify options to the prodreg command without specifying a subcommand. If the subcommand is omitted, the swing subcommand is assumed.
The following subcommands are supported:
Launch the Java awt GUI.
The awt subcommand has the following format:
awt [-R alt_root | --help] |
Display the Solaris Product Registry using a command line interface. The text output of this command displays identifying information of any component in the product registry tree, including its ancestors and children. If you repeatedly invoke this subcommand, you can interactively browse the product registry.
The database components are related as a tree. Components may have one or more children. Except for the root, components have one parent. This subcommand displays the ancestors and children for a given component in the Solaris Product Registry database.
Each time the prodreg browse subcommand is executed, one component in the Registry is shown, along with its ancestry to the root of the Registry, as well as the component's children. To browse in the prodreg GUI, a user selects a node to expand and clicks on it. The analogous activity using the command line interface is to browse on children of nodes successively, which effectively expands a view into the registry.
Start by browsing the root of the Registry with prodreg browse. Select components to expand the scope of the browsing activity. Use browse numbers as a convenience during this interactive browsing, but not in scripts. Browse numbers can change from one session to the next or on different systems. This is because browse numbers are generated as they are first used, by a given user on a particular system.
The browse subcommand has the following format:
browse [-R alt_root] [-u uuid [-i instance | -p location]] browse [-R alt_root] -n bnum [-i instance | -p location] browse [-R alt_root] -m name browse --help |
This following information is output for each component:
This is the browse number associated with each component. This number can be used as an argument to either the prodreg browse or info subcommands as a convenience
The + indicates a component in the tree with children who are not shown. - indicates a component with children of which at least one child is being shown. The . indicates a component which has no children. This field is arranged so that each space (reading left to right) depicts a successive generation.
This is the component's unique identifier.
This is the instance number of the component. Software components can be installed multiple times. The software registry assigns a unique instance to each one.
Each component in the Solaris Product Registry database has a localized name which is displayed in this field. It is possible that this name may not be unique in the registry since there could be another component that has the same name.
The browse subcommand provides four distinct options for viewing the registry database. If multiple instances are associated with the same component, then the output of the subcommand is the ambiguous list. The request must be made unambiguous. The instance or location operands can be used to disambiguate the browse subcommand when used with the -u or -n options.
If no operand information is given, the root of the registry tree is displayed, as well as its children. This is the starting point for interactive browsing of the entire registry database.
If the browse number is given, the component associated is output.
If the uuid is given, the component associated with it is output.
If the name is given, the component associated with it is output.
Display attributes for any component in the Solaris Product Registry by supplying identifying information for the component.
Components in the product registry are associated with attributes. These attributes are composed of a name and a single value string.
This subcommand outputs attribute information associated with components in the Solaris Product Registry. Individual components in the product registry are specified as for the browse subcommand, except that either the uuid, name or bnum must be specified.
If a component requested is ambiguous as it has more than one instance or the name is assigned to more than one component in the registry, the list of possibilities is output, not the attribute information.
The default output of this subcommand is a complete list of each attributes, each on a new line. The attribute name is followed by a colon (:) and a SPACE. The attribute value follows, after which a RETURN is appended. Other options include can be specified using -a and -d.
The info subcommand has the following format:
info --help info [-R alt_root] -u uuid [-i instance | -p location] info [-R alt_root] -n bnum [-i instance | -p location] info [-R alt_root] -m name [-a attr | -d ] |
Display help text.
The help subcommand has the following format:
help | --help | -? |
Launch the Java Swing GUI. If the Java Swing GUI is not available, this subcommand fails.
The swing subcommand has the following format:
swing [-R alt_root | --help] |
Outputs a current version string.
The version subcommand has the following format:
version | --version | -V |
Unregister an entry in the registry.
Remove a component from the Solaris Product Registry. The component corresponding to the uuid specified with the -u option must be a single instance. If it is not, the subcommand fails and returns the list of instances with the associated uuid. The subcommand must be reissued using either -p or -i to uniquely determine which component instance to unregister.
The unregister subcommand fails if there are components in the registry which depend on the component which is to be unregistered.
The unregister subcommand fails if the user does not have write access to the registry. See wsreg_can_access_registry(3WSREG). The unregister subcommand fails if the user attempts to unregister a system component, instead of a component registered with the Solaris Product Registry. System components include those which include the attribute PKG and certain special Registry nodes including the following:
UUID Name ==================================== ============================= root System Registry a01ee8dd-1dd1-11b2-a3f2-0800209a5b6b Solaris System Software 8f64eabf-1dd2-11b2-a3f1-0800209a5b6b Unclassified Software b96ae9a9-1dd1-11b2-a3f2-0800209a5b6b System Software Localizations b1c43601-1dd1-11b2-a3f2-0800209a5b6b Additional System Software a8dcab4f-1dd1-11b2-a3f2-0800209a5b6b Software Localizations |
Before the unregister subcommand with the -f option is used, you should carefully review what components depend upon the component which is to be unregistered. The -r option is even more dangerous, since all children and software components depending upon the component are also deregistered. You can obtain the list of dependent compenents for a component with UUID uuid using :
prodreg info -u uuid -a "Dependent Components" |
prodreg info -u <uuid> -a "Required Components" |
The unregister subcommand has the following format:
unregister [-R alt_root] [-fr] -u uuid [-p location | -i instance] unregister --help |
Launch an uninstaller program.
Each component in the registry can have an uninstaller associated with it. This subcommand executes this associated installer, if there is one, for a component in the registry given by the -u option. If there is no uninstaller associated with the component, the subcommand fails. If the component given by the -u option is not unique (as there is more than one instance of the component installed), the subcommand outputs a list of all instances. The subcommand must then be reissued using -i or -p to disambiguate the uuid given with the -u option. Finally, if the component to uninstall is depended upon by other components, the command fails.
The command may also launch an uninstaller with a -x option. No checks for whether this uninstalls a component upon which other components depend in this case.
The uninstall command is not executed if the user does not have write access to the registry. See wsreg_can_access_registry(3WSREG).
The uninstall command has the following format:
uninstall [-R alt_root] [-f] -u uuid -p location uninstall [-R alt_root] -i instance[arguments ...] uninstall --help |
The awt subcommand supports the following options:
Display help text, do not launch the viewer.
Use the specified alternate root to locate the database todisplay with the GUI viewer.
See OPERANDS for information regarding specification of alt_root.
The browse subcommand supports the following options:
Display help text, do not execute the browse subcommand.
Output the specified component instance.
Output the component instances associated with the name.
Output the component instances associated with the browse number.
Output the component instance installed in the specified location. The install location for a component can be obtained using the 'info' subcommand.
Use the specified alternate root to locate the database.
Output the component instances associated with the uuid.
The info subcommand supports the following options:
Output only the attribute whose name is given by the operand 'attr', instead of all attributes of the specified component.
Output only the attribute whose name is isDamaged, instead of all attributes of the specified component. If the value is set to true, this attribute indicates that the component in the registry
Output help text, do not execute the browse subcommand.
The instance operand distinguishes among multiple instances of components with the same uuid or browse number.
The name operand indicates one or more components in the registry.
Output the attributes of the component instance associated with the browse number bnum. If there is more than one instance, the command must be disambiguated using the -i or -p options.
The install location indicated distinguishes amonng multiple instances of components with the same uuid or browse number.
Use the specified alternate root to locate the database.
Output the attributes of the component instance associated with the uuid. If there is more than one instance, the subcommand must be disambiguated using the -i or -p options.
The swing subcommand supports the following options:
Output help text, do not execute the install subcommand.
Use the specified alternate root to locate the database.
The uninstall subcommand supports the following options:
Force the uninstall. A forced subcommand uninstalls all instances of a component, even if there are multiple ambiguous instances of the uuid operand.
Output help text, do not execute the unregister subcommand.
Disambiguate the uuid operand.
Disambiguate the uuid operand. location corresponds to the where the software component was installed.
Use the specified alternate root to locate the database.
Unregister the uuidcomponent. If this component has been installed multiple times, the instance to unregister must be indicated unambiguously by using the -i or -p option.
The unregister subcommand supports the following options:
Force the unregistration. A forced subcommand unregisters a component even if there are other components which are dependent on this component.
Output help text, do not execute the unregister subcommand.
Disambiguate the uuid operand.
Disambiguate the uuid operand. The location corresponds to the where the software component was installed.
Causes a recursive deregistration of a component as well as that component's children and dependencies.
Use the specified alternate root to locate the database.
Unregister component uuid of the component to unregister. If this component has been installed multiple times, the instance to unregister must be indicated unambiguously by using the -i or -p option.
The following operands are supported:
Pathname to a file indicating an alternate root. The Solaris Product Registry database is located relative to the alternate root. If database relative to this location does not exist, it is created.
Name of an attribute. This operand is used only with the info subcommand. If attr is associated with a component, the attribute name and value is displayed.
The browse number.
Each component in the Solaris Product Registry is associated with a browse number. This number is generated for the convenience of an interactive user. The browse number can change if the system is rebooted or reinstalled. Do not store or use the browse number except to facilitate the browse and info subcommands. Browse numbers are always output by the prodreg browse subcommand. Only these values can be used as input values to the browse or info subcommand.
Software can be installed in more than one location. The Solaris Product Registry associates a unique instance number for each. The browse subcommand shows the instance number associated with each component in the registry. The instance operand is used to distinguish between installed, and possibly different, copies of software, when such exist.
A path to a specific file or directory in the file system. This operand indicates the installed location of registered software. For instance, if software is installed relative to /usr/local the value of this operand would be /usr/local. The install location is used to installer or to indicate the location of an installer or to diambiguate which instance is intended, of a software component which can have multiple instances.
Each software component in the Solaris Product Registry is associated with a name. This name is output by the browse subcommand. Some subcommands allow the user to input the software by name as an operand as a convenience. These names might not be unique. If the user supplies an ambiguous name, for which more than one components exist, the subcommand outputs a list of possible choices. The name can be localized; depending on the language setting the name can differ.
Each software component in the Solaris Product Registry is associated with a unique identifier. This identifier is a handle which accesses an entry in the registry database. The uuid corresponds to the componnet irrespective of how many instances of the component have been installed, and what the localized name of the component is.
Browsing is performed by means of the prodreg browse subcommand. Using these requests iteratively, one can peruse the tree, much as one would using a GUI by expanding components which are collections of other components. Browsing using browse numbers for convenience should be done only during this iterative browsing process, since the numbers are generated as a result of the browsing operation.
Evoking the browse subcommand without any arguments browses from the top of the registry. The output varies depending on the software installed on a particular system.
$ prodreg browse BROWSE # +/-/. UUID # NAME ======== ===== ==================================== = ============ 1 - root 1 System Registry 2 + a01ee8dd-1dd1-11b2-a3f2-0800209a5b6b 1 Solaris 9 System Software 3 + 8f64eabf-1dd2-11b2-a3f1-0800209a5b6b 1 Unclassified Software |
The output of this command lists the browse number, UUID, instance number and name of the root component and its children. The ancestors of a component, each parent up to the root, are also shown. The +/-/. column indicates whether the component in the tree is an expanded parent (-), a child with children (+) or a child without children (.).
The UUID, name and browse number fields can be used to request browsing information about components in the tree. The next example shows how a component can be browsed by UUID.
$ prodreg browse -u a01ee8dd-1dd1-11b2-a3f2-0800209a5b6b BROWSE # +/-/. UUID # NAME ======== ===== ==================================== = =========== 1 - root 1 System Registry 2 - a01ee8dd-1dd1-11b2-a3f2-0800209a5b6b 1 Solaris 9 System Software 4 + b96ae9a9-1dd1-11b2-a3f2-0800209a5b6b 1 System Software Localizations 5 + SUNWCall 1 Entire Distribution |
The following example shows how a node can be browsed by name.
$ prodreg browse -m "System Software Localizations" BROWSE # +/-/. UUID # NAME ======== ===== ==================================== = =========== 1 - root 1 System Registry 2 - a01ee8dd-1dd1-11b2-a3f2-0800209a5b6b 1 Solaris 9 System Software 4 - b96ae9a9-1dd1-11b2-a3f2-0800209a5b6b 1 System Software Localizations 316 . SUNWceuow 1 Central Europe OW Support 317 . SUNWcsfw 1 Simplified Chinese freeware message 318 . SUNWceuox 1 Central Europe 64-bit OS Support |
Additional output has been omitted. As a convenience, the browse number can be used for iterative browsing. This number should not be stored, as it differs depending on which system the prodreg command is run on, which user is running the command, and the log in session in which the command is run.
$ prodreg browse -n 3 BROWSE # +/-/. UUID # NAME ======== ===== ==================================== = =========== 1 - root 1 System Registry 2 - a01ee8dd-1dd1-11b2-a3f2-0800209a5b6b 1 Solaris 9 System Software 5 - SUNWCall 1 Entire Software Distribution 6 . SUNWrsmo 1 RSMPI Operations Registration Module 7 + SUNWCjvx 1 JavaVM (64-bit) 8 . SUNWrsmx 1 Remote Shared Memory (64-bit) 9 + SUNWCacc 1 System Accounting |
If the requested value is ambiguous, the list of ambiguous instances are displayed. In the following example, there are two distinct software components with the same name.
$ ./prodreg browse -m JavaVM The request failed because multiple components correspond to the criteria given. Use the list of possible components given below, select one and try again. BROWSE # +/-/. UUID # NAME ======== ===== ==================================== = =========== 12 . org.spybeam.javavm 1 JavaVM 51 . SUNWCjv 1 JavaVM |
Issue one of the following requests again:
$ prodreg browse -u SUNWCjv |
or
$ prodreg browse -u org.spybeam.javavm |
Another possible ambiguous response arises when a particular software component is installed multiple times. In the example below Example software is registered three times.
$ prodreg browse -m Example The request failed because multiple components correspond to the criteria given. Use the list of possible components given below, select one and try again. BROWSE # +/-/. UUID # NAME ======== ===== ==================================== = =========== 7 . org.spybeam.example 2 Example 7 . org.spybeam.example 3 Example 7 . org.spybeam.example 1 Example The component requested could not be found. |
The request can be repeated specifying a particular instance to disambiguate it. It is also possible to disambiguate a request with the -p option, followed by the install location. In this case, to browse the first instance of the Example software, one would use the command:
$ prodreg browse -u org.spybeam.example -i 1 |
The install location, as well as other attributes of a component can be obtained with the info subcommand. The info subcommand accepts the same disambiguating options and returns all the attributes of a component, each on a single line.
$ prodreg info -m Example The request failed because multiple components correspond to the criteria given. Use the list of possible components given below, select one and try again. BROWSE # +/-/. UUID # NAME ======== ===== ==================================== = =========== 7 . org.spybeam.example 2 Example 7 . org.spybeam.example 3 Example 7 . org.spybeam.example 1 Example The component requested could not be found. |
This variation of the info subcommand outputs all information associated with instance 1 of the Example component. The output from this variation is not displayed
$ prodreg info -u org.spybeam.example -i 1 |
You can use the info subcommand to obtain the install location and other attributes of a component. The info subcommand accepts the same disambiguating options as the browse subcommand. It returns all the attributes of a component, each on a single line. You can also request a single attribute.
The following command outputs the value of the install location attribute:
$ prodreg info -n 23 -a Location |
Removing installed software without using the associated uninstaller can damage the software in the registry. A damaged component indicates that certain software is installed, when in fact it is not present. A component can be damaged by removing files or packages directly, without running the associated uninstaller. The general rule to follow is: If software has been installed by an installer program, it should be uninstalled using the supplied uninstaller program.
This example shows how to identify and repair damaged software components so that software can be reinstalled.
Browsing for Examplesoft, produces the following:
$ prodreg browse -m Examplesoft BROWSE # +/-/. UUID # NAME ======== ===== ==================================== = ============ 1 - root 1 System Registry 2 + a01ee8dd-1dd1-11b2-a3f2-0800209a5b6b 1 Solaris 9 System Software 3 + 8f64eabf-1dd2-11b2-a3f1-0800209a5b6b 1 Unclassified Software 4 - 95842091-725a-8501-ef29-0472985982be 1 ExampleSoft 233 . 90209809-9785-b89e-c821-0472985982be 1 Example Doc 234 . EXSOzzt 1 235 . EXSOblob 1 Example Data |
The Examplesoft child EXSOzzt, representing a package component of registered software does not display its name. This is likely to be because the software Examplesoft is damaged. Verify this with the following command:
$ prodreg info -u 95842091-725a-8501-ef29-0472985982be \ -i 1 -d isDamaged=TRUE |
$ prodreg info \ -u 95842091-725a-8501-ef29-0472985982be\ -i 1 -a PKGS pkgs: EXSOzzt EXSOblob |
$ pkginfo EXSOzzt ERROR: information for "EXSOzzt" was not found $ pkginfo EXSOblob application EXSOblob Example Data |
# prodreg uninstall -u 95842091-725a-8501-ef29-0472985982be -i 1 The install program requested could not be found. |
Something is wrong, or else you would be able to access uninstall program to uninstall the software.. One possibility is that the uninstaller program has been removed manually. It is possible to determine where the uninstaller is located by requesting the uninstallprogram attribute:
$ prodreg info -m ExampleSoft -a uninstallprogram uninstallprogram: /usr/bin/java -mx64m -classpath /var/sadm/prod/org.example.ExampleSoft/987573587 uninstall_ExampleSoft |
Check to see if there is an uninstaller in the registered location.
# ls /var/sadm/prod/org.example.ExampleSoft/987573587 /var/sadm/prod/org.example.ExampleSoft/987573587: No such file or directory |
# /usr/bin/java -mmx64m -classpath \ /var/sadm/prod/org.example.ExampleSoft/987573587 \ uninstall_ExampleSoft |
# prodreg unregister -u 95842091-725a-8501-ef29-0472985982be -i 1 |
# pkgrm EXSOblob |
Component A has children B and C, and C has children D and E, and the you wish to remove all of the components at once. This is useful if the whole hierarchy has to be reinstalled and the uninstaller has been lost or cannot be run
$ prodreg browse -u UUID-of-C BROWSE # +/-/. UUID # NAME ======== ===== ==================================== = ============ 1 - root 1 System Registry 2 + a01ee8dd-1dd1-11b2-a3f2-0800209a5b6b 1 Solaris 9 System Software 3 + 8f64eabf-1dd2-11b2-a3f1-0800209a5b6b 1 Unclassified Software 1423 - UUID-of-A 1 Example A 1436 . UUID-of-B 1 Example B 1437 - UUID-of-C 1 Example C 1462 . UUID-of-D 1 Example D 1463 . UUID-of-E 1 Example E # prodreg uninstall -u UUID-of-A -i 1 |
The uninstall subcommand can fail various ways, for example if the java classes have been removed, if the user has insufficient permissions or if Java software is not present on the system. The recursive unregistration subcommand is very powerful and dangerous. Not only does it unregister every child of a component, it also unregisters every component which depends upon the component to unregister. It is a good idea to view all information about the component to determine if any components will be unintentionally unregistered with UUID-of-A.
$ prodreg info -u UUID-of-A Title: Example A Software Version: 5.8.0.2001.11.02 Location: /usr Vendor: Example Vendor uninstallprogram: /usr/bin/java -mx64m -classpath /var/sadm/prod/org.example.ExampleA/90820965 uninstall_ExampleA vendorurl: http://www.example.org description: Example A Software has many uses Supported Languages: en Child Components: Name UUID # -------------------------- ------------------------------------ - Example B UUID-of-B 1 Example C UUID-of-C 1 Required Components: Name UUID # -------------------------- ------------------------------------ - Example B UUID-of-B 1 Example C UUID-of-C 1 |
No software depends on Example A, or else an additional field, Dependent Components would be shown. To further ensure that there are no suprises, one should examine the dependent components and children of UUID-of-B and UUID-of-C, all the components which depend on UUID-of-B, UUID-of-C and their children, and so on.
If you examine the browse tree, you know the entire list of descendents of UUID-of-A. You can also examine the dependent component attributes of all of Example A's descendents.
$ prodreg info -u UUID-of-B -i 1 -a "Dependent Components" Dependent Components: Name UUID # --------------------------- ------------------------------------ - Example A UUID-of-A 1 $ prodreg info -u UUID-of-C -i 1 -a "Dependent Components" Dependent Components: Name UUID # --------------------------- ------------------------------------ - Example A UUID-of-A 1 $ prodreg info -u UUID-of-D -i 1 -a "Dependent Components" Dependent Components: Name UUID # --------------------------- ------------------------------------ - Example C UUID-of-C 1 $ prodreg info -u UUID-of-E -i 1 -a "Dependent Components" Dependent Components: Name UUID # --------------------------- ------------------------------------ - Example C UUID-of-C 1 |
A recursive unregistration of Example A only results in unregistering Example A and its decendents, as intended.
# prodreg unregister -r -u UUID-of-A -i 1 |
In this example, there is a component, Software ZZZ which is depended upon by other software. Software ZZZ has been damaged and you need to reinstall it. The reinstallation is impossible until Software ZZZ is unregistered.
First, you check what depends upon Software ZZZ:
$ prodreg info -m "Software ZZZ" -a "Dependent Components" Dependent Components: Name UUID # --------------------------- ------------------------------------ - Software Foobar d9723500-9823-1432-810c-0100e09832ff 1 |
Normally, you would have to uninstall Software Foobar before unregistering Software ZZZ, since Software Foobar depends on Software ZZZ. You decide that it is impossible or unreasonable to reinstall Software Foobar. Performing a recursive unregister of Software ZZZ is not an option as it would unregister Software Foobar as well. Instead you can do a forced unregister of Software ZZZ. The UUID of Software ZZZ is 90843fb1-9874-3a20-9b88-984b32098432.
# prodreg unregister -f -u 90843fb1-9874-3a20-9b88-984b32098432 -i 1 |
You can then reinstall Software ZZZ:
# /usr/bin/java -cp /usr/installers/org.example.softwarezzz |
The registry can become out of date because of software being manually removed, or removed using pkgrm(1M) directly. To avoid damaging the registry, use uninstall programs to remove software which was initially installed using an install program.
The following environment variable affects the execution of prodreg:
PKG_INSTALL_ROOT
If present, defines the full path name of a directory to use as the system's PKG_INSTALL_ROOT
path. All product and package information files are then looked
for in the directory tree, starting with the specified PKG_INSTALL_ROOT
path. If not present, the default system path of / is used.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE |
ATTRIBUTE VALUE |
---|---|
Availability |
SUNWwsr2, SUNWwsrv |
Interface Stability |
Evolving |
pkgadd(1M), pkgrm(1M), wsreg_can_access_registry(3WSREG), libwsreg(3LIB), live_upgrade(5), attributes(5)
Application Packaging Developer's Guide
The prodreg GUI and command line interface view both the Solaris Product Registry and the package database. Both look like components in the registry, but some of these cannot be unregistered or uninstalled. Packages do not have an associated uninstaller, so they cannot be uninstalled using the prodreg uninstall subcommand. Solaris packages cannot be unregistered using the prodreg unregister subcommand. Packages are removed using the pkgrm(1M) command, after which time the packages do not appear in the GUI or CLI prodreg viewer.
It is preferable to remove software using the uninstaller associated with the software installed than to remove individual packages using pkgrm(1M), since the uninstaller software takes care of comprehensive removal of all resources associated with the installed software, including unregistering information in Registry and removing the appropriate packages.
The prodreg uninstall subcommand launches an external program. The command line conventions of these programs have to be used to indicate the alternate root for the product registry. Another possibility is to use the PKG_INSTALL_ROOT
environment variable for this purpose as the install program is executed in the same environmen as prodreg. Uninstall programs are frequently java classes which require Java to be installed. If Java software has been removed or is missing from a Solaris distribution, it is impossible to
run java based uninstallers.
Only the prodreg unregister and uninstall subcommands can only be run with root permissions. This is because they modify the product registry in the case of unregister, and remove packages in the case of uninstall. The other operations merely read the registry and can be run with any user permissions. The prodreg uninstall subcommand might require root permissions as well, as installers can execute commands such as pkgadd(1M) or pkgrm(1M) which require root permissions to run.
Attributes associated with components are documented in various places -primarily in the Application Packaging Developer's Guide. The attributes associated with the Solaris Product Registry itself are described in the following glossary.
List of components upon which the component depends.
The location relative to which software was installed.
List of packages which correspond to the component. These packages are added with pkgadd after the component is registered. They are removed with pkgrm before the component is unregistered.
List of components on which the component depends.
Media from which the install was done.
List of locales for which there are registered titles.
Name given by the prodreg browse subcommand. This name can be localized to the locale in which the shell is running.
Name used by previous versions of the Solaris Product Registry. This value is often set to the package name corresponding to a given component in the registry.
Vendor who produced the component.
Version string associated with the component.
The Registry can contain components which do not correspond to software actually installed on the system. This can be detected several ways. The easiest is to check using the info subcommand if a component is damaged. Another way is to determine where software was installed using the info subcommand, and verify it is still there.
NAME | SYNOPSIS | DESCRIPTION | SUBCOMMANDS | OPTIONS | OPERANDS | EXAMPLES | BUGS | ENVIRONMENT VARIABLES | EXIT STATUS | ATTRIBUTES | SEE ALSO | NOTES