On some platforms we potentially have different alignment restrictions depending on the memory type. We also now have different alignment restrictions for the same region across different kernel versions. Extend the region query to return the minimum required GTT alignment.
Showing the changes to include/uapi (1 of 2 files). Show all
Unified · Split
| @@ -3346,8 +3346,33 @@ struct drm_i915_memory_region_info { · 3345 unmodified lines | ||
| 3346 | 3346 | /** @region: The class:instance pair encoding */ |
| 3347 | 3347 | struct drm_i915_gem_memory_class_instance region; |
| 3348 | 3348 | |
| 3349 | − /** @rsvd0: MBZ */ | |
| 3350 | − __u32 rsvd0; | |
| 3349 | + union { | |
| 3350 | + /** @rsvd0: MBZ */ | |
| 3351 | + __u32 rsvd0; | |
| 3352 | + /** | |
| 3353 | + * @gtt_alignment: | |
| 3354 | + * | |
| 3355 | + * The minimum required GTT alignment for this type of memory. | |
| 3356 | + * When allocating a GTT address it must be aligned to this | |
| 3357 | + * value or larger. On some platforms the kernel might opt to | |
| 3358 | + * using 64K pages for I915_MEMORY_CLASS_DEVICE, where 64K GTT | |
| 3359 | + * pages can then be used if we also use 64K GTT alignment. | |
| 3360 | + * | |
| 3361 | + * NOTE: If this is zero then this must be an older | |
| 3362 | + * kernel which lacks support for this field. | |
| 3363 | + * | |
| 3364 | + * Side note: For larger objects (especially for | |
| 3365 | + * I915_MEMORY_CLASS_DEVICE), like 2M+ in size, userspace should | |
| 3366 | + * consider potentially bumping the GTT alignment to say 2M, | |
| 3367 | + * which could potentially increase the likelihood of the kernel | |
| 3368 | + * being able to utilise 2M GTT pages underneath, if the layout | |
| 3369 | + * of the physical pages allows it. On some configurations we | |
| 3370 | + * can then also use a more efficient page-table layout, if we | |
| 3371 | + * can't use the more desirable 2M GTT page, so long as we know | |
| 3372 | + * that the entire page-table will be used by this object. | |
| 3373 | + */ | |
| 3374 | + __u32 gtt_alignment; | |
| 3375 | + }; | |
| 3351 | 3376 | |
| 3352 | 3377 | /** |
| 3353 | 3378 | * @probed_size: Memory probed by the driver |