sleep(3) manpage

sleep(3) manpage

[Petre Mierlutiu]

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

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

[bill o gallmeister]

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>
---
 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
--
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

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

[Michael Kerrisk]

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