Skip to contentSkip to conversation

getrlimit.2: Mention unit used by RLIMIT_CORE and RLIMIT_FSIZE

PATCH In review Thiago Jung Bauermann 2 participants 4 messages Sep 1, 2017 – Sep 3, 2017 3 messages not in the archive Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 getrlimit.2: Mention unit used by RLIMIT_CORE and RLIMIT_FSIZE

It would have been obvious that these limits are in bytes, except that "ulimit -a" in at least bash, dash and zsh says that they're in blocks. This confused me, so I had to check the kernel source code.

My understanding is that they are indeed in bytes, so mention this information in the man page.

---
 man2/getrlimit.2 | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
man2/getrlimit.2 +2 -2
index 84f04d695ea2..f2c5297526d7 100644
@@ -150,7 +150,7 @@ This is the maximum size of a
 .I core
 file (see
 .BR core (5))
-that the process may dump.
+in bytes that the process may dump.
 When 0 no core dump files are created.
 When nonzero, larger dumps are truncated to this size.
 .TP
@@ -187,7 +187,7 @@ which fail with the error
 upon encountering the soft limit of this resource.
 .TP
 .B RLIMIT_FSIZE
-This is the maximum size of files that the process may create.
+This is the maximum size in bytes of files that the process may create.
 Attempts to extend a file beyond this limit result in delivery of a
 .B SIGXFSZ
 signal.

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html

A message that is not in the archive (sent off-list or not yet received): 20170901202743.9678-1-bauerman-23VcF4HTsmIX0ybBhKVfKdBPR1lH4CV8@public.gmane.org

#2 lore raw

Hello Thiago,

Quoted 6 lines · Thiago Jung Bauermann

It would have been obvious that these limits are in bytes, except that "ulimit -a" in at least bash, dash and zsh says that they're in blocks. This confused me, so I had to check the kernel source code.

My understanding is that they are indeed in bytes, so mention this information in the man page.

Thanks. That was a silly deficiency on the man page. Patch applied. I also fixed a similar problem with RLIMIT_DATA.

Cheers,

Michael

Quoted 29 lines
---
 man2/getrlimit.2 | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
man2/getrlimit.2 +2 -2
index 84f04d695ea2..f2c5297526d7 100644
@@ -150,7 +150,7 @@ This is the maximum size of a
 .I core
 file (see
 .BR core (5))
-that the process may dump.
+in bytes that the process may dump.
 When 0 no core dump files are created.
 When nonzero, larger dumps are truncated to this size.
 .TP
@@ -187,7 +187,7 @@ which fail with the error
 upon encountering the soft limit of this resource.
 .TP
 .B RLIMIT_FSIZE
-This is the maximum size of files that the process may create.
+This is the maximum size in bytes of files that the process may create.
 Attempts to extend a file beyond this limit result in delivery of a
 .B SIGXFSZ
 signal.
Signature · 7 lines
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html

A message that is not in the archive (sent off-list or not yet received): 07aa1031-91b5-f1ca-b23f-858c06c3a9f8-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org

#4 lore raw
Quoted 11 lines · Michael Kerrisk (man-pages)

Hello Thiago,

Quoted 6 lines · Thiago Jung Bauermann

It would have been obvious that these limits are in bytes, except that "ulimit -a" in at least bash, dash and zsh says that they're in blocks. This confused me, so I had to check the kernel source code.

My understanding is that they are indeed in bytes, so mention this information in the man page.

Thanks. That was a silly deficiency on the man page. Patch applied.

Thanks!

Quoted 1 line

I also fixed a similar problem with RLIMIT_DATA.

I didn't occur to me to check the other resources. Thanks for doing that.

Signature · 7 lines
Thiago Jung Bauermann
IBM Linux Technology Center

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html

A message that is not in the archive (sent off-list or not yet received): [email protected]

#6 lore raw
Quoted 13 lines · Thiago Jung Bauermann
Quoted 10 lines · Michael Kerrisk (man-pages)

Hello Thiago,

Quoted 6 lines · Thiago Jung Bauermann

It would have been obvious that these limits are in bytes, except that "ulimit -a" in at least bash, dash and zsh says that they're in blocks. This confused me, so I had to check the kernel source code.

My understanding is that they are indeed in bytes, so mention this information in the man page.

Quoted 7 lines
Quoted 1 line

Thanks. That was a silly deficiency on the man page. Patch applied.

Thanks!

Quoted 1 line

I also fixed a similar problem with RLIMIT_DATA.

I didn't occur to me to check the other resources. Thanks for doing that.

No worries.

Cheers,

Michael

Signature · 7 lines
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html