beautypg.com

Invoking dump history – Dialogic 6.2 User Manual

Page 94

background image

Dump History

November 2009

94

Invoking Dump History

You can invoke Dump History from within an application or directly

from the command line.

„

From within an application, one of:

Š

The C system function

Š

BfvHistoryDumpModChan (args)
See Volume 1 of the Bfv API Reference Manual for detailed

information on how to use the BfvHistoryDump... functions.

„

As a stand-alone utility, as follows:

dh [-C] [-f] [-r [-b]] [-R file offset] [-P pktver] [-H hdr_dir] module channel

-C

Clear the history buffer, do not print

entries.

-f

Display history output continuously until

the program is terminated by the user.

This option works best only on lightly

loaded systems. For best speed, use the

options -r -b, then later interpret the

output using -R.

-r

Do a raw dump of the uninterpreted

history data in ASCII form.

-b

Do dump as binary, for use with -r.

-R file offset

Indicates that history interpretation is to

be done using a previously obtained binary

history file. (Such files are obtained from

system crash dumps or by processing the

output of dh -r -b). A filename and starting

offset in hex must be specified. When -R is

used, the module and channel numbers are

not required on the command line.

-P

For use with -R. Forces the packet version

to the specified value (0 or 1).

-H hdr_dir

Read from the directory hdr_dir to create

name tables. Used if modifications were

made to commands or additional command

header files are available after compilation

and distribution of the program.

module 1 channel 1

Main driver history.