---
name: "usddiff"
section: "1"
platform: "linux"
package: "usd"
version: "26.11.1-3"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/usddiff"
---

# usddiff(1)

manual page for usddiff 26.11.1

## NAME

usddiff - manual page for usddiff 26.11.1

## DESCRIPTION

usage: usddiff \[-h\] \[-n\] \[-f\] \[-q\] files \[files ...\]

Compares two usd-readable files using a selected diff program. This is chosen by looking at the $USD\_DIFF environment variable. If this is unset, it will consult the $DIFF environment variable. Lastly, if neither of these is set, it will try to use the canonical unix program, diff. This will relay the exit code of the selected diff program.When comparing two usdz files, each file contained in the package will be examined individually. The $USD\_IMAGE\_DIFF environment variable specifies a specific diff program for comparing image files. The $USD\_IMAGE\_DIFF\_FORMATS environment variable specifies supported image formats using a "," separated list of file extensions.

### positional arguments:

- files

  The files to compare. These must be of the form DIR DIR, FILE... DIR, DIR FILE... or FILE FILE.

### options:

- **-h**, **--help**

  show this help message and exit

- **-n**, **--noeffect**

  Do not edit either file.

- **-f**, **--flatten**

  Fully compose both layers as Usd Stages and flatten into single layers.

- **-q**, **--brief**

  Do not return full results of diffs. Passes **--brief** to the diff command.