Function getVolumeMetadataForPath

getVolumeMetadataForPath(
    pathname: string,
    opts?: Partial<
        Pick<Options, "timeoutMs" | "mountPoints" | "linuxMountTablePaths">,
    >,
): Promise<VolumeMetadata>
Get metadata for the volume that contains the given file or directory path.

Unlike getVolumeMetadata, this accepts any path — not just mount points. Symlinks are resolved, and macOS APFS firmlinks (e.g. /Users → /System/Volumes/Data) are handled correctly, mirroring what df does.
Parameters
- pathname: string
  Path to any file or directory
- Optionalopts: Partial<Pick<Options, "timeoutMs" | "mountPoints" | "linuxMountTablePaths">>
  Optional filesystem operation settings
Returns Promise<VolumeMetadata>
- Defined in index.ts:123