The criteria for when to start and stop the capture process for a port.
Even when capture is enabled with P_CAPTURE, the actual capturing of packets can be delayed until a particular start criteria is met by a received packet. Likewise, a stop criteria can be specified, based on a received packet. If no explicit stop criteria is specified, capture stops when the internal buffer runs full. In buffer overflow situations, if there is an explicit stop criteria, then the latest packets will be retained (and the early ones discarded), and otherwise, the earliest packets are retained (and the later ones discarded).
set and get, value types: I,I,I,I
start: coded integer, the criteria for starting the actual packet capture:
ON (start immediately when capture is started)
FCSERR (start when receiving a packet containing a frame checksum error)
FILTER (start when receiving a packet satisfying a filter condition)
PLDERR (start when receiving a packet containing a packet payload error)
filter1: integer, the index of a particular filter for the start criteria.
stop: coded integer, the criteria for stopping the actual packet capture:
FULL (continue until the capture buffer runs full)
FCSERR (continue until receiving a packet with a frame checksum error)
FILTER (continue until receiving a packet satisfying a filter condition)
PLDERR (continue until receiving a packet with a packet payload error)
USERSTOP* (continue until the user stops the capture manually)
filter2: integer, the index of a particular filter for the stop criteria.
*keyword can be replaced by 4 if not supported.
0/1 PC_TRIGGER FILTER 3 FULL 0
0/1 PC_TRIGGER ON 0 FULL 0
*0/1 PC_TRIGGER ON 0 4 0 (PC_TRIGGER ON 0 USERSTOP 0)
PC_KEEP WHICH INDEX BYTES
Which packets to keep once the start criteria has been triggered for a port. Also how big a portion of each packet to retain, saving space for more packets in the capture buffer.
set and get, value types: I,I,I
which: coded integer, which general kind of packets to keep:
ALL (keep all packets between the start and stop trigger)
FCSERR (keep only those packets with frame checksum errors)
NOTPLD (keep only those packets without a test payload)
TPLD (keep only those packets with a test payload and specific id)
FILTER (keep only those packets satisfying a specific filter condition)
PLDERR (Keep only those packets with payload errors)
index: integer, test payload id or filter index for which packets to keep.
bytes: integer, how many bytes to keep in the buffer for of each packet. The value -1 means no limit on packet size.
0/1 PC_KEEP TPLD 17 30
Award Winning Solutions
Xena has won multiple global awards for price/performance and technical innovation. Learn more.
Privacy & Cookies Policy
Necessary cookies are absolutely essential for the website to function properly. This category only includes cookies that ensures basic functionalities and security features of the website. These cookies do not store any personal information.