Skip to contentSkip to conversation

signal.7: Don't mention that pthread API can return EINTR

PATCH Applied Arkadiusz Drabczyk 2 participants 3 messages Jan 3, 2025 – Jan 4, 2025 Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore
#0 lore raw

PATCH 1/2 signal.7: Don't mention that pthread API can return EINTR

In pthreads.7 it says:

"For each of the pthreads functions that can return an error, POSIX.1-2001 specifies that the function can never fail with the error EINTR."

---
 man/man7/signal.7 | 4 ----
 1 file changed, 4 deletions(-)
man/man7/signal.7 +0 -4
index d19f171b3..dd04c6d1a 100644
@@ -753,10 +753,6 @@ beforehand, always failed with
 .IP \[bu]
 .BR getrandom (2).
 .IP \[bu]
-.BR pthread_mutex_lock (3),
-.BR pthread_cond_wait (3),
-and related APIs.
-.IP \[bu]
 .BR futex (2)
 .BR FUTEX_WAIT_BITSET .
 .IP \[bu]
Signature · 1 line
2.45.2
#1 lore raw

PATCH 2/2 pthread_cond_init.3: Remove EINTR error code

In pthreads.7 it says:

"For each of the pthreads functions that can return an error, POSIX.1-2001 specifies that the function can never fail with the error EINTR."

---
 man/man3/pthread_cond_init.3 | 3 ---
 1 file changed, 3 deletions(-)
man/man3/pthread_cond_init.3 +0 -3
index 658f390f6..15556219b 100644
@@ -153,9 +153,6 @@ the following error codes on error:
 \fBETIMEDOUT\fP
 The condition variable was not signaled
 until the timeout specified by \fIabstime\fP.
-.TP
-\fBEINTR\fP
-\fBpthread_cond_timedwait\fP was interrupted by a signal.
 .RE
 .P
 The \fBpthread_cond_destroy\fP function returns
Signature · 1 line
2.45.2
maintainer Applied
#2 lore raw

Re: [PATCH 2/2] pthread_cond_init.3: Remove EINTR error code

Hi Arkadiusz,

Quoted 9 lines · Arkadiusz Drabczyk

In pthreads.7 it says:

"For each of the pthreads functions that can return an error, POSIX.1-2001 specifies that the function can never fail with the error EINTR."

I have applied both patches. Thanks!
<https://www.alejandro-colomar.es/src/alx/linux/man-pages/man-pages.git/commit/?h=contrib&id=b21b7ef58e5ff367d78432a3af5af235c31e23af>
<https://www.alejandro-colomar.es/src/alx/linux/man-pages/man-pages.git/commit/?h=contrib&id=124f715bfce56727e8ac86989f07476bb345cf19>

Cheers,
Alex

Quoted 21 lines
---
 man/man3/pthread_cond_init.3 | 3 ---
 1 file changed, 3 deletions(-)
man/man3/pthread_cond_init.3 +0 -3
index 658f390f6..15556219b 100644
@@ -153,9 +153,6 @@ the following error codes on error:
 \fBETIMEDOUT\fP
 The condition variable was not signaled
 until the timeout specified by \fIabstime\fP.
-.TP
-\fBEINTR\fP
-\fBpthread_cond_timedwait\fP was interrupted by a signal.
 .RE
 .P
 The \fBpthread_cond_destroy\fP function returns
Signature · 1 line
2.45.2
Signature · 1 line
<https://www.alejandro-colomar.es/>