.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH CANDUMP "1" "March 2023" "candump 2023.03-1" "User Commands"
.SH NAME
candump \- manual page for candump 2023.03-1
.SH SYNOPSIS
.B candump
[\fI\,options\/\fR] \fI\,<CAN interface>+\/\fR
.SH DESCRIPTION
candump \- dump CAN bus traffic.
.IP
(use CTRL\-C to terminate candump)
.SH OPTIONS
.TP
\fB\-t\fR <type>
(timestamp: (a)bsolute/(d)elta/(z)ero/(A)bsolute w date)
.TP
\fB\-H\fR
(read hardware timestamps instead of system timestamps)
.TP
\fB\-c\fR
(increment color mode level)
.TP
\fB\-i\fR
(binary output \- may exceed 80 chars/line)
.TP
\fB\-a\fR
(enable additional ASCII output)
.TP
\fB\-S\fR
(swap byte order in printed CAN data[] \- marked with '`' )
.TP
\fB\-s\fR <level>
(silent mode \- 0: off (default) 1: animation 2: silent)
.TP
\fB\-l\fR
(log CAN\-frames into file. Sets '\-s 2' by default)
.TP
\fB\-f\fR <fname>
(log CAN\-frames into file <fname>. Sets '\-s 2' by default)
.TP
\fB\-L\fR
(use log file format on stdout)
.TP
\fB\-n\fR <count>
(terminate after reception of <count> CAN frames)
.TP
\fB\-r\fR <size>
(set socket receive buffer to <size>)
.TP
\fB\-D\fR
(Don't exit if a "detected" can device goes down)
.TP
\fB\-d\fR
(monitor dropped CAN frames)
.TP
\fB\-e\fR
(dump CAN error frames in human\-readable format)
.TP
\fB\-8\fR
(display raw DLC values in {} for Classical CAN)
.TP
\fB\-x\fR
(print extra message infos, rx/tx brs esi)
.TP
\fB\-T\fR <msecs>
(terminate after <msecs> if no frames were received)
.PP
Up to 16 CAN interfaces with optional filter sets can be specified
on the commandline in the form: <ifname>[,filter]*
.SS "Filters:"
.IP
Comma separated filters can be specified for each given CAN interface:
.IP
<can_id>:<can_mask>
.IP
(matches when <received_can_id> & mask == can_id & mask)
.IP
<can_id>~<can_mask>
.IP
(matches when <received_can_id> & mask != can_id & mask)
.IP
#<error_mask>
.IP
(set error frame filter, see include/linux/can/error.h)
.IP
[j|J]
.IP
(join the given CAN filters \- logical AND semantic)
.PP
CAN IDs, masks and data content are given and expected in hexadecimal values.
When the can_id is 8 digits long the CAN_EFF_FLAG is set for 29 bit EFF format.
Without any given filter all data frames are received ('0:0' default filter).
.PP
Use interface name 'any' to receive from all CAN interfaces.
.SH EXAMPLES
candump \-c \-c \-ta can0,123:7FF,400:700,#000000FF can2,400~7F0 can3 can8
.PP
candump \-l any,0~0,#FFFFFFFF
.IP
(log only error frames but no(!) data frames)
.PP
candump \-l any,0:0,#FFFFFFFF
.IP
(log error frames and also all data frames)
.PP
candump vcan2,12345678:DFFFFFFF
.IP
(match only for extended CAN ID 12345678)
.PP
candump vcan2,123:7FF
.IP
(matches CAN ID 123 \- including EFF and RTR frames)
.PP
candump vcan2,123:C00007FF
.IP
(matches CAN ID 123 \- only SFF and non\-RTR frames)