OSTREE COMMIT(1) ostree commit OSTREE COMMIT(1)

ostree-commit - ثبت یک بازنگری جدید

ostree commit [OPTIONS...] --branch= {BRANCH} [PATH]

این دستور امکان ثبت تغییرات در یک شاخه را فراهم می‌کند. مشخص کردن شاخه الزامی است. در صورت موفقیت‌آمیز بودن ثبت، چکسام آن چاپ خواهد شد.

--subject, -s="SUBJECT"

موضوع یک‌خطی. (اختیاری)

--body, -m="BODY"

توضیحات کامل. (اختیاری)

--body-file, -F="FILE"

توضیحات کامل ثبت از یک فایل. (اختیاری)

--editor, -e

باز کردن یک ویرایشگر متن برای توضیحات ثبت. این گزینه به ترتیب اولویت نزولی از OSTREE_EDITOR، VISUAL، EDITOR یا vi استفاده می‌کند. در صورتی که پیام خالی رها شود، عملیات ثبت لغو خواهد شد.

--branch, -b="BRANCH"

شاخه. الزامی است، مگر اینکه --orphan مشخص شده باشد.

--parent="COMMIT"

چکسام والد یا "none" برای عدم استفاده صریح از والد. در صورت عدم تعیین، BRANCH به عنوان والد استفاده می‌شود (در صورتی که BRANCH وجود نداشته باشد، والدی نخواهد بود).

--tree="dir=PATH" or "tar=TARFILE" or "ref=COMMIT"

پوشش‌دهی آرگومان داده‌شده به عنوان یک درخت. هنگام ثبت یک آرشیو، TARFILE می‌تواند به صورت - مشخص شود تا آرشیو از ورودی استاندارد خوانده شود.

--base="REV"

شروع از محتوای یک ثبت. این گزینه با --tree=ref=REV متفاوت است چرا که هیچ اصلاح‌کننده ثبتی اعمال نمی‌شود. این حالت معمولاً همان چیزی است که هنگام ایجاد یک ثبت مشتق‌شده مد نظر است. همچنین برای --selinux-policy-from-base استفاده می‌شود.

--add-metadata-string="KEY=VALUE"

افزودن یک جفت کلید/مقدار به متادیتا. می‌تواند چندین بار مشخص شود.

--add-metadata="KEY=VALUE"

افزودن یک جفت کلید/مقدار به متادیتا، که در آن KEY یک رشته و VALUE با قالب ()g_variant_parse است. می‌تواند چندین بار مشخص شود.

--keep-metadata="KEY"

نگه‌داشتن KEY متادیتا و VALUE مرتبط با آن از والد. می‌تواند چندین بار مشخص شود.

--add-detached-metadata-string="KEY=VALUE"

افزودن یک جفت کلید/مقدار به متادیتای جداشده.

--owner-uid="UID"

تنظیم شناسه کاربری (UID) مالکیت فایل.

--owner-gid="GID"

تنظیم شناسه گروهی (GID) مالکیت فایل.

--no-xattrs

عدم درون‌ریزی ویژگی‌های گسترش‌یافته (xattrs).

--selinux-labeling-epoch0 | 1

هنگام فعال بودن برچسب‌گذاری SELinux، مبدا (epoch) 1 تضمین می‌کند که /usr/etc به گونه‌ای برچسب‌گذاری شود که گویی /etc است.

--bootable

تزریق متادیتای استاندارد برای یک درخت سیستم‌فایل لینوکس با قابلیت راه‌اندازی (bootable).

--link-checkout-speedup

بهینه‌سازی برای ثبت درخت‌های متشکل از پیوندهای سخت (hardlinks) به درون مخزن.

--tar-autocreate-parents

هنگام بارگذاری آرشیوهای tar، پوشه‌های والد در صورت نیاز به طور خودکار ایجاد شوند.

--skip-if-unchanged

اگر محتوا نسبت به ثبت قبلی بدون تغییر است، هیچ کاری انجام نشود.

--consume

هنگام ثبت از یک دایرکتوری محلی (یعنی نه یک آرشیو یا --tree=ref)، مالکیت محتوا بر عهده گرفته می‌شود. این ممکن است صرفاً شامل حذف آن باشد، اما در صورت امکان، محتوا ممکن است به سادگی به جای ایجاد یک نسخه جدید، با ()rename به درون مخزن منتقل شود.

--statoverride="PATH"

فایل شامل فهرستی از تغییرات برای اعمال بر مجوزها (حالت فایل به صورت ده‌دهی، به دنبال آن فاصله، و به دنبال آن مسیر فایل). حالت مشخص‌شده با حالت اصلی فایل OR منطقی می‌شود، مگر اینکه با "=" شروع شده باشد.

--skip-list="PATH"

فایل حاوی فهرستی از مسیرهای فایل برای نادیده گرفتن (یک مسیر در هر خط).

--table-output

خروجی دادن اطلاعات بیشتر در قالب KEY: VALUE.

--generate-sizes

تولید اطلاعات اندازه همراه با متادیتای ثبت.

--gpg-sign="KEY-ID"

شناسه کلید GPG جهت امضای ثبت (در صورت ساخته شدن با GPGME - GNU Privacy Guard Made Easy).

برای استفاده از یک زیرکلید خاص، اثر انگشت زیرکلید را به دنبال ! ارسال کنید.

--gpg-homedir="HOMEDIR"

دایرکتوری خانگی GPG جهت استفاده هنگام جستجوی دسته‌کلیدها (در صورت ساخته شدن با GPGME - GNU Privacy Guard Made Easy).

--timestamp="TIMESTAMP"

بازنویسی برچسب زمانی ثبت با مقدار TIMESTAMP.

--orphan

ایجاد یک ثبت بدون نوشتن روی یک ارجاع (شاخه)

--fsync="POLICY"

مقدار POLICY یک متغیر بولی است که مشخص می‌کند آیا fsync باید استفاده شود یا خیر. پیش‌فرض true است.

-s, --sign-type

استفاده از یک موتور امضای خاص. انواع امضای موجود در حال حاضر: ed25519, spki و dummy هستند. مقدار پیش‌فرض ed25519 است.

--sign-from-file="PATH"

این گزینه کلید (متناظر با مقدار مشخص‌شده برای --sign-type ) را از مسیر داده‌شده می‌خواند. انکودینگ کلید به موتور امضا بستگی دارد. برای ed25519 کلید باید با base64 کدگذاری شده باشد، برای spki باید در قالب PEM باشد، و برای dummy باید یک رشته ASCII باشد.

--sign="KEY-ID"

در کدهای جدید از استفاده از این گزینه خودداری کنید، زیرا ارسال کلیدهای خصوصی از طریق آرگومان‌های خط فرمان مستعد افشا در لاگ‌ها و فهرست پردازش‌ها است.

مقدار KEY-ID عبارت است از:

برای ed25519 و spki:

کلید محرمانه کدگذاری‌شده با base64 برای امضای ثبت.

برای dummy:

رشته ASCII به عنوان کلید محرمانه.

$ ostree commit --branch=my-branch --subject="Initial commit";

67e382b11d213a402a5313e61cbc69dfd5ab93cb07fbb8b71c2e84f79fa5d7dc
OSTree