NAME

gx-db-dump - Dump information from the TGCDB to stdout

SYNOPSIS

gx-db-dump -help

gx-db-dump [options]

DESCRIPTION

gx-db-dump is part of the gx-map system and of the optional TGCDB (TeraGrid Central Database) subsystem. This subsystem specific to the TeraGrid; it may or may not be installed on your system.

gx-db-dump is intended only for testing and debugging purposes. It should not be run in normal production use. Some invocations may place a significant burden on the database server. I wrote this tool for my own testing as I was developing the TGCDB subsystem; there's probably no need to use it at all.

The gx-db-dump command must be executed by the account that owns the gx-map installation; this is typically the ``gxmap'' or ``globus'' account, but a different account can be configured when the gx-map system is installed.

It is not described here in great detail. If you have any questions, please contact the author.

OPTIONS

Option processing is done using the Perl Getopt::Long module.

Options may be specified with a single or double leading '-' character. Option names may be abbreviated to whatever is unique. Arguments may be separated either by a blank or by an '=' character. For example, ``-foobar 42'', ``--foobar=42'', and ``-foob 42'' would all be equivalent.

-help
Display a usage message and exit.

-version
Display the software version number and exit.

-db-config FILE
Specify a db-config file other than the default etc/gx-map/tgcdb.db-config. This allows queries to a different database, or with different parameters, than the default.

-raw
By default, DNs are normalized (USERID --> UID, etc.), and DNs that are the same after this normalization are displayed only once. With the -raw option, this is not done.

-all
By default, the displayed information is filtered by resource name. The -all option causes all information for all resources to be displayed.

-users
Display only the ``users'' view. Some other options will be ignored.

-people
Display information from the ``people'' table. Some other options will be ignored.

-debugging
Enable debugging output. This is intended for developer testing only.

SEE ALSO

gx-map(7), gx-db-request(8), gx-db-check-requests(8), gx-propagate(8), gx-map-db-config(5)

AUTHOR

Keith Thompson, San Diego Supercomputer Center, <kst@sdsc.edu>

COPYRIGHT AND LICENSE

See the file LICENSE in the gx-map distribution, installed in the etc/gx-map subdirectory.