hcidbdump
This command queries, manipulates, and changes the message transaction database.
This database contains information that is related to messages that are in one of two states:
- Recovery: These are messages currently in transit through the engine.
- Error: These are messages that have not been delivered due to error.
Caution:
Do not terminate
hcidbdump
! Termination before it is finished corrupts
the database. hcidbdump [-U userid] [-v] -B [tarfile]
or
hcidbdump {-r|-e} [-U userid] [-l] [-L [-x]] [-v] [-D] [-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 searchExp] [-C] [-R] [-w searchExp][output_file]
-
-B
performs database backup. -
tarfile
specifies the file name where the database backup is written. If notarfile
is specified, then tar is written to $DBFPATH/cldb.tar. -
-r
saves message from recovery database. -
-e
saves message from error database. -
-U userid
specifies the user ID to access database. -
-l
specifies long form output. This is ignored whenOutput_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. -
-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 or time. -
-E time
selects messages at or before a specified date or time. -
-M map
applies the map to each message. Uses the msgmapdata command. -
-O time
orders output by ascending date. Time flags are:-
i
specifies inbound arrival time. -
o
specifies outbound time. -
r
specifies 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
selects messages with specified message IDs:-
x.y.z
specifies only this message. -
x.y.z1:x.y.z2
specifiesx.y
messagesz1
throughz2
. -
-m
overrides all other restrictions.
Note: -m does not work with -o. -
-
-c searchExp
supports regular expression search on error context. -
-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 tostdout
.
Note: All specified constraints are
ANDed together.