.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.4.
.TH CANGW "1" "March 2018" "cangw 2018.02.0-1~bpo9+1" "User Commands"
.SH NAME
cangw \- manual page for cangw 2018.02.0-1~bpo9+1
.SH SYNOPSIS
.B cangw
[\fI\,options\/\fR]
.SH DESCRIPTION
cangw \- manage PF_CAN netlink gateway.
.SS "Commands:"
.TP
\fB\-A\fR
(add a new rule)
.TP
\fB\-D\fR
(delete a rule)
.TP
\fB\-F\fR
(flush / delete all rules)
.TP
\fB\-L\fR
(list all rules)
.SS "Mandatory:"
.TP
\fB\-s\fR <src_dev>
(source netdevice)
.TP
\fB\-d\fR <dst_dev>
(destination netdevice)
.SH OPTIONS
.TP
\fB\-t\fR
(preserve src_dev rx timestamp)
.TP
\fB\-e\fR
(echo sent frames \- recommended on vcanx)
.TP
\fB\-i\fR
(allow to route to incoming interface)
.TP
\fB\-u\fR <uid>
(user defined modification identifier)
.TP
\fB\-l\fR <hops>
(limit the number of frame hops / routings)
.TP
\fB\-f\fR <filter>
(set CAN filter)
.TP
\fB\-m\fR <mod>
(set frame modifications)
.TP
\fB\-x\fR <from_idx>:<to_idx>:<result_idx>:<init_xor_val>
(XOR checksum)
.TP
\fB\-c\fR <from>:<to>:<result>:<init_val>:<xor_val>:<crctab[256]>
(CRC8 cs)
.TP
\fB\-p\fR <profile>:[<profile_data>]
(CRC8 checksum profile & parameters)
.PP
Values are given and expected in hexadecimal values. Leading 0s can be omitted.
.SS "<filter> is a <value><mask> CAN identifier filter:"
.TP
<can_id>:<can_mask>
(matches when <received_can_id> & mask == can_id & mask)
.TP
<can_id>~<can_mask>
(matches when <received_can_id> & mask != can_id & mask)
.PP
<mod> is a CAN frame modification instruction consisting of
<instruction>:<can_frame\-elements>:<can_id>.<can_dlc>.<can_data>
.TP
<instruction>
is one of 'AND' 'OR' 'XOR' 'SET'
.TP
<can_frame\-elements>
is _one_ or _more_ of 'I'dentifier 'L'ength 'D'ata
.TP
<can_id>
is an u32 value containing the CAN Identifier
.TP
<can_dlc>
is an u8 value containing the data length code (0 .. 8)
.TP
<can_data>
is always eight(!) u8 values containing the CAN frames data
.PP
The max. four modifications are performed in the order AND \-> OR \-> XOR \-> SET
.SS "Supported CRC 8 profiles:"
.TP
Profile '1' (1U8)
\- add one additional u8 value
.TP
Profile '2' (16U8)
\- add u8 value from table[16] indexed by (data[1] & 0xF)
.TP
Profile '3' (SFFID_XOR)
\- add u8 value (can_id & 0xFF) ^ (can_id >> 8 & 0xFF)
.SH EXAMPLES
cangw \-A \-s can0 \-d vcan3 \-e \-f 123:C00007FF \-m SET:IL:333.4.1122334455667788