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):
and to examine named entries:% 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 . . .
% 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
SCB --- Source Code Browser