ostree-refs - فهرست
کردن
ارجاع‌ها
ostree refs [OPTIONS...] [PREFIX]
ostree refs {EXISTING} {--create=NEWREF}
تمام
ارجاع‌های
موجود در
میزبان را
فهرست
می‌کند. در
صورت
تعیین، PREFIX
پیشوند refspec را
مشخص
می‌کند؛
پیشوند
پیش‌فرض
تهی (null) است که
تمام
ارجاع‌ها
را فهرست
می‌کند. این
دستور
همچنین
می‌تواند
برای ایجاد
یا حذف
ارجاع‌ها
به کار رود.
--list
به دلایل
تاریخی،
دستور refs بدون
این گزینه،
پیشوند
مشخص‌شده
را از خروجی
حذف می‌کند.
معمولاً
کاربر مایل
است ارجاع
کامل را
ببیند،
بنابراین
تعیین این
گزینه
تضمین
می‌کند که
ارجاع‌ها
به‌جای
بریده شدن،
به‌طور
کامل چاپ
شوند.
--create=NEWREF
یک ارجاع
ایجاد
می‌کند که
به کامیت EXISTING
اشاره دارد.
NEWREF نباید از
قبل وجود
داشته باشد
و EXISTING باید یک
کامیت
موجود باشد.
بیش از یک
ارجاع
می‌تواند
به یک کامیت
یکسان
اشاره کند.
--delete
به‌جای
فهرست کردن
ارجاع‌ها،
مواردی را
که با PREFIX
مطابقت
دارند حذف
می‌کند. اگر
قصد
آزادسازی
فضا را
دارید، پس
از آن باید
دستور ostree prune یا
ostree admin cleanup را اجرا
کنید.
--revision, -r
هنگام
فهرست کردن
ارجاع‌ها،
بازبینی‌های
(revisions) آن‌ها را
نیز چاپ
می‌کند.
بازبینی‌ها
با نویسه تب
(tab) جدا
می‌شوند.
--alias, -A
در صورت
استفاده
همراه با
--create، یک نام
مستعار
ایجاد
می‌کند. در
غیر این
صورت فقط
نام‌های
مستعار را
فهرست
می‌کند.
--collections, -c
تعامل با
ارجاع‌ها
را از طریق
ترکیب
شناسه‌های
مجموعه (collection IDs) و
نام‌های
ارجاع
آن‌ها فعال
می‌کند.
هنگام
فهرست کردن
ارجاع‌ها،
این گزینه
قالب خروجی
را برای
گنجاندن
شناسه‌های
مجموعه
تغییر داده
و امکان
فهرست‌بندی
ارجاع‌های
آینه‌شده
دوردست را
فراهم
می‌سازد.
هنگام
ایجاد
ارجاع‌ها،
مقدار refspec
ارائه‌شده
به گزینه --create
به‌صورت
COLLECTION-ID:REF-NAME در نظر
گرفته شده و
یک ارجاع
آینه‌شده
ایجاد
می‌شود. (این
استفاده‌ای
نامتعارف
از ساختار
نحوی refspec است.)
هنگام حذف
ارجاع‌ها،
تمام
ارجاع‌هایی
که شناسه
مجموعه
آن‌ها
برابر با PREFIX
است حذف
می‌شوند.
--force
هنگام
ایجاد NEWREF با
گزینه --create،
اجازه
می‌دهد یک
ارجاع
موجود
به‌جای
ایجاد خطا
به‌روزرسانی
شود.
$ ostree refs
my-branch
gnome-ostree/buildmain/x86_64-runtime
