Function getVolumeMetadataForPath

getVolumeMetadataForPath(
    pathname: string,
    opts?: Partial<
        Pick<
            Options,
            | "includeZfsGuids"
            | "mountPoints"
            | "timeoutMs"
            | "linuxMountTablePaths"
            | "networkFsTypes"
            | "skipNetworkVolumes",
        >,
    >,
): 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,
          | "includeZfsGuids"
          | "mountPoints"
          | "timeoutMs"
          | "linuxMountTablePaths"
          | "networkFsTypes"
          | "skipNetworkVolumes",
      >,
  >
  Optional filesystem operation settings
Returns Promise<VolumeMetadata>
- Defined in index.ts:143