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.