.\" Generated by scdoc 1.11.5
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "SYD\-OCI" "1" "2026\-09\-01"
.PP
.SH "نام (NAME)"
syd-oci \- رابط کانتینری سازگار با OCI برای جعبه‌شنی syd
.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBsyd\-oci\fR \fI[OPTIONS]\fR \fI[COMMAND]\fR
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
ابزار syd\-oci یک پیاده‌سازی از زمان اجرای کانتینر OCI برای \fIsyd\fR(1) است.\&
.PP
از تمامی زیردستورهای متداول پشتیبانی می‌شود: create، start، state، kill،
delete، pause، resume، exec، run، list، ps، spec، events، features،
update.\& پشتیبانی از نقطه بررسی/بازیابی (checkpoint/restore) در آینده نزدیک برنامه‌ریزی شده است.\& برای اطلاعات بیشتر، به موضوع مربوطه در youki در نشانی
https://github.\&com/youki\-dev/youki/issues/142
مراجعه کنید.\&
.PP
.SH "یکپارچه‌سازی (INTEGRATION)"
.PP
ابزار syd\-oci یک پوشش سبک پیرامون \fIyouki\fR(1) است که جعبه‌شنی \fIsyd\fR(1)
را درون کانتینرها یکپارچه می‌سازد.\& این ابزار با \fIdocker\fR(1) و
\fIpodman\fR(1) سازگار است.\& برای داشتن syd\-oci، باید \fIsyd\fR(1) را با قابلیت \fBoci\fR
کامپایل کنید.\& برای استفاده از syd\-oci با \fIdocker\fR(1) دو گزینه دارید: یا
\fIdockerd\fR(8) را به‌صورت دستی با گزینه
\fB\-\-add\-runtime=syd\-oci=/bin/syd\-oci\fR
راه‌اندازی کنید و هنگام شروع کانتینرها به عنوان مثال دستور
\fBdocker run \-it \-\-runtime=syd\-oci alpine\fR
را اجرا کنید، یا قطعه کد زیر را به فایل \fB/etc/docker/daemon.\&json\fR خود بیفزایید:
.PP
.nf
.RS 4
{
"runtimes": { "syd\-oci": { "path": "/bin/syd\-oci" } },
"default\-runtime": "syd\-oci"
}
.fi
.RE
.PP
ممکن است بسته به نحوه نصب خود نیاز داشته باشید مسیر syd\-oci را تنظیم کنید.\&
استفاده با \fIpodman\fR(1) نیز مشابه است، کافی است
\fB\-\-runtime=/bin/syd\-oci\fR
را به عنوان یک گزینه به \fBpodman run\fR ارسال کنید.\&
.PP
.SH "پیکربندی (CONFIGURATION)"
.PP
دایرکتوری پیکربندی syd\-oci یکی از موارد زیر است:
.PP
.PD 0
.IP \(bu 4
برای کانتینرهای سراسری سیستم: \fB/etc/syd/oci\fR
.IP \(bu 4
برای کانتینرهای بدون ریشه (rootless)، یکی از موارد زیر:
  \- \fB${XDG_CONFIG_HOME}/syd/oci\fR که در آن XDG_CONFIG_HOME معمولاً \fB\(ti/.\&config\fR است.\&
  \- \fB${HOME}/.\&syd/oci\fR اگر XDG_CONFIG_HOME تنظیم نشده باشد.\&
.PD
.PP
ابزار syd\-oci تلاش می‌کند تا جعبه‌شنی \fIsyd\fR(1) را به ترتیب زیر پیکربندی کند،
و اولین فایل یا نمایه (profile) یافت‌شده را تجزیه کرده و پردازش را متوقف می‌کند؛
می‌توان متغیر محیطی \fBSYD_OCI_NO_CONFIG\fR را برای پرش به مرحله نهایی تنظیم کرد:
.PP
.PD 0
.IP \(bu 4
اگر hostname و domainname برای کانتینر تعریف شده باشند، تلاش برای بارگذاری
\fB${SYD_CONFIG_DIR}/${hostname}.\&${domainname}.\&syd\-3\fR.\&
.IP \(bu 4
اگر domainname برای کانتینر تعریف شده باشد، تلاش برای بارگذاری
\fB${SYD_CONFIG_DIR}/${domainname}.\&syd\-3\fR.\&
.IP \(bu 4
اگر hostname برای کانتینر تعریف شده باشد، تلاش برای بارگذاری
\fB${SYD_CONFIG_DIR}/${hostname}.\&syd\-3\fR.\&
.IP \(bu 4
تلاش برای بارگذاری \fB${SYD_CONFIG_DIR}/default.\&syd\-3\fR
.IP \(bu 4
بارگذاری نمایه توکار \fBoci\fR.\&
این نمایه برای ترکیب با \fIpandora\fR(1) و حالت یادگیری طراحی شده است.\&
برای مشاهده فهرست قوانین به \fBsyd\-cat \-p oci\fR مراجعه کنید.\&
.PD
.PP
عبارت SYD_CONFIG_DIR در موارد بالا به دایرکتوری پیکربندی اشاره دارد.\&
برای آگاهی از نحو فایل‌های پیکربندی \fIsyd\fR(1) به \fIsyd\fR(5) و
برای فهرستی از موارد پیکربندی که \fIsyd\fR(1) درک می‌کند به \fIsyd\fR(2) مراجعه کنید.\&
یک فایل برجسته‌سازی نحو برای \fIvim\fR(1) نیز ارائه شده است تا ویرایش
فایل‌های پیکربندی \fIsyd\fR(1) آسان‌تر باشد.\& از \fBsyd\-cat file.\&syd\-3\fR
برای بررسی خطاهای نحوی فایل پیکربندی \fIsyd\fR(1) استفاده کنید.\&
.PP
پیکربندی پیدا شده عیناً در زمان create در یادداشت (annotation) کانتینر در
\fBorg.\&exherbo.\&syd.\&config\fR
ثبت می‌شود، که پس از آن جعبه‌شنی از روی آن مقداردهی اولیه می‌گردد؛
بنابراین فرایندهای exec از قوانین جعبه‌شنی فرایند init اشتراک می‌گیرند.\&
.PP
در نهایت، توجه داشته باشید که دستورالعمل‌های \fBinclude\fR در فایل‌های پیکربندی
syd\-oci پشتیبانی نمی‌شوند.\& این امر برای اطمینان از این است که فرایند اصلی و
فرایندهای exec قوانین جعبه‌شنی یکسانی داشته باشند.\&
.PP
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fIsyd\fR(1), \fIsyd\fR(2), \fIsyd\fR(5), \fIsyd\fR(7), \fIpandora\fR(1), \fIdocker\fR(1),
\fIdockerd\fR(8), \fIpodman\fR(1), \fIyouki\fR(1)
.PP
.PD 0
.IP \(bu 4
صفحه خانگی \fBsyd\fR: https://sydbox.\&exherbo.\&org
.IP \(bu 4
صفحه خانگی \fByouki\fR: https://containers.\&github.\&io/youki
.PD
.PP
.SH "نویسندگان (AUTHORS)"
.PP
نگه‌داری شده توسط Ali Polatel.\& سورس‌های به‌روز را می‌توان در
https://gitlab.\&exherbo.\&org/sydbox/sydbox.\&git
و روی Radicle در
rad:z38HCnbmcDegA2BMxuPaPRPMdp6wF
یافت.\& اشکالات/وصله‌ها را می‌توان به
https://gitlab.\&exherbo.\&org/groups/sydbox/\-/issues
ارسال کرد.\& گفتگو در #sydbox در Libera Chat یا در #sydbox:mailstation.\&de در Matrix.\&