'\" t
.TH "CAPSULE@\&.SERVICE" "5" "" "systemd 261.2" "capsule@.service"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
capsule@.service \- سرویسهای کاربری کپسول سیستمدی (systemd)
.SH "خلاصه دستور (SYNOPSIS)"
.PP
capsule@\fINAME\fR\&.service
.SH "توضیحات (DESCRIPTION)"
.PP
مدیران سرویس برای کپسول‌ها در واحدهای سیستمی
capsule@\fINAME\fR\&.service
اجرا می‌شوند که در آن‌ها نام کپسول به عنوان شناسه نمونه عمل می‌کند\&. کپسول‌ها راهکاری برای اجرای نمونه‌های اضافی از مدیر سرویس تحت شناسه‌های کاربری پویا (UIDهای پویا) هستند؛ یعنی UIDهایی که هنگام راه‌اندازی مدیر سرویس کپسول تخصیص یافته و پس از توقف آن آزاد می‌شوند\&.
.PP
از جهات بسیاری
capsule@\&.service
مشابه مدیر سرویس مختص هر کاربر
user@\&.service
است، اما چند تمایز مهم وجود دارد:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
مدیر سرویس کپسول از
\fIDynamicUser=\fR
(ببینید
\fBsystemd.exec\fR(5))
برای تخصیص پویای یک UID جدید هنگام فراخوانی استفاده می‌کند\&. نام کاربری به طور خودکار از نام کپسول با افزودن پیشوند
"c\-"
تولید می‌شود\&. با خاتمه یافتن سرویس، این UID آزاد می‌گردد\&. در مقابل، مدیر سرویس کاربر تحت یک شناسه کاربری ایستا کار می‌کند که باید پیش از فراخوانی مدیر سرویس کاربر از پیش وجود داشته باشد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
مدیران سرویس کاربر خود را در
\fBpam\fR(8)
ثبت می‌کنند، اما مدیران سرویس کپسول این کار را انجام نمی‌دهند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
مدیران سرویس کاربر معمولاً پیکربندی خود را از یک دایرکتوری
\fI$HOME\fR
در زیر مسیر
/home/
می‌خوانند، در حالی که مدیران سرویس کپسول آن را از یک دایرکتوری
\fI$HOME\fR
در زیر مسیر
/var/lib/capsules/
بارگیری می‌کنند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
مدیران سرویس کاربر همگی در واحد
user\&.slice
قرار دارند، در حالی که مدیران سرویس کپسول در
capsule\&.slice
جای می‌گیرند\&. همچنین ببینید
\fBsystemd.special\fR(7)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
مدیران سرویس کاربر در ابتدا واحد کاربری
default\&.target
را شروع می‌کنند\&. در عوض، مدیران سرویس کپسول واحد کاربری
capsule@\&.target
را فراخوانی می‌نمایند\&.
.RE
.PP
دسترسی به مدیر سرویس کپسول و کارگزار گذرگاه (bus broker) کپسول از طریق گزینه
\fB\-\-capsule=\fR
در دستورات
\fBsystemctl\fR(1)،
\fBsystemd-run\fR(1)
و
\fBbusctl\fR(1)
امکان‌پذیر است\&.
.PP
کپسول‌های جدید را می‌توان با یک دستور ساده
\fBsystemctl start capsule@\fR\fB\fINAME\fR\fR\fB\&.service\fR
شروع کرد و با
\fBsystemctl stop capsule@\fR\fB\fINAME\fR\fR\fB\&.service\fR
متوقف نمود\&. شروع یک کپسول در صورت موجود نبودن دایرکتوری خانگی، دایرکتوری
/var/lib/capsules/\fINAME\fR/
را به صورت ضمنی ایجاد خواهد کرد\&. همچنین یک دایرکتوری زمان اجرا (runtime) به صورت
/run/capsules/\fINAME\fR/
ساخته می‌شود\&. برای حذف این منابع از دستور
\fBsystemctl clean capsule@\fR\fB\fINAME\fR\fR\fB\&.service\fR،
برای مثال همراه با گزینه
\fB\-\-what=all\fR
استفاده کنید\&.
.PP
واحد
capsule@\&.service
یک فرآیند مدیر سرویس
\fBsystemd \-\-user\fR
را فراخوانی می‌کند\&. این بدان معناست که فایل‌های واحد بر اساس همان قوانین مدیران سرویس کاربر معمولی جستجو می‌شوند، برای مثال در
/var/lib/capsules/\fINAME\fR/\&.config/systemd/user/\&.
.PP
نام‌های کپسول می‌توانند آزادانه توسط کاربر انتخاب شوند؛ با این حال، باید به عنوان نام فایل یونیکس معتبر باشند (یعنی حداکثر ۲۵۵ کاراکتر و فاقد
"/")،
و هنگامی که پیشوند
"c\-"
به آن‌ها اضافه می‌شود، به عنوان یک نام کاربری مطابق با قوانین سخت‌گیرانه POSIX مناسب باشند؛ برای جزئیات به
\m[blue]\fBUser/Group Name Syntax\fR\m[]\&\s-2\u[1]\d\s+2
مراجعه کنید\&.
.PP
اضافه شده در نسخه 256\&.
.SH "مثال‌ها (EXAMPLES)"
.PP
\fBمثال\ \&1.\ \&ایجاد یک کپسول جدید، اجرای دو برنامه در آن (یکی به صورت تعاملی)، خاتمه دادن به آن و پاکسازی کامل همه چیز\fR
.sp
.if n \{\
.RS 4
.\}
.nf
# systemctl start capsule@tatze\&.service
# systemd\-run \-\-capsule=tatze \-\-unit=sleeptest\&.service sleep 999
# systemctl \-\-capsule=tatze status sleeptest\&.service
# systemd\-run \-t \-\-capsule=tatze bash
# systemctl \-\-capsule=tatze stop sleeptest\&.service
# systemctl stop capsule@tatze\&.service
# systemctl clean \-\-all capsule@tatze\&.service
.fi
.if n \{\
.RE
.\}
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsystemd\fR(1), \fBuser@.service\fR(5), \fBsystemd.service\fR(5), \fBsystemd.slice\fR(5), \fBsystemd.exec\fR(5), \fBsystemd.special\fR(7), \fBsystemctl\fR(1), \fBsystemd-run\fR(1), \fBbusctl\fR(1), \fBpam\fR(8)
.SH "یادداشت‌ها (NOTES)"
.IP " 1." 4
User/Group Name Syntax
.RS 4
\%https://systemd.io/USER_NAMES
.RE