Re: [PATCH 1/7] random: Simplify API for random address requests

From: Yann Droneaud
Date: Fri Jul 29 2016 - 04:59:35 EST


Hi,

Le jeudi 28 juillet 2016 Ã 20:47 +0000, Jason Cooper a ÃcritÂ:
> To date, all callers of randomize_range() have set the length to 0,
> and check for a zero return value.ÂÂFor the current callers, the only
> way to get zero returned is if end <= start.ÂÂSince they are all
> adding a constant to the start address, this is unnecessary.
>
> We can remove a bunch of needless checks by simplifying the API to do
> just what everyone wants, return an address between [start, start +
> range).
>
> While we're here, s/get_random_int/get_random_long/.ÂÂNo current call
> site is adversely affected by get_random_int(), since all current
> range requests are < UINT_MAX.ÂÂHowever, we should match caller
> expectations to avoid coming up short (ha!) in the future.
>
> Address generation within [start, start + range) behavior is
> preserved.
>
> All current callers to randomize_range() chose to use the start
> address if randomize_range() failed.ÂÂTherefore, we simplify things
> by just returning the start address on error.
>
> randomize_range() will be removed once all callers have been
> converted over to randomize_addr().
>
> Signed-off-by: Jason Cooper <jason@xxxxxxxxxxxxxx>
> ---
> Âdrivers/char/random.cÂÂ| 26 ++++++++++++++++++++++++++
> Âinclude/linux/random.h |ÂÂ1 +
> Â2 files changed, 27 insertions(+)
>
> diff --git a/drivers/char/random.c b/drivers/char/random.c
> index 0158d3bff7e5..3610774bcc53 100644
> --- a/drivers/char/random.c
> +++ b/drivers/char/random.c
> @@ -1840,6 +1840,32 @@ randomize_range(unsigned long start, unsigned
> long end, unsigned long len)
> Â return PAGE_ALIGN(get_random_int() % range + start);
> Â}
> Â
> +/**
> + * randomize_addr - Generate a random, page aligned address
> + * @start: The smallest acceptable address the caller will take.
> + * @range: The size of the area, starting at @start, within which the
> + * random address must fall.
> + *
> + * Before page alignment, the random address generated can be any value from
> + * @start, to @start + @range - 1 inclusive.
> + *
> + * If @start + @range would overflow, @range is capped.
> + *
> + * Return: A page aligned address within [start, start + range).

PAGE_ALIGN(start + range - 1) can be greater than start + range ..

In the worst case, when start = 0, range = ULONG_MAX, the result would
be 0.

In order to stay in the bounds, the start address must be rounded up,
and the random offset must be rounded down.

Something I haven't found the time to send was looking like this:

 unsigned long base = PAGE_ALIGN(start);

 range -= (base - start);
 range >>= PAGE_SHIFT;

 return base + ((get_random_int() % range) << PAGE_SHIFT);


> ÂÂOn error,
> + * @start is returned.
> + */
> +unsigned long
> +randomize_addr(unsigned long start, unsigned long range)
> +{
> + if (range == 0)
> + return start;
> +
> + if (start > ULONG_MAX - range)
> + range = ULONG_MAX - start;
> +
> + return PAGE_ALIGN(get_random_long() % range + start);
> +}
> +
> Â/* Interface for in-kernel drivers of true hardware RNGs.
> Â * Those devices may produce endless random bits and will be throttled
> Â * when our pool is full.
> diff --git a/include/linux/random.h b/include/linux/random.h
> index e47e533742b5..f1ca2fa4c071 100644
> --- a/include/linux/random.h
> +++ b/include/linux/random.h
> @@ -35,6 +35,7 @@ extern const struct file_operations random_fops, urandom_fops;
> Âunsigned int get_random_int(void);
> Âunsigned long get_random_long(void);
> Âunsigned long randomize_range(unsigned long start, unsigned long end, unsigned long len);
> +unsigned long randomize_addr(unsigned long start, unsigned long range);
> Â
> Âu32 prandom_u32(void);
> Âvoid prandom_bytes(void *buf, size_t nbytes);


Regards.

--
Yann Droneaud
OPTEYA