ostree-checkout -
استخراج یک
کامیت در یک
سیستم‌فایل
ostree checkout [OPTIONS...] {COMMIT} [DESTINATION]
کامیت
داده‌شده
را در
سیستم‌فایل
در
دایرکتوری
DESTINATION استخراج
می‌کند. اگر
DESTINATION مشخص
نشده باشد،
COMMIT مقصد
استخراج
خواهد شد.
اگر مقصد COMMIT
از قبل وجود
داشته
باشد،
دستور با
خطا مواجه
می‌شود مگر
اینکه
گزینهٔ --union
انتخاب شده
باشد.
--user-mode, -U
مالکیت
فایل‌ها را
تغییر
نمی‌دهد و
صفت‌های
گسترش‌یافته
(extended attributes) را
مقداردهی
اولیه
نمی‌کند.
--subpath="PATH"
زیردایرکتوری
PATH را استخراج
می‌کند.
--union
دایرکتوری‌های
موجود و
فایل‌های
تغییرنیافته
را نگه
می‌دارد و
فایل‌های
موجود را
بازنویسی
می‌کند.
--union-add
دایرکتوری‌ها
و فایل‌های
موجود را
نگه
می‌دارد.
--union-identical
مشابه --union،
اما در
صورتی که
قرار باشد
فایلی با یک
فایل
متفاوت
جایگزین
شود، با خطا
متوقف
می‌شود.
فایل‌ها و
دایرکتوری‌های
جدید را
اضافه
می‌کند، از
فایل‌های
یکسان
صرف‌نظر
می‌کند و
دایرکتوری‌های
موجود را
نگه
می‌دارد. به -H
نیاز دارد.
--whiteouts
فایل‌های
whiteout (به سبک Docker) را
پردازش
می‌کند.
--process-passthrough-whiteouts
استخراج
whiteout مربوط به overlayfs
را در قالب
دستگاه‌های
نویسه‌ای (character
devices) با شناسه 0:0
فعال
می‌کند.
موارد whiteout
مربوط به overlayfs
درون ostree به
صورت .ostree-wh.filename
کدگذاری
شده و به
عنوان
دستگاه‌های
نویسه‌ای 0:0
استخراج
می‌شوند.
این ویژگی
برای حمل
فضای
ذخیره‌سازی
کانتینر
تعبیه‌شده
در ostree مفید
است.
--allow-noent
در صورتی
که مسیر
مشخص‌شده
وجود
نداشته
باشد، هیچ
کاری انجام
نمی‌دهد.
--from-stdin
چندین
استخراج را
از ورودی
استاندارد
(standard input) پردازش
می‌کند.
--from-file="FILE"
چندین
استخراج را
از فایل
ورودی
پردازش
می‌کند.
--fsync="POLICY"
مقدار POLICY
یک متغیر
بولی است که
مشخص
می‌کند آیا
fsync باید
استفاده
شود یا خیر.
پیش‌فرض true
است.
--require-hardlinks, -H
در صورت
عدم موفقیت
در ایجاد
پیوند سخت
(hardlink)، به کپی
کامل
پس‌گرد
نمی‌کند.
--force-copy-zerosized, -z
این
گزینه کاری
انجام
نمی‌دهد؛
این
سازوکار در
حال حاضر
همیشه
به‌طور
پیش‌فرض
فعال است.
--force-copy, -C
هرگز
پیوند سخت
ایجاد
نمی‌کند
(اما در صورت
در دسترس
بودن ممکن
است reflink کند).
--bareuseronly-dirs, -M
بیت‌های
حالت (mode bits) خارج
از 0775 را برای
دایرکتوری‌ها
حذف می‌کند
(مانند suid،
قابلیت
نوشتن
همگانی و
غیره).
--skip-list="FILE"
از
استخراج
مسیرهای
مطلق فایل
فهرست‌شده
در FILE (یک مورد
در هر خط)
صرف‌نظر
می‌کند.
--selinux-policy
برچسب‌های
SELinux را بر اساس
شیوه‌نامهٔ
موجود در
سیستم‌فایل
ریشه PATH
(می‌تواند /
باشد) تنظیم
می‌کند. این
گزینه
مستلزم --force-copy
است.
--composefs
فقط یک composefs
تولید
می‌کند، نه
یک
دایرکتوری.
--composefs-noverity
فقط یک composefs
تولید
می‌کند، نه
یک
دایرکتوری؛
خلاصه‌های
fsverity لحاظ
نخواهند شد.
این گزینه
برای
استفادهٔ
«فرصت‌طلبانه»
از composefs بهترین
کاربرد را
دارد.
$ ostree checkout my-branch
$ ls
