Re: Subject: [PATCH] sleep.3: sleep suspends the thread, not the process. (Re: sleep(3) manpage)

[Michael Kerrisk <mtk.manpages-gM/Ye1E23mwN+BqQ9rBEUg@public.gmane.org>]

On Thu, Jan 21, 2010 at 7:40 AM, bill o gallmeister
<bog.kernel-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> wrote:
> Petre Mierlutiu wrote:
>> Hello,
>>
>> the sleep(3) manpage states, under DESCRIPTION, that "sleep()  makes  the  calling  process sleep [...]". I believe this not to be true and the appropriate text would be: "sleep() makes the calling thread sleep [...]".
>>
>>  I think in the past Linux did implement it so it would block the process, I am not sure.
>> Anyway, sleep is currently implemented using nanosleep() and a simple threaded program can be written to prove sleep only sleeps the calling thread.
>>
>> Manpages version: 3.21
>> Distribution: ubuntu 9.10
>>
>> Kind regards,
>>
>> Petre Mierlutiu--
>> To unsubscribe from this list: send the line "unsubscribe linux-man" in
>> the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
>> More majordomo info at  http://vger.kernel.org/majordomo-info.html
>>
>
> Signed-off-by: Bill O. Gallmeister <bog.kernel-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>

Thanks Bill.

Applied for 3.24.

Cheers,

Michael


> ---
>  man3/sleep.3 |    3 ++-
>  1 files changed, 2 insertions(+), 1 deletions(-)
>
> diff --git a/man3/sleep.3 b/man3/sleep.3
> index 900b7fc..41575b7 100644
> --- a/man3/sleep.3
> +++ b/man3/sleep.3
> @@ -32,7 +32,7 @@ sleep \- Sleep for the specified number of seconds
>  .fi
>  .SH DESCRIPTION
>  .BR sleep ()
> -makes the calling process sleep until
> +makes the calling thread sleep until
>  .I seconds
>  seconds have elapsed or a signal arrives which is not ignored.
>  .SH "RETURN VALUE"
> @@ -58,5 +58,6 @@ from a signal handler or modifying the handling of
>  while sleeping will cause undefined results.
>  .SH "SEE ALSO"
>  .BR alarm (2),
> +.BR nanosleep (2),
>  .BR signal (2),
>  .BR signal (7)
> --
> 1.6.0.6
>



-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Author of "The Linux Programming Interface" http://blog.man7.org/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html