Message forwarding options
Message forwarding options include:
- This option takes two
arguments:
resend_errordb -m meta_file_name
This resends from the error database, but with modified metadata from a file. This file takes the same format as the SMAT metadata temp file.
The message IDs that are used in the resend come from the metadata file. When using metadata,
resend_errordb
also supports resending multiple messages. - This option takes four arguments:
resend_errordb -m meta_file_name msgfile_name len10|nl|eof
This performs an error database resend using both message data and metadata from files. As with resend, if the number of messages in both files do not match, the command returns an error without resending any messages.
If two or four arguments are used, then the first option must be
-m
or the command returns an error.Because
resend_errordb
takes from one to four arguments, the full form that is called from hcicmd is:hcicmd -p process_name -c ". resend_errordb mid" hcicmd -p process_name> -c ". resend_errordb -m meta_file_name" hcicmd -p process_name -c ". resend_errordb mid msgfile_name len10|nl|eof" hcicmd -p process_name -c ". resend_errordb -m meta_file_name msgfile_name len10|nl|eof"
-n metadata_file_name
option:hcidbdump enables dumping metadata from the error database into a file of the necessary format. The option for this is
-n metadata_file_name
.hcidbdump -n metadata_file_name -e -m mid output_file_name
For example:
hcidbdump -n meta.txt -e -m 0.0.1:0.0.9999 out.txt
This generates the metadata file. This is meta.txt in the example. You can modify and use this as the second argument to
resend_errordb
.- Message encoding option:
The message encoding option permits you to specify the encoding for the data file. If there is no encoding specified, then the API keeps the old behavior.
If you only specify an MID to resend, then it is unnecessary to specify the encoding. The engine uses UTF-8 to do the resend.
This command resends the message content in the specified format into the specified process. The
run resend
command line is:hcicmd -p process_name -c ". resend_errordb mid msgContent len10|nl|eof [-e msg_encoding]"
save_start
starts saving protocol messages:conn save_start {in|out} file
save_stop
stops saving protocol messages:conn save_stop {in|out}
save_cycle
cycles the save message file:conn save_cycle {in|out}
show
displays information about the alerts that are currently loaded by hcimonitord.show type
Where type is one of:
-
all
shows all loaded alerts. -
alert name
shows the alert named name. group groupname
shows alerts belonging to group groupname.config file_name
shows alerts loaded from the configuration file file_name. For example,default.alrt
.-
disabled
shows alerts currently disabled by hcicmd commands. enabled
shows enabled alerts that have not been disabled by hcicmd commands.-
window
shows alerts currently in their active window. -
window_not
shows alerts currently not in their active window. -
active
shows alerts that are armed or fired.
-
THREADCTL
controls the thread remotely. Uppercase is required.THREADCTL process_name threadname
xhold_post
holds the post-xlate queue.xlt xhold_post conn
xrel_post
releases the post-xlate queue.xlt xrel_post conn
To use these commands in a non-interactive manner, use
-c
with hcicmd.