Geners Tools
The "tools" subdirectory of the "geners" package includes several
programs which can be used to examine the contents of object archives
and catalogs. By default, these programs are compiled during the normal
package installation procedure but they are not installed in any other
location on your computer. If invoked without any arguments, each
program prints its usage instructions to the standard output.
cdump
— "Catalog dump". This program can be used to print catalog contents
to the standard output and to collect item type summaries.
gssa_dump
— "Catalog dump for .gssa or .gssaz files". This program can be used
to print catalogs of string archives saved in dedicated binary files. The convention
here is to use extension .gssa (Generic Serialization String Archive) for such
files without compression and .gssaz with compression.
cmerge
— "Catalog merge". This program can be used to merge contents of
multiple catalogs. The resulting catalog can be treated as a single
combined "geners" archive. Object data files included as members of the
new combined archive do not have to be modified.
gssa_merge
— "String archive merge". This program can be used to merge contents of
multiple .gssa or .gssaz files into a single archive.
crecover
— "Catalog recover". This program can be used to recover catalog data
from binary archive data files if a copy of the catalog was merged into
the data stream. This mode of archive operation is useful mainly in the
code development process, so that the catalog can be recovered in case
of an unexpected program crash.
print_items
— This program can be used to fetch items from an archive and to print
them to the standard output. It is expected that this particular
program will be extended by the users as they develop their own classes
(see comments at the beginning of file "print_items.cc"). In its
original form, the program can only print C++ strings and built-in
numeric types.
template_io_boilerplate
— This program generates a boilerplate header file for serializing
templates that can not be modified by the user (i.e., coming from an external library).