.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH CANSNIFFER "1" "March 2023" "cansniffer 2023.03-1" "User Commands"
.SH NAME
cansniffer \- manual page for cansniffer 2023.03-1
.SH SYNOPSIS
.B cansniffer
[\fI\,can-interface\/\fR]
.SH DESCRIPTION
cansniffer \- volatile CAN content visualizer.
.SH OPTIONS
.TP
\fB\-q\fR
(quiet \- all IDs deactivated)
.TP
\fB\-r\fR <name>
(read sniffset.name from file)
.TP
\fB\-e\fR
(fix extended frame format output \- no auto detect)
.TP
\fB\-b\fR
(start with binary mode)
.TP
\fB\-8\fR
(start with binary mode \- for EFF on 80 chars)
.TP
\fB\-B\fR
(start with binary mode with gap \- exceeds 80 chars!)
.TP
\fB\-c\fR
(color changes)
.TP
\fB\-f\fR <mode>
(CAN FD mode: 0 = OFF, 1 = ON, 2 = auto detect, default: 2)
.TP
\fB\-t\fR <time>
(timeout for ID display [x10ms] default: 500, 0 = OFF)
.TP
\fB\-h\fR <time>
(hold marker on changes [x10ms] default: 100)
.TP
\fB\-l\fR <time>
(loop time (display) [x10ms] default: 20)
.TP
\-?
(print this help text)
.PP
Use interface name 'any' to receive from all can\-interfaces.
.SS "commands that can be entered at runtime:"
.TP
q<ENTER>
\- quit
.TP
b<ENTER>
\- toggle binary / HEX\-ASCII output
.TP
8<ENTER>
\- toggle binary / HEX\-ASCII output (small for EFF on 80 chars)
.TP
B<ENTER>
\- toggle binary with gap / HEX\-ASCII output (exceeds 80 chars!)
.TP
c<ENTER>
\- toggle color mode
.TP
@<ENTER>
\- toggle ASCII output (disabled for CAN FD by default)
.TP
<SPACE><ENTER>
\- force a clear screen
.TP
#<ENTER>
\- notch currently marked/changed bits (can be used repeatedly)
.TP
*<ENTER>
\- clear notched marked
.TP
rMYNAME<ENTER>
\- read settings file (filter/notch)
.TP
wMYNAME<ENTER>
\- write settings file (filter/notch)
.TP
a<ENTER>
\- enable 'a'll SFF CAN\-IDs to sniff
.TP
n<ENTER>
\- enable 'n'one SFF CAN\-IDs to sniff
.TP
A<ENTER>
\- enable 'A'll EFF CAN\-IDs to sniff
.TP
N<ENTER>
\- enable 'N'one EFF CAN\-IDs to sniff
.HP
+FILTER<ENTER>  \- add CAN\-IDs to sniff
.HP
\fB\-FILTER\fR<ENTER>  \- remove CAN\-IDs to sniff
.PP
FILTER can be a single CAN\-ID or a CAN\-ID/Bitmask:
.IP
single SFF 11 bit IDs:
.HP
+1F5<ENTER>               \- add SFF CAN\-ID 0x1F5
.HP
\fB\-42E\fR<ENTER>               \- remove SFF CAN\-ID 0x42E
.IP
single EFF 29 bit IDs:
.HP
+18FEDF55<ENTER>          \- add EFF CAN\-ID 0x18FEDF55
.HP
\fB\-00000090\fR<ENTER>          \- remove EFF CAN\-ID 0x00000090
.IP
CAN\-ID/Bitmask SFF:
.HP
\fB\-42E7FF\fR<ENTER>            \- remove SFF CAN\-ID 0x42E (using Bitmask)
.HP
\fB\-500700\fR<ENTER>            \- remove SFF CAN\-IDs 0x500 \- 0x5FF
.HP
+400600<ENTER>            \- add SFF CAN\-IDs 0x400 \- 0x5FF
.HP
+000000<ENTER>            \- add all SFF CAN\-IDs
.HP
\fB\-000000\fR<ENTER>            \- remove all SFF CAN\-IDs
.IP
CAN\-ID/Bitmask EFF:
.HP
\fB\-0000000000000000\fR<ENTER>  \- remove all EFF CAN\-IDs
.HP
+12345678000000FF<ENTER>  \- add EFF CAN IDs xxxxxx78
.HP
+0000000000000000<ENTER>  \- add all EFF CAN\-IDs
.PP
if (id & filter) == (sniff\-id & filter) the action (+/\-) is performed,
which is quite easy when the filter is 000 resp. 00000000 for EFF.