Family psp netlink specification¶
Summary¶
PSP Security Protocol Generic Netlink family.
Operations¶
dev-get¶
Get / dump information about PSP capable devices on the system.
- attribute-set:
- do:
- request
- attributes:
- [ - id]
 
- reply
- attributes:
- [ - id,- ifindex,- psp-versions-cap,- psp-versions-ena]
 
- pre
- psp-device-get-locked 
- post
- psp-device-unlock 
 
- dump:
- reply
- attributes:
- [ - id,- ifindex,- psp-versions-cap,- psp-versions-ena]
 
 
dev-add-ntf¶
Notification about device appearing.
- notify:
- dev-get 
- mcgrp:
- mgmt 
dev-del-ntf¶
Notification about device disappearing.
- notify:
- dev-get 
- mcgrp:
- mgmt 
dev-set¶
Set the configuration of a PSP device.
- attribute-set:
- do:
- request
- attributes:
- [ - id,- psp-versions-ena]
 
- reply
- attributes:
- [] 
 
- pre
- psp-device-get-locked 
- post
- psp-device-unlock 
 
dev-change-ntf¶
Notification about device configuration being changed.
- notify:
- dev-get 
- mcgrp:
- mgmt 
key-rotate¶
Rotate the device key.
- attribute-set:
- do:
- request
- attributes:
- [ - id]
 
- reply
- attributes:
- [ - id]
 
- pre
- psp-device-get-locked 
- post
- psp-device-unlock 
 
key-rotate-ntf¶
Notification about device key getting rotated.
- notify:
- key-rotate 
- mcgrp:
- use 
rx-assoc¶
Allocate a new Rx key + SPI pair, associate it with a socket.
- attribute-set:
- do:
- request
- attributes:
- [ - dev-id,- version,- sock-fd]
 
- reply
- attributes:
- [ - dev-id,- rx-key]
 
- pre
- psp-assoc-device-get-locked 
- post
- psp-device-unlock 
 
tx-assoc¶
Add a PSP Tx association.
- attribute-set:
- do:
- request
- attributes:
- [ - dev-id,- version,- tx-key,- sock-fd]
 
- reply
- attributes:
- [] 
 
- pre
- psp-assoc-device-get-locked 
- post
- psp-device-unlock 
 
Multicast groups¶
- mgmt 
- use 
Definitions¶
version¶
- type:
- enum 
- entries:
- hdr0-aes-gcm-128
- hdr0-aes-gcm-256
- hdr0-aes-gmac-128
- hdr0-aes-gmac-256
 
Attribute sets¶
dev¶
id (u32)¶
- doc:
- PSP device ID. 
ifindex (u32)¶
- doc:
- ifindex of the main netdevice linked to the PSP device. 
psp-versions-cap (u32)¶
- doc:
- Bitmask of PSP versions supported by the device. 
- enum:
- enum-as-flags:
- True 
psp-versions-ena (u32)¶
- doc:
- Bitmask of currently enabled (accepted on Rx) PSP versions. 
- enum:
- enum-as-flags:
- True 
assoc¶
dev-id (u32)¶
- doc:
- PSP device ID. 
version (u32)¶
- doc:
- PSP versions (AEAD and protocol version) used by this association, dictates the size of the key. 
- enum:
rx-key (nest)¶
- nested-attributes:
tx-key (nest)¶
- nested-attributes:
sock-fd (u32)¶
- doc:
- Sockets which should be bound to the association immediately. 
keys¶
key (binary)¶
spi (u32)¶
- doc:
- Security Parameters Index (SPI) of the association.