---
name: "iofile.d"
section: "1m"
platform: "macos"
package: "dtrace"
version: "413"
release: "macOS 26.5"
platforms: ["macos"]
url: "https://new.carta.tech/iofile.d"
---

# iofile.d(1m)

I/O wait time by file and process. Uses DTrace.

## NAME

iofile.d - I/O wait time by file and process. Uses DTrace.

## SYNOPSIS

**iofile.d**

## DESCRIPTION

This prints the total I/O wait times for each filename by process. This can help determine why an application is performing poorly by identifying which file they are waiting on, and the total times. Both disk and NFS I/O are measured.

Since this uses DTrace, only users with root privileges can run this command.

## EXAMPLES

- Sample until Ctrl-C is hit then print report,

  \#  **iofile.d**

## FIELDS

- PID

  process ID

- CMD

  process name

- TIME

  total wait time for disk events, us

- FILE

  file pathname

## BASED ON

/usr/demo/dtrace/iocpu.d

## DOCUMENTATION

See the DTraceToolkit for further documentation under the  Docs directory. The DTraceToolkit docs may include full worked examples with verbose descriptions explaining the output.

## EXIT

iofile.d will sample until Ctrl-C is hit.

## SEE ALSO

iosnoop(1M), dtrace(1M)