From nobody Tue Feb 10 14:49:47 2026 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of _spf.google.com designates 209.85.128.42 as permitted sender) client-ip=209.85.128.42; envelope-from=philippe.mathieu.daude@gmail.com; helo=mail-wm1-f42.google.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of _spf.google.com designates 209.85.128.42 as permitted sender) smtp.mailfrom=philippe.mathieu.daude@gmail.com; dmarc=fail(p=quarantine dis=quarantine) header.from=amsat.org ARC-Seal: i=1; a=rsa-sha256; t=1642507406; cv=none; d=zohomail.com; s=zohoarc; b=KsxcL4DNjgGiwZkE3wVtC8tzoKfcDlKf9yjAUS9CK8qrjBgc9XYRqx8g+nAa/zTlAfA9OU6kaWFnUAmQdZ+Xv6jEJfnHM86jtoecroowg2NwBR+kaLUqRNWeBknInHnb7jxfyF7o8eEc1OBvqPaJ5PpMpYqRIomL6JwCRHL2Bc8= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1642507406; h=Content-Type:Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:MIME-Version:Message-ID:References:Sender:Subject:To; bh=xqRINyUHKRPM2UFVgERzZu4xOCjYsVl6rEoXt0ggBys=; b=LCNKQKXhEHpvkPsLWnCLJzOwAW2LY2X86LW0ZduT8wy/aQUVeJNokqVZupPJKs/BDhFdGzJgnNHX4rg58998f2xaNFsfP+yFMw9QNerT5qWFjtHgQC5l8nN6ME7RWtNoHRgYiUEPm5mOVnsEGRIZPt28m0l5qSAUz6BCVde41SY= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of _spf.google.com designates 209.85.128.42 as permitted sender) smtp.mailfrom=philippe.mathieu.daude@gmail.com; dmarc=fail header.from= (p=quarantine dis=quarantine) Received: from mail-wm1-f42.google.com (mail-wm1-f42.google.com [209.85.128.42]) by mx.zohomail.com with SMTPS id 1642507406093459.1220723083195; Tue, 18 Jan 2022 04:03:26 -0800 (PST) Received: by mail-wm1-f42.google.com with SMTP id c66so27131313wma.5 for ; Tue, 18 Jan 2022 04:03:25 -0800 (PST) Return-Path: Return-Path: Received: from nuc.. (154.red-83-50-83.dynamicip.rima-tde.net. [83.50.83.154]) by smtp.gmail.com with ESMTPSA id z7sm19180054wrm.117.2022.01.18.04.03.23 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 18 Jan 2022 04:03:24 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=sender:from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=xqRINyUHKRPM2UFVgERzZu4xOCjYsVl6rEoXt0ggBys=; b=fzXVnAMh6yrb/0oN6kN5dwc5bPmUMEDcgH6qZmPDNnW+A0jL3NSWCGsQnXzJIssAdE nD6r6TGngrcVXEz0ttKpTjTJyQRZ8ddqngUDRkjCLSaeHtESDGjME+dyLbdg1Oq/QJ40 hFwuFURjo35G7IlnMTUoV1xNgndvJHwSq2j07jAJpVoFQGxisXyFRG/SlaPD6Ni2qD98 oCwyP/Sz9YC7JMkPcIu+izboleiSpHmKrnco8Dy7o52oZNz5KIjha8UFkaEytcZ8kq8W qCEZgD9H77CfYoZlpLuFX9wRwQzWeGlk6BxH0WvjZGGcRk6I7ZsegcB1ddCaMgnQkzkQ s+og== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:sender:from:to:cc:subject:date:message-id :in-reply-to:references:mime-version:content-transfer-encoding; bh=xqRINyUHKRPM2UFVgERzZu4xOCjYsVl6rEoXt0ggBys=; b=WIuhOCVx9/EznIF3/p3AgUbAMZFX637OvVupqBn52h4bCvooWH8N/YHmTAMH51LGmi z1uQKWu3PuxYWrAZexLDBSbvUTmt0nMKW6hDW1ZCubJWzGXDas0Xwe9O6+7IdhCh1XWG wmmMACHbXUmMQn8E7DtQdUkq4Lo/di4ben0buL53Xc6/sVmD7l+RZjVqWXBwF1xDuz+O +EEOibpboRWCDzUaeSQcvPooCZbv8ex9OnhvSzEzZ2RiK8JAArh/2MdD6pY1ac7p7eMh EDnfqx8PGo1Kmq4A61a3cWqO026GhK/amutdbQ7Dg0L5JF+FnVFmigfjTUzLqx1nLW/8 PVDQ== X-Gm-Message-State: AOAM533Udq8R4nejTtwUno2jcZx11AU4uGSj+ZfjlX2KvLRw9Lyu+SUp fy2BOZQLrosOabDyfJQAFWjXsAK34sA= X-Google-Smtp-Source: ABdhPJyxEXgXqfOZgXli85mVw7lSzxT+3Ui7KQ5DXcVJ6UK55eiVMepPLdc72bCIXgKy852Ssf+JRQ== X-Received: by 2002:adf:e2cc:: with SMTP id d12mr23489929wrj.107.1642507404393; Tue, 18 Jan 2022 04:03:24 -0800 (PST) Sender: =?UTF-8?Q?Philippe_Mathieu=2DDaud=C3=A9?= From: =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= To: qemu-devel@nongnu.org Cc: Peter Xu , David Hildenbrand , Paolo Bonzini , qemu-block@nongnu.org, =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , "Michael S . Tsirkin" , Richard Henderson , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= Subject: [PULL 11/19] hw/pci: Document pci_dma_map() Date: Tue, 18 Jan 2022 13:02:21 +0100 Message-Id: <20220118120229.196337-12-f4bug@amsat.org> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20220118120229.196337-1-f4bug@amsat.org> References: <20220118120229.196337-1-f4bug@amsat.org> MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @gmail.com) X-ZM-MESSAGEID: 1642507407612100001 From: Philippe Mathieu-Daud=C3=A9 Signed-off-by: Philippe Mathieu-Daud=C3=A9 Reviewed-by: Michael S. Tsirkin Reviewed-by: Richard Henderson Message-Id: <20220111184309.28637-5-f4bug@amsat.org> Signed-off-by: Philippe Mathieu-Daud=C3=A9 --- include/hw/pci/pci.h | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/include/hw/pci/pci.h b/include/hw/pci/pci.h index 483d5c7c727..023abc0f791 100644 --- a/include/hw/pci/pci.h +++ b/include/hw/pci/pci.h @@ -881,6 +881,18 @@ PCI_DMA_DEFINE_LDST(q_be, q_be, 64); =20 #undef PCI_DMA_DEFINE_LDST =20 +/** + * pci_dma_map: Map device PCI address space range into host virtual addre= ss + * @dev: #PCIDevice to be accessed + * @addr: address within that device's address space + * @plen: pointer to length of buffer; updated on return to indicate + * if only a subset of the requested range has been mapped + * @dir: indicates the transfer direction + * + * Return: A host pointer, or %NULL if the resources needed to + * perform the mapping are exhausted (in that case *@plen + * is set to zero). + */ static inline void *pci_dma_map(PCIDevice *dev, dma_addr_t addr, dma_addr_t *plen, DMADirection dir) { --=20 2.34.1