rnd_elf: add comment explaining the interface

Requested and reviewed by:	markj
Sponsored by:	The FreeBSD Foundation
MFC after:	1 week
Differential revision:	https://reviews.freebsd.org/D33359
This commit is contained in:
Konstantin Belousov 2021-12-09 17:22:54 +02:00
parent 9cf78c1cf6
commit a4007ae10c

View File

@ -875,6 +875,16 @@ __elfN(load_file)(struct proc *p, const char *file, u_long *addr,
return (error);
}
/*
* Select randomized valid address in the map map, between minv and
* maxv, with specified alignment. The [minv, maxv) range must belong
* to the map. Note that function only allocates the address, it is
* up to caller to clamp maxv in a way that the final allocation
* length fit into the map.
*
* Result is returned in *resp, error code indicates that arguments
* did not pass sanity checks for overflow and range correctness.
*/
static int
__CONCAT(rnd_, __elfN(base))(vm_map_t map, u_long minv, u_long maxv,
u_int align, u_long *resp)