REGUTIL

regutil − Utility for Managing the LDM Registry

regutil [-d dir] -c

regutil [-d dir] -R

regutil [-d dir] [-q] [path ...]

regutil [-d dir] [-q] -r path ...

regutil [-d dir] (-b bool|-h sig|-s string|-t time|-u uint) valpath

This program manages the LDM registry.

The first execution form creates the registry if it doesn’t already exist.

The second execution form resets the registry, performing as much recovery as possible without removing any data.

The third execution form prints to the standard output stream all pathname/value pairs in the registry that have one of the path arguments as a prefix. If no pathname arguments are specified, then all pathname/value pairs are printed.

The fourth execution form removes from the registry all pathname/value pairs that have one of the path arguments as a prefix.

The last execution form sets a pathname/value pair in the registry. One of the options -b, -h, -s, -t, or -u must be specified. valpath is the absolute pathname of the parameter to be set.

-b bool

The boolean value to which to set the parameter. One of TRUE, or FALSE.

-c

Create the registry if it doesn’t already exist.

-d dir

Pathname of the directory containing the LDM registry. The default is $LDMHOME/etc.

-h signature

The signature value to which to set the parameter. The signature shall be specified as a 32 character hexadecimal digit.

-q

Causes the utility to be "quiet" (i.e., to not write an error message to the standard error stream) if a value or node doesn’t exist.

-R

Resets the registry. Does as much recovery as possible.

-s string

The string value to which to set the parameter.

-t time

The time value to which to set the parameter. The time shall be specified as YYYYMMDDThhmmss[.uuuuuu], where [.uuuuuu] denotes an optional microsecond portion (without the brackets).

-u uint

The unsigned integer value to which to set the parameter.

0

Success.

1

Incorrect usage (i.e., command-line syntax error). A "usage" error-message should have been printed.

2

At least one of the referenced entries didn’t exist. All the other entries were correctly processed. Error messages identifying the missing entries should have been printed.

3

System error. An error message should have been printed.

If you have problems with this program, then you should first examine the LDM email archive for similar problems and how they were solved. The email archive is available via the following URL:

http://www.unidata.ucar.edu/software/ldm/

If this does not suffice, then send an inquiry via email -- together will all relevant information -- to

support-ldm@unidata.ucar.edu