From: Jiri Pirko <jiri@resnulli.us>
To: linux-coco@lists.linux.dev
Cc: linux-kernel@vger.kernel.org, linux-api@vger.kernel.org,
x86@kernel.org, kvm@vger.kernel.org, linux-doc@vger.kernel.org,
jgg@ziepe.ca, david.quigley@intel.com, lukas@wunner.de,
ksinyuk@kernel.org, rodrigo.vivi@intel.com,
cedric.xing@intel.com, sameo@meta.com, drdeeglaze@gmail.com,
James.Bottomley@HansenPartnership.com, aik@amd.com,
jpiotrowski@nvidia.com, qinkun@google.com, pgonda@google.com,
jic23@kernel.org, alistair.francis@wdc.com, ankita@nvidia.com,
suzuki.poulose@arm.com, kas@kernel.org,
rick.p.edgecombe@intel.com, elena.reshetova@intel.com,
dave.hansen@linux.intel.com,
sathyanarayanan.kuppuswamy@linux.intel.com, peter.fang@intel.com,
jarkko@kernel.org, zohar@linux.ibm.com, yeoreum.yun@arm.com,
aneesh.kumar@kernel.org, dave.jiang@intel.com,
nik.borisov@suse.com, sergii.dmytruk@3mdeb.com
Subject: [PATCH RFC v2 7/9] tdx-guest: Expose the native attestation service API
Date: Fri, 13 Nov 2026 17:08:36 +0100 [thread overview]
Message-ID: <20261113160838.2512652-8-jiri@resnulli.us> (raw)
In-Reply-To: <20261113160838.2512652-1-jiri@resnulli.us>
From: Jiri Pirko <jiri@nvidia.com>
Factor the Quote and measurement-register operations of the misc, TSM
report and TSM MR interfaces into helpers declared in a driver-internal
header, for an attestation provider built into the driver to share.
Assisted-by: Cursor: GPT-5.6 Sol
Assisted-by: Cursor: Claude Opus 5.5
Signed-off-by: Jiri Pirko <jiri@nvidia.com>
---
RFC->RFCv2:
- kept the helpers inside tdx-guest, in place of a client API and its
header
- dropped the MAINTAINERS lines, which N: tdx already covers
- sized the TSM report outblob to its Quote
- dropped an unreachable return in tdx_do_report()
- dropped the stale kernel client section from tdx-guest.rst
- numbered every enum member
---
drivers/virt/coco/tdx-guest/internal.h | 30 ++++++
drivers/virt/coco/tdx-guest/tdx-guest.c | 130 +++++++++++++++++++-----
2 files changed, 132 insertions(+), 28 deletions(-)
create mode 100644 drivers/virt/coco/tdx-guest/internal.h
diff --git a/drivers/virt/coco/tdx-guest/internal.h b/drivers/virt/coco/tdx-guest/internal.h
new file mode 100644
index 000000000000..d57a8c385aff
--- /dev/null
+++ b/drivers/virt/coco/tdx-guest/internal.h
@@ -0,0 +1,30 @@
+/* SPDX-License-Identifier: GPL-2.0 */
+#ifndef _TDX_GUEST_INTERNAL_H
+#define _TDX_GUEST_INTERNAL_H
+
+#include <crypto/sha2.h>
+#include <linux/types.h>
+
+#define TDX_GUEST_QUOTE_MAX_LEN ((128 * 1024) - 24)
+
+struct tdx_guest_info {
+ u8 mrconfigid[SHA384_DIGEST_SIZE];
+ u8 mrowner[SHA384_DIGEST_SIZE];
+ u8 mrownerconfig[SHA384_DIGEST_SIZE];
+};
+
+enum tdx_guest_mr {
+ TDX_GUEST_MR_MRTD = 0,
+ TDX_GUEST_MR_RTMR0 = 1,
+ TDX_GUEST_MR_RTMR1 = 2,
+ TDX_GUEST_MR_RTMR2 = 3,
+ TDX_GUEST_MR_RTMR3 = 4,
+};
+
+/* @reportdata is TDX_REPORTDATA_LEN bytes, and @out holds TDX_GUEST_QUOTE_MAX_LEN. */
+int tdx_guest_quote_get(const u8 *reportdata, void *out, size_t *out_length);
+int tdx_guest_mr_read(enum tdx_guest_mr mr, u8 value[SHA384_DIGEST_SIZE]);
+int tdx_guest_rtmr_extend(unsigned int rtmr,
+ const u8 value[SHA384_DIGEST_SIZE]);
+
+#endif /* _TDX_GUEST_INTERNAL_H */
diff --git a/drivers/virt/coco/tdx-guest/tdx-guest.c b/drivers/virt/coco/tdx-guest/tdx-guest.c
index 11d741da3b35..c49454ec0b18 100644
--- a/drivers/virt/coco/tdx-guest/tdx-guest.c
+++ b/drivers/virt/coco/tdx-guest/tdx-guest.c
@@ -25,8 +25,11 @@
#include <asm/cpu_device_id.h>
#include <asm/tdx.h>
+#include "internal.h"
+
/* TDREPORT buffer */
static u8 *tdx_report_buf;
+static struct tdx_guest_info tdx_guest_info;
/* Lock to serialize TDG.MR.REPORT and TDG.MR.RTMR.EXTEND TDCALLs */
static DEFINE_MUTEX(mr_lock);
@@ -49,27 +52,32 @@ enum {
TDREPORT_servtd_hash = TDREPORT_rtmr3 + SHA384_DIGEST_SIZE,
};
-static int tdx_do_report(sockptr_t data, sockptr_t tdreport)
+static int __tdx_do_report(sockptr_t data, sockptr_t tdreport)
{
- scoped_cond_guard(mutex_intr, return -EINTR, &mr_lock) {
- u8 *reportdata = tdx_report_buf + TDREPORT_reportdata;
- int ret;
+ u8 *reportdata = tdx_report_buf + TDREPORT_reportdata;
+ int ret;
- if (!sockptr_is_null(data) &&
- copy_from_sockptr(reportdata, data, TDX_REPORTDATA_LEN))
- return -EFAULT;
+ lockdep_assert_held(&mr_lock);
+ if (!sockptr_is_null(data) &&
+ copy_from_sockptr(reportdata, data, TDX_REPORTDATA_LEN))
+ return -EFAULT;
- ret = tdx_mcall_get_report0(reportdata, tdx_report_buf);
- if (WARN_ONCE(ret, "tdx_mcall_get_report0() failed: %d", ret))
- return ret;
+ ret = tdx_mcall_get_report0(reportdata, tdx_report_buf);
+ if (WARN_ONCE(ret, "tdx_mcall_get_report0() failed: %d", ret))
+ return ret;
- if (!sockptr_is_null(tdreport) &&
- copy_to_sockptr(tdreport, tdx_report_buf, TDX_REPORT_LEN))
- return -EFAULT;
- }
+ if (!sockptr_is_null(tdreport) &&
+ copy_to_sockptr(tdreport, tdx_report_buf, TDX_REPORT_LEN))
+ return -EFAULT;
return 0;
}
+static int tdx_do_report(sockptr_t data, sockptr_t tdreport)
+{
+ scoped_cond_guard(mutex_intr, return -EINTR, &mr_lock)
+ return __tdx_do_report(data, tdreport);
+}
+
static int tdx_do_extend(u8 mr_ind, const u8 *data)
{
scoped_cond_guard(mutex_intr, return -EINTR, &mr_lock) {
@@ -90,6 +98,34 @@ static int tdx_do_extend(u8 mr_ind, const u8 *data)
return 0;
}
+int tdx_guest_mr_read(enum tdx_guest_mr mr, u8 value[SHA384_DIGEST_SIZE])
+{
+ static const size_t offsets[] = {
+ [TDX_GUEST_MR_MRTD] = TDREPORT_mrtd,
+ [TDX_GUEST_MR_RTMR0] = TDREPORT_rtmr0,
+ [TDX_GUEST_MR_RTMR1] = TDREPORT_rtmr1,
+ [TDX_GUEST_MR_RTMR2] = TDREPORT_rtmr2,
+ [TDX_GUEST_MR_RTMR3] = TDREPORT_rtmr3,
+ };
+ int ret;
+
+ scoped_cond_guard(mutex_intr, return -EINTR, &mr_lock) {
+ ret = __tdx_do_report(KERNEL_SOCKPTR(NULL),
+ KERNEL_SOCKPTR(NULL));
+ if (ret)
+ return ret;
+ memcpy(value, tdx_report_buf + offsets[mr],
+ SHA384_DIGEST_SIZE);
+ }
+ return 0;
+}
+
+int tdx_guest_rtmr_extend(unsigned int rtmr,
+ const u8 value[SHA384_DIGEST_SIZE])
+{
+ return tdx_do_extend(rtmr, value);
+}
+
#define TDX_MR_(r) .mr_value = (void *)TDREPORT_##r, TSM_MR_(r, SHA384)
static struct tsm_measurement_register tdx_mrs[] = {
{ TDX_MR_(rtmr0) | TSM_MR_F_RTMR },
@@ -135,6 +171,12 @@ static const struct attribute_group *tdx_mr_init(void)
rc = tdx_mr_refresh(&tdx_measurements);
if (rc)
return ERR_PTR(rc);
+ memcpy(tdx_guest_info.mrconfigid,
+ buf + TDREPORT_mrconfigid, SHA384_DIGEST_SIZE);
+ memcpy(tdx_guest_info.mrowner,
+ buf + TDREPORT_mrowner, SHA384_DIGEST_SIZE);
+ memcpy(tdx_guest_info.mrownerconfig,
+ buf + TDREPORT_mrownerconfig, SHA384_DIGEST_SIZE);
/*
* @mr_value was initialized with the offset only, while the base
@@ -189,6 +231,9 @@ struct tdx_quote_buf {
u8 data[];
};
+static_assert(TDX_GUEST_QUOTE_MAX_LEN ==
+ TDX_DEFAULT_QUOTE_SIZE - sizeof(struct tdx_quote_buf));
+
static struct tdx_quote_buf *quote_buf;
/* Lock to streamline quote requests */
@@ -285,15 +330,18 @@ static int wait_for_quote_completion(struct tdx_quote_buf *buf, u32 timeout)
return (i == timeout) ? -ETIMEDOUT : 0;
}
-static int tdx_report_new_locked(struct tsm_report *report)
+/* Leaves the Quote in quote_buf; copy it out before dropping quote_lock. */
+static int __tdx_guest_quote_get(const u8 *reportdata, size_t length,
+ size_t *out_length)
{
- u8 *buf;
- struct tsm_report_desc *desc = &report->desc;
size_t quote_buf_size = get_quote_buf_size();
u32 out_len;
int ret;
u64 err;
+ lockdep_assert_held("e_lock);
+ if (!reportdata || length != TDX_REPORTDATA_LEN)
+ return -EINVAL;
/*
* If the previous request is timedout or interrupted, and the
* Quote buf status is still in GET_QUOTE_IN_FLIGHT (owned by
@@ -302,16 +350,13 @@ static int tdx_report_new_locked(struct tsm_report *report)
if (quote_buf->status == GET_QUOTE_IN_FLIGHT)
return -EBUSY;
- if (desc->inblob_len != TDX_REPORTDATA_LEN)
- return -EINVAL;
-
memset(quote_buf, 0, quote_buf_size);
/* Update Quote buffer header */
quote_buf->version = GET_QUOTE_CMD_VER;
quote_buf->in_len = TDX_REPORT_LEN;
- ret = tdx_do_report(KERNEL_SOCKPTR(desc->inblob),
+ ret = tdx_do_report(KERNEL_SOCKPTR((void *)reportdata),
KERNEL_SOCKPTR(quote_buf->data));
if (ret)
return ret;
@@ -337,13 +382,7 @@ static int tdx_report_new_locked(struct tsm_report *report)
if (struct_size(quote_buf, data, out_len) > quote_buf_size)
return -EFBIG;
-
- buf = kvmemdup(quote_buf->data, out_len, GFP_KERNEL);
- if (!buf)
- return -ENOMEM;
-
- report->outblob = buf;
- report->outblob_len = out_len;
+ *out_length = out_len;
/*
* TODO: parse the PEM-formatted cert chain out of the quote buffer when
@@ -353,6 +392,41 @@ static int tdx_report_new_locked(struct tsm_report *report)
return ret;
}
+int tdx_guest_quote_get(const u8 *reportdata, void *out, size_t *out_length)
+{
+ int ret;
+
+ scoped_cond_guard(mutex_intr, return -EINTR, "e_lock) {
+ ret = __tdx_guest_quote_get(reportdata, TDX_REPORTDATA_LEN,
+ out_length);
+ if (ret)
+ return ret;
+ /* The TDX module may allow a Quote longer than @out. */
+ if (*out_length > TDX_GUEST_QUOTE_MAX_LEN)
+ return -EFBIG;
+ memcpy(out, quote_buf->data, *out_length);
+ }
+ return 0;
+}
+
+static int tdx_report_new_locked(struct tsm_report *report)
+{
+ struct tsm_report_desc *desc = &report->desc;
+ size_t length;
+ void *buf;
+ int ret;
+
+ ret = __tdx_guest_quote_get(desc->inblob, desc->inblob_len, &length);
+ if (ret)
+ return ret;
+ buf = kvmemdup(quote_buf->data, length, GFP_KERNEL);
+ if (!buf)
+ return -ENOMEM;
+ report->outblob = buf;
+ report->outblob_len = length;
+ return 0;
+}
+
static int tdx_report_new(struct tsm_report *report, void *unused)
{
scoped_cond_guard(mutex_intr, return -EINTR, "e_lock)
--
2.56.0
next prev parent reply other threads:[~2026-11-13 16:09 UTC|newest]
Thread overview: 10+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-11-13 16:08 [PATCH RFC v2 0/9] attestation: Add a common subsystem and TDX support Jiri Pirko
2026-11-13 16:08 ` [PATCH RFC v2 1/9] attestation: Add the base family specification and generated files Jiri Pirko
2026-11-13 16:08 ` [PATCH RFC v2 2/9] Documentation: attestation: Add userspace ABI Jiri Pirko
2026-11-13 16:08 ` [PATCH RFC v2 3/9] attestation: Prepare provider and instance core Jiri Pirko
2026-11-13 16:08 ` [PATCH RFC v2 4/9] attestation: Prepare measurement registers Jiri Pirko
2026-11-13 16:08 ` [PATCH RFC v2 5/9] attestation: Add CTLV operation handling Jiri Pirko
2026-11-13 16:08 ` [PATCH RFC v2 6/9] Documentation: attestation: Describe how to write a provider Jiri Pirko
2026-11-13 16:08 ` Jiri Pirko [this message]
2026-11-13 16:08 ` [PATCH RFC v2 8/9] attestation: Add the TDX family specification and generated files Jiri Pirko
2026-11-13 16:08 ` [PATCH RFC v2 9/9] attestation: Add the TDX family implementation Jiri Pirko
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=20261113160838.2512652-8-jiri@resnulli.us \
--to=jiri@resnulli.us \
--cc=James.Bottomley@HansenPartnership.com \
--cc=aik@amd.com \
--cc=alistair.francis@wdc.com \
--cc=aneesh.kumar@kernel.org \
--cc=ankita@nvidia.com \
--cc=cedric.xing@intel.com \
--cc=dave.hansen@linux.intel.com \
--cc=dave.jiang@intel.com \
--cc=david.quigley@intel.com \
--cc=drdeeglaze@gmail.com \
--cc=elena.reshetova@intel.com \
--cc=jarkko@kernel.org \
--cc=jgg@ziepe.ca \
--cc=jic23@kernel.org \
--cc=jpiotrowski@nvidia.com \
--cc=kas@kernel.org \
--cc=ksinyuk@kernel.org \
--cc=kvm@vger.kernel.org \
--cc=linux-api@vger.kernel.org \
--cc=linux-coco@lists.linux.dev \
--cc=linux-doc@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=lukas@wunner.de \
--cc=nik.borisov@suse.com \
--cc=peter.fang@intel.com \
--cc=pgonda@google.com \
--cc=qinkun@google.com \
--cc=rick.p.edgecombe@intel.com \
--cc=rodrigo.vivi@intel.com \
--cc=sameo@meta.com \
--cc=sathyanarayanan.kuppuswamy@linux.intel.com \
--cc=sergii.dmytruk@3mdeb.com \
--cc=suzuki.poulose@arm.com \
--cc=x86@kernel.org \
--cc=yeoreum.yun@arm.com \
--cc=zohar@linux.ibm.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