Thread (37 messages) 37 messages, 3 authors, 2026-01-10

[PATCH v1 09/11] man/man3type/stat.3type: HISTORY: Specify initial datatypes of st_{blksize,blocks}

From: Seth McDonald <hidden>
Date: 2026-01-08 03:04:14
Subsystem: the rest · Maintainer: Linus Torvalds

From: Seth McDonald <redacted>

The st_blksize and st_blocks fields of the stat(3type) structure were
both specified as 'long' integers in SUSv1.[1]  SUSv2 then changed them
to blksize_t(3type) and blkcnt_t(3type), respectively.[2]

[1] X/Open CAE Specification, System Interfaces and Headers Issue 4,
Version 2, Chapter 4 "Headers", p. 830.
[2] CAE Specification, System Interfaces and Headers, Issue 5, Chapter 4
"Headers", p. 1169.
<https://pubs.opengroup.org/onlinepubs/7908799/xsh/sysstat.h.html>

Signed-off-by: Seth McDonald <redacted>
---
 man/man3type/stat.3type | 7 +++++++
 1 file changed, 7 insertions(+)
diff --git a/man/man3type/stat.3type b/man/man3type/stat.3type
index 83f6e881a5ae..82f0dd6e778d 100644
--- a/man/man3type/stat.3type
+++ b/man/man3type/stat.3type
@@ -144,6 +144,13 @@ .SH HISTORY
 .I .st_blocks
 fields first appeared in SUSv1
 before being added to POSIX.1-2001 XSI.
+Initially, SUSv1 specified
+.I .st_blksize
+and
+.I .st_blocks
+with type
+.IR long .
+This was remedied in SUSv2.
 .P
 Old kernels and old standards did not support nanosecond timestamp fields.
 Instead, there were three timestamp fields
-- 
2.47.3
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help