.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH USDCAT "1" "September 2026" "usdcat 26.08" "User Commands"
.SH NAME
usdcat \- manual page for usdcat 26.08
.SH SYNOPSIS
.B usdcat
[\fI\,OPTIONS\/\fR] \fI\,inputFiles\/\fR...
.SH DESCRIPTION
Write usd file(s) either as text to stdout or to a specified output file.
.SS "Positionals:"
.TP
inputFiles ...
A list of input files
.SH OPTIONS
.TP
\fB\-h\fR,\-\-help
Print this help message and exit
.TP
\fB\-o\fR,\-\-out file
Write a single input file to this output file instead of stdout.
.TP
\fB\-\-usdFormat\fR usda|usdc
Use this underlying file format for output files
with the extension 'usd'. For example, passing
\&'\-o output.usd \fB\-\-usdformat\fR usda' will create
output.usd as a text file. The USD_DEFAULT_FILE_FORMAT
environment variable is another way to achieve this.
.TP
\fB\-l\fR,\-\-loadOnly
Attempt to load the specified input files and report 'OK'
or 'ERR' for each one. After all files are processed, this
script will exit with a non\-zero exit code if any files
failed to load.
.TP
\fB\-f\fR,\-\-flatten
Compose stages with the input files as root layers
and write their flattened content.
.TP
\fB\-\-flattenLayerStack\fR
Flatten the layer stack with the given root layer, and
write out the results. Unlike \fB\-\-flatten\fR, this does not flatten
composition arcs (such as references).
.TP
\fB\-\-skipSourceFileComment\fR
If \fB\-\-flatten\fR is specified, skip adding a comment regarding the
source of the flattened layer in the documentation field of the
output layer.
.TP
\fB\-\-mask\fR PRIMPATH[,PRIMPATH...]
Limit stage population to these prims, their descendants and
ancestors. To specify multiple paths, either use commas with no
spaces, or quote the argument and separate paths by commas
and/or spaces. Requires \fB\-\-flatten\fR.
.TP
\fB\-\-layerMetadata\fR
Load only layer metadata in the USD file.
This option cannot be combined with either \fB\-\-flatten\fR or
\fB\-\-flattenLayerStack\fR.