1 /* 2 * A flexpage abstraction. 3 * 4 * Copyright (C) 2021, 2022 Paul Boddie <paul@boddie.org.uk> 5 * 6 * This program is free software; you can redistribute it and/or 7 * modify it under the terms of the GNU General Public License as 8 * published by the Free Software Foundation; either version 2 of 9 * the License, or (at your option) any later version. 10 * 11 * This program is distributed in the hope that it will be useful, 12 * but WITHOUT ANY WARRANTY; without even the implied warranty of 13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 14 * GNU General Public License for more details. 15 * 16 * You should have received a copy of the GNU General Public License 17 * along with this program; if not, write to the Free Software 18 * Foundation, Inc., 51 Franklin Street, Fifth Floor, 19 * Boston, MA 02110-1301, USA 20 */ 21 22 #pragma once 23 24 #include <l4/re/c/dataspace.h> 25 26 #include <list> 27 28 #include <mem/memory_utils.h> 29 #include <mem/region.h> 30 #include <mem/send_flexpage.h> 31 32 33 34 /* Work around API change. */ 35 36 #define L4RE_DS_MAP_FLAG_RO L4RE_DS_F_R 37 #define L4RE_DS_MAP_FLAG_RW L4RE_DS_F_RW 38 39 40 41 /* Forward declaration. */ 42 43 class Flexpage; 44 45 /* Employed data types. */ 46 47 typedef std::list<Flexpage *> DerivedFlexpages; 48 49 50 51 /* A flexpage abstraction. */ 52 53 class Flexpage 54 { 55 protected: 56 unsigned int _counter; 57 map_flags_t _flags; 58 59 public: 60 Region *region; 61 62 /* Flexpage relationships to support masked regions. */ 63 64 DerivedFlexpages derived; 65 66 /* General flexpage characteristics. */ 67 68 offset_t base_addr, size; 69 offset_t base_offset; 70 71 /* Physical address characteristics. */ 72 73 l4re_dma_space_dma_addr_t base_addr_physical; 74 75 /* Transient debugging information. */ 76 77 offset_t page_addr, page_offset; 78 79 /* Associate a flexpage with a memory 'region'. */ 80 81 explicit Flexpage(Region *region = NULL) 82 : region(region) 83 { 84 } 85 86 virtual ~Flexpage(); 87 88 void set_region(Region *region); 89 90 void reset(offset_t offset); 91 92 bool decrement(); 93 94 void increment(); 95 96 void invalidate(); 97 98 bool valid(); 99 100 bool supports_position(offset_t position); 101 102 void upgrade(map_flags_t flags); 103 104 bool modified(); 105 106 SendFlexpage to_send(offset_t offset, offset_t hot_spot, map_flags_t flags, 107 offset_t max_offset=0); 108 109 SendFlexpage to_unmap(); 110 111 /* Associate other flexpages with this flexpage. */ 112 113 void associate(Flexpage *flexpage); 114 115 void disassociate(); 116 }; 117 118 // vim: tabstop=4 expandtab shiftwidth=4