ttdbck - display, check, or repair ToolTalk databases
ttdbck [ selection opts ] [ diagnosis opts ] [ display opts ] [ repair opts ] [ data-base-directory ]...
ttdbck(8) ToolTalk Commands ttdbck(8)
NAME
ttdbck - display, check, or repair ToolTalk databases
SYNOPSIS
ttdbck [ selection opts ] [ diagnosis opts ] [ display opts ] [
repair opts ]
[ data-base-directory ]...
DESCRIPTION
ttdbck is the ToolTalk database maintenance tool. It allows direct
inspection of ToolTalk spec data, detection of inconsistencies, and
repair of problems.
OPTIONS
data-base-directory
Names the directory or directories containing the ToolTalk data-
base to be inspected or repaired. If no directories are named,
the current directory is assumed. If a directory path does not
end in ``TT_DB'', ``TT_DB'' is appended.
The user running the command must have read access to the files
in the directory to inspect the data and write access to repair
the data. Since ToolTalk databases are typically accessible
only to root, this command is normally run as root.
Selection options
The selection options determine which specs in the database are dis-
played or modified. If no selection options are given, all specs in
the database are displayed. To prevent massive accidental changes to
ToolTalk databases, no repair options except -I are allowed unless a
selection or diagnosis option is given.
-f filename
Restricts the set of specs to be inspected or modified to those
which describe objects in the named file. The file name can con-
tain shell-style wildcards which must be escaped to prevent the
shell from expanding them.
-k objidkey
An object id key, specifying a particular spec to be displayed
or modified. The object id key can be obtained from a previous
invocation of ttdbck; one might display a set of specs, deter-
mine the one that needs repair, and specify its key here.
-t type
Restricts the set of specs to be inspected or modified to those
with otype type. The type name can contain shell-style wild-
cards which must be escaped to prevent the shell from expanding
them.
Diagnosis options
These options check for and report on inconsistencies in the selected
specs. Only specs selected by the selection options are checked. If a
diagnosis option is given, any display or repair option is applied only
to specs which fail the diagnostic check.
-b Check for badly formed specs: those which have no file or type
or those which have types not defined in the type database.
-x Check for specs which refer to files that no longer exist.
Display options
These options determine which data is printed for each selected spec.
-i Display the object id (including the object id key.)
-m Display the mandatory data that must appear in every spec: the
otype of the object described by the spec and the file in which
the spec is stored.
-p Display all the properties and values for each selected spec.
-a Display all data (equivalent to specifying -imp)
Repair options
-I Invoke the NetISAM isrepair() function for all files accessed.
This action is applied before any other inspection or repair
action. This option should be used when normal operations
return EBADFILE (error code 105).
-F filename
Change the file name for the selected specs to the supplied file
name.
-T otypeid
Change the type of the selected specs to the given otype.
-Z Remove the selected specs entirely.
EXAMPLES
ttdbck -bxi /home
In the /home/TT_DB directory, finds all badly formed specs and specs
that refer to non-existent files and prints their ids.
ttdbck -f /home/sample/data -F /home/sample/data1 /home
In the /home/TT_DB directory, finds all specs that refer to objects in
file /home/sample/data and changes them to refer to /home/sample/data1.
ttdbck -t Sample_Otype_Name -Z /export/TT_DB
In the /export/TT_DB directory, finds all specs that refer to objects
of type Sample_Otype_Name and deletes the specs.
FILES
/path/TT_DB ToolTalk database
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+------------------+
|Availability | library/tooltalk |
+---------------+------------------+
|Stability | Committed |
+---------------+------------------+
NOTES
The ttdbck command should be run on the same machine where the TT_DB
files being inspected and repaired physically exist. That is, don't
try to access the TT_DB files via NFS.
ToolTalk 1.3 1 March 1996 ttdbck(8)