* [v3 PATCH] move_pages.2: Returning positive value is a new error case
@ 2020-02-03 19:18 ` Yang Shi
0 siblings, 0 replies; 8+ messages in thread
From: Yang Shi @ 2020-02-03 19:18 UTC (permalink / raw)
To: mhocko, mtk.manpages, david, akpm
Cc: yang.shi, linux-man, linux-api, linux-mm, linux-kernel
Since commit a49bd4d71637 ("mm, numa: rework do_pages_move"),
the semantic of move_pages() has changed to return the number of
non-migrated pages if they were result of a non-fatal reasons (usually a
busy page). This was an unintentional change that hasn't been noticed
except for LTP tests which checked for the documented behavior.
There are two ways to go around this change. We can even get back to the
original behavior and return -EAGAIN whenever migrate_pages is not able
to migrate pages due to non-fatal reasons. Another option would be to
simply continue with the changed semantic and extend move_pages
documentation to clarify that -errno is returned on an invalid input or
when migration simply cannot succeed (e.g. -ENOMEM, -EBUSY) or the
number of pages that couldn't have been migrated due to ephemeral
reasons (e.g. page is pinned or locked for other reasons).
We decided to keep the second option in kernel because this behavior is in
place for some time without anybody complaining and possibly new users
depending on it. Also it allows to have a slightly easier error handling
as the caller knows that it is worth to retry when err > 0.
Update man pages to reflect the new semantic.
Cc: Michal Hocko <mhocko@suse.com>
Cc: Michael Kerrisk <mtk.manpages@gmail.com>
Signed-off-by: Yang Shi <yang.shi@linux.alibaba.com>
---
v3: * Fixed the comments from David Hildenbrand.
* Fixed the inaccuracy about pre-initialized status array values.
v2: * Added notes about status array per Michal.
* Added Michal's Acked-by.
man2/move_pages.2 | 10 ++++++++--
1 file changed, 8 insertions(+), 2 deletions(-)
diff --git a/man2/move_pages.2 b/man2/move_pages.2
index 1bf1053..50c83a4 100644
--- a/man2/move_pages.2
+++ b/man2/move_pages.2
@@ -104,7 +104,9 @@ pages that need to be moved.
is an array of integers that return the status of each page.
The array contains valid values only if
.BR move_pages ()
-did not return an error.
+did not return an error. Pre-initialization of the array to the value
+which cannot represent a real numa node or valid error of status array
+could help to identify pages that have been migrated
.PP
.I flags
specify what types of pages to move.
@@ -164,9 +166,13 @@ returns zero.
.\" do the right thing?
On error, it returns \-1, and sets
.I errno
-to indicate the error.
+to indicate the error. If positive value is returned, it is the number of
+non-migrated pages.
.SH ERRORS
.TP
+.B Positive value
+The number of non-migrated pages if they were the result of non-fatal
+reasons (since version 4.17).
.B E2BIG
Too many pages to move.
Since Linux 2.6.29,
--
1.8.3.1
^ permalink raw reply related [flat|nested] 8+ messages in thread
* [v3 PATCH] move_pages.2: Returning positive value is a new error case
@ 2020-02-03 19:18 ` Yang Shi
0 siblings, 0 replies; 8+ messages in thread
From: Yang Shi @ 2020-02-03 19:18 UTC (permalink / raw)
To: mhocko-IBi9RG/b67k, mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w,
david-H+wXaHxf7aLQT0dZR+AlfA,
akpm-de/tnXTf+JLsfHDXvbKv3WD2FQJk+8+b
Cc: yang.shi-KPsoFbNs7GizrGE5bRqYAgC/G2K4zDHf,
linux-man-u79uwXL29TY76Z2rM5mHXA,
linux-api-u79uwXL29TY76Z2rM5mHXA,
linux-mm-Bw31MaZKKs3YtjvyW6yDsg,
linux-kernel-u79uwXL29TY76Z2rM5mHXA
Since commit a49bd4d71637 ("mm, numa: rework do_pages_move"),
the semantic of move_pages() has changed to return the number of
non-migrated pages if they were result of a non-fatal reasons (usually a
busy page). This was an unintentional change that hasn't been noticed
except for LTP tests which checked for the documented behavior.
There are two ways to go around this change. We can even get back to the
original behavior and return -EAGAIN whenever migrate_pages is not able
to migrate pages due to non-fatal reasons. Another option would be to
simply continue with the changed semantic and extend move_pages
documentation to clarify that -errno is returned on an invalid input or
when migration simply cannot succeed (e.g. -ENOMEM, -EBUSY) or the
number of pages that couldn't have been migrated due to ephemeral
reasons (e.g. page is pinned or locked for other reasons).
We decided to keep the second option in kernel because this behavior is in
place for some time without anybody complaining and possibly new users
depending on it. Also it allows to have a slightly easier error handling
as the caller knows that it is worth to retry when err > 0.
Update man pages to reflect the new semantic.
Cc: Michal Hocko <mhocko-IBi9RG/b67k@public.gmane.org>
Cc: Michael Kerrisk <mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
Signed-off-by: Yang Shi <yang.shi-KPsoFbNs7GizrGE5bRqYAgC/G2K4zDHf@public.gmane.org>
---
v3: * Fixed the comments from David Hildenbrand.
* Fixed the inaccuracy about pre-initialized status array values.
v2: * Added notes about status array per Michal.
* Added Michal's Acked-by.
man2/move_pages.2 | 10 ++++++++--
1 file changed, 8 insertions(+), 2 deletions(-)
diff --git a/man2/move_pages.2 b/man2/move_pages.2
index 1bf1053..50c83a4 100644
--- a/man2/move_pages.2
+++ b/man2/move_pages.2
@@ -104,7 +104,9 @@ pages that need to be moved.
is an array of integers that return the status of each page.
The array contains valid values only if
.BR move_pages ()
-did not return an error.
+did not return an error. Pre-initialization of the array to the value
+which cannot represent a real numa node or valid error of status array
+could help to identify pages that have been migrated
.PP
.I flags
specify what types of pages to move.
@@ -164,9 +166,13 @@ returns zero.
.\" do the right thing?
On error, it returns \-1, and sets
.I errno
-to indicate the error.
+to indicate the error. If positive value is returned, it is the number of
+non-migrated pages.
.SH ERRORS
.TP
+.B Positive value
+The number of non-migrated pages if they were the result of non-fatal
+reasons (since version 4.17).
.B E2BIG
Too many pages to move.
Since Linux 2.6.29,
--
1.8.3.1
^ permalink raw reply related [flat|nested] 8+ messages in thread
* Re: [v3 PATCH] move_pages.2: Returning positive value is a new error case
@ 2020-02-10 9:36 ` Michal Hocko
0 siblings, 0 replies; 8+ messages in thread
From: Michal Hocko @ 2020-02-10 9:36 UTC (permalink / raw)
To: Yang Shi
Cc: mtk.manpages, david, akpm, linux-man, linux-api, linux-mm, linux-kernel
On Tue 04-02-20 03:18:27, Yang Shi wrote:
> Since commit a49bd4d71637 ("mm, numa: rework do_pages_move"),
> the semantic of move_pages() has changed to return the number of
> non-migrated pages if they were result of a non-fatal reasons (usually a
> busy page). This was an unintentional change that hasn't been noticed
> except for LTP tests which checked for the documented behavior.
>
> There are two ways to go around this change. We can even get back to the
> original behavior and return -EAGAIN whenever migrate_pages is not able
> to migrate pages due to non-fatal reasons. Another option would be to
> simply continue with the changed semantic and extend move_pages
> documentation to clarify that -errno is returned on an invalid input or
> when migration simply cannot succeed (e.g. -ENOMEM, -EBUSY) or the
> number of pages that couldn't have been migrated due to ephemeral
> reasons (e.g. page is pinned or locked for other reasons).
>
> We decided to keep the second option in kernel because this behavior is in
> place for some time without anybody complaining and possibly new users
> depending on it. Also it allows to have a slightly easier error handling
> as the caller knows that it is worth to retry when err > 0.
>
> Update man pages to reflect the new semantic.
>
> Cc: Michal Hocko <mhocko@suse.com>
> Cc: Michael Kerrisk <mtk.manpages@gmail.com>
> Signed-off-by: Yang Shi <yang.shi@linux.alibaba.com>
Acked-by: Michal Hocko <mhocko@suse.com>
> ---
> v3: * Fixed the comments from David Hildenbrand.
> * Fixed the inaccuracy about pre-initialized status array values.
> v2: * Added notes about status array per Michal.
> * Added Michal's Acked-by.
>
> man2/move_pages.2 | 10 ++++++++--
> 1 file changed, 8 insertions(+), 2 deletions(-)
>
> diff --git a/man2/move_pages.2 b/man2/move_pages.2
> index 1bf1053..50c83a4 100644
> --- a/man2/move_pages.2
> +++ b/man2/move_pages.2
> @@ -104,7 +104,9 @@ pages that need to be moved.
> is an array of integers that return the status of each page.
> The array contains valid values only if
> .BR move_pages ()
> -did not return an error.
> +did not return an error. Pre-initialization of the array to the value
> +which cannot represent a real numa node or valid error of status array
> +could help to identify pages that have been migrated
> .PP
> .I flags
> specify what types of pages to move.
> @@ -164,9 +166,13 @@ returns zero.
> .\" do the right thing?
> On error, it returns \-1, and sets
> .I errno
> -to indicate the error.
> +to indicate the error. If positive value is returned, it is the number of
> +non-migrated pages.
> .SH ERRORS
> .TP
> +.B Positive value
> +The number of non-migrated pages if they were the result of non-fatal
> +reasons (since version 4.17).
> .B E2BIG
> Too many pages to move.
> Since Linux 2.6.29,
> --
> 1.8.3.1
--
Michal Hocko
SUSE Labs
^ permalink raw reply [flat|nested] 8+ messages in thread
* Re: [v3 PATCH] move_pages.2: Returning positive value is a new error case
@ 2020-02-10 9:36 ` Michal Hocko
0 siblings, 0 replies; 8+ messages in thread
From: Michal Hocko @ 2020-02-10 9:36 UTC (permalink / raw)
To: Yang Shi
Cc: mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w,
david-H+wXaHxf7aLQT0dZR+AlfA,
akpm-de/tnXTf+JLsfHDXvbKv3WD2FQJk+8+b,
linux-man-u79uwXL29TY76Z2rM5mHXA,
linux-api-u79uwXL29TY76Z2rM5mHXA,
linux-mm-Bw31MaZKKs3YtjvyW6yDsg,
linux-kernel-u79uwXL29TY76Z2rM5mHXA
On Tue 04-02-20 03:18:27, Yang Shi wrote:
> Since commit a49bd4d71637 ("mm, numa: rework do_pages_move"),
> the semantic of move_pages() has changed to return the number of
> non-migrated pages if they were result of a non-fatal reasons (usually a
> busy page). This was an unintentional change that hasn't been noticed
> except for LTP tests which checked for the documented behavior.
>
> There are two ways to go around this change. We can even get back to the
> original behavior and return -EAGAIN whenever migrate_pages is not able
> to migrate pages due to non-fatal reasons. Another option would be to
> simply continue with the changed semantic and extend move_pages
> documentation to clarify that -errno is returned on an invalid input or
> when migration simply cannot succeed (e.g. -ENOMEM, -EBUSY) or the
> number of pages that couldn't have been migrated due to ephemeral
> reasons (e.g. page is pinned or locked for other reasons).
>
> We decided to keep the second option in kernel because this behavior is in
> place for some time without anybody complaining and possibly new users
> depending on it. Also it allows to have a slightly easier error handling
> as the caller knows that it is worth to retry when err > 0.
>
> Update man pages to reflect the new semantic.
>
> Cc: Michal Hocko <mhocko-IBi9RG/b67k@public.gmane.org>
> Cc: Michael Kerrisk <mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
> Signed-off-by: Yang Shi <yang.shi-KPsoFbNs7GizrGE5bRqYAgC/G2K4zDHf@public.gmane.org>
Acked-by: Michal Hocko <mhocko-IBi9RG/b67k@public.gmane.org>
> ---
> v3: * Fixed the comments from David Hildenbrand.
> * Fixed the inaccuracy about pre-initialized status array values.
> v2: * Added notes about status array per Michal.
> * Added Michal's Acked-by.
>
> man2/move_pages.2 | 10 ++++++++--
> 1 file changed, 8 insertions(+), 2 deletions(-)
>
> diff --git a/man2/move_pages.2 b/man2/move_pages.2
> index 1bf1053..50c83a4 100644
> --- a/man2/move_pages.2
> +++ b/man2/move_pages.2
> @@ -104,7 +104,9 @@ pages that need to be moved.
> is an array of integers that return the status of each page.
> The array contains valid values only if
> .BR move_pages ()
> -did not return an error.
> +did not return an error. Pre-initialization of the array to the value
> +which cannot represent a real numa node or valid error of status array
> +could help to identify pages that have been migrated
> .PP
> .I flags
> specify what types of pages to move.
> @@ -164,9 +166,13 @@ returns zero.
> .\" do the right thing?
> On error, it returns \-1, and sets
> .I errno
> -to indicate the error.
> +to indicate the error. If positive value is returned, it is the number of
> +non-migrated pages.
> .SH ERRORS
> .TP
> +.B Positive value
> +The number of non-migrated pages if they were the result of non-fatal
> +reasons (since version 4.17).
> .B E2BIG
> Too many pages to move.
> Since Linux 2.6.29,
> --
> 1.8.3.1
--
Michal Hocko
SUSE Labs
^ permalink raw reply [flat|nested] 8+ messages in thread
* Re: [v3 PATCH] move_pages.2: Returning positive value is a new error case
2020-02-10 9:36 ` Michal Hocko
(?)
@ 2020-02-20 17:06 ` Yang Shi
2020-03-10 18:24 ` Yang Shi
-1 siblings, 1 reply; 8+ messages in thread
From: Yang Shi @ 2020-02-20 17:06 UTC (permalink / raw)
To: mtk.manpages
Cc: Michal Hocko, david, akpm, linux-man, linux-api, linux-mm, linux-kernel
On 2/10/20 1:36 AM, Michal Hocko wrote:
> On Tue 04-02-20 03:18:27, Yang Shi wrote:
>> Since commit a49bd4d71637 ("mm, numa: rework do_pages_move"),
>> the semantic of move_pages() has changed to return the number of
>> non-migrated pages if they were result of a non-fatal reasons (usually a
>> busy page). This was an unintentional change that hasn't been noticed
>> except for LTP tests which checked for the documented behavior.
>>
>> There are two ways to go around this change. We can even get back to the
>> original behavior and return -EAGAIN whenever migrate_pages is not able
>> to migrate pages due to non-fatal reasons. Another option would be to
>> simply continue with the changed semantic and extend move_pages
>> documentation to clarify that -errno is returned on an invalid input or
>> when migration simply cannot succeed (e.g. -ENOMEM, -EBUSY) or the
>> number of pages that couldn't have been migrated due to ephemeral
>> reasons (e.g. page is pinned or locked for other reasons).
>>
>> We decided to keep the second option in kernel because this behavior is in
>> place for some time without anybody complaining and possibly new users
>> depending on it. Also it allows to have a slightly easier error handling
>> as the caller knows that it is worth to retry when err > 0.
>>
>> Update man pages to reflect the new semantic.
>>
>> Cc: Michal Hocko <mhocko@suse.com>
>> Cc: Michael Kerrisk <mtk.manpages@gmail.com>
>> Signed-off-by: Yang Shi <yang.shi@linux.alibaba.com>
Hi Michael,
Would you please consider take this patch? The kernel change has been
upstreamed.
Thanks,
Yang
> Acked-by: Michal Hocko <mhocko@suse.com>
>
>> ---
>> v3: * Fixed the comments from David Hildenbrand.
>> * Fixed the inaccuracy about pre-initialized status array values.
>> v2: * Added notes about status array per Michal.
>> * Added Michal's Acked-by.
>>
>> man2/move_pages.2 | 10 ++++++++--
>> 1 file changed, 8 insertions(+), 2 deletions(-)
>>
>> diff --git a/man2/move_pages.2 b/man2/move_pages.2
>> index 1bf1053..50c83a4 100644
>> --- a/man2/move_pages.2
>> +++ b/man2/move_pages.2
>> @@ -104,7 +104,9 @@ pages that need to be moved.
>> is an array of integers that return the status of each page.
>> The array contains valid values only if
>> .BR move_pages ()
>> -did not return an error.
>> +did not return an error. Pre-initialization of the array to the value
>> +which cannot represent a real numa node or valid error of status array
>> +could help to identify pages that have been migrated
>> .PP
>> .I flags
>> specify what types of pages to move.
>> @@ -164,9 +166,13 @@ returns zero.
>> .\" do the right thing?
>> On error, it returns \-1, and sets
>> .I errno
>> -to indicate the error.
>> +to indicate the error. If positive value is returned, it is the number of
>> +non-migrated pages.
>> .SH ERRORS
>> .TP
>> +.B Positive value
>> +The number of non-migrated pages if they were the result of non-fatal
>> +reasons (since version 4.17).
>> .B E2BIG
>> Too many pages to move.
>> Since Linux 2.6.29,
>> --
>> 1.8.3.1
^ permalink raw reply [flat|nested] 8+ messages in thread
* Re: [v3 PATCH] move_pages.2: Returning positive value is a new error case
2020-02-20 17:06 ` Yang Shi
@ 2020-03-10 18:24 ` Yang Shi
0 siblings, 0 replies; 8+ messages in thread
From: Yang Shi @ 2020-03-10 18:24 UTC (permalink / raw)
To: mtk.manpages
Cc: Yang Shi, Michal Hocko, david, Andrew Morton, linux-man,
linux-api, Linux MM, Linux Kernel Mailing List
On Thu, Feb 20, 2020 at 9:07 AM Yang Shi <yang.shi@linux.alibaba.com> wrote:
>
>
>
> On 2/10/20 1:36 AM, Michal Hocko wrote:
> > On Tue 04-02-20 03:18:27, Yang Shi wrote:
> >> Since commit a49bd4d71637 ("mm, numa: rework do_pages_move"),
> >> the semantic of move_pages() has changed to return the number of
> >> non-migrated pages if they were result of a non-fatal reasons (usually a
> >> busy page). This was an unintentional change that hasn't been noticed
> >> except for LTP tests which checked for the documented behavior.
> >>
> >> There are two ways to go around this change. We can even get back to the
> >> original behavior and return -EAGAIN whenever migrate_pages is not able
> >> to migrate pages due to non-fatal reasons. Another option would be to
> >> simply continue with the changed semantic and extend move_pages
> >> documentation to clarify that -errno is returned on an invalid input or
> >> when migration simply cannot succeed (e.g. -ENOMEM, -EBUSY) or the
> >> number of pages that couldn't have been migrated due to ephemeral
> >> reasons (e.g. page is pinned or locked for other reasons).
> >>
> >> We decided to keep the second option in kernel because this behavior is in
> >> place for some time without anybody complaining and possibly new users
> >> depending on it. Also it allows to have a slightly easier error handling
> >> as the caller knows that it is worth to retry when err > 0.
> >>
> >> Update man pages to reflect the new semantic.
> >>
> >> Cc: Michal Hocko <mhocko@suse.com>
> >> Cc: Michael Kerrisk <mtk.manpages@gmail.com>
> >> Signed-off-by: Yang Shi <yang.shi@linux.alibaba.com>
>
Hi Michale,
Maybe my work email went to your spam folder. So, ping with my
personal email. Would you please consider take this patch?
Thanks,
Yang
> Hi Michael,
>
> Would you please consider take this patch? The kernel change has been
> upstreamed.
>
> Thanks,
> Yang
>
> > Acked-by: Michal Hocko <mhocko@suse.com>
> >
> >> ---
> >> v3: * Fixed the comments from David Hildenbrand.
> >> * Fixed the inaccuracy about pre-initialized status array values.
> >> v2: * Added notes about status array per Michal.
> >> * Added Michal's Acked-by.
> >>
> >> man2/move_pages.2 | 10 ++++++++--
> >> 1 file changed, 8 insertions(+), 2 deletions(-)
> >>
> >> diff --git a/man2/move_pages.2 b/man2/move_pages.2
> >> index 1bf1053..50c83a4 100644
> >> --- a/man2/move_pages.2
> >> +++ b/man2/move_pages.2
> >> @@ -104,7 +104,9 @@ pages that need to be moved.
> >> is an array of integers that return the status of each page.
> >> The array contains valid values only if
> >> .BR move_pages ()
> >> -did not return an error.
> >> +did not return an error. Pre-initialization of the array to the value
> >> +which cannot represent a real numa node or valid error of status array
> >> +could help to identify pages that have been migrated
> >> .PP
> >> .I flags
> >> specify what types of pages to move.
> >> @@ -164,9 +166,13 @@ returns zero.
> >> .\" do the right thing?
> >> On error, it returns \-1, and sets
> >> .I errno
> >> -to indicate the error.
> >> +to indicate the error. If positive value is returned, it is the number of
> >> +non-migrated pages.
> >> .SH ERRORS
> >> .TP
> >> +.B Positive value
> >> +The number of non-migrated pages if they were the result of non-fatal
> >> +reasons (since version 4.17).
> >> .B E2BIG
> >> Too many pages to move.
> >> Since Linux 2.6.29,
> >> --
> >> 1.8.3.1
>
^ permalink raw reply [flat|nested] 8+ messages in thread
* Re: [v3 PATCH] move_pages.2: Returning positive value is a new error case
@ 2020-03-10 18:24 ` Yang Shi
0 siblings, 0 replies; 8+ messages in thread
From: Yang Shi @ 2020-03-10 18:24 UTC (permalink / raw)
To: mtk.manpages
Cc: Yang Shi, Michal Hocko, david, Andrew Morton, linux-man,
linux-api, Linux MM, Linux Kernel Mailing List
On Thu, Feb 20, 2020 at 9:07 AM Yang Shi <yang.shi@linux.alibaba.com> wrote:
>
>
>
> On 2/10/20 1:36 AM, Michal Hocko wrote:
> > On Tue 04-02-20 03:18:27, Yang Shi wrote:
> >> Since commit a49bd4d71637 ("mm, numa: rework do_pages_move"),
> >> the semantic of move_pages() has changed to return the number of
> >> non-migrated pages if they were result of a non-fatal reasons (usually a
> >> busy page). This was an unintentional change that hasn't been noticed
> >> except for LTP tests which checked for the documented behavior.
> >>
> >> There are two ways to go around this change. We can even get back to the
> >> original behavior and return -EAGAIN whenever migrate_pages is not able
> >> to migrate pages due to non-fatal reasons. Another option would be to
> >> simply continue with the changed semantic and extend move_pages
> >> documentation to clarify that -errno is returned on an invalid input or
> >> when migration simply cannot succeed (e.g. -ENOMEM, -EBUSY) or the
> >> number of pages that couldn't have been migrated due to ephemeral
> >> reasons (e.g. page is pinned or locked for other reasons).
> >>
> >> We decided to keep the second option in kernel because this behavior is in
> >> place for some time without anybody complaining and possibly new users
> >> depending on it. Also it allows to have a slightly easier error handling
> >> as the caller knows that it is worth to retry when err > 0.
> >>
> >> Update man pages to reflect the new semantic.
> >>
> >> Cc: Michal Hocko <mhocko@suse.com>
> >> Cc: Michael Kerrisk <mtk.manpages@gmail.com>
> >> Signed-off-by: Yang Shi <yang.shi@linux.alibaba.com>
>
Hi Michale,
Maybe my work email went to your spam folder. So, ping with my
personal email. Would you please consider take this patch?
Thanks,
Yang
> Hi Michael,
>
> Would you please consider take this patch? The kernel change has been
> upstreamed.
>
> Thanks,
> Yang
>
> > Acked-by: Michal Hocko <mhocko@suse.com>
> >
> >> ---
> >> v3: * Fixed the comments from David Hildenbrand.
> >> * Fixed the inaccuracy about pre-initialized status array values.
> >> v2: * Added notes about status array per Michal.
> >> * Added Michal's Acked-by.
> >>
> >> man2/move_pages.2 | 10 ++++++++--
> >> 1 file changed, 8 insertions(+), 2 deletions(-)
> >>
> >> diff --git a/man2/move_pages.2 b/man2/move_pages.2
> >> index 1bf1053..50c83a4 100644
> >> --- a/man2/move_pages.2
> >> +++ b/man2/move_pages.2
> >> @@ -104,7 +104,9 @@ pages that need to be moved.
> >> is an array of integers that return the status of each page.
> >> The array contains valid values only if
> >> .BR move_pages ()
> >> -did not return an error.
> >> +did not return an error. Pre-initialization of the array to the value
> >> +which cannot represent a real numa node or valid error of status array
> >> +could help to identify pages that have been migrated
> >> .PP
> >> .I flags
> >> specify what types of pages to move.
> >> @@ -164,9 +166,13 @@ returns zero.
> >> .\" do the right thing?
> >> On error, it returns \-1, and sets
> >> .I errno
> >> -to indicate the error.
> >> +to indicate the error. If positive value is returned, it is the number of
> >> +non-migrated pages.
> >> .SH ERRORS
> >> .TP
> >> +.B Positive value
> >> +The number of non-migrated pages if they were the result of non-fatal
> >> +reasons (since version 4.17).
> >> .B E2BIG
> >> Too many pages to move.
> >> Since Linux 2.6.29,
> >> --
> >> 1.8.3.1
>
^ permalink raw reply [flat|nested] 8+ messages in thread
* Re: [v3 PATCH] move_pages.2: Returning positive value is a new error case
2020-02-03 19:18 ` Yang Shi
(?)
(?)
@ 2020-04-16 11:35 ` Michael Kerrisk (man-pages)
-1 siblings, 0 replies; 8+ messages in thread
From: Michael Kerrisk (man-pages) @ 2020-04-16 11:35 UTC (permalink / raw)
To: Yang Shi, mhocko, david, akpm
Cc: mtk.manpages, linux-man, linux-api, linux-mm, linux-kernel
Hello Yang Shi,
On 2/3/20 8:18 PM, Yang Shi wrote:
> Since commit a49bd4d71637 ("mm, numa: rework do_pages_move"),
> the semantic of move_pages() has changed to return the number of
> non-migrated pages if they were result of a non-fatal reasons (usually a
> busy page). This was an unintentional change that hasn't been noticed
> except for LTP tests which checked for the documented behavior.
>
> There are two ways to go around this change. We can even get back to the
> original behavior and return -EAGAIN whenever migrate_pages is not able
> to migrate pages due to non-fatal reasons. Another option would be to
> simply continue with the changed semantic and extend move_pages
> documentation to clarify that -errno is returned on an invalid input or
> when migration simply cannot succeed (e.g. -ENOMEM, -EBUSY) or the
> number of pages that couldn't have been migrated due to ephemeral
> reasons (e.g. page is pinned or locked for other reasons).
>
> We decided to keep the second option in kernel because this behavior is in
> place for some time without anybody complaining and possibly new users
> depending on it. Also it allows to have a slightly easier error handling
> as the caller knows that it is worth to retry when err > 0.
>
> Update man pages to reflect the new semantic.
Thanks for the patch. I've applied it.
@Michal: thanks for the Ack.
Cheers,
Michael
>
> Cc: Michal Hocko <mhocko@suse.com>
> Cc: Michael Kerrisk <mtk.manpages@gmail.com>
> Signed-off-by: Yang Shi <yang.shi@linux.alibaba.com>
> ---
> v3: * Fixed the comments from David Hildenbrand.
> * Fixed the inaccuracy about pre-initialized status array values.
> v2: * Added notes about status array per Michal.
> * Added Michal's Acked-by.
>
> man2/move_pages.2 | 10 ++++++++--
> 1 file changed, 8 insertions(+), 2 deletions(-)
>
> diff --git a/man2/move_pages.2 b/man2/move_pages.2
> index 1bf1053..50c83a4 100644
> --- a/man2/move_pages.2
> +++ b/man2/move_pages.2
> @@ -104,7 +104,9 @@ pages that need to be moved.
> is an array of integers that return the status of each page.
> The array contains valid values only if
> .BR move_pages ()
> -did not return an error.
> +did not return an error. Pre-initialization of the array to the value
> +which cannot represent a real numa node or valid error of status array
> +could help to identify pages that have been migrated
> .PP
> .I flags
> specify what types of pages to move.
> @@ -164,9 +166,13 @@ returns zero.
> .\" do the right thing?
> On error, it returns \-1, and sets
> .I errno
> -to indicate the error.
> +to indicate the error. If positive value is returned, it is the number of
> +non-migrated pages.
> .SH ERRORS
> .TP
> +.B Positive value
> +The number of non-migrated pages if they were the result of non-fatal
> +reasons (since version 4.17).
> .B E2BIG
> Too many pages to move.
> Since Linux 2.6.29,
>
--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
^ permalink raw reply [flat|nested] 8+ messages in thread
end of thread, other threads:[~2020-04-16 11:36 UTC | newest]
Thread overview: 8+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-02-03 19:18 [v3 PATCH] move_pages.2: Returning positive value is a new error case Yang Shi
2020-02-03 19:18 ` Yang Shi
2020-02-10 9:36 ` Michal Hocko
2020-02-10 9:36 ` Michal Hocko
2020-02-20 17:06 ` Yang Shi
2020-03-10 18:24 ` Yang Shi
2020-03-10 18:24 ` Yang Shi
2020-04-16 11:35 ` Michael Kerrisk (man-pages)
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.