.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH USDUPDATECRATE "1" "سپتامبر 2026" "usdupdatecrate 26.08" "دستورهای کاربری"
.SH "نام (NAME)"
usdupdatecrate \- صفحه راهنمای usdupdatecrate 26.08
.SH "توضیحات (DESCRIPTION)"
کاربرد: usdupdatecrate [\-h] [\-\-root DIR] [\-\-olderThan VERSION]
.TP
[\-\-exclude PATTERN] [\-\-output FILE]
[\-\-saveWorkList FILE] [\-\-fromWorkList FILE] [\-\-update |
\fB\-\-cleanup]\fR [\-\-noCleanup] [\-\-preserveAttrs |
\fB\-\-noPreserveAttrs]\fR [\-\-workers N] [\-\-batchSize N]
[\-\-walkThreads N] [\-\-quiescenceTimeout SECONDS]
[\-\-perFileTimeout SECONDS]
.PP
یافتن و در صورت تمایل به‌روزرسانی فایل‌های crate فرمت Pixar USD (.usd/.usdc) که قدیمی‌تر از نسخهٔ مشخص‌شده هستند.
.PP
به‌طور پیش‌فرض این اسکریپت فایل‌های منطبق را در stdout گزارش می‌دهد و هیچ عملی انجام نمی‌دهد. با گزینهٔ \fB\-\-update\fR، هر فایل را از طریق Sdf.Layer.FindOrOpen() باز کرده و دوباره برون‌ریزی می‌کند که موجب می‌شود USD فایل را با نسخهٔ crate فعلی ذخیره کند.
.PP
به‌روزرسانی‌ها به شکلی امن انجام می‌شوند: هر فایل در یک مسیر موقت هم‌جوار برون‌ریزی می‌شود، نسخهٔ جدید crate آن اعتبارسنجی شده، و تنها پس از آن، فایل موقت به‌صورت اتمیک بر روی فایل اصلی تغییر نام داده می‌شود (جایگزین می‌شود). در صورت بروز هرگونه شکست، فایل اصلی دست‌نخورده باقی می‌ماند.
.PP
نکته درباره پیوندهای سخت (hard links): یک به‌روزرسانی، مدخل دایرکتوری اصلی را با استفاده از os.replace() جایگزین می‌کند. هر نام دیگری که به‌صورت پیوند سخت به inode اصلی متصل بوده است، همچنان به همان inode بدون تغییر اشاره خواهد کرد و محتوای پیشین را نگه می‌دارد.
.SS "گزینه‌ها (OPTIONS):"
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش این پیام راهنما و خروج.
.TP
\fB\-\-root\fR DIR
دایرکتوری ریشه برای جستجو (پیش‌فرض: دایرکتوری کاری فعلی).
.TP
\fB\-\-olderThan\fR VERSION
شناسایی فایل‌های crate با نسخه‌ای قدیمی‌تر از این مقدار (major.minor.patch، پیش‌فرض: 0.8.0).
.TP
\fB\-\-exclude\fR PATTERN
مستثنی کردن فایل‌هایی که مسیر نسبی آن‌ها به \fB\-\-root\fR با این الگوی fnmatch مطابقت دارد. این گزینه می‌تواند چندین بار مشخص شود. زیردایرکتوری‌های مستثنی‌شده پیش از پیمایش حذف (prune) می‌شوند.
.TP
\fB\-\-output\fR FILE
نوشتن فهرست فایل‌های منطبق در FILE به جای stdout.
.TP
\fB\-\-saveWorkList\fR FILE
ذخیرهٔ فهرست یکتاشدهٔ فایل‌های در انتظار به‌روزرسانی در FILE پیش از اجرای هر به‌روزرسانی. مناسب به عنوان مرحلهٔ میانی دستی یا برای بازیابی پس از خرابی (crash recovery).
.TP
\fB\-\-fromWorkList\fR FILE
خواندن فایل‌های کاندید از FILE به جای پیمایش \fB\-\-root\fR. با تعیین این گزینه، مقادیر \fB\-\-root\fR، \fB\-\-exclude\fR و \fB\-\-walkThreads\fR نادیده گرفته می‌شوند.
.TP
\fB\-\-update\fR
به‌روزرسانی فایل‌های منطبق از طریق برون‌ریزی مجدد آن‌ها توسط Sdf.Layer.
.TP
\fB\-\-cleanup\fR
حالت مستقل: پیمایش \fB\-\-root\fR و پاک‌سازی فایل‌های موقت کهنهٔ *.usdupdatecrate.*.tmp.* به‌جامانده از اجراهای پیشین کرش‌کرده یا متوقف‌شده، و سپس خروج. از \fB\-\-exclude\fR و \fB\-\-walkThreads\fR تبعیت می‌کند.
.TP
\fB\-\-noCleanup\fR
در طول اجرای \fB\-\-update\fR، از حذف ضمنی فایل‌های موقت کهنهٔ شناسایی‌شده در حین پیمایش صرف‌نظر می‌کند. در حالت \fB\-\-cleanup\fR (که خود یک پاک‌سازی است) هیچ تأثیری ندارد.
.TP
\fB\-\-preserveAttrs\fR
حفظ حالت (mode) و مالکیت فایل اصلی بر روی فایل به‌روزرسانی‌شده. چنانچه حالت یا مالکیت نتواند تطبیق یابد (برای نمونه، دسترسی ناکافی برای اجرای chown)، به‌روزرسانی آن فایل به عنوان ناموفق تلقی شده و فایل اصلی دست‌نخورده باقی می‌ماند. پیش‌فرض: فعال (POSIX)، پشتیبانی‌نشده (Windows).
.TP
\fB\-\-noPreserveAttrs\fR
غیرفعال‌سازی حفظ حالت و مالکیت اصلی. فایل‌های به‌روزرسانی‌شده uid/gid کاربر اجراکننده و حالت مطابق با umask را به خود می‌گیرند.
.TP
\fB\-\-workers\fR N
تعداد صریح فرآیندهای کارگر (worker). بر \fB\-\-batchSize\fR مقدم است.
.TP
\fB\-\-batchSize\fR N
تعداد فایل‌ها در هر وظیفهٔ استخر (پیش‌فرض: 16). فایل‌ها به دسته‌هایی با این اندازه تقسیم شده و از طریق imap_unordered بین کارگرها توزیع می‌شوند. مقادیر کوچک‌تر ایمن‌تر هستند (شعاع اثر خرابی کوچک‌تر، سرقت کار یا work-stealing بهتر)؛ مقادیر بزرگ‌تر هزینهٔ سربار به ازای هر وظیفه را سرشکن می‌کنند. در صورت مشخص شدن \fB\-\-workers\fR نادیده گرفته می‌شود.
.TP
\fB\-\-walkThreads\fR N
تعداد رشته‌ها برای شمارش موازی دایرکتوری (پیش‌فرض: 32). برای استفاده از os.walk() تک‌رشته‌ای، مقدار را به 1 تغییر دهید.
.TP
\fB\-\-quiescenceTimeout\fR SECONDS
گردانندهٔ استخر به‌روزرسانی: اگر برای این تعداد ثانیه هیچ نتیجه‌ای از بخش‌ها (chunk-result) دریافت نشود، تمام بخش‌های تکمیل‌نشده به عنوان کرش‌کرده/قفل‌شده در نظر گرفته شده و از طریق جداسازی زیرپردازشی به ازای هر فایل بازیابی می‌شوند (پیش‌فرض: 120). اگر بخش‌هایی دارید که به‌طور معمول پردازش آن‌ها طولانی است، این مقدار را افزایش دهید.
.TP
\fB\-\-perFileTimeout\fR SECONDS
بازیابی: حد نهایی سخت‌گیرانه برای زیرپردازش جداسازی‌شدهٔ یک فایل (پیش‌فرض: 60). در صورت تجاوز از این زمان، زیرپردازش خاتمه یافته و فایل به عنوان ERROR_CRASH ثبت می‌شود.