Home | History | Annotate | Download | only in XenBusDxe
      1 /** @file
      2   Grant Table function declaration.
      3 
      4   Grant Table are used to grant access to certain page of the current
      5   VM to an other VM.
      6 
      7   Copyright (C) 2014, Citrix Ltd.
      8 
      9   This program and the accompanying materials
     10   are licensed and made available under the terms and conditions of the BSD License
     11   which accompanies this distribution.  The full text of the license may be found at
     12   http://opensource.org/licenses/bsd-license.php
     13 
     14   THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
     15   WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
     16 
     17 **/
     18 #ifndef __GNTTAB_H__
     19 #define __GNTTAB_H__
     20 
     21 #include <IndustryStandard/Xen/grant_table.h>
     22 
     23 /**
     24   Initialize the Grant Table at the address MmioAddr.
     25 
     26   @param Dev      A pointer to XENBUS_DEVICE.
     27   @param MmioAddr An address where the grant table can be mapped into
     28                   the guest.
     29 **/
     30 VOID
     31 XenGrantTableInit (
     32   IN XENBUS_DEVICE  *Dev
     33   );
     34 
     35 /**
     36   Desinitilize the Grant Table.
     37 **/
     38 VOID
     39 XenGrantTableDeinit (
     40   IN XENBUS_DEVICE  *Dev
     41   );
     42 
     43 /**
     44   Grant access to the page Frame to the domain DomainId.
     45 
     46   @param This       A pointer to XENBUS_PROTOCOL instance.
     47   @param DomainId   ID of the domain to grant acces to.
     48   @param Frame      Frame Number of the page to grant access to.
     49   @param ReadOnly   Provide read-only or read-write access.
     50   @param RefPtr     Reference number of the grant will be written to this pointer.
     51 **/
     52 EFI_STATUS
     53 EFIAPI
     54 XenBusGrantAccess (
     55   IN  XENBUS_PROTOCOL *This,
     56   IN  domid_t         DomainId,
     57   IN  UINTN           Frame, // MFN
     58   IN  BOOLEAN         ReadOnly,
     59   OUT grant_ref_t     *RefPtr
     60   );
     61 
     62 /**
     63   End access to grant Ref, previously return by XenBusGrantAccess.
     64 
     65   @param This       A pointer to XENBUS_PROTOCOL instance.
     66   @param Ref        Reference numeber of a grant previously returned by
     67                     XenBusGrantAccess.
     68 **/
     69 EFI_STATUS
     70 EFIAPI
     71 XenBusGrantEndAccess (
     72   IN XENBUS_PROTOCOL  *This,
     73   IN grant_ref_t      Ref
     74   );
     75 
     76 #endif /* !__GNTTAB_H__ */
     77