lkml.org 
[lkml]   [2022]   [Apr]   [21]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
/
Date
From
SubjectRe: [PATCH 1/3] memblock tests: update style of comments for memblock_add_*() functions
On Thu, Apr 21, 2022 at 09:12:02AM +0200, David Hildenbrand wrote:
> On 20.04.22 13:19, Rebecca Mckeever wrote:
> > Update comments in memblock_add_*() functions to match the style used
> > in tests/alloc_*.c by rewording to make the expected outcome more apparent
> > and, if more than one memblock is involved, adding a visual of the
> > memory blocks.
> >
> > Signed-off-by: Rebecca Mckeever <remckee0@gmail.com>
> > ---
> > tools/testing/memblock/tests/basic_api.c | 75 +++++++++++++++++-------
> > 1 file changed, 54 insertions(+), 21 deletions(-)
> >
> > diff --git a/tools/testing/memblock/tests/basic_api.c b/tools/testing/memblock/tests/basic_api.c
> > index fbc1ce160303..cdf112d25343 100644
> > --- a/tools/testing/memblock/tests/basic_api.c
> > +++ b/tools/testing/memblock/tests/basic_api.c
> > @@ -26,8 +26,8 @@ static int memblock_initialization_check(void)
> > /*
> > * A simple test that adds a memory block of a specified base address
> > * and size to the collection of available memory regions (memblock.memory).
> > - * It checks if a new entry was created and if region counter and total memory
> > - * were correctly updated.
> > + * Expect to create a new entry. The region counter and total memory get
> > + * updated.
> > */
> > static int memblock_add_simple_check(void)
> > {
> > @@ -55,8 +55,8 @@ static int memblock_add_simple_check(void)
> > /*
> > * A simple test that adds a memory block of a specified base address, size

Can you please add coma after size ... ^

> > * NUMA node and memory flags to the collection of available memory regions.
> > - * It checks if the new entry, region counter and total memory size have
> > - * expected values.
> > + * Expect to create a new entry. The region counter and total memory get
> > + * updated.
> > */
> > static int memblock_add_node_simple_check(void)
> > {

...

> > @@ -125,10 +131,20 @@ static int memblock_add_disjoint_check(void)
> >
> > /*
> > * A test that tries to add two memory blocks, where the second one overlaps
> > - * with the beginning of the first entry (that is r1.base < r2.base + r2.size).
> > - * After this, it checks if two entries are merged into one region that starts
> > - * at r2.base and has size of two regions minus their intersection. It also
> > - * verifies the reported total size of the available memory and region counter.
> > + * with the beginning of the first entry (that is r1.base < r2.base + r2.size):
> > + *
> > + * | +----+----+------------+ |
> > + * | | r|2 | r1 | |
> > + * +----+----+----+------------+----------+

I'd move | separator outside the block name, e.g

* | +----+----+------------+ |
* | | | r2 | r1 | |
* +----+----+----+------------+----------+

but no strong feelings about this :)

> > + * ^ ^
> > + * | |
> > + * | r1.base
> > + * |
> > + * r2.base
> > + *
> > + * Expect to merge the two entries into one region that starts at r2.base
> > + * and has size of two regions minus their intersection. The total size of
> > + * the available memory is updated, and the region counter stays the same.
> > */
> > static int memblock_add_overlap_top_check(void)

...

> Reviewed-by: David Hildenbrand <david@redhat.com>
>
> --
> Thanks,
>
> David / dhildenb
>
>

--
Sincerely yours,
Mike.

\
 
 \ /
  Last update: 2022-04-21 16:35    [W:0.045 / U:0.392 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site