Loongarch SE

Overview

Loongarch SE (Security Element) is an innate security IP core of LoongArch processors. It can provide secure, compliant, and standardized encryption capabilities for your applications.

SE devices can be virtualized and attached to VM instances, thus providing secure encryption for VM instances. You can virtualize up to 64 SE devices on the Cloud but we do not recommend that you virtualize more than 24 SE devices in case of reducing the host performance.

Inventory

Properties

Name	Description	Starting Version
uuid	The UUID. For more information, see Resource Property.	4.6.0
name	The name. For more information, see Resource Property.	4.6.0
description	The description. For more information, see Resource Property.	4.6.0
hostUuid	The host UUID.	4.6.0
type	The type.	4.6.0
state		4.6.0
virtStatus		4.6.0
groupBy	Groups rows into subgroups based on values of columns or expressions. This field is equivalent to the Group By clause in MySQL, such as groupBy=type.	4.6.0
createDate	The creation date. For more information, see Resource Property.	4.6.0
lastOpDate	The last operation date. For more information, see Resource Property.	4.6.0
userTags	The user tags. For more information, see CreateUserTag.	4.6.0
systemTags	The system tags. For more information, see CreateSystemTag.	4.6.0

Sample

{
    "inventories": [
        {
            "createDate": "Feb 13, 2023 7:12:56 PM",
            "description": "SE_Controller: computing encryption device",
            "hostUuid": "6f8da96c96e24c0bbdccdc06892cbc04",
            "lastOpDate": "Feb 13, 2023 7:16:05 PM",
            "name": "SE_3964069b",
            "state": "Enabled",
            "type": "SE_Controller",
            "uuid": "3964069ba3524c2e82915e1a2cb5632b",
            "virtStatus": "VFIO_MDEV_VIRTUALIZED"
        }
    ],
    "success": true
}

Operations

GenerateSeMdevDevices

Virtualizes a VFIO_MDEV MTTY device. For example,

GenerateSeMdevDevices mttyDeviceUuid=d6e129976ad830fdbd2361a62f9f44e0 virtPartNum=4.0

Parameters

Name	Description	Optional	Starting Version
mttyDeviceUuid	The UUID of the MTTY device.		4.6.0
virtPartNum	The virtualized device number.		4.6.0
userTags	The user tags. For more information, see CreateUserTag.	Yes	4.6.0
systemTags	The system tags. For more information, see CreateSystemTag.	Yes	4.6.0
timeout		Yes

QueryMttyDevice

Queries an MTTY device. For example,

QueryMttyDevice

Primitive Fields of Query

See MTTY Device Inventory.

UngenerateSeMdevDevices

Unvirtualizes a VFIO_MDEV MTTY device. For example,

UngenerateSeMdevDevices mttyDeviceUuid=1efca0f4fb223cbd83e5d225d0c97637

Parameters

Name	Description	Optional	Starting Version
mttyDeviceUuid	The UUID of the virtualized MTTY device.		4.6.0
userTags	The user tags. For more information, see CreateUserTag.	Yes	4.6.0
systemTags	The system tags. For more information, see CreateSystemTag.	Yes	4.6.0
timeout		Yes

DeleteMdevDevice

Deletes an inactive MEDV device. For example,

DeleteMdevDevice uuid=f858a5a7428935b39aa038b6d781efdb

Parameters

Name	Description	Optional	Starting Version
uuid	The UUID of the MDEV device.		4.6.0
deleteMode	The deletion mode.	Yes	4.6.0
userTags	The user tags. For more information, see CreateUserTag.	Yes	4.6.0
systemTags	The system tags. For more information, see CreateSystemTag.	Yes	4.6.0
timeout		Yes

PreviousSR-IOV NextHygon SE