Skip to main content

inspect-dcp

filerepack inspect-dcp <checkpoint-directory> [OPTIONS]

Inventories a flat local PyTorch Distributed Checkpoint directory. .metadata and rank .distcp shards are treated as opaque files; no pickle is deserialized and no checkpoint is loaded or rewritten. It does not establish completeness or native-reader compatibility.

filerepack inspect-dcp ./checkpoint --json
FlagMeaning
--format-max-nodesFile-inventory limit; default 100000
--format-timeoutInspection deadline in seconds; default 120
--jsonStructured inventory, including shard count, sizes and limitations

Nested layouts, symlinks, special files and individually supplied shards are unsupported. The source directory must contain .metadata and at least one shard named __<rank>_<index>.distcp. No Torch installation is needed for this passive inventory.

A completed inventory exits 0. JSON explicitly sets metadata_loaded, complete_checkpoint_verified and writer_registered to false; zero is not an integrity guarantee. Unsupported layouts and path/option errors exit 1; argument-parser errors exit 2. See model weight formats for the current writer gates.