next up previous 62
Next: scbcp.pl
Up: Additional utilities
Previous: Additional utilities


dbmcat

The dbmcat utility directly examines the DBM files in which the File and Routine indexes are kept (see section 5.1.

Source documentation is as follows:

#  Name:
#     dbmcat.pl

#  Purpose:
#     Examine StarIndex files.

#  Language:
#     Perl 5

#  Invocation:
#     dbmcat.pl filename
#     dbmcat.pl filename key ...

#  Description:
#     This utility is for examining the DBM files representing StarIndex
#     objects used to store the indexes used by the SCB package for
#     indexing files and routines.
#
#     It is not required for any part of the package operation, but is
#     provided for manual examination of these files.  It will mainly
#     be useful for debugging, but may also be useful (in combination
#     with, for instance, grep(1)) for making more flexible queries
#     of the index files than are permitted by the 'type=regex'
#     argument of the scb.pl extractor program.
#
#     It can be used in two modes: if the name of the index only is
#     specified, then every record in the index is printed (in an
#     unpredictable order); the format is
#
#        key    => value value value ...
#
#     where the values are file locations using the logical pathnames
#     as used in the rest of the SCB package.  There may be one or more
#     values, and they are separated by spaces.

#  Arguments:
#     filename
#        Name of the index file.  This is the name of the index as
#        submitted to the StarIndex::new() routine, i.e. without
#        whatever file extensions (.db, .dir, ...) may appear when
#        the file is actually written.  The full path must be given.
#     key
#        One or more keys of the index may be specified.  They must be
#        exact.
Thus to examine the whole index (note that records are printed in no particular order):
% dbmcat.pl $SCB_INDEX/file
ary1_gt1d.f          => ary#ary_source.tar>ary1_gt1d.f
test_abbrv.f         => chr#chr_source.tar>test_abbrv.f
ech_read_type.f      => echomop#echomop_source.tar>ech_read_type.f
optextract.hlp       => figaro#figaro_iraf.tar>doc/optextract.hlp
    . . .
and to examine named entries:
% dbmcat.pl /star/etc/scb/func add_ rec_unlock
add_                 => img#img_source.tar>add.f kappa#kappa_sub.tar>add.f
rec_unlock           => hds#hds_source.tar>rec_unlock.c



next up previous 62
Next: scbcp.pl
Up: Additional utilities
Previous: Additional utilities

SCB --- Source Code Browser
Starlink User Note 225
M. B. Taylor
10 December 1999
E-mail:ussc@star.rl.ac.uk