OvmfPkg/VirtioNetDxe: dynamically alloc transmit header

[mirror_edk2.git] / OvmfPkg / VirtioNetDxe / SnpSharedHelpers.c

/** @file\r
\r
  Helper functions used by at least two Simple Network Protocol methods.\r
\r
  Copyright (C) 2013, Red Hat, Inc.\r
\r
  This program and the accompanying materials are licensed and made available\r
  under the terms and conditions of the BSD License which accompanies this\r
  distribution. The full text of the license may be found at\r
  http://opensource.org/licenses/bsd-license.php\r
\r
  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, WITHOUT\r
  WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
**/\r
\r
#include <Library/MemoryAllocationLib.h>\r
\r
#include "VirtioNet.h"\r
\r
/**\r
  Release RX and TX resources on the boundary of the\r
  EfiSimpleNetworkInitialized state.\r
\r
  These functions contribute to rolling back a partial, failed initialization\r
  of the virtio-net SNP driver instance, or to shutting down a fully\r
  initialized, running instance.\r
\r
  They are only callable by the VirtioNetInitialize() and the\r
  VirtioNetShutdown() SNP methods. See the state diagram in "VirtioNet.h".\r
\r
  @param[in,out] Dev  The VNET_DEV driver instance being shut down, or whose\r
                      partial, failed initialization is being rolled back.\r
*/\r
\r
VOID\r
EFIAPI\r
VirtioNetShutdownRx (\r
  IN OUT VNET_DEV *Dev\r
  )\r
{\r
  Dev->VirtIo->UnmapSharedBuffer (Dev->VirtIo, Dev->RxBufMap);\r
  Dev->VirtIo->FreeSharedPages (\r
                 Dev->VirtIo,\r
                 Dev->RxBufNrPages,\r
                 Dev->RxBuf\r
                 );\r
}\r
\r
\r
VOID\r
EFIAPI\r
VirtioNetShutdownTx (\r
  IN OUT VNET_DEV *Dev\r
  )\r
{\r
  Dev->VirtIo->UnmapSharedBuffer (Dev->VirtIo, Dev->TxSharedReqMap);\r
  Dev->VirtIo->FreeSharedPages (\r
                 Dev->VirtIo,\r
                 EFI_SIZE_TO_PAGES (sizeof *(Dev->TxSharedReq)),\r
                 Dev->TxSharedReq\r
                 );\r
\r
  FreePool (Dev->TxFreeStack);\r
}\r
\r
/**\r
  Release TX and RX VRING resources.\r
\r
  @param[in,out] Dev       The VNET_DEV driver instance which was using\r
                           the ring.\r
  @param[in,out] Ring      The virtio ring to clean up.\r
  @param[in]     RingMap   A token return from the VirtioRingMap()\r
*/\r
VOID\r
EFIAPI\r
VirtioNetUninitRing (\r
  IN OUT VNET_DEV *Dev,\r
  IN OUT VRING    *Ring,\r
  IN     VOID     *RingMap\r
  )\r
{\r
  Dev->VirtIo->UnmapSharedBuffer (Dev->VirtIo, RingMap);\r
  VirtioRingUninit (Dev->VirtIo, Ring);\r
}\r