1f517f792SVaibhav Jain /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */ 2f517f792SVaibhav Jain /* 3f517f792SVaibhav Jain * PAPR nvDimm Specific Methods (PDSM) and structs for libndctl 4f517f792SVaibhav Jain * 5f517f792SVaibhav Jain * (C) Copyright IBM 2020 6f517f792SVaibhav Jain * 7f517f792SVaibhav Jain * Author: Vaibhav Jain <vaibhav at linux.ibm.com> 8f517f792SVaibhav Jain */ 9f517f792SVaibhav Jain 10f517f792SVaibhav Jain #ifndef _UAPI_ASM_POWERPC_PAPR_PDSM_H_ 11f517f792SVaibhav Jain #define _UAPI_ASM_POWERPC_PAPR_PDSM_H_ 12f517f792SVaibhav Jain 13f517f792SVaibhav Jain #include <linux/types.h> 14f517f792SVaibhav Jain #include <linux/ndctl.h> 15f517f792SVaibhav Jain 16f517f792SVaibhav Jain /* 17f517f792SVaibhav Jain * PDSM Envelope: 18f517f792SVaibhav Jain * 19f517f792SVaibhav Jain * The ioctl ND_CMD_CALL exchange data between user-space and kernel via 20f517f792SVaibhav Jain * envelope which consists of 2 headers sections and payload sections as 21f517f792SVaibhav Jain * illustrated below: 22f517f792SVaibhav Jain * +-----------------+---------------+---------------------------+ 23f517f792SVaibhav Jain * | 64-Bytes | 8-Bytes | Max 184-Bytes | 24f517f792SVaibhav Jain * +-----------------+---------------+---------------------------+ 25f517f792SVaibhav Jain * | ND-HEADER | PDSM-HEADER | PDSM-PAYLOAD | 26f517f792SVaibhav Jain * +-----------------+---------------+---------------------------+ 27f517f792SVaibhav Jain * | nd_family | | | 28f517f792SVaibhav Jain * | nd_size_out | cmd_status | | 29f517f792SVaibhav Jain * | nd_size_in | reserved | nd_pdsm_payload | 30f517f792SVaibhav Jain * | nd_command | payload --> | | 31f517f792SVaibhav Jain * | nd_fw_size | | | 32f517f792SVaibhav Jain * | nd_payload ---> | | | 33f517f792SVaibhav Jain * +---------------+-----------------+---------------------------+ 34f517f792SVaibhav Jain * 35f517f792SVaibhav Jain * ND Header: 36f517f792SVaibhav Jain * This is the generic libnvdimm header described as 'struct nd_cmd_pkg' 37f517f792SVaibhav Jain * which is interpreted by libnvdimm before passed on to papr_scm. Important 38f517f792SVaibhav Jain * member fields used are: 39f517f792SVaibhav Jain * 'nd_family' : (In) NVDIMM_FAMILY_PAPR_SCM 40f517f792SVaibhav Jain * 'nd_size_in' : (In) PDSM-HEADER + PDSM-IN-PAYLOAD (usually 0) 41f517f792SVaibhav Jain * 'nd_size_out' : (In) PDSM-HEADER + PDSM-RETURN-PAYLOAD 42f517f792SVaibhav Jain * 'nd_command' : (In) One of PAPR_PDSM_XXX 43f517f792SVaibhav Jain * 'nd_fw_size' : (Out) PDSM-HEADER + size of actual payload returned 44f517f792SVaibhav Jain * 45f517f792SVaibhav Jain * PDSM Header: 46f517f792SVaibhav Jain * This is papr-scm specific header that precedes the payload. This is defined 47f517f792SVaibhav Jain * as nd_cmd_pdsm_pkg. Following fields aare available in this header: 48f517f792SVaibhav Jain * 49f517f792SVaibhav Jain * 'cmd_status' : (Out) Errors if any encountered while servicing PDSM. 50f517f792SVaibhav Jain * 'reserved' : Not used, reserved for future and should be set to 0. 51f517f792SVaibhav Jain * 'payload' : A union of all the possible payload structs 52f517f792SVaibhav Jain * 53f517f792SVaibhav Jain * PDSM Payload: 54f517f792SVaibhav Jain * 55f517f792SVaibhav Jain * The layout of the PDSM Payload is defined by various structs shared between 56f517f792SVaibhav Jain * papr_scm and libndctl so that contents of payload can be interpreted. As such 57f517f792SVaibhav Jain * its defined as a union of all possible payload structs as 58f517f792SVaibhav Jain * 'union nd_pdsm_payload'. Based on the value of 'nd_cmd_pkg.nd_command' 59f517f792SVaibhav Jain * appropriate member of the union is accessed. 60f517f792SVaibhav Jain */ 61f517f792SVaibhav Jain 62f517f792SVaibhav Jain /* Max payload size that we can handle */ 63f517f792SVaibhav Jain #define ND_PDSM_PAYLOAD_MAX_SIZE 184 64f517f792SVaibhav Jain 65f517f792SVaibhav Jain /* Max payload size that we can handle */ 66f517f792SVaibhav Jain #define ND_PDSM_HDR_SIZE \ 67f517f792SVaibhav Jain (sizeof(struct nd_pkg_pdsm) - ND_PDSM_PAYLOAD_MAX_SIZE) 68f517f792SVaibhav Jain 69f517f792SVaibhav Jain /* 70f517f792SVaibhav Jain * Methods to be embedded in ND_CMD_CALL request. These are sent to the kernel 71f517f792SVaibhav Jain * via 'nd_cmd_pkg.nd_command' member of the ioctl struct 72f517f792SVaibhav Jain */ 73f517f792SVaibhav Jain enum papr_pdsm { 74f517f792SVaibhav Jain PAPR_PDSM_MIN = 0x0, 75f517f792SVaibhav Jain PAPR_PDSM_MAX, 76f517f792SVaibhav Jain }; 77f517f792SVaibhav Jain 78f517f792SVaibhav Jain /* Maximal union that can hold all possible payload types */ 79f517f792SVaibhav Jain union nd_pdsm_payload { 80f517f792SVaibhav Jain __u8 buf[ND_PDSM_PAYLOAD_MAX_SIZE]; 81f517f792SVaibhav Jain } __packed; 82f517f792SVaibhav Jain 83f517f792SVaibhav Jain /* 84f517f792SVaibhav Jain * PDSM-header + payload expected with ND_CMD_CALL ioctl from libnvdimm 85f517f792SVaibhav Jain * Valid member of union 'payload' is identified via 'nd_cmd_pkg.nd_command' 86f517f792SVaibhav Jain * that should always precede this struct when sent to papr_scm via CMD_CALL 87f517f792SVaibhav Jain * interface. 88f517f792SVaibhav Jain */ 89f517f792SVaibhav Jain struct nd_pkg_pdsm { 90f517f792SVaibhav Jain __s32 cmd_status; /* Out: Sub-cmd status returned back */ 91f517f792SVaibhav Jain __u16 reserved[2]; /* Ignored and to be set as '0' */ 92f517f792SVaibhav Jain union nd_pdsm_payload payload; 93f517f792SVaibhav Jain } __packed; 94f517f792SVaibhav Jain 95f517f792SVaibhav Jain #endif /* _UAPI_ASM_POWERPC_PAPR_PDSM_H_ */ 96