Skip to contentSkip to conversation

man3/sem_post.3: EOVERFLOW add SEM_VALUE_MAX to description (wfix)

PATCH In review Alex Tran 2 participants 3 messages Aug 18, 2025 Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore

Alex Tran

author
#0 lore raw

PATCH 1/1 man3/sem_post.3: EOVERFLOW add SEM_VALUE_MAX to description (wfix)

See: <https://bugzilla.kernel.org/show_bug.cgi?id=219335>

---
 man/man3/sem_post.3 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
man/man3/sem_post.3 +1 -1
index 1df132c89..03b91b9a9 100644
@@ -38,7 +38,7 @@ is not a valid semaphore.
 .TP
 .B EOVERFLOW
 .\" Added in POSIX.1-2008 TC1 (Austin Interpretation 213)
-The maximum allowable value for a semaphore would be exceeded.
+The value exceeded SEM_VALUE_MAX limit.
 .SH ATTRIBUTES
 For an explanation of the terms used in this section, see
 .BR attributes (7).
Signature · 1 line
2.34.1
#1 lore raw

Hi Alex,

Quoted 3 lines · Alex Tran

See: <https://bugzilla.kernel.org/show_bug.cgi?id=219335>

Thanks! See a comment below.

Quoted 9 lines
---
 man/man3/sem_post.3 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
man/man3/sem_post.3 +0 -0
index 1df132c89..03b91b9a9 100644

man/man3/sem_post.3 is not a valid semaphore. · line 41

Quoted 5 lines
man/man3/sem_post.3 +1 -1
@@ -38,7 +38,7 @@ is not a valid semaphore.
 .TP
 .B EOVERFLOW
 .\" Added in POSIX.1-2008 TC1 (Austin Interpretation 213)
-The maximum allowable value for a semaphore would be exceeded.
+The value exceeded SEM_VALUE_MAX limit.

This wording is slightly incorrect: the value would be exceeded, if it were increased, but of course, sem_post(3) will not increase it.

I suggest something like:

The value would exceed SEM_VALUE_MAX.

Have a lovely day!
Alex

Quoted 7 lines
man/man3/sem_post.3 +0 -0
 .SH ATTRIBUTES
 For an explanation of the terms used in this section, see
 .BR attributes (7).
Signature · 1 line
2.34.1
Signature · 1 line
<https://www.alejandro-colomar.es/>
author
#2 lore raw

Thanks for the review. I'll follow up with a patch v2 with the adjustments.

Quoted 46 lines · Alejandro Colomar

Hi Alex,

Quoted 3 lines · Alex Tran

See: <https://bugzilla.kernel.org/show_bug.cgi?id=219335>

Thanks! See a comment below.

Quoted 9 lines
---
 man/man3/sem_post.3 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
man/man3/sem_post.3 +0 -0
index 1df132c89..03b91b9a9 100644

man/man3/sem_post.3 is not a valid semaphore. · line 41

Quoted 5 lines
man/man3/sem_post.3 +1 -1
@@ -38,7 +38,7 @@ is not a valid semaphore.
 .TP
 .B EOVERFLOW
 .\" Added in POSIX.1-2008 TC1 (Austin Interpretation 213)
-The maximum allowable value for a semaphore would be exceeded.
+The value exceeded SEM_VALUE_MAX limit.

This wording is slightly incorrect: the value would be exceeded, if it were increased, but of course, sem_post(3) will not increase it.

I suggest something like:

The value would exceed SEM_VALUE_MAX.

Have a lovely day!
Alex

Quoted 7 lines
man/man3/sem_post.3 +0 -1
 .SH ATTRIBUTES
 For an explanation of the terms used in this section, see
 .BR attributes (7).
--

2.34.1

--
<https://www.alejandro-colomar.es/>

Signature · 2 lines
Alex Tran
[email protected] | 408-406-2417