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

# usdupdatecrate(1)

manual page for usdupdatecrate 26.11.1

## NAME

usdupdatecrate - manual page for usdupdatecrate 26.11.1

## DESCRIPTION

usage: usdupdatecrate \[-h\] \[--root DIR\] \[--olderThan VERSION\]

- \[--exclude PATTERN\] \[--output FILE\]

  \[--saveWorkList FILE\] \[--fromWorkList FILE\] \[--update \| **--cleanup\]** \[--noCleanup\] \[--preserveAttrs \| **--noPreserveAttrs\]** \[--preserveOwner\] \[--workers N\] \[--batchSize N\] \[--walkThreads N\] \[--quiescenceTimeout SECONDS\] \[--perFileTimeout SECONDS\]

Find and optionally update Pixar USD crate (.usd/.usdc) files older than a given version.

By default the script reports matching files to stdout and takes no action. With **--update** it opens each file via Sdf.Layer.FindOrOpen() and re-exports it, which causes USD to write the file at the current crate version.

Updates are performed safely: each file is exported to a sibling temp path, its new crate version is verified, and only then is the temp atomically renamed over the original.  The original is left untouched on any failure.

Note on hard links: an update replaces the original directory entry via os.replace().  Any other names that were hard-linked to the original inode continue to refer to the unchanged inode and so retain the old content.

### options:

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

  show this help message and exit

- **--root** DIR

  Root directory to search (default: current working directory).

- **--olderThan** VERSION

  Identify crate files with version older than this (major.minor.patch, default: 0.8.0).

- **--exclude** PATTERN

  Exclude files whose path relative to **--root** matches this fnmatch pattern. May be specified multiple times. Excluded subdirectories are pruned before descent.

- **--output** FILE

  Write matching file list to FILE instead of stdout.

- **--saveWorkList** FILE

  Save the deduplicated to-update file list to FILE before any update runs. Useful as a manual two-step staging point or for crash recovery.

- **--fromWorkList** FILE

  Read candidate files from FILE instead of walking **--root**. **--root**, **--exclude**, and **--walkThreads** are ignored when this is set.

- **--update**

  Update matched files by re-exporting them via Sdf.Layer.

- **--cleanup**

  Standalone mode: walk **--root** and remove stale \*.usdupdatecrate.\*.tmp.\* files left behind by crashed or killed prior runs, then exit. Honors **--exclude** and **--walkThreads**.

- **--noCleanup**

  During an **--update** run, skip the implicit removal of stale temp files discovered by the walk. Has no effect in **--cleanup** mode (which is itself a cleanup).

- **--preserveAttrs**

  Preserve the original file's mode and group on the updated file. If either cannot be matched (e.g. you are not a member of the original's group), the update for that file is treated as failed and the original is left untouched. The owner is not preserved unless **--preserveOwner** is also given. Default: on (POSIX), unsupported (Windows).

- **--noPreserveAttrs**

  Disable preservation of the original mode and group. Updated files take on the running user's primary group (or the directory's group, if it is setgid) and a umask-respecting mode.

- **--preserveOwner**

  Also preserve the original file's owner. Off by default because changing a file's owner requires root; without it, updated files are owned by the running user. A file whose owner cannot be set is treated as failed and left untouched. POSIX only.

- **--workers** N

  Explicit number of worker processes. Overrides **--batchSize**.

- **--batchSize** N

  Number of files per pool task (default: 16). Files are split into batches of this size and dispatched across workers via imap\_unordered. Smaller is safer (smaller crash blast radius, better work-stealing); larger amortizes per-task overhead. Ignored if **--workers** is given.

- **--walkThreads** N

  Number of threads for parallel directory enumeration (default: 32). Set to 1 to use a single-threaded os.walk() instead.

- **--quiescenceTimeout** SECONDS

  Update pool driver: if no chunk-result arrives for this many seconds, treat any not-yet-completed chunks as crashed/hung and recover them via per-file subprocess isolation (default: 120). Raise this if you have legitimately long-running chunks.

- **--perFileTimeout** SECONDS

  Recovery: hard cap on a single file's isolated subprocess (default: 60). If exceeded, the subprocess is terminated and the file recorded as an ERROR\_CRASH.