Endace DAG 9.2X2 - Page 47

EDM01-36v10 DAG_9.2X2_Card_User_Guide - Using your DAG card
©2010 - 2012 Endace Technology Ltd. Confidential - Version 10 - May 2012 41
-i
--api <api>
Use "API" interface for live DAG API capture. Possible options are:
• 0 DAG 2.4 legacy API interface [dag_offset(3)].
• 1 DAG 2.5 API interface [dag_advance_stream(3)].
• 2 DAG 2.5 API interface [dag_rx_stream_next_record(3)].
-I, --ipf
Assume the ERF contains color information in the pad and offset bytes (for Ethernet ERFs) or
HDLC header bytes (for PoS ERFs) and display this information as a packet classification and
destination memory buffer.
-j,
--jthresh <t>
Set the threshold for the jitter test to <t> microseconds.
-l, --maal <m>
Check for the specified MAAL error code.
-L,
--idle_int <n>
For test idle, interval to detect data is <n>.
-m,
--prnmaxerr <n>
Print the first <n> errored records only, and then continue to count errors silently for the
duration of the session.
-n,
--numpkts <n>
Expected number of packets to receive. Returns an error if the actual number is different.
-p, --posformat
Set legacy format to PoS (default: ATM).
-P,
--params <params>
DAG 3.5S capture parameters.
-q, --quiet
Quiet. This instructs dagbits to suppress summary information when terminating. Error
messages are not affected by this option.
-r, --reclen <n>
Set legacy format record lengths to <n>.
-R, --rlen <n>
When used in conjunction with the rlen test, indicates the RLEN of ERF records to match
against. <n>.
-s, --strict
Check for strictly monotonic (increasing) timestamps, rather than monotonic (non-
decreasing). Affects the behavior of the mono test. With strict checking it is an error for
consecutive timestamps to be equal; they must always increase.
-S, --stop <n>
Terminate dagbits after <n> seconds of capture. This option only makes sense when
capturing packets from a DAG card (i.e. when used in conjunction with the -d flag).
-t,
--haltany <n>
Terminate dagbits if any ERF record type does not match <n>.
-T,
--pause_timing
<x:y:z>
Pause stream for testing purposes where
• x is the delay to start
• y is the period of pause repetition, and
• z is the length of the pause
-u, --count_pad
Count pad records and strictly check -t option.
-U, --maxrec <n>
Process at most <n> records in one pass. This option enables the user to reduce the
performance of
dagbits
for various purposes. For live DAG API capture only. See also -D.
-v,
--verbose
Increase verbosity of dagbits. This option increase the amount of data displayed when
printing an ERF record due to the print test or errors in other tests. -v will print payload
contents, -vv will print payload contents and an accompanying ASCII dump of the packet
payload.
-V, --version
Display version information.
-w, --warnings
Instruct dagbits to treat all warnings as errors.
-W, --wlen <n>
When used in conjunction with the wlen test, the wire length of ERF records must be exactly
NUM bytes.
-X, --wait <n>
Wait before first packet capture from the stream extra n microseconds
-y
--delay_test <n>
Start testing after <n> records have been received
-z, --idlestop
Stop when no traffic is received for one second.
--delta-min
<sec.ms.us.ns>
Delta test minimum timestamp difference - any timestamp difference smaller than the value
will be reported as a failure.
--delta-max
<sec.ms.us.ns>
Delta test maximum timestamp difference - any timestamp difference larger than the value
will be reported as a failure.
--erase_pad
Erase padding bytes from print function.
--hlb-range <min-
max>
Steer hlb (hash load balance) range test range, for example: 15.0-50.0
--no_pad
Turn off pad record flushing.