IP-MACSEC 8 "07 Mar 2016" "iproute" "Linux"
NAME
ip-macsec - MACsec device configuration
"SYNOPSIS"
"ip link add link " DEVICE " name " NAME " type macsec " [ [
address " <lladdr>" ]
port " PORT" |
sci " <u64>" ] [
cipher " { " default " | " gcm-aes-128 " } ] [" icvlen " ICVLEN" ] [
encrypt " { " on " | " off " } ] [" send_sci " { " on " | " off " } ] [" end_station " { " on " | " off " } ] [" scb " { " on " | " off " } ] [" protect " { " on " | " off " } ] [" replay " { " on " | " off " } ] [" window " WINDOW" ] [
validate " { " strict " | " check " | " disabled " } ] [" encodingsa " SA" ]
"ip macsec add " DEV " tx sa" "{ " 0..3 " } [ " OPTS " ]" key " ID KEY" "ip macsec set " DEV " tx sa" "{ " 0..3 " } [ " OPTS " ]" "ip macsec del " DEV " tx sa" "{ " 0..3 " }"
"ip macsec add " DEV " rx " SCI [ " on " | " off " ] "ip macsec set " DEV " rx " SCI [ " on " | " off " ] "ip macsec del " DEV " rx " SCI
"ip macsec add " DEV " rx " SCI " sa" "{ " 0..3 " } [ " OPTS " ]" key " ID KEY" "ip macsec set " DEV " rx " SCI " sa" "{ " 0..3 " } [ " OPTS " ]" "ip macsec del " DEV " rx " SCI " sa" "{ " 0..3 " }"
ip macsec show [ " DEV " ]
OPTS " := [ " pn " { " 1..2^32-1 " } ] [" on " | " off " ]" SCI " := { " sci <u64> " | " port PORT address " <lladdr> " }
PORT " := { " 1..2^16-1 " } "
DESCRIPTION
The
ip macsec commands are used to configure transmit secure associations and receive secure channels and their secure associations on a MACsec device created with the
ip link add command using the
macsec type.
EXAMPLES
Create a MACsec device on link eth0
# ip link add link eth0 macsec0 type macsec port 11 encrypt on
Configure a secure association on that device
# ip macsec add macsec0 tx sa 0 pn 1024 on key 01 81818181818181818181818181818181
Configure a receive channel
# ip macsec add macsec0 rx port 1234 address c6:19:52:8f:e6:a0
Configure a receive association
# ip macsec add macsec0 rx port 1234 address c6:19:52:8f:e6:a0 sa 0 pn 1 on key 00 82828282828282828282828282828282
Display MACsec configuration
# ip macsec show
SEE ALSO
ip-link (8) AUTHOR
Sabrina Dubroca <sd (at] queasysnail.net>