bufdump is actually a script that pipes together BufferToRing with dumper to dump data from old style NSCL event files as ring items.
If there are filename arguments on the command line, all files given are dumped in the order in which they appear. If no files are given, the data for the command is accepted on standard input, allowing this program to live inside a unix pipeline.
Most of the dumper options are available. See OPTIONS below for the specific options that are available.
--skip, -mThe value of this option determines how many translated ring items are skipped before the data are dumped.
--count, -cThe value of this option determines how many translated ring items are dumped before the program exits. If omitted the entire data source is dumped.
--sample, -SThis option has no effect and is supplied only for compatibility with the dumper program. This is because bufdump cannot directly take data from a ring buffer.
--excldue, -eThe value of this option is a list of buffer types that should not be dumped. Multiple buffer types should be separated by commas.
--scaler-width, -wThe value of this option is the width, in bits, of scaler counters in the data. This is used to generate a mask that removes any extraneous bits from the unused bits of scalers whose width is less than 32
Example 1. Dumping all data from an old style event file
$DAQROOT/bin/bufdump ~/stagearea/complete/run-124-4096.evt
Example 2. Dumping all data but event data from an old style event file
$DAQROOT/bin/bufdump --exclude=PHYSICS_EVENT ~/stagearea/complete/run-124-4096.evt
Multiple event files can be used as well:
Example 3. Dumping all but physics data from several event files
$DAQROOT/bin/bufdump --exclude=PHYSICS_EVENT ~/stagearea/complete/run-124-4096.evt \
~/stagearea/complete/run-125-4096.evt \
~/stagearea/complete/run-126-4096.evt
# wild cards can be used:
$DAQROOT/bin/bufdump --exclude=PHYSICS_EVENT ~/stagearea/complete/*.evt