lmb.h 4.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135
  1. /* SPDX-License-Identifier: GPL-2.0+ */
  2. #ifndef _LINUX_LMB_H
  3. #define _LINUX_LMB_H
  4. #ifdef __KERNEL__
  5. #include <asm/types.h>
  6. #include <asm/u-boot.h>
  7. /*
  8. * Logical memory blocks.
  9. *
  10. * Copyright (C) 2001 Peter Bergner, IBM Corp.
  11. */
  12. /**
  13. * enum lmb_flags - definition of memory region attributes
  14. * @LMB_NONE: no special request
  15. * @LMB_NOMAP: don't add to mmu configuration
  16. */
  17. enum lmb_flags {
  18. LMB_NONE = 0x0,
  19. LMB_NOMAP = 0x4,
  20. };
  21. /**
  22. * struct lmb_property - Description of one region.
  23. *
  24. * @base: Base address of the region.
  25. * @size: Size of the region
  26. */
  27. struct lmb_property {
  28. phys_addr_t base;
  29. phys_size_t size;
  30. enum lmb_flags flags;
  31. };
  32. /**
  33. * struct lmb_region - Description of a set of region.
  34. *
  35. * @cnt: Number of regions.
  36. * @max: Size of the region array, max value of cnt.
  37. * @region: Array of the region properties
  38. */
  39. struct lmb_region {
  40. unsigned long cnt;
  41. unsigned long max;
  42. #if IS_ENABLED(CONFIG_LMB_USE_MAX_REGIONS)
  43. struct lmb_property region[CONFIG_LMB_MAX_REGIONS];
  44. #else
  45. struct lmb_property *region;
  46. #endif
  47. };
  48. /**
  49. * struct lmb - Logical memory block handle.
  50. *
  51. * Clients provide storage for Logical memory block (lmb) handles.
  52. * The content of the structure is managed by the lmb library.
  53. * A lmb struct is initialized by lmb_init() functions.
  54. * The lmb struct is passed to all other lmb APIs.
  55. *
  56. * @memory: Description of memory regions.
  57. * @reserved: Description of reserved regions.
  58. * @memory_regions: Array of the memory regions (statically allocated)
  59. * @reserved_regions: Array of the reserved regions (statically allocated)
  60. */
  61. struct lmb {
  62. struct lmb_region memory;
  63. struct lmb_region reserved;
  64. #if !IS_ENABLED(CONFIG_LMB_USE_MAX_REGIONS)
  65. struct lmb_property memory_regions[CONFIG_LMB_MEMORY_REGIONS];
  66. struct lmb_property reserved_regions[CONFIG_LMB_RESERVED_REGIONS];
  67. #endif
  68. };
  69. extern void lmb_init(struct lmb *lmb);
  70. extern void lmb_init_and_reserve(struct lmb *lmb, struct bd_info *bd,
  71. void *fdt_blob);
  72. extern void lmb_init_and_reserve_range(struct lmb *lmb, phys_addr_t base,
  73. phys_size_t size, void *fdt_blob);
  74. extern long lmb_add(struct lmb *lmb, phys_addr_t base, phys_size_t size);
  75. extern long lmb_reserve(struct lmb *lmb, phys_addr_t base, phys_size_t size);
  76. /**
  77. * lmb_reserve_flags - Reserve one region with a specific flags bitfield.
  78. *
  79. * @lmb the logical memory block struct
  80. * @base base address of the memory region
  81. * @size size of the memory region
  82. * @flags flags for the memory region
  83. * @return 0 if OK, > 0 for coalesced region or a negative error code.
  84. */
  85. long lmb_reserve_flags(struct lmb *lmb, phys_addr_t base,
  86. phys_size_t size, enum lmb_flags flags);
  87. extern phys_addr_t lmb_alloc(struct lmb *lmb, phys_size_t size, ulong align);
  88. extern phys_addr_t lmb_alloc_base(struct lmb *lmb, phys_size_t size, ulong align,
  89. phys_addr_t max_addr);
  90. extern phys_addr_t __lmb_alloc_base(struct lmb *lmb, phys_size_t size, ulong align,
  91. phys_addr_t max_addr);
  92. extern phys_addr_t lmb_alloc_addr(struct lmb *lmb, phys_addr_t base,
  93. phys_size_t size);
  94. extern phys_size_t lmb_get_free_size(struct lmb *lmb, phys_addr_t addr);
  95. extern int lmb_is_reserved(struct lmb *lmb, phys_addr_t addr);
  96. /**
  97. * lmb_is_reserved_flags - test if tha address is in reserved region with a bitfield flag
  98. *
  99. * @lmb the logical memory block struct
  100. * @addr address to be tested
  101. * @flags flags bitfied to be tested
  102. * @return 0 if not reserved or reserved without the requested flag else 1
  103. */
  104. int lmb_is_reserved_flags(struct lmb *lmb, phys_addr_t addr, int flags);
  105. extern long lmb_free(struct lmb *lmb, phys_addr_t base, phys_size_t size);
  106. extern void lmb_dump_all(struct lmb *lmb);
  107. extern void lmb_dump_all_force(struct lmb *lmb);
  108. static inline phys_size_t
  109. lmb_size_bytes(struct lmb_region *type, unsigned long region_nr)
  110. {
  111. return type->region[region_nr].size;
  112. }
  113. void board_lmb_reserve(struct lmb *lmb);
  114. void arch_lmb_reserve(struct lmb *lmb);
  115. /* Low level functions */
  116. static inline bool lmb_is_nomap(struct lmb_property *m)
  117. {
  118. return m->flags & LMB_NOMAP;
  119. }
  120. #endif /* __KERNEL__ */
  121. #endif /* _LINUX_LMB_H */