LXR linux/arch/s390/include/asm/gmap.h

   1/* SPDX-License-Identifier: GPL-2.0 */
   2/*
   3 *  KVM guest address space mapping code
   4 *
   5 *    Copyright IBM Corp. 2007, 2016
   6 *    Author(s): Martin Schwidefsky <schwidefsky@de.ibm.com>
   7 */
   8
   9#ifndef _ASM_S390_GMAP_H
  10#define _ASM_S390_GMAP_H
  11
  12#include <linux/refcount.h>
  13
  14/* Generic bits for GMAP notification on DAT table entry changes. */
  15#define GMAP_NOTIFY_SHADOW      0x2
  16#define GMAP_NOTIFY_MPROT       0x1
  17
  18/* Status bits only for huge segment entries */
  19#define _SEGMENT_ENTRY_GMAP_IN          0x8000  /* invalidation notify bit */
  20#define _SEGMENT_ENTRY_GMAP_UC          0x4000  /* dirty (migration) */
  21
  22/**
  23 * struct gmap_struct - guest address space
  24 * @list: list head for the mm->context gmap list
  25 * @crst_list: list of all crst tables used in the guest address space
  26 * @mm: pointer to the parent mm_struct
  27 * @guest_to_host: radix tree with guest to host address translation
  28 * @host_to_guest: radix tree with pointer to segment table entries
  29 * @guest_table_lock: spinlock to protect all entries in the guest page table
  30 * @ref_count: reference counter for the gmap structure
  31 * @table: pointer to the page directory
  32 * @asce: address space control element for gmap page table
  33 * @pfault_enabled: defines if pfaults are applicable for the guest
  34 * @host_to_rmap: radix tree with gmap_rmap lists
  35 * @children: list of shadow gmap structures
  36 * @pt_list: list of all page tables used in the shadow guest address space
  37 * @shadow_lock: spinlock to protect the shadow gmap list
  38 * @parent: pointer to the parent gmap for shadow guest address spaces
  39 * @orig_asce: ASCE for which the shadow page table has been created
  40 * @edat_level: edat level to be used for the shadow translation
  41 * @removed: flag to indicate if a shadow guest address space has been removed
  42 * @initialized: flag to indicate if a shadow guest address space can be used
  43 */
  44struct gmap {
  45        struct list_head list;
  46        struct list_head crst_list;
  47        struct mm_struct *mm;
  48        struct radix_tree_root guest_to_host;
  49        struct radix_tree_root host_to_guest;
  50        spinlock_t guest_table_lock;
  51        refcount_t ref_count;
  52        unsigned long *table;
  53        unsigned long asce;
  54        unsigned long asce_end;
  55        void *private;
  56        bool pfault_enabled;
  57        /* Additional data for shadow guest address spaces */
  58        struct radix_tree_root host_to_rmap;
  59        struct list_head children;
  60        struct list_head pt_list;
  61        spinlock_t shadow_lock;
  62        struct gmap *parent;
  63        unsigned long orig_asce;
  64        int edat_level;
  65        bool removed;
  66        bool initialized;
  67};
  68
  69/**
  70 * struct gmap_rmap - reverse mapping for shadow page table entries
  71 * @next: pointer to next rmap in the list
  72 * @raddr: virtual rmap address in the shadow guest address space
  73 */
  74struct gmap_rmap {
  75        struct gmap_rmap *next;
  76        unsigned long raddr;
  77};
  78
  79#define gmap_for_each_rmap(pos, head) \
  80        for (pos = (head); pos; pos = pos->next)
  81
  82#define gmap_for_each_rmap_safe(pos, n, head) \
  83        for (pos = (head); n = pos ? pos->next : NULL, pos; pos = n)
  84
  85/**
  86 * struct gmap_notifier - notify function block for page invalidation
  87 * @notifier_call: address of callback function
  88 */
  89struct gmap_notifier {
  90        struct list_head list;
  91        struct rcu_head rcu;
  92        void (*notifier_call)(struct gmap *gmap, unsigned long start,
  93                              unsigned long end);
  94};
  95
  96static inline int gmap_is_shadow(struct gmap *gmap)
  97{
  98        return !!gmap->parent;
  99}
 100
 101struct gmap *gmap_create(struct mm_struct *mm, unsigned long limit);
 102void gmap_remove(struct gmap *gmap);
 103struct gmap *gmap_get(struct gmap *gmap);
 104void gmap_put(struct gmap *gmap);
 105
 106void gmap_enable(struct gmap *gmap);
 107void gmap_disable(struct gmap *gmap);
 108struct gmap *gmap_get_enabled(void);
 109int gmap_map_segment(struct gmap *gmap, unsigned long from,
 110                     unsigned long to, unsigned long len);
 111int gmap_unmap_segment(struct gmap *gmap, unsigned long to, unsigned long len);
 112unsigned long __gmap_translate(struct gmap *, unsigned long gaddr);
 113unsigned long gmap_translate(struct gmap *, unsigned long gaddr);
 114int __gmap_link(struct gmap *gmap, unsigned long gaddr, unsigned long vmaddr);
 115int gmap_fault(struct gmap *, unsigned long gaddr, unsigned int fault_flags);
 116void gmap_discard(struct gmap *, unsigned long from, unsigned long to);
 117void __gmap_zap(struct gmap *, unsigned long gaddr);
 118void gmap_unlink(struct mm_struct *, unsigned long *table, unsigned long vmaddr);
 119
 120int gmap_read_table(struct gmap *gmap, unsigned long gaddr, unsigned long *val);
 121
 122struct gmap *gmap_shadow(struct gmap *parent, unsigned long asce,
 123                         int edat_level);
 124int gmap_shadow_valid(struct gmap *sg, unsigned long asce, int edat_level);
 125int gmap_shadow_r2t(struct gmap *sg, unsigned long saddr, unsigned long r2t,
 126                    int fake);
 127int gmap_shadow_r3t(struct gmap *sg, unsigned long saddr, unsigned long r3t,
 128                    int fake);
 129int gmap_shadow_sgt(struct gmap *sg, unsigned long saddr, unsigned long sgt,
 130                    int fake);
 131int gmap_shadow_pgt(struct gmap *sg, unsigned long saddr, unsigned long pgt,
 132                    int fake);
 133int gmap_shadow_pgt_lookup(struct gmap *sg, unsigned long saddr,
 134                           unsigned long *pgt, int *dat_protection, int *fake);
 135int gmap_shadow_page(struct gmap *sg, unsigned long saddr, pte_t pte);
 136
 137void gmap_register_pte_notifier(struct gmap_notifier *);
 138void gmap_unregister_pte_notifier(struct gmap_notifier *);
 139void gmap_pte_notify(struct mm_struct *, unsigned long addr, pte_t *,
 140                     unsigned long bits);
 141
 142int gmap_mprotect_notify(struct gmap *, unsigned long start,
 143                         unsigned long len, int prot);
 144
 145void gmap_sync_dirty_log_pmd(struct gmap *gmap, unsigned long dirty_bitmap[4],
 146                             unsigned long gaddr, unsigned long vmaddr);
 147#endif /* _ASM_S390_GMAP_H */
 148