mark-registry(2)

NAME

mark-registry - Modify the operating mode of a registry node

SYNOPSIS

n mark-registry "root" "mode"

DESCRIPTION

mark-registry modifies the mode of a registry node root. If an argument n is supplied then the nth register node down from root (as viewed from list-registry(2) output) is modified instead. The mode is string specifying the modes, each mode is represented by a character. Lower case characters add a mode, upper case characters delete a mode. The modes are defined as:-

? - Query Name


Returns the full name, including path, of the given registry node in the variable $result(5). This does not alter the registry.

a - Autosave


Automatically saves the registry when it is deleted or unloaded from the registry. The user is not prompted for a save.

b - Backup


Automatically performs a backup of the registry file whenever a save operation is performed.

c - Create


If the registry file cannot be loaded then the root node is created and the invocation succeeds. If this mode is omitted then the call fails if the file cannot be found.

d - Discard


Marks the registry as discardable. This is typically used for registries that are not saved.

f - File


The registry node is marked as a file root, the value must be set to the registry file name.

h - Hidden


The registry node is created in the Hidden state. (i.e. children will not be shown in list-registry(2) output).

u - Updated


Marks the registry as modified. The modified bit is removed when the registry file is saved. If the modified bit is applied to a registry node the user will be prompted to save the registry when it is deleted (or it will be automatically saved when the Autosave mode is used).

Multiple modes may be applied.

EXAMPLE

A history registry can be hidden with the following invocation:-

mark-registry "/history" "h" 

It could then be made visible again using:-

mark-registry "/history" "H" 

BUGS

At exit only registry nodes attached to the root are saved.

DIAGNOSTICS

mark-registry fails if root does not exist.

SEE ALSO

get-registry(2), list-registry(2), read-registry(2), set-registry(2), erf(8).

(c) Copyright JASSPA 1999
Last Modified: 1999/03/18
Generated On: 1999/12/01