From: Ben Widawsky <ben.widawsky@intel.com>
To: Vishal Verma <vishal.l.verma@intel.com>
Cc: linux-cxl@vger.kernel.org, linux-nvdimm@lists.01.org
Subject: Re: [ndctl PATCH v2 04/13] libcxl: add support for the 'Identify Device' command
Date: Mon, 22 Feb 2021 14:02:09 -0800 [thread overview]
Message-ID: <20210222220209.62pvejo6mxhcqqth@intel.com> (raw)
In-Reply-To: <20210219020331.725687-5-vishal.l.verma@intel.com>
On 21-02-18 19:03:22, Vishal Verma wrote:
> Add APIs to allocate and send an 'Identify Device' command, and
> accessors to retrieve some of the fields from the resulting data.
>
> Only add a handful accessor functions; more can be added as the need
> arises. The fields added are fw_revision, partition_align, and
> lsa_size.
>
How do we feel about for each command the ability to return n bytes as an opaque
object? That way, if some client application wants more of the identify data
they can get it without needing library API to do it.
/**
* cxl_cmd_identify_get_payload() - Return output payload
* @cmd: Identify command.
* @n: Max number of bytes to return.
* @out: Buffer to copy to.
*
* Returns actual number of bytes copied out.
*
* Returns up to n bytes in (CXL native format) of data from the output payload
* of the identify command.
*/
CXL_EXPORT unsigned int
cxl_cmd_identify_get_payload(struct cxl_cmd *cmd, unsigned int n, void *out)
{
}
I recall discussing this briefly, but I don't recall what we had decided.
> Cc: Ben Widawsky <ben.widawsky@intel.com>
> Cc: Dan Williams <dan.j.williams@intel.com>
> Signed-off-by: Vishal Verma <vishal.l.verma@intel.com>
> ---
> cxl/lib/private.h | 19 ++++++++++++++++++
> cxl/lib/libcxl.c | 49 ++++++++++++++++++++++++++++++++++++++++++++++
> cxl/libcxl.h | 4 ++++
> cxl/lib/libcxl.sym | 4 ++++
> 4 files changed, 76 insertions(+)
>
> diff --git a/cxl/lib/private.h b/cxl/lib/private.h
> index 87ca17e..3273f21 100644
> --- a/cxl/lib/private.h
> +++ b/cxl/lib/private.h
> @@ -54,6 +54,25 @@ struct cxl_cmd {
> int status;
> };
>
> +#define CXL_CMD_IDENTIFY_FW_REV_LENGTH 0x10
> +
> +struct cxl_cmd_identify {
> + char fw_revision[CXL_CMD_IDENTIFY_FW_REV_LENGTH];
> + le64 total_capacity;
> + le64 volatile_capacity;
> + le64 persistent_capacity;
> + le64 partition_align;
> + le16 info_event_log_size;
> + le16 warning_event_log_size;
> + le16 failure_event_log_size;
> + le16 fatal_event_log_size;
> + le32 lsa_size;
> + u8 poison_list_max_mer[3];
> + le16 inject_poison_limit;
> + u8 poison_caps;
> + u8 qos_telemetry_caps;
> +} __attribute__((packed));
> +
> static inline int check_kmod(struct kmod_ctx *kmod_ctx)
> {
> return kmod_ctx ? 0 : -ENXIO;
> diff --git a/cxl/lib/libcxl.c b/cxl/lib/libcxl.c
> index f1155a1..4751cba 100644
> --- a/cxl/lib/libcxl.c
> +++ b/cxl/lib/libcxl.c
> @@ -13,7 +13,10 @@
> #include <sys/sysmacros.h>
> #include <uuid/uuid.h>
> #include <ccan/list/list.h>
> +#include <ccan/endian/endian.h>
> +#include <ccan/minmax/minmax.h>
> #include <ccan/array_size/array_size.h>
> +#include <ccan/short_types/short_types.h>
>
> #include <util/log.h>
> #include <util/sysfs.h>
> @@ -675,6 +678,52 @@ CXL_EXPORT const char *cxl_cmd_get_devname(struct cxl_cmd *cmd)
> return cxl_memdev_get_devname(cmd->memdev);
> }
>
> +CXL_EXPORT struct cxl_cmd *cxl_cmd_new_identify(struct cxl_memdev *memdev)
> +{
> + return cxl_cmd_new_generic(memdev, CXL_MEM_COMMAND_ID_IDENTIFY);
> +}
> +
> +CXL_EXPORT int cxl_cmd_identify_get_fw_rev(struct cxl_cmd *cmd, char *fw_rev,
> + int fw_len)
> +{
> + struct cxl_cmd_identify *id = (void *)cmd->send_cmd->out.payload;
> +
> + if (cmd->send_cmd->id != CXL_MEM_COMMAND_ID_IDENTIFY)
> + return -EINVAL;
> + if (cmd->status < 0)
> + return cmd->status;
> +
> + if (fw_len > 0)
> + memcpy(fw_rev, id->fw_revision,
> + min(fw_len, CXL_CMD_IDENTIFY_FW_REV_LENGTH));
> + return 0;
> +}
> +
> +CXL_EXPORT unsigned long long cxl_cmd_identify_get_partition_align(
> + struct cxl_cmd *cmd)
> +{
> + struct cxl_cmd_identify *id = (void *)cmd->send_cmd->out.payload;
> +
> + if (cmd->send_cmd->id != CXL_MEM_COMMAND_ID_IDENTIFY)
> + return -EINVAL;
> + if (cmd->status < 0)
> + return cmd->status;
> +
> + return le64_to_cpu(id->partition_align);
> +}
> +
> +CXL_EXPORT unsigned int cxl_cmd_identify_get_lsa_size(struct cxl_cmd *cmd)
> +{
> + struct cxl_cmd_identify *id = (void *)cmd->send_cmd->out.payload;
> +
> + if (cmd->send_cmd->id != CXL_MEM_COMMAND_ID_IDENTIFY)
> + return -EINVAL;
> + if (cmd->status < 0)
> + return cmd->status;
> +
> + return le32_to_cpu(id->lsa_size);
> +}
> +
> CXL_EXPORT struct cxl_cmd *cxl_cmd_new_raw(struct cxl_memdev *memdev,
> int opcode)
> {
> diff --git a/cxl/libcxl.h b/cxl/libcxl.h
> index 6e87b80..9ed8c83 100644
> --- a/cxl/libcxl.h
> +++ b/cxl/libcxl.h
> @@ -58,6 +58,10 @@ void cxl_cmd_unref(struct cxl_cmd *cmd);
> int cxl_cmd_submit(struct cxl_cmd *cmd);
> int cxl_cmd_get_mbox_status(struct cxl_cmd *cmd);
> int cxl_cmd_get_out_size(struct cxl_cmd *cmd);
> +struct cxl_cmd *cxl_cmd_new_identify(struct cxl_memdev *memdev);
> +int cxl_cmd_identify_get_fw_rev(struct cxl_cmd *cmd, char *fw_rev, int fw_len);
> +unsigned long long cxl_cmd_identify_get_partition_align(struct cxl_cmd *cmd);
> +unsigned int cxl_cmd_identify_get_lsa_size(struct cxl_cmd *cmd);
>
> #ifdef __cplusplus
> } /* extern "C" */
> diff --git a/cxl/lib/libcxl.sym b/cxl/lib/libcxl.sym
> index 493429c..d6aa0b2 100644
> --- a/cxl/lib/libcxl.sym
> +++ b/cxl/lib/libcxl.sym
> @@ -39,4 +39,8 @@ global:
> cxl_cmd_submit;
> cxl_cmd_get_mbox_status;
> cxl_cmd_get_out_size;
> + cxl_cmd_new_identify;
> + cxl_cmd_identify_get_fw_rev;
> + cxl_cmd_identify_get_partition_align;
> + cxl_cmd_identify_get_lsa_size;
> } LIBCXL_2;
> --
> 2.29.2
>
_______________________________________________
Linux-nvdimm mailing list -- linux-nvdimm@lists.01.org
To unsubscribe send an email to linux-nvdimm-leave@lists.01.org
next prev parent reply other threads:[~2021-02-22 22:02 UTC|newest]
Thread overview: 20+ messages / expand[flat|nested] mbox.gz Atom feed top
2021-02-19 2:03 [ndctl PATCH v2 00/13] Initial CXL support Vishal Verma
2021-02-19 2:03 ` [ndctl PATCH v2 01/13] cxl: add a cxl utility and libcxl library Vishal Verma
2021-02-22 21:36 ` Ben Widawsky
2021-02-23 19:23 ` Verma, Vishal L
2021-02-19 2:03 ` [ndctl PATCH v2 02/13] cxl: add a local copy of the cxl_mem UAPI header Vishal Verma
2021-02-22 21:41 ` Ben Widawsky
2021-02-19 2:03 ` [ndctl PATCH v2 03/13] libcxl: add support for command query and submission Vishal Verma
2021-02-22 21:55 ` Ben Widawsky
2021-02-19 2:03 ` [ndctl PATCH v2 04/13] libcxl: add support for the 'Identify Device' command Vishal Verma
2021-02-22 22:02 ` Ben Widawsky [this message]
2021-02-19 2:03 ` [ndctl PATCH v2 05/13] test: rename 'ndctl_test' to 'test_ctx' Vishal Verma
2021-02-19 2:03 ` [ndctl PATCH v2 06/13] test: rename 'ndctl_test_*' helpers to 'test_*' Vishal Verma
2021-02-19 2:03 ` [ndctl PATCH v2 07/13] test: introduce a libcxl unit test Vishal Verma
2021-02-22 22:15 ` Ben Widawsky
2021-02-19 2:03 ` [ndctl PATCH v2 08/13] libcxl: add GET_HEALTH_INFO mailbox command and accessors Vishal Verma
2021-02-19 2:03 ` [ndctl PATCH v2 09/13] libcxl: add support for the 'GET_LSA' command Vishal Verma
2021-02-19 2:03 ` [ndctl PATCH v2 10/13] util/hexdump: Add a util helper to print a buffer in hex Vishal Verma
2021-02-19 2:03 ` [ndctl PATCH v2 11/13] test/libcxl: add a test for {set, get}_lsa commands Vishal Verma
2021-02-19 2:03 ` [ndctl PATCH v2 12/13] Documentation/cxl: add library API documentation Vishal Verma
2021-02-19 2:03 ` [ndctl PATCH v2 13/13] test/libcxl: introduce a command size fuzzing test Vishal Verma
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20210222220209.62pvejo6mxhcqqth@intel.com \
--to=ben.widawsky@intel.com \
--cc=linux-cxl@vger.kernel.org \
--cc=linux-nvdimm@lists.01.org \
--cc=vishal.l.verma@intel.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).