fs: expose frsize field in statfs results

Node.js statfs() exposes bsize (optimal I/O block size) but not frsize
(fundamental filesystem block size). Per POSIX, block counts (blocks,
bfree, bavail) are in units of frsize, not bsize. libuv already reads
f_frsize from the kernel — it was simply not mapped to JavaScript.

On most native filesystems bsize == frsize, so the omission was
harmless. However, on FUSE mounts (e.g. Docker Desktop on macOS with
VirtioFS or gRPC FUSE), they can differ by orders of magnitude
(bsize=2MiB vs frsize=16KiB), causing applications that compute disk
space as bsize*blocks to report wildly inflated values.

This commit adds the frsize property to the StatFs object returned by
fs.statfs(), fs.statfsSync(), and fsPromises.statfs(), in both normal
and bigint modes.

Author: juicecultus

doc/api/fs.md

@@ -7899,7 +7899,8 @@ StatFs {
   bfree: 61058895,
   bavail: 61058895,
   files: 999,
-  ffree: 1000000
+  ffree: 1000000,
+  frsize: 4096
 }
 ```
 
@@ -7913,7 +7914,8 @@ StatFs {
   bfree: 61058895n,
   bavail: 61058895n,
   files: 999n,
-  ffree: 1000000n
+  ffree: 1000000n,
+  frsize: 4096n
 }
 ```
 
@@ -7989,6 +7991,20 @@ added:
 
 Total file nodes in file system.
 
+#### `statfs.frsize`
+
+<!-- YAML
+added: REPLACEME
+-->
+
+* Type: {number|bigint}
+
+Fundamental file system block size. This is the unit in which `blocks`,
+`bfree`, and `bavail` are counted. On most file systems this equals `bsize`,
+but on FUSE mounts (e.g. Docker Desktop on macOS using VirtioFS) they can
+differ. Use `frsize` (not `bsize`) when calculating disk space from block
+counts.
+
 #### `statfs.type`
 
 <!-- YAML

lib/internal/fs/utils.js

@@ -571,20 +571,22 @@ function getStatsFromBinding(stats, offset = 0) {
 }
 
 class StatFs {
-  constructor(type, bsize, blocks, bfree, bavail, files, ffree) {
+  constructor(type, bsize, blocks, bfree, bavail, files, ffree, frsize) {
     this.type = type;
     this.bsize = bsize;
     this.blocks = blocks;
     this.bfree = bfree;
     this.bavail = bavail;
     this.files = files;
     this.ffree = ffree;
+    this.frsize = frsize;
   }
 }
 
 function getStatFsFromBinding(stats) {
   return new StatFs(
     stats[0], stats[1], stats[2], stats[3], stats[4], stats[5], stats[6],
+    stats[7],
   );
 }
 

src/node_file-inl.h

@@ -158,6 +158,7 @@ void FillStatFsArray(AliasedBufferBase<NativeT, V8T>* fields,
   SET_FIELD(kBAvail, s->f_bavail);
   SET_FIELD(kFiles, s->f_files);
   SET_FIELD(kFFree, s->f_ffree);
+  SET_FIELD(kFrSize, s->f_frsize);
 
 #undef SET_FIELD
 }

src/node_file.h

@@ -49,6 +49,7 @@ enum class FsStatFsOffset {
   kBAvail,
   kFiles,
   kFFree,
+  kFrSize,
   kFsStatFsFieldsNumber
 };
 

test/parallel/test-fs-promises.js

@@ -94,6 +94,7 @@ function verifyStatFsObject(stat, isBigint = false) {
   assert.strictEqual(typeof stat.bavail, valueType);
   assert.strictEqual(typeof stat.files, valueType);
   assert.strictEqual(typeof stat.ffree, valueType);
+  assert.strictEqual(typeof stat.frsize, valueType);
 }
 
 async function getHandle(dest) {

test/parallel/test-fs-statfs.js

@@ -7,7 +7,7 @@ function verifyStatFsObject(statfs, isBigint = false) {
   const valueType = isBigint ? 'bigint' : 'number';
 
   [
-    'type', 'bsize', 'blocks', 'bfree', 'bavail', 'files', 'ffree',
+    'type', 'bsize', 'blocks', 'bfree', 'bavail', 'files', 'ffree', 'frsize',
   ].forEach((k) => {
     assert.ok(Object.hasOwn(statfs, k));
     assert.strictEqual(typeof statfs[k], valueType,