Maintenance Commands                                 regcheck(1m)

NAME
     regcheck - enumerates all of the keys in the Registry, dumps
     the  contents of the Registry, checks and repairs the Regis-
     try.

SYNOPSIS
     regcheck -E | -D | -C | -R [ -L ] [ -I instance ]

DESCRIPTION
     The regcheck command is used to enumerate all of the keys in
     the  Registry. It also can be used to dump the entire Regis-
     try for diagnostic purposes. If the internal format  of  the
     Registry becomes corrupt, it can be repaired.

OPTIONS
  -C
     Checks the Registry file.

  -D
     Dumps the entire Registry in detail.

  -E
     Enumerates the full paths of all Registry keys.

  -R
     Checks and repairs the Registry file.

  -L
     Locks the Registry while performing a specified action.

  -I instance
     Specifies the PCNL instance name  or  number.  In  a  multi-
     instance environment instance may be specified either on the
     command line or by the environment  variable  PCNL_INSTANCE.
     If  there  is only one instance configured, it is not neces-
     sary to specify this argument.

NOTES
     This command must be run as root.

     The check (-C) and repair (-R) options only check and repair
     the  internal  format  of the Registry.  No checking is per-
     formed on the validity of any of  the  data  stored  in  the
     Registry.

     The dump (-D) option outputs an exceptionally  large  amount
     of  data, including information about the internal format of
     the Registry. This output is intended for diagnostic  opera-
     tions performed by product support personnel who have access
     to source code for the Registry. It is not intended for  use
     by system administrators.
     By default, the check (-C), dump (-D),  and  enumerate  (-E)
     options  do  not lock the Registry. The advantage of this is
     that these commands can be executed without blocking PC Net-
     Link  if  it is running. The disadvantage of this is that if
     PC NetLink modifies the Registry while a command with one of
     these  options is being executed, the Registry may appear to
     be inconsistent. If the locking (-L)  option  is  specified,
     commands containing the check, repair, and enumerate options
     are guaranteed to see a consistent snapshot of the Registry.
     However,  PC NetLink will not be able to access the Registry
     while a command with the locking option is being executed.

     The repair (-R) option performs locking by default and  thus
     is unaffected by the locking (-L) option.