From: Huang Rui <ray.huang@amd.com>
To: Akihiko Odaki <akihiko.odaki@daynix.com>
Cc: "Gerd Hoffmann" <kraxel@redhat.com>,
"Michael S . Tsirkin" <mst@redhat.com>,
"Stefano Stabellini" <sstabellini@kernel.org>,
"Anthony PERARD" <anthony.perard@citrix.com>,
"Antonio Caggiano" <antonio.caggiano@collabora.com>,
"Dr . David Alan Gilbert" <dgilbert@redhat.com>,
"Robert Beckett" <bob.beckett@collabora.com>,
"Dmitry Osipenko" <dmitry.osipenko@collabora.com>,
"Alex Bennée" <alex.bennee@linaro.org>,
"qemu-devel@nongnu.org" <qemu-devel@nongnu.org>,
"xen-devel@lists.xenproject.org" <xen-devel@lists.xenproject.org>,
"Gurchetan Singh" <gurchetansingh@chromium.org>,
"ernunes@redhat.com" <ernunes@redhat.com>,
"Philippe Mathieu-Daudé" <philmd@linaro.org>,
"Alyssa Ross" <hi@alyssa.is>,
"Roger Pau Monné" <roger.pau@citrix.com>,
"Deucher, Alexander" <Alexander.Deucher@amd.com>,
"Koenig, Christian" <Christian.Koenig@amd.com>,
"Ragiadakou, Xenia" <Xenia.Ragiadakou@amd.com>,
"Pelloux-Prayer,
Pierre-Eric" <Pierre-eric.Pelloux-prayer@amd.com>,
"Huang, Honglei1" <Honglei1.Huang@amd.com>,
"Zhang, Julia" <Julia.Zhang@amd.com>,
"Chen, Jiqian" <Jiqian.Chen@amd.com>
Subject: Re: [QEMU PATCH v4 09/13] virtio-gpu: Handle resource blob commands
Date: Wed, 6 Sep 2023 15:56:12 +0800 [thread overview]
Message-ID: <ZPgwnMR5YM9rFLtK@amd.com> (raw)
In-Reply-To: <9d883490-3c82-4016-a290-6570f682908a@daynix.com>
On Wed, Sep 06, 2023 at 11:39:09AM +0800, Akihiko Odaki wrote:
> On 2023/09/06 12:09, Huang Rui wrote:
> > On Tue, Sep 05, 2023 at 05:20:43PM +0800, Akihiko Odaki wrote:
> >> On 2023/09/05 18:08, Huang Rui wrote:
> >>> On Thu, Aug 31, 2023 at 06:24:32PM +0800, Akihiko Odaki wrote:
> >>>> On 2023/08/31 18:32, Huang Rui wrote:
> >>>>> From: Antonio Caggiano <antonio.caggiano@collabora.com>
> >>>>>
> >>>>> Support BLOB resources creation, mapping and unmapping by calling the
> >>>>> new stable virglrenderer 0.10 interface. Only enabled when available and
> >>>>> via the blob config. E.g. -device virtio-vga-gl,blob=true
> >>>>>
> >>>>> Signed-off-by: Antonio Caggiano <antonio.caggiano@collabora.com>
> >>>>> Signed-off-by: Dmitry Osipenko <dmitry.osipenko@collabora.com>
> >>>>> Signed-off-by: Xenia Ragiadakou <xenia.ragiadakou@amd.com>
> >>>>> Signed-off-by: Huang Rui <ray.huang@amd.com>
> >>>>> ---
> >>>>>
> >>>>> v1->v2:
> >>>>> - Remove unused #include "hw/virtio/virtio-iommu.h"
> >>>>>
> >>>>> - Add a local function, called virgl_resource_destroy(), that is used
> >>>>> to release a vgpu resource on error paths and in resource_unref.
> >>>>>
> >>>>> - Remove virtio_gpu_virgl_resource_unmap from virtio_gpu_cleanup_mapping(),
> >>>>> since this function won't be called on blob resources and also because
> >>>>> blob resources are unmapped via virgl_cmd_resource_unmap_blob().
> >>>>>
> >>>>> - In virgl_cmd_resource_create_blob(), do proper cleanup in error paths
> >>>>> and move QTAILQ_INSERT_HEAD(&g->reslist, res, next) after the resource
> >>>>> has been fully initialized.
> >>>>>
> >>>>> - Memory region has a different life-cycle from virtio gpu resources
> >>>>> i.e. cannot be released synchronously along with the vgpu resource.
> >>>>> So, here the field "region" was changed to a pointer that will be
> >>>>> released automatically once the memory region is unparented and all
> >>>>> of its references have been released.
> >>>>> Also, since the pointer can be used to indicate whether the blob
> >>>>> is mapped, the explicit field "mapped" was removed.
> >>>>>
> >>>>> - In virgl_cmd_resource_map_blob(), add check on the value of
> >>>>> res->region, to prevent beeing called twice on the same resource.
> >>>>>
> >>>>> - Remove direct references to parent_obj.
> >>>>>
> >>>>> - Separate declarations from code.
> >>>>>
> >>>>> hw/display/virtio-gpu-virgl.c | 213 +++++++++++++++++++++++++++++++++
> >>>>> hw/display/virtio-gpu.c | 4 +-
> >>>>> include/hw/virtio/virtio-gpu.h | 5 +
> >>>>> meson.build | 4 +
> >>>>> 4 files changed, 225 insertions(+), 1 deletion(-)
> >>>>>
> >>>>> diff --git a/hw/display/virtio-gpu-virgl.c b/hw/display/virtio-gpu-virgl.c
> >>>>> index 312953ec16..17b634d4ee 100644
> >>>>> --- a/hw/display/virtio-gpu-virgl.c
> >>>>> +++ b/hw/display/virtio-gpu-virgl.c
> >>>>> @@ -17,6 +17,7 @@
> >>>>> #include "trace.h"
> >>>>> #include "hw/virtio/virtio.h"
> >>>>> #include "hw/virtio/virtio-gpu.h"
> >>>>> +#include "hw/virtio/virtio-gpu-bswap.h"
> >>>>>
> >>>>> #include "ui/egl-helpers.h"
> >>>>>
> >>>>> @@ -78,9 +79,24 @@ static void virgl_cmd_create_resource_3d(VirtIOGPU *g,
> >>>>> virgl_renderer_resource_create(&args, NULL, 0);
> >>>>> }
> >>>>>
> >>>>> +static void virgl_resource_destroy(VirtIOGPU *g,
> >>>>> + struct virtio_gpu_simple_resource *res)
> >>>>> +{
> >>>>> + if (!res)
> >>>>> + return;
> >>>>> +
> >>>>> + QTAILQ_REMOVE(&g->reslist, res, next);
> >>>>> +
> >>>>> + virtio_gpu_cleanup_mapping_iov(g, res->iov, res->iov_cnt);
> >>>>> + g_free(res->addrs);
> >>>>> +
> >>>>> + g_free(res);
> >>>>> +}
> >>>>> +
> >>>>> static void virgl_cmd_resource_unref(VirtIOGPU *g,
> >>>>> struct virtio_gpu_ctrl_command *cmd)
> >>>>> {
> >>>>> + struct virtio_gpu_simple_resource *res;
> >>>>> struct virtio_gpu_resource_unref unref;
> >>>>> struct iovec *res_iovs = NULL;
> >>>>> int num_iovs = 0;
> >>>>> @@ -88,13 +104,22 @@ static void virgl_cmd_resource_unref(VirtIOGPU *g,
> >>>>> VIRTIO_GPU_FILL_CMD(unref);
> >>>>> trace_virtio_gpu_cmd_res_unref(unref.resource_id);
> >>>>>
> >>>>> + res = virtio_gpu_find_resource(g, unref.resource_id);
> >>>>> +
> >>>>> virgl_renderer_resource_detach_iov(unref.resource_id,
> >>>>> &res_iovs,
> >>>>> &num_iovs);
> >>>>> if (res_iovs != NULL && num_iovs != 0) {
> >>>>> virtio_gpu_cleanup_mapping_iov(g, res_iovs, num_iovs);
> >>>>> + if (res) {
> >>>>> + res->iov = NULL;
> >>>>> + res->iov_cnt = 0;
> >>>>> + }
> >>>>> }
> >>>>> +
> >>>>> virgl_renderer_resource_unref(unref.resource_id);
> >>>>> +
> >>>>> + virgl_resource_destroy(g, res);
> >>>>> }
> >>>>>
> >>>>> static void virgl_cmd_context_create(VirtIOGPU *g,
> >>>>> @@ -426,6 +451,183 @@ static void virgl_cmd_get_capset(VirtIOGPU *g,
> >>>>> g_free(resp);
> >>>>> }
> >>>>>
> >>>>> +#ifdef HAVE_VIRGL_RESOURCE_BLOB
> >>>>> +
> >>>>> +static void virgl_cmd_resource_create_blob(VirtIOGPU *g,
> >>>>> + struct virtio_gpu_ctrl_command *cmd)
> >>>>> +{
> >>>>> + struct virtio_gpu_simple_resource *res;
> >>>>> + struct virtio_gpu_resource_create_blob cblob;
> >>>>> + struct virgl_renderer_resource_create_blob_args virgl_args = { 0 };
> >>>>> + int ret;
> >>>>> +
> >>>>> + VIRTIO_GPU_FILL_CMD(cblob);
> >>>>> + virtio_gpu_create_blob_bswap(&cblob);
> >>>>> + trace_virtio_gpu_cmd_res_create_blob(cblob.resource_id, cblob.size);
> >>>>> +
> >>>>> + if (cblob.resource_id == 0) {
> >>>>> + qemu_log_mask(LOG_GUEST_ERROR, "%s: resource id 0 is not allowed\n",
> >>>>> + __func__);
> >>>>> + cmd->error = VIRTIO_GPU_RESP_ERR_INVALID_RESOURCE_ID;
> >>>>> + return;
> >>>>> + }
> >>>>> +
> >>>>> + res = virtio_gpu_find_resource(g, cblob.resource_id);
> >>>>> + if (res) {
> >>>>> + qemu_log_mask(LOG_GUEST_ERROR, "%s: resource already exists %d\n",
> >>>>> + __func__, cblob.resource_id);
> >>>>> + cmd->error = VIRTIO_GPU_RESP_ERR_INVALID_RESOURCE_ID;
> >>>>> + return;
> >>>>> + }
> >>>>> +
> >>>>> + res = g_new0(struct virtio_gpu_simple_resource, 1);
> >>>>> + if (!res) {
> >>>>> + cmd->error = VIRTIO_GPU_RESP_ERR_OUT_OF_MEMORY;
> >>>>> + return;
> >>>>> + }
> >>>>> +
> >>>>> + res->resource_id = cblob.resource_id;
> >>>>> + res->blob_size = cblob.size;
> >>>>> +
> >>>>> + if (cblob.blob_mem != VIRTIO_GPU_BLOB_MEM_HOST3D) {
> >>>>> + ret = virtio_gpu_create_mapping_iov(g, cblob.nr_entries, sizeof(cblob),
> >>>>> + cmd, &res->addrs, &res->iov,
> >>>>> + &res->iov_cnt);
> >>>>> + if (!ret) {
> >>>>> + g_free(res);
> >>>>> + cmd->error = VIRTIO_GPU_RESP_ERR_UNSPEC;
> >>>>> + return;
> >>>>> + }
> >>>>> + }
> >>>>> +
> >>>>> + QTAILQ_INSERT_HEAD(&g->reslist, res, next);
> >>>>> +
> >>>>> + virgl_args.res_handle = cblob.resource_id;
> >>>>> + virgl_args.ctx_id = cblob.hdr.ctx_id;
> >>>>> + virgl_args.blob_mem = cblob.blob_mem;
> >>>>> + virgl_args.blob_id = cblob.blob_id;
> >>>>> + virgl_args.blob_flags = cblob.blob_flags;
> >>>>> + virgl_args.size = cblob.size;
> >>>>> + virgl_args.iovecs = res->iov;
> >>>>> + virgl_args.num_iovs = res->iov_cnt;
> >>>>> +
> >>>>> + ret = virgl_renderer_resource_create_blob(&virgl_args);
> >>>>> + if (ret) {
> >>>>> + virgl_resource_destroy(g, res);
> >>>>> + qemu_log_mask(LOG_GUEST_ERROR, "%s: virgl blob create error: %s\n",
> >>>>> + __func__, strerror(-ret));
> >>>>> + cmd->error = VIRTIO_GPU_RESP_ERR_UNSPEC;
> >>>>> + }
> >>>>> +}
> >>>>> +
> >>>>> +static void virgl_cmd_resource_map_blob(VirtIOGPU *g,
> >>>>> + struct virtio_gpu_ctrl_command *cmd)
> >>>>> +{
> >>>>> + struct virtio_gpu_simple_resource *res;
> >>>>> + struct virtio_gpu_resource_map_blob mblob;
> >>>>> + int ret;
> >>>>> + void *data;
> >>>>> + uint64_t size;
> >>>>> + struct virtio_gpu_resp_map_info resp;
> >>>>> + VirtIOGPUBase *b = VIRTIO_GPU_BASE(g);
> >>>>> +
> >>>>> + VIRTIO_GPU_FILL_CMD(mblob);
> >>>>> + virtio_gpu_map_blob_bswap(&mblob);
> >>>>> +
> >>>>> + if (mblob.resource_id == 0) {
> >>>>> + qemu_log_mask(LOG_GUEST_ERROR, "%s: resource id 0 is not allowed\n",
> >>>>> + __func__);
> >>>>> + cmd->error = VIRTIO_GPU_RESP_ERR_INVALID_RESOURCE_ID;
> >>>>> + return;
> >>>>> + }
> >>>>> +
> >>>>> + res = virtio_gpu_find_resource(g, mblob.resource_id);
> >>>>> + if (!res) {
> >>>>> + qemu_log_mask(LOG_GUEST_ERROR, "%s: resource does not exist %d\n",
> >>>>> + __func__, mblob.resource_id);
> >>>>> + cmd->error = VIRTIO_GPU_RESP_ERR_INVALID_RESOURCE_ID;
> >>>>> + return;
> >>>>> + }
> >>>>> + if (res->region) {
> >>>>> + qemu_log_mask(LOG_GUEST_ERROR, "%s: resource already mapped %d\n",
> >>>>> + __func__, mblob.resource_id);
> >>>>> + cmd->error = VIRTIO_GPU_RESP_ERR_INVALID_RESOURCE_ID;
> >>>>> + return;
> >>>>> + }
> >>>>> +
> >>>>> + ret = virgl_renderer_resource_map(res->resource_id, &data, &size);
> >>>>> + if (ret) {
> >>>>> + qemu_log_mask(LOG_GUEST_ERROR, "%s: resource map error: %s\n",
> >>>>> + __func__, strerror(-ret));
> >>>>> + cmd->error = VIRTIO_GPU_RESP_ERR_INVALID_RESOURCE_ID;
> >>>>> + return;
> >>>>> + }
> >>>>> +
> >>>>> + res->region = g_new0(MemoryRegion, 1);
> >>>>> + if (!res->region) {
> >>>>> + virgl_renderer_resource_unmap(res->resource_id);
> >>>>> + cmd->error = VIRTIO_GPU_RESP_ERR_OUT_OF_MEMORY;
> >>>>> + return;
> >>>>> + }
> >>>>> + memory_region_init_ram_device_ptr(res->region, OBJECT(g), NULL, size, data);
> >>>>
> >>>> I think memory_region_init_ram_ptr() should be used instead.
> >>>
> >>> Would you mind to explain the reason?
> >>
> >> The documentation comment of memory_region_init_ram_device_ptr() says:
> >> > A RAM device represents a mapping to a physical device, such as to a
> >> > PCI MMIO BAR of an vfio-pci assigned device. The memory region may be
> >> > mapped into the VM address space and access to the region will modify
> >> > memory directly. However, the memory region should not be included in
> >> > a memory dump (device may not be enabled/mapped at the time of the
> >> > dump), and operations incompatible with manipulating MMIO should be
> >> > avoided. Replaces skip_dump flag.
> >>
> >> In my understanding it's not MMIO so memory_region_init_ram_ptr() should
> >> be used instead.
> >>
> >
> > It actually maybe the video memory (mmio) or system memory here. :-)
> >
> > We will get the host memory for blob from host with
> > virgl_renderer_resource_map() in virglrenderer. In virglrenderer, there are two
> > types of VIRGL_RESOURCE_FD_DMABUF and VIRGL_RESOURCE_FD_SHM to indicate the
> > memory types. The shmem is the system memory that won't need GPU
> > accessible, and dmabuf is the memory that required GPU accessible. Host
> > kernel amdgpu driver will register dma-buf to export the resource buffer
> > for sharing, and here, it may have video memory that exposed by amdgpu pcie
> > bar0 in the dma-buf buffers. And we also have system memory(gtt) that can
> > be mapped as gpu page tables for gpu accessible.
> >
> > 07:00.0 VGA compatible controller: Advanced Micro Devices, Inc. [AMD/ATI] Renoir (rev c1) (prog-if 00 [VGA controller])
> > Subsystem: Advanced Micro Devices, Inc. [AMD/ATI] Renoir
> > Flags: bus master, fast devsel, latency 0, IRQ 56
> > Memory at fcc0000000 (64-bit, prefetchable) [size=256M]
> > Memory at fcd0000000 (64-bit, prefetchable) [size=2M]
> > I/O ports at 1000 [size=256]
> > Memory at d0400000 (32-bit, non-prefetchable) [size=512K]
> > Capabilities: <access denied>
> > Kernel driver in use: amdgpu
> > Kernel modules: amdgpu
>
> In my understanding it is not relevant if the memory is backed by device
> or not. Here MMIO means memory-mapping I/O registers that has
> side-effects during accesses. Reading such a register may acknowledge an
> interrupt for example and the unit of writes may also matter.
> memory_region_init_ram_device_ptr() ensures no supurious memory read
> will not happen and word accesses are preserved.
>
> They do not matter for video memory even if it lies in a separate device
> memory. In this sense the name "memory_region_init_ram_device_ptr" is
> somewhat misnomer.
>
OK. Thanks for the clarification.
After traced the code, if memory_region_init_ram_device_ptr(), it will use
memory_region_dispatch_write() to call into memory_region_ram_device_write()
which registered as ram_device_mem_ops to write ram_block->host with offset
dword by dword. And if we use memory_region_init_ram_ptr(), the
flatview_write_continue() will use memmove() to write buf into ramblock while
we write the blob memory. May I know whether you mean the "memmove" may have an
interrupt or supurious memory access?
} else if (!memory_access_is_direct(mr, true)) {
release_lock |= prepare_mmio_access(mr);
l = memory_access_size(mr, l, addr1);
/* XXX: could force current_cpu to NULL to avoid
potential bugs */
val = ldn_he_p(buf, l);
result |= memory_region_dispatch_write(mr, addr1, val,
size_memop(l), attrs);
} else {
/* RAM case */
ram_ptr = qemu_ram_ptr_length(mr->ram_block, addr1, &l, false);
memmove(ram_ptr, buf, l);
invalidate_and_set_dirty(mr, addr1, l);
}
Thanks,
Ray
next prev parent reply other threads:[~2023-09-06 7:57 UTC|newest]
Thread overview: 51+ messages / expand[flat|nested] mbox.gz Atom feed top
2023-08-31 9:32 [QEMU PATCH v4 00/13] Support blob memory and venus on qemu Huang Rui
2023-08-31 9:32 ` [QEMU PATCH v4 01/13] virtio: Add shared memory capability Huang Rui
2023-08-31 9:32 ` [QEMU PATCH v4 02/13] virtio-gpu: CONTEXT_INIT feature Huang Rui
2023-08-31 9:32 ` [QEMU PATCH v4 03/13] virtio-gpu: hostmem Huang Rui
2023-08-31 9:32 ` [QEMU PATCH v4 04/13] virtio-gpu: blob prep Huang Rui
2023-08-31 9:32 ` [QEMU PATCH v4 05/13] virtio-gpu: Support context init feature with virglrenderer Huang Rui
2023-08-31 9:41 ` Philippe Mathieu-Daudé
2023-08-31 9:32 ` [QEMU PATCH v4 06/13] virtio-gpu: Configure context init for virglrenderer Huang Rui
2023-08-31 9:39 ` Philippe Mathieu-Daudé
2023-09-04 6:45 ` Huang Rui via
2023-08-31 9:32 ` [QEMU PATCH v4 07/13] softmmu/memory: enable automatic deallocation of memory regions Huang Rui
2023-08-31 10:10 ` Akihiko Odaki
2023-09-05 9:07 ` Huang Rui
2023-09-05 9:17 ` Akihiko Odaki
2023-09-05 13:29 ` Huang Rui
2023-08-31 9:32 ` [QEMU PATCH v4 08/13] virtio-gpu: Don't require udmabuf when blobs and virgl are enabled Huang Rui
2023-08-31 9:32 ` [QEMU PATCH v4 09/13] virtio-gpu: Handle resource blob commands Huang Rui
2023-08-31 10:24 ` Akihiko Odaki
2023-09-05 9:08 ` Huang Rui
2023-09-05 9:20 ` Akihiko Odaki
2023-09-06 3:09 ` Huang Rui
2023-09-06 3:39 ` Akihiko Odaki
2023-09-06 7:56 ` Huang Rui [this message]
2023-09-06 14:16 ` Akihiko Odaki
2023-08-31 9:32 ` [QEMU PATCH v4 10/13] virtio-gpu: Resource UUID Huang Rui
2023-08-31 10:36 ` Akihiko Odaki
2023-09-09 9:09 ` Huang Rui
2023-09-10 4:21 ` Akihiko Odaki
2023-09-13 7:55 ` Albert Esteve
2023-09-13 10:34 ` Akihiko Odaki
2023-09-13 11:34 ` Albert Esteve
2023-09-13 12:22 ` Akihiko Odaki
2023-09-13 12:58 ` Albert Esteve
2023-09-13 13:43 ` Akihiko Odaki
2023-09-13 14:18 ` Albert Esteve
2023-09-13 14:27 ` Albert Esteve
2023-09-14 7:17 ` Akihiko Odaki
2023-09-14 8:29 ` Albert Esteve
2023-09-14 16:55 ` Akihiko Odaki
2023-09-15 9:56 ` Albert Esteve
2023-08-31 9:32 ` [QEMU PATCH v4 11/13] virtio-gpu: Support Venus capset Huang Rui
2023-08-31 10:43 ` Akihiko Odaki
2023-09-09 9:29 ` Huang Rui
2023-09-10 4:32 ` Akihiko Odaki
2023-08-31 9:32 ` [QEMU PATCH v4 12/13] virtio-gpu: Initialize Venus Huang Rui
2023-08-31 10:40 ` Antonio Caggiano
2023-08-31 15:51 ` Dmitry Osipenko
2023-09-09 10:53 ` Huang Rui via
2023-09-12 13:44 ` Dmitry Osipenko
2023-09-09 10:52 ` Huang Rui
2023-08-31 9:32 ` [QEMU PATCH v4 13/13] virtio-gpu: Enable virglrenderer render server flag for venus Huang Rui
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=ZPgwnMR5YM9rFLtK@amd.com \
--to=ray.huang@amd.com \
--cc=Alexander.Deucher@amd.com \
--cc=Christian.Koenig@amd.com \
--cc=Honglei1.Huang@amd.com \
--cc=Jiqian.Chen@amd.com \
--cc=Julia.Zhang@amd.com \
--cc=Pierre-eric.Pelloux-prayer@amd.com \
--cc=Xenia.Ragiadakou@amd.com \
--cc=akihiko.odaki@daynix.com \
--cc=alex.bennee@linaro.org \
--cc=anthony.perard@citrix.com \
--cc=antonio.caggiano@collabora.com \
--cc=bob.beckett@collabora.com \
--cc=dgilbert@redhat.com \
--cc=dmitry.osipenko@collabora.com \
--cc=ernunes@redhat.com \
--cc=gurchetansingh@chromium.org \
--cc=hi@alyssa.is \
--cc=kraxel@redhat.com \
--cc=mst@redhat.com \
--cc=philmd@linaro.org \
--cc=qemu-devel@nongnu.org \
--cc=roger.pau@citrix.com \
--cc=sstabellini@kernel.org \
--cc=xen-devel@lists.xenproject.org \
/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).