From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from NAM02-BL2-obe.outbound.protection.outlook.com (mail-bl2nam02on0070.outbound.protection.outlook.com [104.47.38.70]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-SHA384 (256/256 bits)) (No client certificate requested) by ml01.01.org (Postfix) with ESMTPS id 5C65A21D492EE for ; Thu, 14 Sep 2017 14:20:02 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=amdcloud.onmicrosoft.com; s=selector1-amd-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=am5yjXF1WNczph3BKTWP8/yMM0FmMEM0qev6bYImO6o=; b=Xfp+BGOcwt1pYJ6pg6cuIjkKqUS5XuboF7yP1p0TH2Y7GBnpZwgoerJEWqO++Fo/zEA16V2jTGAPFGa3JKlARPBQfedztUYTVfiYeYHdueuWNHKYsYH7Ea0QBJOBf+kl9YimHwvIWVIMerxYoohfZ07Me3TxzbLTfEFgU0EBfnY= Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=brijesh.singh@amd.com; Received: from ubuntu-010236106000.amd.com (165.204.78.1) by DM2PR12MB0155.namprd12.prod.outlook.com (2a01:111:e400:50ce::18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.35.12; Thu, 14 Sep 2017 21:22:59 +0000 From: Brijesh Singh To: edk2-devel@lists.01.org Cc: Brijesh Singh , Ard Biesheuvel , Jordan Justen , Tom Lendacky , Laszlo Ersek Date: Thu, 14 Sep 2017 16:22:45 -0500 Message-Id: <20170914212247.124937-7-brijesh.singh@amd.com> X-Mailer: git-send-email 2.9.5 In-Reply-To: <20170914212247.124937-1-brijesh.singh@amd.com> References: <20170914212247.124937-1-brijesh.singh@amd.com> MIME-Version: 1.0 X-Originating-IP: [165.204.78.1] X-ClientProxiedBy: DM5PR20CA0014.namprd20.prod.outlook.com (2603:10b6:3:93::24) To DM2PR12MB0155.namprd12.prod.outlook.com (2a01:111:e400:50ce::18) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 45df23eb-e5f5-459f-a849-08d4fbb6c64b X-MS-Office365-Filtering-HT: Tenant X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(300000500095)(300135000095)(300000501095)(300135300095)(22001)(300000502095)(300135100095)(2017030254152)(48565401081)(300000503095)(300135400095)(2017052603199)(201703131423075)(201703031133081)(201702281549075)(300000504095)(300135200095)(300000505095)(300135600095)(300000506095)(300135500095); SRVR:DM2PR12MB0155; X-Microsoft-Exchange-Diagnostics: 1; DM2PR12MB0155; 3:cIWMaM0U2r6YJq64C/6mWzQZ+6PRRPS7Zyd2AHWKiAhEpQx4x+gJVOk/WEIfiEhITbSFCJmQFdyDDGwVNgqaY1lCnuUhKuZBpAxt6ic9rQFdSjIk977kNzDtlJgcLTzv3u3Z7JHwKly7kFMWiQGCDTB5/0S6qnqO4bviN6Skg7g90dnEfJZWii+VctGDG8JjEGZe7TnEUh+SeHCSI/CyxnmTrctqduN2SsRzwsN9E23MLjEFFW5I/MYXpIu1MPG2; 25:WujjjCeMZSHIGhhKNnvHBz37UOQo5obXEW4USySt69L8MMxGqY+2DV4/CZnKx9RO7nmmLjEwz/ZtpWauwH5O/q5FAWt7EJveLOOKOU4tInwjYH/QpGgzg7GYsHuro/6hzw/VtUmCw91yxxHiLuq1XmRJAjOo8GhrNGoaT6lrxVhvR0AittaBvbQoih6Z9+8jNAZiYcIifHHPj0oLLoe/6c9bfsS1frMKlq5OfCSIPD8FhMbFKpFcsN1/FsWWPV4WqToYcreVTyQWRW/gBL7pFWyRKglPc/aeM9UFdFZSM7CYY42cgODJJQVzGT3B1Y08GRmbu/aL074TFbWlc2tpuw==; 31:TuGYJlhfvOCBc3YYwlou4pqHLQLh/Z+ZLfoe72LyL6s/N1i+AfH5gR4NAbbzsKxWzixsv1nASe1Qnia8+3054xlG71d+sYjtTyXqwwWkRTuf27RtSDNID/syHPaYM5Crfj+Ls73tamjQ3oDavzNVPd3fL95PF+u9WWh5nRG4/8EP3QZ906hqRcn46xCn/dnhnUB6vbREhJbMg3/PKCkqxiJElC7IBMpx58sKLlEPFKQ= X-MS-TrafficTypeDiagnostic: DM2PR12MB0155: X-Microsoft-Exchange-Diagnostics: 1; DM2PR12MB0155; 20:Jj5PrAtI0Ay1JNVPzcRRsAGdSGIxewoxWQBHbLXCqb1sdScV7hN3nSyOGqjJ6j+hVbmPRiJBM8/YQoPe/R9Z98SZ0lDIebCjCGTGnk3mJwucLfaY2n6XDBaw9gc67j4WbOe62Q9rwSmYdx/FSZ97qKjhXDAI6IUqYhyOvYEj9OWoT+0vNxKBb07TjN9Ry602Ic3F7T/ytpQ4sJMS6qHp9Q77Tz31eGZyzxrm9l7PrrjLb2lz4EKPbOd8gGNJVHS0965G37CI7txNDnfbWMtkzlY+XpHT6LTRs33lGHyggKiX3rhGwC0M813jUcl7g3LmRM1ZRcd4MwjXDLs2EH/qJdSwPLO8Es//+sGQpfIpZIiRd+eIW/8yf/ZnWdFsBWUaEvN+KyQpKTpr+F7D4bTl2Ul4iQ+fkksaRi1WygjtCoTiuD2WXf+KCHpLiWFEQxAXNknDQ4+ZCk0Vd/rmfJOufT/H9fh/2QS5XHCZ/BufwapKx9qwYyfzFd8w1D/C77Pq; 4:SbWJxwXzGL5lNS4tuKekNxuzggd9AfEBkQd2lVYzOHnyYKGKqp/X/zTXBasreKblusik2oQh0LZ5psRaMcXlhm5kvHJBV4cN2hcnByIJ+H/BBXECerbkRtZ4w3PrF9hxRYg5/rYntw8U1h2gRTmO9wHc1Ekvi32a9XGltxhB2VLr0f9jt6YogG1OZS19jcpEHWZbTJ3UahwOudwxzC1PnIeLWY81Y5TSfBjAVYIoU5zSTrnllm9aFbFh4YaLe7w1lnhym/JUsRCUAUui6JU0Ak1ajKC7XSwoCSvIwOvkWw/mZ3hNlQl18soezG4ir/jbco8evoSSQO1QvT27XnQ9mw== X-Exchange-Antispam-Report-Test: UriScan:(767451399110)(228905959029699); X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(100000700101)(100105000095)(100000701101)(100105300095)(100000702101)(100105100095)(6040450)(2401047)(8121501046)(5005006)(3002001)(93006095)(93001095)(100000703101)(100105400095)(10201501046)(6055026)(6041248)(20161123555025)(20161123562025)(20161123558100)(201703131423075)(201702281528075)(201703061421075)(201703061406153)(20161123564025)(20161123560025)(6072148)(201708071742011)(100000704101)(100105200095)(100000705101)(100105500095); SRVR:DM2PR12MB0155; BCL:0; PCL:0; RULEID:(100000800101)(100110000095)(100000801101)(100110300095)(100000802101)(100110100095)(100000803101)(100110400095)(100000804101)(100110200095)(100000805101)(100110500095); SRVR:DM2PR12MB0155; X-Forefront-PRVS: 0430FA5CB7 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(6009001)(39860400002)(346002)(376002)(51234002)(199003)(189002)(53936002)(4326008)(110136004)(50466002)(47776003)(50226002)(81156014)(81166006)(68736007)(54906002)(8676002)(2361001)(66066001)(2950100002)(6916009)(33646002)(2351001)(36756003)(106356001)(105586002)(53416004)(101416001)(48376002)(8936002)(25786009)(6486002)(97736004)(305945005)(7736002)(5660300001)(16526017)(16586007)(2906002)(5003940100001)(1076002)(6116002)(3846002)(316002)(50986999)(6666003)(76176999)(86362001)(478600001)(189998001); DIR:OUT; SFP:1101; SCL:1; SRVR:DM2PR12MB0155; H:ubuntu-010236106000.amd.com; FPR:; SPF:None; PTR:InfoNoRecords; A:1; MX:1; LANG:en; Received-SPF: None (protection.outlook.com: amd.com does not designate permitted sender hosts) X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; DM2PR12MB0155; 23:qkWbH7XBljyFrmPalq6wNucAyncwluggZ9gwedVaF?= =?us-ascii?Q?KbjOb9qGq8lUUW/M4aNR2O0HFhW6MGk/AkcPHpMueTsELqxycN0rkDVSj+Ra?= =?us-ascii?Q?VTFOe8YzIjCZDjHpyO094zVwv29N3ae+IBkX9/5sA2oYMPwBPpWZ5rU8OHBd?= =?us-ascii?Q?ZA5f5qvUxOFatzgd+TWvUv5/sDA7zoQoYKdZBiV+pp1AsJ3RmKP8p3wyFYQF?= =?us-ascii?Q?phndmp/WUxEEdqvZt9fN9UR52aAvZxGYd1RvxrPEXfu+r4paeGPChgB9ikqX?= =?us-ascii?Q?E5ocwpTSLcpclVmRODYS8j5A9zpRHUTf4y/DAsF8TseKxwE/RvkiCOMMQabQ?= =?us-ascii?Q?34ccWBz9veKe4o5nDcZt0tMqm1OdJ9CpG+6aigomHOQGfEcDoev4Yiz1fIfp?= =?us-ascii?Q?gY5DYkoo9DEi8iI926caIZdHdCoLakGT3qcQAacRyzPA+L6vJnsBX3jC3LKi?= =?us-ascii?Q?IOmpnSc+zd5FLT8RVvZ4CtyA5tuAPNuc1y5rlvxZ68E38uLGwaHl8CbbcEgM?= =?us-ascii?Q?wbuMZi+pe1aw3l0VUie+SNMNsCcIfFqmZ18Y58MypDsHtHlXxR4c7lniV+Ko?= =?us-ascii?Q?aQCG640drIsL5KJZN+j7YbbTIuCOHoxSbEGPaCgbeDGdJ62itEgykox2Nchm?= =?us-ascii?Q?YvT0iGsbwTJ+aGeYLrYNsYv+zxFOGLDE7fsDn5CY7BleQQgu9cRdk4YxPeZc?= =?us-ascii?Q?SZlLLn0jbtoNneRscc6dVy4y+CYNOykC5OCzsfvprHLVDLc5WwhH9N/XOVXs?= =?us-ascii?Q?2PYn3bd9u8b+m6/YVY9wzeiLiXQdRFnehLnmnKQeBuMy8zjEy7F67G7zue/6?= =?us-ascii?Q?I9dkdhMIl6E8P0LIhBWY6FgAnX1I3yv9Jfme49pIy5Q2PNwCOzlCur2PfWRA?= =?us-ascii?Q?XXYxZqusxnsD20TPG1Lk3UQKZIkls5Nad82stl30vmLyyo6uhfK+//00XIUm?= =?us-ascii?Q?qipq6srKuod8Dqx9JiPY7sp3vWqQJnSP+wXjQkDstYp68h9UulzHb+k77lfM?= =?us-ascii?Q?/QXf1x8IBGn1m9kw3K0JYasuHdgqQ303xRNrDBeYCakukbKHe2ZnmvvezM6U?= =?us-ascii?Q?sZHsWrjjjGGDl1f5Hhw0EXm9Grb9t4dl3DhCwq49f5IyPdvyhuYXuKxpeur+?= =?us-ascii?Q?n7E3n7rOR7gm7LKnL0s9xnXGpktX5fv1ZTIHvMQV2HNzJ1pmv8jftvxJjBBN?= =?us-ascii?Q?hELL9yynX636i+fkLIotpWXG2PfkhZMJtb2?= X-Microsoft-Exchange-Diagnostics: 1; DM2PR12MB0155; 6:UOl/lLEMA59b1xz3GMDACZVJ4QLdr6+7fyLi44Jl+raZohlo0OnydUz8fJ0XzKcBhUA/5KLxwNzyL6FPsJgLdPJLCuUApuF81EyuwCQknajat6VfatuspB42EFuUe7l3a6UHZqbooB00VfSssl0HARvdlPQt6Eq9YliY8bFbbPGPZI4iJ36/KVlC0Bn/bN0ruRuYuEIwieQrQwtSEjgjn6dnMk2BNShDW3j3gBi5m6vXTtWhzRTzqqNBZuKJVUEBiGnme5dYGnpsLWjBdMhP+qeTz5cj2bXx4I/ik94+fAnPZNHvKU2I32U5mZf9COZv0vj+8xuM9rUzwPNPlaSgiQ==; 5:4Xt+CiDK4NjXGkthPOlomHQdSn7fYr36gtWJIhuHwZLReenBNxFu3zT3dC5dGV/HXiPV7xLesRTAYCB9Wlr/EbIdpqcsjMWIvbCKWkXwWLIEGd0pxmi8lTub3T1odIKez3sBdYjL13smLLrVOzVzyLmbmdVWAKLPjRfOSd54Ya8=; 24:FAewDQ7IOEHknZZDQ4AFfGEWRktpAWwKeXHovXoUxgY6bFSoxXlxnNT1J/AUL2jKYiDyFtMxHhE2AUe7bODaP4pqavU84cMkZ4/tNPtvPpA=; 7:HnC54sM3W88r/jmNSvUc2qrmv3oELpMddYcomkJS1ScW5URBkrCpJtv2J/LkWHeDSkVtZxHy81ItNPe+7iGfwXJlLznzfAwZys9MFPXZnBQ42Ze/dAGg1pqzNBGCOi/tBE8axGbWpjD5XeKuBamC5ak/wpXgtSbij/MFyK7lacbTZpAdZ11pfQpsfcr41EsRqj72GE4OWQFbhvM2Cr4eS4be+y443c/g+KnG10tsT1w= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; DM2PR12MB0155; 20:FHLpGoYrvllG7quvp1egsPa3NyfHx5chsMawtZx9DDiZK1XCVf/WjW1dLvajxPP0bE3Cewr6SVcsebYgjZVZe+hAgc7t6B+y7OktFc5BpJfSAuG2ojvwcLk1FS/N7etyj0vAME5VGPqjcUvFedrZoc2I2JUbyMNvIVTpLih85DKzMPVxQWkxQyXE2Ww56c7LPkp3QnbZMBot5GosyozM8SvP/ND3d1izlBqcaDjFrxPVu4gd4Fftk6fmJyOOk0nh X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 14 Sep 2017 21:22:59.3361 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 3dd8961f-e488-4e60-8e11-a82d994e183d X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM2PR12MB0155 Subject: [PATCH v4 6/8] OvmfPkg/VirtioNetDxe: add Tx packet map/unmap helper functions X-BeenThere: edk2-devel@lists.01.org X-Mailman-Version: 2.1.22 Precedence: list List-Id: EDK II Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 14 Sep 2017 21:20:02 -0000 Content-Type: text/plain When device is behind IOMMU, driver is require to pass the device address of TxBuf in the Tx VRING. The patch adds helper functions and data structure to map and unmap the TxBuf system physical address to a device address. Since the TxBuf is returned back to caller from VirtioNetGetStatus() hence we use OrderedCollection interface to save the TxBuf system physical to device address mapping. After the TxBuf is succesfully transmitted VirtioNetUnmapTxBuf() does the reverse lookup in OrderedCollection data structure to get the system physical address of TxBuf for a given device address. Cc: Ard Biesheuvel Cc: Jordan Justen Cc: Tom Lendacky Cc: Laszlo Ersek Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Brijesh Singh Reviewed-by: Laszlo Ersek --- OvmfPkg/VirtioNetDxe/VirtioNet.inf | 1 + OvmfPkg/VirtioNetDxe/VirtioNet.h | 38 ++++ OvmfPkg/VirtioNetDxe/SnpInitialize.c | 18 +- OvmfPkg/VirtioNetDxe/SnpSharedHelpers.c | 224 ++++++++++++++++++++ 4 files changed, 279 insertions(+), 2 deletions(-) diff --git a/OvmfPkg/VirtioNetDxe/VirtioNet.inf b/OvmfPkg/VirtioNetDxe/VirtioNet.inf index a855ad4ac154..9ff6d87e6190 100644 --- a/OvmfPkg/VirtioNetDxe/VirtioNet.inf +++ b/OvmfPkg/VirtioNetDxe/VirtioNet.inf @@ -49,6 +49,7 @@ DebugLib DevicePathLib MemoryAllocationLib + OrderedCollectionLib UefiBootServicesTableLib UefiDriverEntryPoint UefiLib diff --git a/OvmfPkg/VirtioNetDxe/VirtioNet.h b/OvmfPkg/VirtioNetDxe/VirtioNet.h index 027f75993e8e..3fc88cfb790e 100644 --- a/OvmfPkg/VirtioNetDxe/VirtioNet.h +++ b/OvmfPkg/VirtioNetDxe/VirtioNet.h @@ -26,6 +26,7 @@ #include #include #include +#include #define VNET_SIG SIGNATURE_32 ('V', 'N', 'E', 'T') @@ -100,6 +101,7 @@ typedef struct { VIRTIO_1_0_NET_REQ *TxSharedReq; // VirtioNetInitTx VOID *TxSharedReqMap; // VirtioNetInitTx UINT16 TxLastUsed; // VirtioNetInitTx + ORDERED_COLLECTION *TxBufCollection; // VirtioNetInitTx } VNET_DEV; @@ -281,6 +283,42 @@ VirtioNetUninitRing ( ); // +// utility functions to map caller-supplied Tx buffer system physical address +// to a device address and vice versa +// +EFI_STATUS +EFIAPI +VirtioNetMapTxBuf ( + IN VNET_DEV *Dev, + IN VOID *Buffer, + IN UINTN NumberOfBytes, + OUT EFI_PHYSICAL_ADDRESS *DeviceAddress + ); + +EFI_STATUS +EFIAPI +VirtioNetUnmapTxBuf ( + IN VNET_DEV *Dev, + OUT VOID **Buffer, + IN EFI_PHYSICAL_ADDRESS DeviceAddress + ); + +INTN +EFIAPI +VirtioNetTxBufMapInfoCompare ( + IN CONST VOID *UserStruct1, + IN CONST VOID *UserStruct2 + ); + +INTN +EFIAPI +VirtioNetTxBufDeviceAddressCompare ( + IN CONST VOID *StandaloneKey, + IN CONST VOID *UserStruct + ); + + +// // event callbacks // VOID diff --git a/OvmfPkg/VirtioNetDxe/SnpInitialize.c b/OvmfPkg/VirtioNetDxe/SnpInitialize.c index 9621f936d2cb..ffb3deefe00c 100644 --- a/OvmfPkg/VirtioNetDxe/SnpInitialize.c +++ b/OvmfPkg/VirtioNetDxe/SnpInitialize.c @@ -147,7 +147,8 @@ ReleaseQueue: EfiSimpleNetworkInitialized state. @retval EFI_OUT_OF_RESOURCES Failed to allocate the stack to track the heads - of free descriptor chains. + of free descriptor chains or failed to init + TxBufCollection. @return Status codes from VIRTIO_DEVICE_PROTOCOL. AllocateSharedPages() or VirtioMapAllBytesInSharedBuffer() @@ -176,6 +177,15 @@ VirtioNetInitTx ( return EFI_OUT_OF_RESOURCES; } + Dev->TxBufCollection = OrderedCollectionInit ( + VirtioNetTxBufMapInfoCompare, + VirtioNetTxBufDeviceAddressCompare + ); + if (Dev->TxBufCollection == NULL) { + Status = EFI_OUT_OF_RESOURCES; + goto FreeTxFreeStack; + } + // // Allocate TxSharedReq header and map with BusMasterCommonBuffer so that it // can be accessed equally by both processor and device. @@ -186,7 +196,7 @@ VirtioNetInitTx ( &TxSharedReqBuffer ); if (EFI_ERROR (Status)) { - goto FreeTxFreeStack; + goto UninitTxBufCollection; } ZeroMem (TxSharedReqBuffer, sizeof *Dev->TxSharedReq); @@ -267,6 +277,10 @@ FreeTxSharedReqBuffer: EFI_SIZE_TO_PAGES (sizeof *(Dev->TxSharedReq)), TxSharedReqBuffer ); + +UninitTxBufCollection: + OrderedCollectionUninit (Dev->TxBufCollection); + FreeTxFreeStack: FreePool (Dev->TxFreeStack); diff --git a/OvmfPkg/VirtioNetDxe/SnpSharedHelpers.c b/OvmfPkg/VirtioNetDxe/SnpSharedHelpers.c index 2fce8142d554..18dbf1812541 100644 --- a/OvmfPkg/VirtioNetDxe/SnpSharedHelpers.c +++ b/OvmfPkg/VirtioNetDxe/SnpSharedHelpers.c @@ -18,6 +18,16 @@ #include "VirtioNet.h" +// +// The user structure for the ordered collection that will track the mapping +// info of the packets queued in TxRing +// +typedef struct { + VOID *Buffer; + EFI_PHYSICAL_ADDRESS DeviceAddress; // lookup key for reverse mapping + VOID *BufMap; +} TX_BUF_MAP_INFO; + /** Release RX and TX resources on the boundary of the EfiSimpleNetworkInitialized state. @@ -54,6 +64,10 @@ VirtioNetShutdownTx ( IN OUT VNET_DEV *Dev ) { + ORDERED_COLLECTION_ENTRY *Entry, *Entry2; + TX_BUF_MAP_INFO *TxBufMapInfo; + VOID *UserStruct; + Dev->VirtIo->UnmapSharedBuffer (Dev->VirtIo, Dev->TxSharedReqMap); Dev->VirtIo->FreeSharedPages ( Dev->VirtIo, @@ -61,6 +75,17 @@ VirtioNetShutdownTx ( Dev->TxSharedReq ); + for (Entry = OrderedCollectionMin (Dev->TxBufCollection); + Entry != NULL; + Entry = Entry2) { + Entry2 = OrderedCollectionNext (Entry); + OrderedCollectionDelete (Dev->TxBufCollection, Entry, &UserStruct); + TxBufMapInfo = UserStruct; + Dev->VirtIo->UnmapSharedBuffer (Dev->VirtIo, TxBufMapInfo->BufMap); + FreePool (TxBufMapInfo); + } + OrderedCollectionUninit (Dev->TxBufCollection); + FreePool (Dev->TxFreeStack); } @@ -83,3 +108,202 @@ VirtioNetUninitRing ( Dev->VirtIo->UnmapSharedBuffer (Dev->VirtIo, RingMap); VirtioRingUninit (Dev->VirtIo, Ring); } + + +/** + Map Caller-supplied TxBuf buffer to the device-mapped address + + @param[in] Dev The VNET_DEV driver instance which wants to + map the Tx packet. + @param[in] Buffer The system physical address of TxBuf + @param[in] NumberOfBytes Number of bytes to map + @param[out] DeviceAddress The resulting device address for the bus + master access. + + @retval EFI_OUT_OF_RESOURCES The request could not be completed due to + a lack of resources. + @return Status codes from + VirtioMapAllBytesInSharedBuffer() + @retval EFI_SUCCESS Caller-supplied buffer is succesfully mapped. +*/ +EFI_STATUS +EFIAPI +VirtioNetMapTxBuf ( + IN VNET_DEV *Dev, + IN VOID *Buffer, + IN UINTN NumberOfBytes, + OUT EFI_PHYSICAL_ADDRESS *DeviceAddress + ) +{ + EFI_STATUS Status; + TX_BUF_MAP_INFO *TxBufMapInfo; + EFI_PHYSICAL_ADDRESS Address; + VOID *Mapping; + + TxBufMapInfo = AllocatePool (sizeof (*TxBufMapInfo)); + if (TxBufMapInfo == NULL) { + return EFI_OUT_OF_RESOURCES; + } + + Status = VirtioMapAllBytesInSharedBuffer ( + Dev->VirtIo, + VirtioOperationBusMasterRead, + Buffer, + NumberOfBytes, + &Address, + &Mapping + ); + if (EFI_ERROR (Status)) { + goto FreeTxBufMapInfo; + } + + TxBufMapInfo->Buffer = Buffer; + TxBufMapInfo->DeviceAddress = Address; + TxBufMapInfo->BufMap = Mapping; + + Status = OrderedCollectionInsert ( + Dev->TxBufCollection, + NULL, + TxBufMapInfo + ); + switch (Status) { + case EFI_OUT_OF_RESOURCES: + goto UnmapTxBuf; + case EFI_ALREADY_STARTED: + // + // This should never happen: it implies + // + // - an identity-mapping VIRTIO_DEVICE_PROTOCOL.MapSharedBuffer() + // implementation -- which is fine, + // + // - and an SNP client that queues multiple instances of the exact same + // buffer address with SNP.Transmit() -- which is undefined behavior, + // based on the TxBuf language in UEFI-2.7, + // EFI_SIMPLE_NETWORK.GetStatus(). + // + ASSERT (FALSE); + Status = EFI_INVALID_PARAMETER; + goto UnmapTxBuf; + default: + ASSERT_EFI_ERROR (Status); + break; + } + + *DeviceAddress = Address; + return EFI_SUCCESS; + +UnmapTxBuf: + Dev->VirtIo->UnmapSharedBuffer (Dev->VirtIo, Mapping); + +FreeTxBufMapInfo: + FreePool (TxBufMapInfo); + return Status; +} + +/** + Unmap (aka reverse mapping) device mapped TxBuf buffer to the system + physical address + + @param[in] Dev The VNET_DEV driver instance which wants to + reverse- and unmap the Tx packet. + @param[out] Buffer The system physical address of TxBuf + @param[in] DeviceAddress The device address for the TxBuf + + @retval EFI_INVALID_PARAMETER The DeviceAddress is not mapped + @retval EFI_SUCCESS The TxBuf at DeviceAddress has been unmapped, + and Buffer has been set to TxBuf's system + physical address. + +*/ +EFI_STATUS +EFIAPI +VirtioNetUnmapTxBuf ( + IN VNET_DEV *Dev, + OUT VOID **Buffer, + IN EFI_PHYSICAL_ADDRESS DeviceAddress + ) +{ + ORDERED_COLLECTION_ENTRY *Entry; + TX_BUF_MAP_INFO *TxBufMapInfo; + VOID *UserStruct; + + Entry = OrderedCollectionFind (Dev->TxBufCollection, &DeviceAddress); + if (Entry == NULL) { + return EFI_INVALID_PARAMETER; + } + + OrderedCollectionDelete (Dev->TxBufCollection, Entry, &UserStruct); + + TxBufMapInfo = UserStruct; + + *Buffer = TxBufMapInfo->Buffer; + Dev->VirtIo->UnmapSharedBuffer (Dev->VirtIo, TxBufMapInfo->BufMap); + FreePool (TxBufMapInfo); + + return EFI_SUCCESS; +} + +/** + Comparator function for two TX_BUF_MAP_INFO objects. + + @param[in] UserStruct1 Pointer to the first TX_BUF_MAP_INFO object. + + @param[in] UserStruct2 Pointer to the second TX_BUF_MAP_INFO object. + + @retval <0 If UserStruct1 compares less than UserStruct2. + + @retval 0 If UserStruct1 compares equal to UserStruct2. + + @retval >0 If UserStruct1 compares greater than UserStruct2. +*/ +INTN +EFIAPI +VirtioNetTxBufMapInfoCompare ( + IN CONST VOID *UserStruct1, + IN CONST VOID *UserStruct2 + ) +{ + CONST TX_BUF_MAP_INFO *MapInfo1; + CONST TX_BUF_MAP_INFO *MapInfo2; + + MapInfo1 = UserStruct1; + MapInfo2 = UserStruct2; + + return MapInfo1->DeviceAddress < MapInfo2->DeviceAddress ? -1 : + MapInfo1->DeviceAddress > MapInfo2->DeviceAddress ? 1 : + 0; +} + +/** + Compare a standalone DeviceAddress against a TX_BUF_MAP_INFO object + containing an embedded DeviceAddress. + + @param[in] StandaloneKey Pointer to DeviceAddress, which has type + EFI_PHYSICAL_ADDRESS. + + @param[in] UserStruct Pointer to the TX_BUF_MAP_INFO object with the + embedded DeviceAddress. + + @retval <0 If StandaloneKey compares less than UserStruct's key. + + @retval 0 If StandaloneKey compares equal to UserStruct's key. + + @retval >0 If StandaloneKey compares greater than UserStruct's key. +**/ +INTN +EFIAPI +VirtioNetTxBufDeviceAddressCompare ( + IN CONST VOID *StandaloneKey, + IN CONST VOID *UserStruct + ) +{ + CONST EFI_PHYSICAL_ADDRESS *DeviceAddress; + CONST TX_BUF_MAP_INFO *MapInfo; + + DeviceAddress = StandaloneKey; + MapInfo = UserStruct; + + return *DeviceAddress < MapInfo->DeviceAddress ? -1 : + *DeviceAddress > MapInfo->DeviceAddress ? 1 : + 0; +} -- 2.9.5