.nh
.TH umoci(1) # umoci - umoci modifies Open Container images
Aleksa Sarai
SEPTEMBER 2018

.SH "نام (NAME)"
umoci \- ویرایش و اصلاح تصاویر Open Container


.SH "خلاصه دستور (SYNOPSIS)"
\fBumoci\fP
[\fB--help\fP|\fB-h\fP]
[\fB--version\fP|\fB-v\fP]
[\fB--log\fP={\fIdebug\fP|\fIinfo\fP|\fIwarn\fP|\fIerror\fP|\fIfatal\fP}]
[\fB--verbose\fP]
\fIcommand\fP [\fIargs\fP]


.SH "توضیحات (DESCRIPTION)"
\fBumoci\fP ابزاری است که امکان تغییر و ویرایش سطح‌بالای چیدمان تصویر OCI (layout) و تصاویر برچسب‌خوردهٔ آن را فراهم می‌کند. هرچند \fBumoci\fP تلاش می‌کند جزئیات مشخصات فنی تصویر OCI را انتزاعی کند، توصیه می‌شود کاربران این ابزار مشخصات فنی
\[la]https://github.com/opencontainers/image\-spec\[ra] را مطالعه کنند تا ایده و مفهوم کلی آن را به‌خوبی درک نمایند.

.PP
\fBumoci\fP از این جهت منحصربه‌فرد است که در زمان نگارش این مستند، نخستین ابزاری است که امکان اصلاح دلخواه یک تصویر OCI را به‌شکلی سطح‌بالا فراهم می‌آورد (به‌گونه‌ای که تمام blobهای مختلف در تصویر OCI، هنگام انجام عملیات سطح‌بالا مانند \fBumoci-repack\fP(1)، همگی توسط \fBumoci\fP مدیریت می‌شوند).


.SH "گزینه‌های عمومی (GLOBAL OPTIONS)"
\fB--help, -h\fP
  نمایش پیام راهنمای نحوه استفاده.

.PP
\fB--version, -v\fP
  نمایش نسخه.

.PP
\fB--cpu-profile\fP=\fIfilename\fP
  تولید یک پروفایل پردازنده (CPU profile) در حین اجرای umoci و ذخیرهٔ آن در \fIfilename\fP\&.
  این فایل در قالب pprof زبان Go
\[la]https://golang.org/pkg/runtime/pprof\[ra] ذخیره می‌شود و می‌توان با استفاده از \fIgo
  tool pprof\fP یا ابزارهای مشابه آن را تحلیل کرد.

.PP
\fB--log\fP={\fIdebug\fP|\fIinfo\fP|\fIwarn\fP|\fIerror\fP|\fIfatal\fP}
  تنظیم سطح گزارش‌گیری (logging). مقدار پیش‌فرض "warn" است.

.PP
\fB--verbose\fP
  نام مستعار برای \fB--log=info\fP\&.


.SH "دستورها (COMMANDS)"
\fBinit\fP
  ایجاد یک ساختار چیدمان (layout) جدید OCI. برای اطلاعات دقیق‌تر درباره نحوه
  استفاده، \fBumoci-init\fP(1) را ببینید.

.PP
\fBnew\fP
  یک تصویر OCI خالی و برچسب‌خورده ایجاد می‌کند. برای اطلاعات دقیق‌تر درباره نحوه
  استفاده، \fBumoci-new\fP(1) را ببینید.

.PP
\fBunpack\fP
  استخراج یک تصویر برچسب‌خورده درون یک بسته زمان اجرای (runtime bundle) OCI. برای اطلاعات
  دقیق‌تر درباره نحوه استفاده، \fBumoci-unpack\fP(1) را ببینید.

.PP
\fBrepack\fP
  بسته‌بندی مجدد یک بسته زمان اجرای OCI درون یک تصویر برچسب‌خورده. برای اطلاعات
  دقیق‌تر درباره نحوه استفاده، \fBumoci-repack\fP(1) را ببینید.

.PP
\fBconfig\fP
  پیکربندی یک تصویر OCI را تغییر می‌دهد. برای اطلاعات دقیق‌تر درباره نحوه
  استفاده، \fBumoci-config\fP(1) را ببینید.

.PP
\fBstat\fP
  اطلاعات وضعیت یک مانیفست تصویر را نمایش می‌دهد. برای اطلاعات دقیق‌تر درباره نحوه
  استفاده، \fBumoci-stat\fP(1) را ببینید.

.PP
\fBtag\fP
  یک برچسب جدید در تصویر OCI ایجاد می‌کند. برای اطلاعات دقیق‌تر درباره نحوه
  استفاده، \fBumoci-tag\fP(1) را ببینید.

.PP
\fBremove, rm\fP
  یک برچسب را از تصویر OCI حذف می‌کند. برای اطلاعات دقیق‌تر درباره نحوه
  استفاده، \fBumoci-remove\fP(1) را ببینید.

.PP
\fBlist, ls\fP
  مجموعه برچسب‌های موجود در تصویر OCI را فهرست می‌کند. برای اطلاعات دقیق‌تر
  درباره نحوه استفاده، \fBumoci-list\fP(1) را ببینید.

.PP
\fBgc\fP
  تمام blobهای بدون ارجاع تصویر OCI را زباله‌روبی (Garbage collect) می‌کند. برای
  اطلاعات دقیق‌تر درباره نحوه استفاده، \fBumoci-gc\fP(1) را ببینید.


.SH "همچنین ببینید (SEE ALSO)"
\fBumoci-init\fP(1),
\fBumoci-new\fP(1),
\fBumoci-unpack\fP(1),
\fBumoci-repack\fP(1),
\fBumoci-config\fP(1),
\fBumoci-stat\fP(1),
\fBumoci-tag\fP(1),
\fBumoci-remove\fP(1),
\fBumoci-list\fP(1),
\fBumoci-gc\fP(1),
\fBskopeo\fP(1)