631  * DOC: lru scan roster
641  * interfaces. First a scan operation needs to be initialized with
651  * in the scan mode no other operation is allowed.
654  * reported true) in the scan, and any overlapping nodes after color adjustment
658  * scan operation even begins this is linear in the number of objects. It
664  * @scan: scan state
665  * @mm: drm_mm to scan
677  * As long as the scan list is non-empty, no other operations than
678  * adding/removing nodes to/from the scan list are allowed.
680 void drm_mm_scan_init_with_range(struct drm_mm_scan *scan,  in drm_mm_scan_init_with_range()  argument
693 	scan->mm = mm;  in drm_mm_scan_init_with_range()
698 	scan->color = color;  in drm_mm_scan_init_with_range()
699 	scan->alignment = alignment;  in drm_mm_scan_init_with_range()
700 	scan->remainder_mask = is_power_of_2(alignment) ? alignment - 1 : 0;  in drm_mm_scan_init_with_range()
701 	scan->size = size;  in drm_mm_scan_init_with_range()
702 	scan->mode = mode;  in drm_mm_scan_init_with_range()
705 	scan->range_start = start;  in drm_mm_scan_init_with_range()
706 	scan->range_end = end;  in drm_mm_scan_init_with_range()
708 	scan->hit_start = U64_MAX;  in drm_mm_scan_init_with_range()
709 	scan->hit_end = 0;  in drm_mm_scan_init_with_range()
714  * drm_mm_scan_add_block - add a node to the scan list
715  * @scan: the active drm_mm scanner
718  * Add a node to the scan list that might be freed to make space for the desired
724 bool drm_mm_scan_add_block(struct drm_mm_scan *scan,  in drm_mm_scan_add_block()  argument
727 	struct drm_mm *mm = scan->mm;  in drm_mm_scan_add_block()
754 		mm->color_adjust(hole, scan->color, &col_start, &col_end);  in drm_mm_scan_add_block()
756 	adj_start = max(col_start, scan->range_start);  in drm_mm_scan_add_block()
757 	adj_end = min(col_end, scan->range_end);  in drm_mm_scan_add_block()
758 	if (adj_end <= adj_start || adj_end - adj_start < scan->size)  in drm_mm_scan_add_block()
761 	if (scan->mode == DRM_MM_INSERT_HIGH)  in drm_mm_scan_add_block()
762 		adj_start = adj_end - scan->size;  in drm_mm_scan_add_block()
764 	if (scan->alignment) {  in drm_mm_scan_add_block()
767 		if (likely(scan->remainder_mask))  in drm_mm_scan_add_block()
768 			rem = adj_start & scan->remainder_mask;  in drm_mm_scan_add_block()
770 			div64_u64_rem(adj_start, scan->alignment, &rem);  in drm_mm_scan_add_block()
773 			if (scan->mode != DRM_MM_INSERT_HIGH)  in drm_mm_scan_add_block()
774 				adj_start += scan->alignment;  in drm_mm_scan_add_block()
775 			if (adj_start < max(col_start, scan->range_start) ||  in drm_mm_scan_add_block()
776 			    min(col_end, scan->range_end) - adj_start < scan->size)  in drm_mm_scan_add_block()
780 			    adj_end - adj_start < scan->size)  in drm_mm_scan_add_block()
785 	scan->hit_start = adj_start;  in drm_mm_scan_add_block()
786 	scan->hit_end = adj_start + scan->size;  in drm_mm_scan_add_block()
788 	DRM_MM_BUG_ON(scan->hit_start >= scan->hit_end);  in drm_mm_scan_add_block()
789 	DRM_MM_BUG_ON(scan->hit_start < hole_start);  in drm_mm_scan_add_block()
790 	DRM_MM_BUG_ON(scan->hit_end > hole_end);  in drm_mm_scan_add_block()
797  * drm_mm_scan_remove_block - remove a node from the scan list
798  * @scan: the active drm_mm scanner
801  * Nodes **must** be removed in exactly the reverse order from the scan list as
806  * When the scan list is empty, the selected memory nodes can be freed. An
815 bool drm_mm_scan_remove_block(struct drm_mm_scan *scan,  in drm_mm_scan_remove_block()  argument
820 	DRM_MM_BUG_ON(node->mm != scan->mm);  in drm_mm_scan_remove_block()
840 	return (node->start + node->size > scan->hit_start &&  in drm_mm_scan_remove_block()
841 		node->start < scan->hit_end);  in drm_mm_scan_remove_block()
847  * @scan: drm_mm scan with target hole
849  * After completing an eviction scan and removing the selected nodes, we may
856 struct drm_mm_node *drm_mm_scan_color_evict(struct drm_mm_scan *scan)  in drm_mm_scan_color_evict()  argument
858 	struct drm_mm *mm = scan->mm;  in drm_mm_scan_color_evict()
876 		if (hole_start <= scan->hit_start &&  in drm_mm_scan_color_evict()
877 		    hole_end >= scan->hit_end)  in drm_mm_scan_color_evict()
886 	DRM_MM_BUG_ON(hole_start > scan->hit_start);  in drm_mm_scan_color_evict()
887 	DRM_MM_BUG_ON(hole_end < scan->hit_end);  in drm_mm_scan_color_evict()
889 	mm->color_adjust(hole, scan->color, &hole_start, &hole_end);  in drm_mm_scan_color_evict()
890 	if (hole_start > scan->hit_start)  in drm_mm_scan_color_evict()
892 	if (hole_end < scan->hit_end)  in drm_mm_scan_color_evict()