USDUPDATECRATE(1) دستورهای کاربری USDUPDATECRATE(1)

usdupdatecrate - صفحه راهنمای usdupdatecrate 26.08

کاربرد: usdupdatecrate [-h] [--root DIR] [--olderThan VERSION]

[--exclude PATTERN] [--output FILE]
[--saveWorkList FILE] [--fromWorkList FILE] [--update | --cleanup] [--noCleanup] [--preserveAttrs | --noPreserveAttrs] [--workers N] [--batchSize N] [--walkThreads N] [--quiescenceTimeout SECONDS] [--perFileTimeout SECONDS]

یافتن و در صورت تمایل به‌روزرسانی فایل‌های crate فرمت Pixar USD (.usd/.usdc) که قدیمی‌تر از نسخهٔ مشخص‌شده هستند.

به‌طور پیش‌فرض این اسکریپت فایل‌های منطبق را در stdout گزارش می‌دهد و هیچ عملی انجام نمی‌دهد. با گزینهٔ --update، هر فایل را از طریق Sdf.Layer.FindOrOpen() باز کرده و دوباره برون‌ریزی می‌کند که موجب می‌شود USD فایل را با نسخهٔ crate فعلی ذخیره کند.

به‌روزرسانی‌ها به شکلی امن انجام می‌شوند: هر فایل در یک مسیر موقت هم‌جوار برون‌ریزی می‌شود، نسخهٔ جدید crate آن اعتبارسنجی شده، و تنها پس از آن، فایل موقت به‌صورت اتمیک بر روی فایل اصلی تغییر نام داده می‌شود (جایگزین می‌شود). در صورت بروز هرگونه شکست، فایل اصلی دست‌نخورده باقی می‌ماند.

نکته درباره پیوندهای سخت (hard links): یک به‌روزرسانی، مدخل دایرکتوری اصلی را با استفاده از os.replace() جایگزین می‌کند. هر نام دیگری که به‌صورت پیوند سخت به inode اصلی متصل بوده است، همچنان به همان inode بدون تغییر اشاره خواهد کرد و محتوای پیشین را نگه می‌دارد.

نمایش این پیام راهنما و خروج.
دایرکتوری ریشه برای جستجو (پیش‌فرض: دایرکتوری کاری فعلی).
شناسایی فایل‌های crate با نسخه‌ای قدیمی‌تر از این مقدار (major.minor.patch، پیش‌فرض: 0.8.0).
مستثنی کردن فایل‌هایی که مسیر نسبی آن‌ها به --root با این الگوی fnmatch مطابقت دارد. این گزینه می‌تواند چندین بار مشخص شود. زیردایرکتوری‌های مستثنی‌شده پیش از پیمایش حذف (prune) می‌شوند.
نوشتن فهرست فایل‌های منطبق در FILE به جای stdout.
ذخیرهٔ فهرست یکتاشدهٔ فایل‌های در انتظار به‌روزرسانی در FILE پیش از اجرای هر به‌روزرسانی. مناسب به عنوان مرحلهٔ میانی دستی یا برای بازیابی پس از خرابی (crash recovery).
خواندن فایل‌های کاندید از FILE به جای پیمایش --root. با تعیین این گزینه، مقادیر --root، --exclude و --walkThreads نادیده گرفته می‌شوند.
به‌روزرسانی فایل‌های منطبق از طریق برون‌ریزی مجدد آن‌ها توسط Sdf.Layer.
حالت مستقل: پیمایش --root و پاک‌سازی فایل‌های موقت کهنهٔ *.usdupdatecrate.*.tmp.* به‌جامانده از اجراهای پیشین کرش‌کرده یا متوقف‌شده، و سپس خروج. از --exclude و --walkThreads تبعیت می‌کند.
در طول اجرای --update، از حذف ضمنی فایل‌های موقت کهنهٔ شناسایی‌شده در حین پیمایش صرف‌نظر می‌کند. در حالت --cleanup (که خود یک پاک‌سازی است) هیچ تأثیری ندارد.
حفظ حالت (mode) و مالکیت فایل اصلی بر روی فایل به‌روزرسانی‌شده. چنانچه حالت یا مالکیت نتواند تطبیق یابد (برای نمونه، دسترسی ناکافی برای اجرای chown)، به‌روزرسانی آن فایل به عنوان ناموفق تلقی شده و فایل اصلی دست‌نخورده باقی می‌ماند. پیش‌فرض: فعال (POSIX)، پشتیبانی‌نشده (Windows).
غیرفعال‌سازی حفظ حالت و مالکیت اصلی. فایل‌های به‌روزرسانی‌شده uid/gid کاربر اجراکننده و حالت مطابق با umask را به خود می‌گیرند.
تعداد صریح فرآیندهای کارگر (worker). بر --batchSize مقدم است.
تعداد فایل‌ها در هر وظیفهٔ استخر (پیش‌فرض: 16). فایل‌ها به دسته‌هایی با این اندازه تقسیم شده و از طریق imap_unordered بین کارگرها توزیع می‌شوند. مقادیر کوچک‌تر ایمن‌تر هستند (شعاع اثر خرابی کوچک‌تر، سرقت کار یا work-stealing بهتر)؛ مقادیر بزرگ‌تر هزینهٔ سربار به ازای هر وظیفه را سرشکن می‌کنند. در صورت مشخص شدن --workers نادیده گرفته می‌شود.
تعداد رشته‌ها برای شمارش موازی دایرکتوری (پیش‌فرض: 32). برای استفاده از os.walk() تک‌رشته‌ای، مقدار را به 1 تغییر دهید.
گردانندهٔ استخر به‌روزرسانی: اگر برای این تعداد ثانیه هیچ نتیجه‌ای از بخش‌ها (chunk-result) دریافت نشود، تمام بخش‌های تکمیل‌نشده به عنوان کرش‌کرده/قفل‌شده در نظر گرفته شده و از طریق جداسازی زیرپردازشی به ازای هر فایل بازیابی می‌شوند (پیش‌فرض: 120). اگر بخش‌هایی دارید که به‌طور معمول پردازش آن‌ها طولانی است، این مقدار را افزایش دهید.
بازیابی: حد نهایی سخت‌گیرانه برای زیرپردازش جداسازی‌شدهٔ یک فایل (پیش‌فرض: 60). در صورت تجاوز از این زمان، زیرپردازش خاتمه یافته و فایل به عنوان ERROR_CRASH ثبت می‌شود.
سپتامبر 2026 usdupdatecrate 26.08