bsd/kern/ubc_subr.c

59 #include <mach/upl.h>
942  *		of the file will require modification or use of an existing upl
994 	        upl_t		upl;
1003 	        kret = ubc_create_upl(vp, lastpg, PAGE_SIZE, &upl, &pl, UPL_SET_LITE);
1009 		        cluster_zero(upl, (uint32_t)lastoff, PAGE_SIZE - (uint32_t)lastoff, NULL);
1011 		ubc_upl_abort_range(upl, 0, PAGE_SIZE, UPL_ABORT_FREE_ON_EMPTY);
2148  * Parameters:	vp			The vnode from which to create the upl
2151  *		bufsize			The size of the upl to create
2153  *					created upl; MUST NOT be NULL
2155  *					list for the created upl; MAY be NULL
2158  * Returns:	KERN_SUCCESS		The requested upl has been created
2272  * Map the page list assocated with the supplied upl into the kernel virtual
2274  * the entire upl is mapped
2276  * Parameters:	upl			The upl to map
2277  *		dst_addr		The address at which to map the upl
2279  * Returns:	KERN_SUCCESS		The upl has been mapped
2280  *		KERN_INVALID_ARGUMENT	The upl is UPL_NULL
2281  *		KERN_FAILURE		The upl is already mapped
2288 	upl_t		upl,
2291 	return (vm_upl_map(kernel_map, upl, dst_addr));
2298  * Unmap the page list assocated with the supplied upl from the kernel virtual
2299  * address space; the entire upl is unmapped.
2301  * Parameters:	upl			The upl to unmap
2303  * Returns:	KERN_SUCCESS		The upl has been unmapped
2304  *		KERN_FAILURE		The upl is not currently mapped
2305  *		KERN_INVALID_ARGUMENT	If the upl is UPL_NULL
2309 	upl_t	upl)
2311 	return(vm_upl_unmap(kernel_map, upl));
2318  * Commit the contents of the upl to the backing store
2320  * Parameters:	upl			The upl to commit
2322  * Returns:	KERN_SUCCESS		The upl has been committed
2323  *		KERN_INVALID_ARGUMENT	The supplied upl was UPL_NULL
2324  *		KERN_FAILURE		The supplied upl does not represent
2327  *					the upl
2331  *		since the upl is deallocated regardless of success or failure,
2340 	upl_t 			upl)
2345 	pl = UPL_GET_INTERNAL_PAGE_LIST(upl);
2346 	kr = upl_commit(upl, pl, MAX_UPL_SIZE);
2347 	upl_deallocate(upl);
2355  * Commit the contents of the specified range of the upl to the backing store
2357  * Parameters:	upl			The upl to commit
2358  *		offset			The offset into the upl
2364  *		KERN_INVALID_ARGUMENT	The supplied upl was UPL_NULL
2365  *		KERN_FAILURE		The supplied upl does not represent
2368  *					the upl
2371  *		empty, the upl will be deallocated.  Since the caller cannot
2374  *		is equal to the upl size.
2377  *		the upl to be committed; allowable flags are:
2379  *		o	UPL_COMMIT_FREE_ON_EMPTY	Free the upl when it is
2406 	upl_t 			upl,
2422 	pl = UPL_GET_INTERNAL_PAGE_LIST(upl);
2424 	kr = upl_commit_range(upl, offset, size, flags,
2428 		upl_deallocate(upl);
2437  * Abort the contents of the specified range of the specified upl
2439  * Parameters:	upl			The upl to abort
2440  *		offset			The offset into the upl
2446  *		KERN_INVALID_ARGUMENT	The supplied upl was UPL_NULL
2447  *		KERN_FAILURE		The supplied upl does not represent
2450  *					the upl
2453  *		empty, the upl will be deallocated.  Since the caller cannot
2456  *		is equal to the upl size.
2459  *		pages in the upl to be aborted; allowable flags are:
2461  *		o	UPL_ABORT_FREE_ON_EMPTY	Free the upl when it is both
2481 	upl_t			upl,
2492 	kr = upl_abort_range(upl, offset, size, abort_flags, &empty);
2495 		upl_deallocate(upl);
2504  * Abort the contents of the specified upl
2506  * Parameters:	upl			The upl to abort
2510  *		KERN_INVALID_ARGUMENT	The supplied upl was UPL_NULL
2511  *		KERN_FAILURE		The supplied upl does not represent
2514  *					the upl
2517  *		empty, the upl will be deallocated.  Since the caller cannot
2520  *		is equal to the upl size.
2523  *		pages in the upl to be aborted; allowable flags are:
2525  *		o	UPL_ABORT_FREE_ON_EMPTY	Free the upl when it is both
2545 	upl_t			upl,
2550 	kr = upl_abort(upl, abort_type);
2551 	upl_deallocate(upl);
2559  *  Retrieve the internal page list for the specified upl
2561  * Parameters:	upl			The upl to obtain the page list from
2564  *					list internal to the upl
2576 	upl_t			upl)
2578 	return (UPL_GET_INTERNAL_PAGE_LIST(upl));
2591 	upl_t		upl,
2595 	upl_range_needed(upl, index, count);