IP-MACSEC(8)                         Linux                        IP-MACSEC(8)

<?><?><?> (NAME)
       ip-macsec - <?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> MACsec

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       ip link add link DEVICE name NAME type macsec  [ [ address <lladdr> ]
       port PORT | sci <u64> ] [ cipher { default | gcm-aes-128 | gcm-aes-256
       | gcm-aes-xpn-128 | gcm-aes-xpn-256 } ] [ 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 ] [ offload { off | phy | mac } ]

       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 offload DEV { off | phy | mac }

       ip macsec show [ DEV ]

       OPTS := [  pn {  1..2^32-1 } | xpn {  1..2^64-1 } ] [ salt SALT ] [
       ssci <u32> ] [ on | off ]
       SCI := {  sci <u64> |  port PORT address <lladdr>  }
       PORT := { 1..2^16-1 }
       SALT := 96-bit hex string



<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?><?><?> ip macsec <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> (transmit
       secure associations)<?> <?><?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> (receive secure channels) <?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?> MACsec <?><?>
       <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> ip link add <?> <?><?><?> macsec <?><?><?><?><?>
       <?><?><?> <?><?><?><?>.


<?><?><?><?><?><?><?> (EXAMPLES)
   <?><?><?><?><?> <?><?> <?><?><?><?><?><?> MACsec <?><?><?> <?><?><?><?><?>
       eth0 (<?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?>)
       # ip link add link eth0 macsec0 type macsec port 11 encrypt on

   <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?>
       <?><?> <?><?><?><?><?><?>
       # ip macsec add macsec0 tx sa 0 pn 1024 on key 01 81818181818181818181818181818181

   <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       # ip macsec add macsec0 rx port 1234 address c6:19:52:8f:e6:a0

   <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?>
       # ip macsec add macsec0 rx port 1234 address c6:19:52:8f:e6:a0 sa 0 pn 1 on key 00 82828282828282828282828282828282

   <?><?><?><?><?> <?><?><?><?><?><?><?><?> MACsec
       # ip macsec show

   <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?>
       # ip macsec offload macsec0 phy

   <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> MACsec
       # ip link add link eth0 macsec0 type macsec port 11 encrypt on offload mac


<?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> (EXTENDED PACKET NUMBER EXAMPLES)
   <?><?><?><?><?> <?><?> <?><?><?><?><?><?> MACsec <?><?><?> <?><?><?><?><?>
       eth0 <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> (<?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?>)
       # ip link add link eth0 macsec0 type macsec port 11 encrypt on cipher gcm-aes-xpn-128

   <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?>
       <?><?> <?><?><?><?><?><?>
       # ip macsec add macsec0 tx sa 0 xpn 1024 on salt 838383838383838383838383 ssci 123 key 01 81818181818181818181818181818181

   <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       # ip macsec add macsec0 rx port 11 address c6:19:52:8f:e6:a0

   <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?>
       # ip macsec add macsec0 rx port 11 address c6:19:52:8f:e6:a0 sa 0 xpn 1 on salt 838383838383838383838383 ssci 123 key 00 82828282828282828282828282828282

   <?><?><?><?><?> <?><?><?><?><?><?><?><?> MACsec
       # ip macsec show

<?><?><?><?> (NOTES)
       <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> 802.1AE <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>. <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?> 802.1AE <?><?>
       <?><?><?><?><?><?><?><?> GCM-AES <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> (IV)
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> (packet number) <?><?><?><?> <?><?><?><?><?><?>. <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?>
       <?><?><?> <?><?> <?><?><?><?> IV <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?>.
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> (user-space) <?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?>. <?><?><?>
       <?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?> <?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?>. <?><?><?>
       <?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> 802.1X-2010
       <?><?><?> <?><?> <?><?><?><?> wpa_supplicant
       <?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?>.


<?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       (EXTENDED PACKET NUMBER NOTES)
       <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> gcm-aes-xpn-128 <?><?> gcm-aes-xpn-256 <?><?>
       <?><?><?><?><?> ip link add <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?> macsec<?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?> salt <?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> 'salt' <?> <?><?><?><?><?> ssci <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> 'ssci'<?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> 'xpn' <?><?><?><?><?><?> 'pn' <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> ip macsec <?><?><?>.


<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       ip-link(8) wpa_supplicant(8)

<?><?><?><?><?><?><?> (AUTHOR)
       Sabrina Dubroca <sd@queasysnail.net>

iproute                           07 Mar 2016                     IP-MACSEC(8)