Service Registry 3.1 Administration Guide

rm

Removes objects from a RegistryPackage.

Synopsis

rm [-d] [-r] {pattern | URN}…

Description

The rm command removes the member objects of the current RegistryPackage whose names (in the current locale) match the patterns specified by a pattern or URN.

When a matching RegistryObject is a member of multiple RegistryPackage objects, this command removes only the association between the current RegistryPackage and the object. The object is removed from the Registry only when the removal of the association leaves the object with no association with any other RegistryObject, including other containing RegistryPackage objects.

When a matching member object is itself a RegistryPackage that contains other objects, neither the object nor the association between the current RegistryPackage and the member RegistryPackage is removed unless either the -r or the -d option is specified.

When both the -d and -r options are specified, the -d option is applied recursively, so all objects that would be selected by -r (and their associations) are removed whether or not they have other associations.

Options

-d

Removes the association between the current RegistryPackage and the specified RegistryPackage. Removes the specified RegistryPackage only if its only remaining associations are to its member objects. Member objects of the now-removed RegistryPackage that are not anchored by being the target of other HasMember associations are now accessible as members of the root of the Registry.

-r

Removes the specified RegistryPackage object and all its descendant objects (except when an object has other associations).

Operands

pattern

A pattern comprising literal characters and the special characters asterisk (*) (representing zero or more characters) and question mark (?) (representing one and only one character). You can specify more than one pattern.

URN

A URN starting with urn:, for example, urn:uuid:4a6741e7-4be1-4cfb-960a-e5520356c4fd. You can specify more than one URN.

Examples

The following command removes all RegistryPackage objects that contain the string "stat" and all their descendants.


admin> rm -r *stat*