hcidbdump

This command accesses the same functions as the Database Administrator GUI. This supports a regex search on message content and dump error context.

Note:  Do not terminate hcidbdump! Termination before it is finished corrupts the database.

You can use one of these formats:

hcidbdump [-U userid] [-v] -B [tarfile] 
hcidbdump {-r|-e} [-U userid] [-l] [-L [-x]] [-v] [-D] [-i] [-f source_system] 
[-o owner_system] [-d dest_system][-t type] [-s state] 
[-S time] [-E time] [-M map] [-O time] [-a] [-b [eof]] 
[-F] [-n metadata_filename] [-m mid] [-c ] [-C] [-R] [-w searchExp] 
[output_file] 
  • -B performs database backup.
  • tarfile specifies the file name where the database backup is written. If no tarfile is specified, then tar is written to $DBFPATH/cldb.tar.
  • -r saves message from recovery database.
  • -e saves message from error database.
  • -Uuserid specifies the user ID to access database.
  • -l specifies long form output. This is ignored when output_file is specified.
  • -L specifies ultra-long form output. Overrides -l.
  • -x gives an expanded view of flags. This is ignored unless using -L.
  • -v specifies verbose operation.
  • -D deletes messages after processing.
  • -i shows the entire process and thread name without truncation.
  • -f source_system selects messages with a specified source.
  • -o owner_system selects messages with a specified owner.
  • -d dest_system selects messages with a specified destination.
  • -t type selects messages with a specified type:
    • D specifies data.
    • R specifies reply.
    • U specifies unknown.
  • -s state selects messages with a specified state.
  • -S time selects messages at or after a specified date/time.
  • -E time selects messages at or before a specified date/time.
  • -M map applies the map to each message. Uses the msgmapdata command.
  • -O time orders output by ascending date. Time flags are:
    • ispecifies inbound arrival time.
    • o specifies outbound time.
    • rspecifies recovery time.
    • x specifies xlate start time.
  • -a appends data to output file.
  • -b [eof] dumps message to output file in length-encoded or end-of-file format.
    • -b dumps in length-encoded format.
    • -b [eof] dumps in end-of-file format. Argument [eof] is optional.
    Note: You must provide an output file name for -b [eof]; otherwise, an error message results.
  • -F deletes sent messages without prompting for confirmation.
  • -n metadata_filename enables metadata to be dumped from the error database into a file of the necessary format.
  • -m mid messages with specified message IDs:
    • x.y.z specifies only this message.
    • x.y.z1:x.y.z2 specifies x.y messages z1 through z2.
    • -m overrides all other restrictions.
    Note:  -m does not work with -o.
  • -c displays context from error database.
  • -C prints only the message count.
  • -R is recovery mode for the recovery database.
  • -w searchExp supports regular expression search on message content. The search is case-sensitive, and works only for the error database.
  • output_file specifies the file name where messages are written. If no output file is specified, then message data is written to stdout.

All specified constraints are ANDed together.