diff mbox series

rt-numa: Correct the comment of numa_initialize()

Message ID TYCP286MB1913AD6234046FE1CF1D3877A17E9@TYCP286MB1913.JPNP286.PROD.OUTLOOK.COM
State New
Headers show
Series rt-numa: Correct the comment of numa_initialize() | expand

Commit Message

Oscar Shiang Dec. 23, 2021, 2:01 p.m. UTC
numa_initialize() returns 0 only when numa_available() returns -1,
which means that libnuma is unavailable.

The return values in the comment should be corrected to 1 if all
functions are available and 0 when the functions are unavailable.

Signed-off-by: Oscar Shiang <oscar0225@livemail.tw>
---
 src/lib/rt-numa.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

Comments

John Kacur Dec. 25, 2021, 4:43 p.m. UTC | #1
On Thu, 23 Dec 2021, Oscar Shiang wrote:

> numa_initialize() returns 0 only when numa_available() returns -1,
> which means that libnuma is unavailable.
> 
> The return values in the comment should be corrected to 1 if all
> functions are available and 0 when the functions are unavailable.
> 
> Signed-off-by: Oscar Shiang <oscar0225@livemail.tw>
> ---
>  src/lib/rt-numa.c | 2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
> 
> diff --git a/src/lib/rt-numa.c b/src/lib/rt-numa.c
> index bb0121a..ee5ab99 100644
> --- a/src/lib/rt-numa.c
> +++ b/src/lib/rt-numa.c
> @@ -15,7 +15,7 @@
>  
>  /*
>   * numa_available() must be called before any other calls to the numa library
> - * returns 0 if numa is available, or 1 if numa is not available
> + * returns 1 if numa is available, or 0 if numa is not available
>   */
>  int numa_initialize(void)
>  {
> -- 
> 2.25.1
> 
> 
Signed-off-by: John Kacur <jkacur@redhat.com>
John Kacur Dec. 25, 2021, 4:58 p.m. UTC | #2
On Thu, 23 Dec 2021, Sebastian Andrzej Siewior wrote:

> On 2021-12-23 22:01:07 [+0800], Oscar Shiang wrote:
> > --- a/src/lib/rt-numa.c
> > +++ b/src/lib/rt-numa.c
> > @@ -15,7 +15,7 @@
> >  
> >  /*
> >   * numa_available() must be called before any other calls to the numa library
> > - * returns 0 if numa is available, or 1 if numa is not available
> > + * returns 1 if numa is available, or 0 if numa is not available
> >   */
> 
> To quote the man page:
> 
>        Before  any  other  calls  in this library can be used numa_available()
>        must be called. If it returns -1, all other functions in  this  library
>        are undefined.
> 
> Based on that, neither 0 nor 1 is defined.
> 
> Sebastian
> 

Right, but the numa_initialize function is meant to wrap that in such a 
way that we only call numa_available once, and then subsequent calls will 
return 1 (or true) for numa is available or 0 (false) if it is not 
available. This wrapper could probably be omitted, but it's supposed 
to make the code more readable.

This still isn't entirely cleaned up after this functionality 
was removed during the JSON stuff that mistakenly assumed numa is always 
available at runtime. (it might not be for example on some embedded 
platforms). In some case there might still be paths through the code that 
don't call non-numa versions of the functions when numa is not available.
It's on my list to fix.

John
diff mbox series

Patch

diff --git a/src/lib/rt-numa.c b/src/lib/rt-numa.c
index bb0121a..ee5ab99 100644
--- a/src/lib/rt-numa.c
+++ b/src/lib/rt-numa.c
@@ -15,7 +15,7 @@ 
 
 /*
  * numa_available() must be called before any other calls to the numa library
- * returns 0 if numa is available, or 1 if numa is not available
+ * returns 1 if numa is available, or 0 if numa is not available
  */
 int numa_initialize(void)
 {