io-pgtable-arm.c 28 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081
  1. /*
  2. * CPU-agnostic ARM page table allocator.
  3. *
  4. * This program is free software; you can redistribute it and/or modify
  5. * it under the terms of the GNU General Public License version 2 as
  6. * published by the Free Software Foundation.
  7. *
  8. * This program is distributed in the hope that it will be useful,
  9. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  10. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  11. * GNU General Public License for more details.
  12. *
  13. * You should have received a copy of the GNU General Public License
  14. * along with this program. If not, see <http://www.gnu.org/licenses/>.
  15. *
  16. * Copyright (C) 2014 ARM Limited
  17. *
  18. * Author: Will Deacon <will.deacon@arm.com>
  19. */
  20. #define pr_fmt(fmt) "arm-lpae io-pgtable: " fmt
  21. #include <linux/iommu.h>
  22. #include <linux/kernel.h>
  23. #include <linux/sizes.h>
  24. #include <linux/slab.h>
  25. #include <linux/types.h>
  26. #include <linux/dma-mapping.h>
  27. #include <asm/barrier.h>
  28. #include "io-pgtable.h"
  29. #define ARM_LPAE_MAX_ADDR_BITS 48
  30. #define ARM_LPAE_S2_MAX_CONCAT_PAGES 16
  31. #define ARM_LPAE_MAX_LEVELS 4
  32. /* Struct accessors */
  33. #define io_pgtable_to_data(x) \
  34. container_of((x), struct arm_lpae_io_pgtable, iop)
  35. #define io_pgtable_ops_to_data(x) \
  36. io_pgtable_to_data(io_pgtable_ops_to_pgtable(x))
  37. /*
  38. * For consistency with the architecture, we always consider
  39. * ARM_LPAE_MAX_LEVELS levels, with the walk starting at level n >=0
  40. */
  41. #define ARM_LPAE_START_LVL(d) (ARM_LPAE_MAX_LEVELS - (d)->levels)
  42. /*
  43. * Calculate the right shift amount to get to the portion describing level l
  44. * in a virtual address mapped by the pagetable in d.
  45. */
  46. #define ARM_LPAE_LVL_SHIFT(l,d) \
  47. ((((d)->levels - ((l) - ARM_LPAE_START_LVL(d) + 1)) \
  48. * (d)->bits_per_level) + (d)->pg_shift)
  49. #define ARM_LPAE_GRANULE(d) (1UL << (d)->pg_shift)
  50. #define ARM_LPAE_PAGES_PER_PGD(d) \
  51. DIV_ROUND_UP((d)->pgd_size, ARM_LPAE_GRANULE(d))
  52. /*
  53. * Calculate the index at level l used to map virtual address a using the
  54. * pagetable in d.
  55. */
  56. #define ARM_LPAE_PGD_IDX(l,d) \
  57. ((l) == ARM_LPAE_START_LVL(d) ? ilog2(ARM_LPAE_PAGES_PER_PGD(d)) : 0)
  58. #define ARM_LPAE_LVL_IDX(a,l,d) \
  59. (((u64)(a) >> ARM_LPAE_LVL_SHIFT(l,d)) & \
  60. ((1 << ((d)->bits_per_level + ARM_LPAE_PGD_IDX(l,d))) - 1))
  61. /* Calculate the block/page mapping size at level l for pagetable in d. */
  62. #define ARM_LPAE_BLOCK_SIZE(l,d) \
  63. (1 << (ilog2(sizeof(arm_lpae_iopte)) + \
  64. ((ARM_LPAE_MAX_LEVELS - (l)) * (d)->bits_per_level)))
  65. /* Page table bits */
  66. #define ARM_LPAE_PTE_TYPE_SHIFT 0
  67. #define ARM_LPAE_PTE_TYPE_MASK 0x3
  68. #define ARM_LPAE_PTE_TYPE_BLOCK 1
  69. #define ARM_LPAE_PTE_TYPE_TABLE 3
  70. #define ARM_LPAE_PTE_TYPE_PAGE 3
  71. #define ARM_LPAE_PTE_NSTABLE (((arm_lpae_iopte)1) << 63)
  72. #define ARM_LPAE_PTE_XN (((arm_lpae_iopte)3) << 53)
  73. #define ARM_LPAE_PTE_AF (((arm_lpae_iopte)1) << 10)
  74. #define ARM_LPAE_PTE_SH_NS (((arm_lpae_iopte)0) << 8)
  75. #define ARM_LPAE_PTE_SH_OS (((arm_lpae_iopte)2) << 8)
  76. #define ARM_LPAE_PTE_SH_IS (((arm_lpae_iopte)3) << 8)
  77. #define ARM_LPAE_PTE_NS (((arm_lpae_iopte)1) << 5)
  78. #define ARM_LPAE_PTE_VALID (((arm_lpae_iopte)1) << 0)
  79. #define ARM_LPAE_PTE_ATTR_LO_MASK (((arm_lpae_iopte)0x3ff) << 2)
  80. /* Ignore the contiguous bit for block splitting */
  81. #define ARM_LPAE_PTE_ATTR_HI_MASK (((arm_lpae_iopte)6) << 52)
  82. #define ARM_LPAE_PTE_ATTR_MASK (ARM_LPAE_PTE_ATTR_LO_MASK | \
  83. ARM_LPAE_PTE_ATTR_HI_MASK)
  84. /* Stage-1 PTE */
  85. #define ARM_LPAE_PTE_AP_UNPRIV (((arm_lpae_iopte)1) << 6)
  86. #define ARM_LPAE_PTE_AP_RDONLY (((arm_lpae_iopte)2) << 6)
  87. #define ARM_LPAE_PTE_ATTRINDX_SHIFT 2
  88. #define ARM_LPAE_PTE_nG (((arm_lpae_iopte)1) << 11)
  89. /* Stage-2 PTE */
  90. #define ARM_LPAE_PTE_HAP_FAULT (((arm_lpae_iopte)0) << 6)
  91. #define ARM_LPAE_PTE_HAP_READ (((arm_lpae_iopte)1) << 6)
  92. #define ARM_LPAE_PTE_HAP_WRITE (((arm_lpae_iopte)2) << 6)
  93. #define ARM_LPAE_PTE_MEMATTR_OIWB (((arm_lpae_iopte)0xf) << 2)
  94. #define ARM_LPAE_PTE_MEMATTR_NC (((arm_lpae_iopte)0x5) << 2)
  95. #define ARM_LPAE_PTE_MEMATTR_DEV (((arm_lpae_iopte)0x1) << 2)
  96. /* Register bits */
  97. #define ARM_32_LPAE_TCR_EAE (1 << 31)
  98. #define ARM_64_LPAE_S2_TCR_RES1 (1 << 31)
  99. #define ARM_LPAE_TCR_EPD1 (1 << 23)
  100. #define ARM_LPAE_TCR_TG0_4K (0 << 14)
  101. #define ARM_LPAE_TCR_TG0_64K (1 << 14)
  102. #define ARM_LPAE_TCR_TG0_16K (2 << 14)
  103. #define ARM_LPAE_TCR_SH0_SHIFT 12
  104. #define ARM_LPAE_TCR_SH0_MASK 0x3
  105. #define ARM_LPAE_TCR_SH_NS 0
  106. #define ARM_LPAE_TCR_SH_OS 2
  107. #define ARM_LPAE_TCR_SH_IS 3
  108. #define ARM_LPAE_TCR_ORGN0_SHIFT 10
  109. #define ARM_LPAE_TCR_IRGN0_SHIFT 8
  110. #define ARM_LPAE_TCR_RGN_MASK 0x3
  111. #define ARM_LPAE_TCR_RGN_NC 0
  112. #define ARM_LPAE_TCR_RGN_WBWA 1
  113. #define ARM_LPAE_TCR_RGN_WT 2
  114. #define ARM_LPAE_TCR_RGN_WB 3
  115. #define ARM_LPAE_TCR_SL0_SHIFT 6
  116. #define ARM_LPAE_TCR_SL0_MASK 0x3
  117. #define ARM_LPAE_TCR_T0SZ_SHIFT 0
  118. #define ARM_LPAE_TCR_SZ_MASK 0xf
  119. #define ARM_LPAE_TCR_PS_SHIFT 16
  120. #define ARM_LPAE_TCR_PS_MASK 0x7
  121. #define ARM_LPAE_TCR_IPS_SHIFT 32
  122. #define ARM_LPAE_TCR_IPS_MASK 0x7
  123. #define ARM_LPAE_TCR_PS_32_BIT 0x0ULL
  124. #define ARM_LPAE_TCR_PS_36_BIT 0x1ULL
  125. #define ARM_LPAE_TCR_PS_40_BIT 0x2ULL
  126. #define ARM_LPAE_TCR_PS_42_BIT 0x3ULL
  127. #define ARM_LPAE_TCR_PS_44_BIT 0x4ULL
  128. #define ARM_LPAE_TCR_PS_48_BIT 0x5ULL
  129. #define ARM_LPAE_MAIR_ATTR_SHIFT(n) ((n) << 3)
  130. #define ARM_LPAE_MAIR_ATTR_MASK 0xff
  131. #define ARM_LPAE_MAIR_ATTR_DEVICE 0x04
  132. #define ARM_LPAE_MAIR_ATTR_NC 0x44
  133. #define ARM_LPAE_MAIR_ATTR_WBRWA 0xff
  134. #define ARM_LPAE_MAIR_ATTR_IDX_NC 0
  135. #define ARM_LPAE_MAIR_ATTR_IDX_CACHE 1
  136. #define ARM_LPAE_MAIR_ATTR_IDX_DEV 2
  137. /* IOPTE accessors */
  138. #define iopte_deref(pte,d) \
  139. (__va((pte) & ((1ULL << ARM_LPAE_MAX_ADDR_BITS) - 1) \
  140. & ~(ARM_LPAE_GRANULE(d) - 1ULL)))
  141. #define iopte_type(pte,l) \
  142. (((pte) >> ARM_LPAE_PTE_TYPE_SHIFT) & ARM_LPAE_PTE_TYPE_MASK)
  143. #define iopte_prot(pte) ((pte) & ARM_LPAE_PTE_ATTR_MASK)
  144. #define iopte_leaf(pte,l) \
  145. (l == (ARM_LPAE_MAX_LEVELS - 1) ? \
  146. (iopte_type(pte,l) == ARM_LPAE_PTE_TYPE_PAGE) : \
  147. (iopte_type(pte,l) == ARM_LPAE_PTE_TYPE_BLOCK))
  148. #define iopte_to_pfn(pte,d) \
  149. (((pte) & ((1ULL << ARM_LPAE_MAX_ADDR_BITS) - 1)) >> (d)->pg_shift)
  150. #define pfn_to_iopte(pfn,d) \
  151. (((pfn) << (d)->pg_shift) & ((1ULL << ARM_LPAE_MAX_ADDR_BITS) - 1))
  152. struct arm_lpae_io_pgtable {
  153. struct io_pgtable iop;
  154. int levels;
  155. size_t pgd_size;
  156. unsigned long pg_shift;
  157. unsigned long bits_per_level;
  158. void *pgd;
  159. };
  160. typedef u64 arm_lpae_iopte;
  161. static bool selftest_running = false;
  162. static dma_addr_t __arm_lpae_dma_addr(void *pages)
  163. {
  164. return (dma_addr_t)virt_to_phys(pages);
  165. }
  166. static void *__arm_lpae_alloc_pages(size_t size, gfp_t gfp,
  167. struct io_pgtable_cfg *cfg)
  168. {
  169. struct device *dev = cfg->iommu_dev;
  170. dma_addr_t dma;
  171. void *pages = alloc_pages_exact(size, gfp | __GFP_ZERO);
  172. if (!pages)
  173. return NULL;
  174. if (!selftest_running) {
  175. dma = dma_map_single(dev, pages, size, DMA_TO_DEVICE);
  176. if (dma_mapping_error(dev, dma))
  177. goto out_free;
  178. /*
  179. * We depend on the IOMMU being able to work with any physical
  180. * address directly, so if the DMA layer suggests otherwise by
  181. * translating or truncating them, that bodes very badly...
  182. */
  183. if (dma != virt_to_phys(pages))
  184. goto out_unmap;
  185. }
  186. return pages;
  187. out_unmap:
  188. dev_err(dev, "Cannot accommodate DMA translation for IOMMU page tables\n");
  189. dma_unmap_single(dev, dma, size, DMA_TO_DEVICE);
  190. out_free:
  191. free_pages_exact(pages, size);
  192. return NULL;
  193. }
  194. static void __arm_lpae_free_pages(void *pages, size_t size,
  195. struct io_pgtable_cfg *cfg)
  196. {
  197. if (!selftest_running)
  198. dma_unmap_single(cfg->iommu_dev, __arm_lpae_dma_addr(pages),
  199. size, DMA_TO_DEVICE);
  200. free_pages_exact(pages, size);
  201. }
  202. static void __arm_lpae_set_pte(arm_lpae_iopte *ptep, arm_lpae_iopte pte,
  203. struct io_pgtable_cfg *cfg)
  204. {
  205. *ptep = pte;
  206. if (!selftest_running)
  207. dma_sync_single_for_device(cfg->iommu_dev,
  208. __arm_lpae_dma_addr(ptep),
  209. sizeof(pte), DMA_TO_DEVICE);
  210. }
  211. static int __arm_lpae_unmap(struct arm_lpae_io_pgtable *data,
  212. unsigned long iova, size_t size, int lvl,
  213. arm_lpae_iopte *ptep);
  214. static int arm_lpae_init_pte(struct arm_lpae_io_pgtable *data,
  215. unsigned long iova, phys_addr_t paddr,
  216. arm_lpae_iopte prot, int lvl,
  217. arm_lpae_iopte *ptep)
  218. {
  219. arm_lpae_iopte pte = prot;
  220. struct io_pgtable_cfg *cfg = &data->iop.cfg;
  221. if (iopte_leaf(*ptep, lvl)) {
  222. /* We require an unmap first */
  223. WARN_ON(!selftest_running);
  224. return -EEXIST;
  225. } else if (iopte_type(*ptep, lvl) == ARM_LPAE_PTE_TYPE_TABLE) {
  226. /*
  227. * We need to unmap and free the old table before
  228. * overwriting it with a block entry.
  229. */
  230. arm_lpae_iopte *tblp;
  231. size_t sz = ARM_LPAE_BLOCK_SIZE(lvl, data);
  232. tblp = ptep - ARM_LPAE_LVL_IDX(iova, lvl, data);
  233. if (WARN_ON(__arm_lpae_unmap(data, iova, sz, lvl, tblp) != sz))
  234. return -EINVAL;
  235. }
  236. if (cfg->quirks & IO_PGTABLE_QUIRK_ARM_NS)
  237. pte |= ARM_LPAE_PTE_NS;
  238. if (lvl == ARM_LPAE_MAX_LEVELS - 1)
  239. pte |= ARM_LPAE_PTE_TYPE_PAGE;
  240. else
  241. pte |= ARM_LPAE_PTE_TYPE_BLOCK;
  242. pte |= ARM_LPAE_PTE_AF | ARM_LPAE_PTE_SH_IS;
  243. pte |= pfn_to_iopte(paddr >> data->pg_shift, data);
  244. __arm_lpae_set_pte(ptep, pte, cfg);
  245. return 0;
  246. }
  247. static int __arm_lpae_map(struct arm_lpae_io_pgtable *data, unsigned long iova,
  248. phys_addr_t paddr, size_t size, arm_lpae_iopte prot,
  249. int lvl, arm_lpae_iopte *ptep)
  250. {
  251. arm_lpae_iopte *cptep, pte;
  252. size_t block_size = ARM_LPAE_BLOCK_SIZE(lvl, data);
  253. struct io_pgtable_cfg *cfg = &data->iop.cfg;
  254. /* Find our entry at the current level */
  255. ptep += ARM_LPAE_LVL_IDX(iova, lvl, data);
  256. /* If we can install a leaf entry at this level, then do so */
  257. if (size == block_size && (size & cfg->pgsize_bitmap))
  258. return arm_lpae_init_pte(data, iova, paddr, prot, lvl, ptep);
  259. /* We can't allocate tables at the final level */
  260. if (WARN_ON(lvl >= ARM_LPAE_MAX_LEVELS - 1))
  261. return -EINVAL;
  262. /* Grab a pointer to the next level */
  263. pte = *ptep;
  264. if (!pte) {
  265. cptep = __arm_lpae_alloc_pages(ARM_LPAE_GRANULE(data),
  266. GFP_ATOMIC, cfg);
  267. if (!cptep)
  268. return -ENOMEM;
  269. pte = __pa(cptep) | ARM_LPAE_PTE_TYPE_TABLE;
  270. if (cfg->quirks & IO_PGTABLE_QUIRK_ARM_NS)
  271. pte |= ARM_LPAE_PTE_NSTABLE;
  272. __arm_lpae_set_pte(ptep, pte, cfg);
  273. } else {
  274. cptep = iopte_deref(pte, data);
  275. }
  276. /* Rinse, repeat */
  277. return __arm_lpae_map(data, iova, paddr, size, prot, lvl + 1, cptep);
  278. }
  279. static arm_lpae_iopte arm_lpae_prot_to_pte(struct arm_lpae_io_pgtable *data,
  280. int prot)
  281. {
  282. arm_lpae_iopte pte;
  283. if (data->iop.fmt == ARM_64_LPAE_S1 ||
  284. data->iop.fmt == ARM_32_LPAE_S1) {
  285. pte = ARM_LPAE_PTE_AP_UNPRIV | ARM_LPAE_PTE_nG;
  286. if (!(prot & IOMMU_WRITE) && (prot & IOMMU_READ))
  287. pte |= ARM_LPAE_PTE_AP_RDONLY;
  288. if (prot & IOMMU_MMIO)
  289. pte |= (ARM_LPAE_MAIR_ATTR_IDX_DEV
  290. << ARM_LPAE_PTE_ATTRINDX_SHIFT);
  291. else if (prot & IOMMU_CACHE)
  292. pte |= (ARM_LPAE_MAIR_ATTR_IDX_CACHE
  293. << ARM_LPAE_PTE_ATTRINDX_SHIFT);
  294. } else {
  295. pte = ARM_LPAE_PTE_HAP_FAULT;
  296. if (prot & IOMMU_READ)
  297. pte |= ARM_LPAE_PTE_HAP_READ;
  298. if (prot & IOMMU_WRITE)
  299. pte |= ARM_LPAE_PTE_HAP_WRITE;
  300. if (prot & IOMMU_MMIO)
  301. pte |= ARM_LPAE_PTE_MEMATTR_DEV;
  302. else if (prot & IOMMU_CACHE)
  303. pte |= ARM_LPAE_PTE_MEMATTR_OIWB;
  304. else
  305. pte |= ARM_LPAE_PTE_MEMATTR_NC;
  306. }
  307. if (prot & IOMMU_NOEXEC)
  308. pte |= ARM_LPAE_PTE_XN;
  309. return pte;
  310. }
  311. static int arm_lpae_map(struct io_pgtable_ops *ops, unsigned long iova,
  312. phys_addr_t paddr, size_t size, int iommu_prot)
  313. {
  314. struct arm_lpae_io_pgtable *data = io_pgtable_ops_to_data(ops);
  315. arm_lpae_iopte *ptep = data->pgd;
  316. int ret, lvl = ARM_LPAE_START_LVL(data);
  317. arm_lpae_iopte prot;
  318. /* If no access, then nothing to do */
  319. if (!(iommu_prot & (IOMMU_READ | IOMMU_WRITE)))
  320. return 0;
  321. prot = arm_lpae_prot_to_pte(data, iommu_prot);
  322. ret = __arm_lpae_map(data, iova, paddr, size, prot, lvl, ptep);
  323. /*
  324. * Synchronise all PTE updates for the new mapping before there's
  325. * a chance for anything to kick off a table walk for the new iova.
  326. */
  327. wmb();
  328. return ret;
  329. }
  330. static void __arm_lpae_free_pgtable(struct arm_lpae_io_pgtable *data, int lvl,
  331. arm_lpae_iopte *ptep)
  332. {
  333. arm_lpae_iopte *start, *end;
  334. unsigned long table_size;
  335. if (lvl == ARM_LPAE_START_LVL(data))
  336. table_size = data->pgd_size;
  337. else
  338. table_size = ARM_LPAE_GRANULE(data);
  339. start = ptep;
  340. /* Only leaf entries at the last level */
  341. if (lvl == ARM_LPAE_MAX_LEVELS - 1)
  342. end = ptep;
  343. else
  344. end = (void *)ptep + table_size;
  345. while (ptep != end) {
  346. arm_lpae_iopte pte = *ptep++;
  347. if (!pte || iopte_leaf(pte, lvl))
  348. continue;
  349. __arm_lpae_free_pgtable(data, lvl + 1, iopte_deref(pte, data));
  350. }
  351. __arm_lpae_free_pages(start, table_size, &data->iop.cfg);
  352. }
  353. static void arm_lpae_free_pgtable(struct io_pgtable *iop)
  354. {
  355. struct arm_lpae_io_pgtable *data = io_pgtable_to_data(iop);
  356. __arm_lpae_free_pgtable(data, ARM_LPAE_START_LVL(data), data->pgd);
  357. kfree(data);
  358. }
  359. static int arm_lpae_split_blk_unmap(struct arm_lpae_io_pgtable *data,
  360. unsigned long iova, size_t size,
  361. arm_lpae_iopte prot, int lvl,
  362. arm_lpae_iopte *ptep, size_t blk_size)
  363. {
  364. unsigned long blk_start, blk_end;
  365. phys_addr_t blk_paddr;
  366. arm_lpae_iopte table = 0;
  367. blk_start = iova & ~(blk_size - 1);
  368. blk_end = blk_start + blk_size;
  369. blk_paddr = iopte_to_pfn(*ptep, data) << data->pg_shift;
  370. for (; blk_start < blk_end; blk_start += size, blk_paddr += size) {
  371. arm_lpae_iopte *tablep;
  372. /* Unmap! */
  373. if (blk_start == iova)
  374. continue;
  375. /* __arm_lpae_map expects a pointer to the start of the table */
  376. tablep = &table - ARM_LPAE_LVL_IDX(blk_start, lvl, data);
  377. if (__arm_lpae_map(data, blk_start, blk_paddr, size, prot, lvl,
  378. tablep) < 0) {
  379. if (table) {
  380. /* Free the table we allocated */
  381. tablep = iopte_deref(table, data);
  382. __arm_lpae_free_pgtable(data, lvl + 1, tablep);
  383. }
  384. return 0; /* Bytes unmapped */
  385. }
  386. }
  387. __arm_lpae_set_pte(ptep, table, &data->iop.cfg);
  388. iova &= ~(blk_size - 1);
  389. io_pgtable_tlb_add_flush(&data->iop, iova, blk_size, blk_size, true);
  390. return size;
  391. }
  392. static int __arm_lpae_unmap(struct arm_lpae_io_pgtable *data,
  393. unsigned long iova, size_t size, int lvl,
  394. arm_lpae_iopte *ptep)
  395. {
  396. arm_lpae_iopte pte;
  397. struct io_pgtable *iop = &data->iop;
  398. size_t blk_size = ARM_LPAE_BLOCK_SIZE(lvl, data);
  399. /* Something went horribly wrong and we ran out of page table */
  400. if (WARN_ON(lvl == ARM_LPAE_MAX_LEVELS))
  401. return 0;
  402. ptep += ARM_LPAE_LVL_IDX(iova, lvl, data);
  403. pte = *ptep;
  404. if (WARN_ON(!pte))
  405. return 0;
  406. /* If the size matches this level, we're in the right place */
  407. if (size == blk_size) {
  408. __arm_lpae_set_pte(ptep, 0, &iop->cfg);
  409. if (!iopte_leaf(pte, lvl)) {
  410. /* Also flush any partial walks */
  411. io_pgtable_tlb_add_flush(iop, iova, size,
  412. ARM_LPAE_GRANULE(data), false);
  413. io_pgtable_tlb_sync(iop);
  414. ptep = iopte_deref(pte, data);
  415. __arm_lpae_free_pgtable(data, lvl + 1, ptep);
  416. } else {
  417. io_pgtable_tlb_add_flush(iop, iova, size, size, true);
  418. }
  419. return size;
  420. } else if (iopte_leaf(pte, lvl)) {
  421. /*
  422. * Insert a table at the next level to map the old region,
  423. * minus the part we want to unmap
  424. */
  425. return arm_lpae_split_blk_unmap(data, iova, size,
  426. iopte_prot(pte), lvl, ptep,
  427. blk_size);
  428. }
  429. /* Keep on walkin' */
  430. ptep = iopte_deref(pte, data);
  431. return __arm_lpae_unmap(data, iova, size, lvl + 1, ptep);
  432. }
  433. static int arm_lpae_unmap(struct io_pgtable_ops *ops, unsigned long iova,
  434. size_t size)
  435. {
  436. size_t unmapped;
  437. struct arm_lpae_io_pgtable *data = io_pgtable_ops_to_data(ops);
  438. arm_lpae_iopte *ptep = data->pgd;
  439. int lvl = ARM_LPAE_START_LVL(data);
  440. unmapped = __arm_lpae_unmap(data, iova, size, lvl, ptep);
  441. if (unmapped)
  442. io_pgtable_tlb_sync(&data->iop);
  443. return unmapped;
  444. }
  445. static phys_addr_t arm_lpae_iova_to_phys(struct io_pgtable_ops *ops,
  446. unsigned long iova)
  447. {
  448. struct arm_lpae_io_pgtable *data = io_pgtable_ops_to_data(ops);
  449. arm_lpae_iopte pte, *ptep = data->pgd;
  450. int lvl = ARM_LPAE_START_LVL(data);
  451. do {
  452. /* Valid IOPTE pointer? */
  453. if (!ptep)
  454. return 0;
  455. /* Grab the IOPTE we're interested in */
  456. pte = *(ptep + ARM_LPAE_LVL_IDX(iova, lvl, data));
  457. /* Valid entry? */
  458. if (!pte)
  459. return 0;
  460. /* Leaf entry? */
  461. if (iopte_leaf(pte,lvl))
  462. goto found_translation;
  463. /* Take it to the next level */
  464. ptep = iopte_deref(pte, data);
  465. } while (++lvl < ARM_LPAE_MAX_LEVELS);
  466. /* Ran out of page tables to walk */
  467. return 0;
  468. found_translation:
  469. iova &= (ARM_LPAE_BLOCK_SIZE(lvl, data) - 1);
  470. return ((phys_addr_t)iopte_to_pfn(pte,data) << data->pg_shift) | iova;
  471. }
  472. static void arm_lpae_restrict_pgsizes(struct io_pgtable_cfg *cfg)
  473. {
  474. unsigned long granule;
  475. /*
  476. * We need to restrict the supported page sizes to match the
  477. * translation regime for a particular granule. Aim to match
  478. * the CPU page size if possible, otherwise prefer smaller sizes.
  479. * While we're at it, restrict the block sizes to match the
  480. * chosen granule.
  481. */
  482. if (cfg->pgsize_bitmap & PAGE_SIZE)
  483. granule = PAGE_SIZE;
  484. else if (cfg->pgsize_bitmap & ~PAGE_MASK)
  485. granule = 1UL << __fls(cfg->pgsize_bitmap & ~PAGE_MASK);
  486. else if (cfg->pgsize_bitmap & PAGE_MASK)
  487. granule = 1UL << __ffs(cfg->pgsize_bitmap & PAGE_MASK);
  488. else
  489. granule = 0;
  490. switch (granule) {
  491. case SZ_4K:
  492. cfg->pgsize_bitmap &= (SZ_4K | SZ_2M | SZ_1G);
  493. break;
  494. case SZ_16K:
  495. cfg->pgsize_bitmap &= (SZ_16K | SZ_32M);
  496. break;
  497. case SZ_64K:
  498. cfg->pgsize_bitmap &= (SZ_64K | SZ_512M);
  499. break;
  500. default:
  501. cfg->pgsize_bitmap = 0;
  502. }
  503. }
  504. static struct arm_lpae_io_pgtable *
  505. arm_lpae_alloc_pgtable(struct io_pgtable_cfg *cfg)
  506. {
  507. unsigned long va_bits, pgd_bits;
  508. struct arm_lpae_io_pgtable *data;
  509. arm_lpae_restrict_pgsizes(cfg);
  510. if (!(cfg->pgsize_bitmap & (SZ_4K | SZ_16K | SZ_64K)))
  511. return NULL;
  512. if (cfg->ias > ARM_LPAE_MAX_ADDR_BITS)
  513. return NULL;
  514. if (cfg->oas > ARM_LPAE_MAX_ADDR_BITS)
  515. return NULL;
  516. if (!selftest_running && cfg->iommu_dev->dma_pfn_offset) {
  517. dev_err(cfg->iommu_dev, "Cannot accommodate DMA offset for IOMMU page tables\n");
  518. return NULL;
  519. }
  520. data = kmalloc(sizeof(*data), GFP_KERNEL);
  521. if (!data)
  522. return NULL;
  523. data->pg_shift = __ffs(cfg->pgsize_bitmap);
  524. data->bits_per_level = data->pg_shift - ilog2(sizeof(arm_lpae_iopte));
  525. va_bits = cfg->ias - data->pg_shift;
  526. data->levels = DIV_ROUND_UP(va_bits, data->bits_per_level);
  527. /* Calculate the actual size of our pgd (without concatenation) */
  528. pgd_bits = va_bits - (data->bits_per_level * (data->levels - 1));
  529. data->pgd_size = 1UL << (pgd_bits + ilog2(sizeof(arm_lpae_iopte)));
  530. data->iop.ops = (struct io_pgtable_ops) {
  531. .map = arm_lpae_map,
  532. .unmap = arm_lpae_unmap,
  533. .iova_to_phys = arm_lpae_iova_to_phys,
  534. };
  535. return data;
  536. }
  537. static struct io_pgtable *
  538. arm_64_lpae_alloc_pgtable_s1(struct io_pgtable_cfg *cfg, void *cookie)
  539. {
  540. u64 reg;
  541. struct arm_lpae_io_pgtable *data;
  542. if (cfg->quirks & ~IO_PGTABLE_QUIRK_ARM_NS)
  543. return NULL;
  544. data = arm_lpae_alloc_pgtable(cfg);
  545. if (!data)
  546. return NULL;
  547. /* TCR */
  548. reg = (ARM_LPAE_TCR_SH_IS << ARM_LPAE_TCR_SH0_SHIFT) |
  549. (ARM_LPAE_TCR_RGN_WBWA << ARM_LPAE_TCR_IRGN0_SHIFT) |
  550. (ARM_LPAE_TCR_RGN_WBWA << ARM_LPAE_TCR_ORGN0_SHIFT);
  551. switch (ARM_LPAE_GRANULE(data)) {
  552. case SZ_4K:
  553. reg |= ARM_LPAE_TCR_TG0_4K;
  554. break;
  555. case SZ_16K:
  556. reg |= ARM_LPAE_TCR_TG0_16K;
  557. break;
  558. case SZ_64K:
  559. reg |= ARM_LPAE_TCR_TG0_64K;
  560. break;
  561. }
  562. switch (cfg->oas) {
  563. case 32:
  564. reg |= (ARM_LPAE_TCR_PS_32_BIT << ARM_LPAE_TCR_IPS_SHIFT);
  565. break;
  566. case 36:
  567. reg |= (ARM_LPAE_TCR_PS_36_BIT << ARM_LPAE_TCR_IPS_SHIFT);
  568. break;
  569. case 40:
  570. reg |= (ARM_LPAE_TCR_PS_40_BIT << ARM_LPAE_TCR_IPS_SHIFT);
  571. break;
  572. case 42:
  573. reg |= (ARM_LPAE_TCR_PS_42_BIT << ARM_LPAE_TCR_IPS_SHIFT);
  574. break;
  575. case 44:
  576. reg |= (ARM_LPAE_TCR_PS_44_BIT << ARM_LPAE_TCR_IPS_SHIFT);
  577. break;
  578. case 48:
  579. reg |= (ARM_LPAE_TCR_PS_48_BIT << ARM_LPAE_TCR_IPS_SHIFT);
  580. break;
  581. default:
  582. goto out_free_data;
  583. }
  584. reg |= (64ULL - cfg->ias) << ARM_LPAE_TCR_T0SZ_SHIFT;
  585. /* Disable speculative walks through TTBR1 */
  586. reg |= ARM_LPAE_TCR_EPD1;
  587. cfg->arm_lpae_s1_cfg.tcr = reg;
  588. /* MAIRs */
  589. reg = (ARM_LPAE_MAIR_ATTR_NC
  590. << ARM_LPAE_MAIR_ATTR_SHIFT(ARM_LPAE_MAIR_ATTR_IDX_NC)) |
  591. (ARM_LPAE_MAIR_ATTR_WBRWA
  592. << ARM_LPAE_MAIR_ATTR_SHIFT(ARM_LPAE_MAIR_ATTR_IDX_CACHE)) |
  593. (ARM_LPAE_MAIR_ATTR_DEVICE
  594. << ARM_LPAE_MAIR_ATTR_SHIFT(ARM_LPAE_MAIR_ATTR_IDX_DEV));
  595. cfg->arm_lpae_s1_cfg.mair[0] = reg;
  596. cfg->arm_lpae_s1_cfg.mair[1] = 0;
  597. /* Looking good; allocate a pgd */
  598. data->pgd = __arm_lpae_alloc_pages(data->pgd_size, GFP_KERNEL, cfg);
  599. if (!data->pgd)
  600. goto out_free_data;
  601. /* Ensure the empty pgd is visible before any actual TTBR write */
  602. wmb();
  603. /* TTBRs */
  604. cfg->arm_lpae_s1_cfg.ttbr[0] = virt_to_phys(data->pgd);
  605. cfg->arm_lpae_s1_cfg.ttbr[1] = 0;
  606. return &data->iop;
  607. out_free_data:
  608. kfree(data);
  609. return NULL;
  610. }
  611. static struct io_pgtable *
  612. arm_64_lpae_alloc_pgtable_s2(struct io_pgtable_cfg *cfg, void *cookie)
  613. {
  614. u64 reg, sl;
  615. struct arm_lpae_io_pgtable *data;
  616. /* The NS quirk doesn't apply at stage 2 */
  617. if (cfg->quirks)
  618. return NULL;
  619. data = arm_lpae_alloc_pgtable(cfg);
  620. if (!data)
  621. return NULL;
  622. /*
  623. * Concatenate PGDs at level 1 if possible in order to reduce
  624. * the depth of the stage-2 walk.
  625. */
  626. if (data->levels == ARM_LPAE_MAX_LEVELS) {
  627. unsigned long pgd_pages;
  628. pgd_pages = data->pgd_size >> ilog2(sizeof(arm_lpae_iopte));
  629. if (pgd_pages <= ARM_LPAE_S2_MAX_CONCAT_PAGES) {
  630. data->pgd_size = pgd_pages << data->pg_shift;
  631. data->levels--;
  632. }
  633. }
  634. /* VTCR */
  635. reg = ARM_64_LPAE_S2_TCR_RES1 |
  636. (ARM_LPAE_TCR_SH_IS << ARM_LPAE_TCR_SH0_SHIFT) |
  637. (ARM_LPAE_TCR_RGN_WBWA << ARM_LPAE_TCR_IRGN0_SHIFT) |
  638. (ARM_LPAE_TCR_RGN_WBWA << ARM_LPAE_TCR_ORGN0_SHIFT);
  639. sl = ARM_LPAE_START_LVL(data);
  640. switch (ARM_LPAE_GRANULE(data)) {
  641. case SZ_4K:
  642. reg |= ARM_LPAE_TCR_TG0_4K;
  643. sl++; /* SL0 format is different for 4K granule size */
  644. break;
  645. case SZ_16K:
  646. reg |= ARM_LPAE_TCR_TG0_16K;
  647. break;
  648. case SZ_64K:
  649. reg |= ARM_LPAE_TCR_TG0_64K;
  650. break;
  651. }
  652. switch (cfg->oas) {
  653. case 32:
  654. reg |= (ARM_LPAE_TCR_PS_32_BIT << ARM_LPAE_TCR_PS_SHIFT);
  655. break;
  656. case 36:
  657. reg |= (ARM_LPAE_TCR_PS_36_BIT << ARM_LPAE_TCR_PS_SHIFT);
  658. break;
  659. case 40:
  660. reg |= (ARM_LPAE_TCR_PS_40_BIT << ARM_LPAE_TCR_PS_SHIFT);
  661. break;
  662. case 42:
  663. reg |= (ARM_LPAE_TCR_PS_42_BIT << ARM_LPAE_TCR_PS_SHIFT);
  664. break;
  665. case 44:
  666. reg |= (ARM_LPAE_TCR_PS_44_BIT << ARM_LPAE_TCR_PS_SHIFT);
  667. break;
  668. case 48:
  669. reg |= (ARM_LPAE_TCR_PS_48_BIT << ARM_LPAE_TCR_PS_SHIFT);
  670. break;
  671. default:
  672. goto out_free_data;
  673. }
  674. reg |= (64ULL - cfg->ias) << ARM_LPAE_TCR_T0SZ_SHIFT;
  675. reg |= (~sl & ARM_LPAE_TCR_SL0_MASK) << ARM_LPAE_TCR_SL0_SHIFT;
  676. cfg->arm_lpae_s2_cfg.vtcr = reg;
  677. /* Allocate pgd pages */
  678. data->pgd = __arm_lpae_alloc_pages(data->pgd_size, GFP_KERNEL, cfg);
  679. if (!data->pgd)
  680. goto out_free_data;
  681. /* Ensure the empty pgd is visible before any actual TTBR write */
  682. wmb();
  683. /* VTTBR */
  684. cfg->arm_lpae_s2_cfg.vttbr = virt_to_phys(data->pgd);
  685. return &data->iop;
  686. out_free_data:
  687. kfree(data);
  688. return NULL;
  689. }
  690. static struct io_pgtable *
  691. arm_32_lpae_alloc_pgtable_s1(struct io_pgtable_cfg *cfg, void *cookie)
  692. {
  693. struct io_pgtable *iop;
  694. if (cfg->ias > 32 || cfg->oas > 40)
  695. return NULL;
  696. cfg->pgsize_bitmap &= (SZ_4K | SZ_2M | SZ_1G);
  697. iop = arm_64_lpae_alloc_pgtable_s1(cfg, cookie);
  698. if (iop) {
  699. cfg->arm_lpae_s1_cfg.tcr |= ARM_32_LPAE_TCR_EAE;
  700. cfg->arm_lpae_s1_cfg.tcr &= 0xffffffff;
  701. }
  702. return iop;
  703. }
  704. static struct io_pgtable *
  705. arm_32_lpae_alloc_pgtable_s2(struct io_pgtable_cfg *cfg, void *cookie)
  706. {
  707. struct io_pgtable *iop;
  708. if (cfg->ias > 40 || cfg->oas > 40)
  709. return NULL;
  710. cfg->pgsize_bitmap &= (SZ_4K | SZ_2M | SZ_1G);
  711. iop = arm_64_lpae_alloc_pgtable_s2(cfg, cookie);
  712. if (iop)
  713. cfg->arm_lpae_s2_cfg.vtcr &= 0xffffffff;
  714. return iop;
  715. }
  716. struct io_pgtable_init_fns io_pgtable_arm_64_lpae_s1_init_fns = {
  717. .alloc = arm_64_lpae_alloc_pgtable_s1,
  718. .free = arm_lpae_free_pgtable,
  719. };
  720. struct io_pgtable_init_fns io_pgtable_arm_64_lpae_s2_init_fns = {
  721. .alloc = arm_64_lpae_alloc_pgtable_s2,
  722. .free = arm_lpae_free_pgtable,
  723. };
  724. struct io_pgtable_init_fns io_pgtable_arm_32_lpae_s1_init_fns = {
  725. .alloc = arm_32_lpae_alloc_pgtable_s1,
  726. .free = arm_lpae_free_pgtable,
  727. };
  728. struct io_pgtable_init_fns io_pgtable_arm_32_lpae_s2_init_fns = {
  729. .alloc = arm_32_lpae_alloc_pgtable_s2,
  730. .free = arm_lpae_free_pgtable,
  731. };
  732. #ifdef CONFIG_IOMMU_IO_PGTABLE_LPAE_SELFTEST
  733. static struct io_pgtable_cfg *cfg_cookie;
  734. static void dummy_tlb_flush_all(void *cookie)
  735. {
  736. WARN_ON(cookie != cfg_cookie);
  737. }
  738. static void dummy_tlb_add_flush(unsigned long iova, size_t size,
  739. size_t granule, bool leaf, void *cookie)
  740. {
  741. WARN_ON(cookie != cfg_cookie);
  742. WARN_ON(!(size & cfg_cookie->pgsize_bitmap));
  743. }
  744. static void dummy_tlb_sync(void *cookie)
  745. {
  746. WARN_ON(cookie != cfg_cookie);
  747. }
  748. static const struct iommu_gather_ops dummy_tlb_ops __initconst = {
  749. .tlb_flush_all = dummy_tlb_flush_all,
  750. .tlb_add_flush = dummy_tlb_add_flush,
  751. .tlb_sync = dummy_tlb_sync,
  752. };
  753. static void __init arm_lpae_dump_ops(struct io_pgtable_ops *ops)
  754. {
  755. struct arm_lpae_io_pgtable *data = io_pgtable_ops_to_data(ops);
  756. struct io_pgtable_cfg *cfg = &data->iop.cfg;
  757. pr_err("cfg: pgsize_bitmap 0x%lx, ias %u-bit\n",
  758. cfg->pgsize_bitmap, cfg->ias);
  759. pr_err("data: %d levels, 0x%zx pgd_size, %lu pg_shift, %lu bits_per_level, pgd @ %p\n",
  760. data->levels, data->pgd_size, data->pg_shift,
  761. data->bits_per_level, data->pgd);
  762. }
  763. #define __FAIL(ops, i) ({ \
  764. WARN(1, "selftest: test failed for fmt idx %d\n", (i)); \
  765. arm_lpae_dump_ops(ops); \
  766. selftest_running = false; \
  767. -EFAULT; \
  768. })
  769. static int __init arm_lpae_run_tests(struct io_pgtable_cfg *cfg)
  770. {
  771. static const enum io_pgtable_fmt fmts[] = {
  772. ARM_64_LPAE_S1,
  773. ARM_64_LPAE_S2,
  774. };
  775. int i, j;
  776. unsigned long iova;
  777. size_t size;
  778. struct io_pgtable_ops *ops;
  779. selftest_running = true;
  780. for (i = 0; i < ARRAY_SIZE(fmts); ++i) {
  781. cfg_cookie = cfg;
  782. ops = alloc_io_pgtable_ops(fmts[i], cfg, cfg);
  783. if (!ops) {
  784. pr_err("selftest: failed to allocate io pgtable ops\n");
  785. return -ENOMEM;
  786. }
  787. /*
  788. * Initial sanity checks.
  789. * Empty page tables shouldn't provide any translations.
  790. */
  791. if (ops->iova_to_phys(ops, 42))
  792. return __FAIL(ops, i);
  793. if (ops->iova_to_phys(ops, SZ_1G + 42))
  794. return __FAIL(ops, i);
  795. if (ops->iova_to_phys(ops, SZ_2G + 42))
  796. return __FAIL(ops, i);
  797. /*
  798. * Distinct mappings of different granule sizes.
  799. */
  800. iova = 0;
  801. for_each_set_bit(j, &cfg->pgsize_bitmap, BITS_PER_LONG) {
  802. size = 1UL << j;
  803. if (ops->map(ops, iova, iova, size, IOMMU_READ |
  804. IOMMU_WRITE |
  805. IOMMU_NOEXEC |
  806. IOMMU_CACHE))
  807. return __FAIL(ops, i);
  808. /* Overlapping mappings */
  809. if (!ops->map(ops, iova, iova + size, size,
  810. IOMMU_READ | IOMMU_NOEXEC))
  811. return __FAIL(ops, i);
  812. if (ops->iova_to_phys(ops, iova + 42) != (iova + 42))
  813. return __FAIL(ops, i);
  814. iova += SZ_1G;
  815. }
  816. /* Partial unmap */
  817. size = 1UL << __ffs(cfg->pgsize_bitmap);
  818. if (ops->unmap(ops, SZ_1G + size, size) != size)
  819. return __FAIL(ops, i);
  820. /* Remap of partial unmap */
  821. if (ops->map(ops, SZ_1G + size, size, size, IOMMU_READ))
  822. return __FAIL(ops, i);
  823. if (ops->iova_to_phys(ops, SZ_1G + size + 42) != (size + 42))
  824. return __FAIL(ops, i);
  825. /* Full unmap */
  826. iova = 0;
  827. j = find_first_bit(&cfg->pgsize_bitmap, BITS_PER_LONG);
  828. while (j != BITS_PER_LONG) {
  829. size = 1UL << j;
  830. if (ops->unmap(ops, iova, size) != size)
  831. return __FAIL(ops, i);
  832. if (ops->iova_to_phys(ops, iova + 42))
  833. return __FAIL(ops, i);
  834. /* Remap full block */
  835. if (ops->map(ops, iova, iova, size, IOMMU_WRITE))
  836. return __FAIL(ops, i);
  837. if (ops->iova_to_phys(ops, iova + 42) != (iova + 42))
  838. return __FAIL(ops, i);
  839. iova += SZ_1G;
  840. j++;
  841. j = find_next_bit(&cfg->pgsize_bitmap, BITS_PER_LONG, j);
  842. }
  843. free_io_pgtable_ops(ops);
  844. }
  845. selftest_running = false;
  846. return 0;
  847. }
  848. static int __init arm_lpae_do_selftests(void)
  849. {
  850. static const unsigned long pgsize[] = {
  851. SZ_4K | SZ_2M | SZ_1G,
  852. SZ_16K | SZ_32M,
  853. SZ_64K | SZ_512M,
  854. };
  855. static const unsigned int ias[] = {
  856. 32, 36, 40, 42, 44, 48,
  857. };
  858. int i, j, pass = 0, fail = 0;
  859. struct io_pgtable_cfg cfg = {
  860. .tlb = &dummy_tlb_ops,
  861. .oas = 48,
  862. };
  863. for (i = 0; i < ARRAY_SIZE(pgsize); ++i) {
  864. for (j = 0; j < ARRAY_SIZE(ias); ++j) {
  865. cfg.pgsize_bitmap = pgsize[i];
  866. cfg.ias = ias[j];
  867. pr_info("selftest: pgsize_bitmap 0x%08lx, IAS %u\n",
  868. pgsize[i], ias[j]);
  869. if (arm_lpae_run_tests(&cfg))
  870. fail++;
  871. else
  872. pass++;
  873. }
  874. }
  875. pr_info("selftest: completed with %d PASS %d FAIL\n", pass, fail);
  876. return fail ? -EFAULT : 0;
  877. }
  878. subsys_initcall(arm_lpae_do_selftests);
  879. #endif