.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "virt-login-shell" "1" "" "" "Virtualization Support"
.SH "نام (NAME)"
virt-login-shell \- شل لاگین برای اتصال مستقیم کاربر به کانتینر LXC
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBvirt\-login\-shell\fP [\fIگزینه‌ها\fR]
.SH "توضیحات (DESCRIPTION)"
.sp
برنامه \fBvirt\-login\-shell\fP یک پوسته setuid است که برای پیوستن به
کانتینر LXC متناظر با نام کاربر استفاده می‌شود. اگر کانتینر در حال اجرا
نباشد، \fBvirt\-login\-shell\fP تلاش می‌کند تا آن را راه‌اندازی کند.
کاربر ریشه (root) مجاز به اجرای \fBvirt\-login\-shell\fP نیست. کاربران عادی در
صورتی که نام کاربری آن‌ها با یک کانتینر موجود مطابقت داشته باشد و در فایل
\fB/etc/libvirt/virt\-login\-shell.conf\fP پیکربندی شده باشند، به آن کانتینر
وارد خواهند شد.
.sp
ساختار پایه بیشتر کاربردهای \fBvirt\-login\-shell\fP به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
virt\-login\-shell
.EE
.UNINDENT
.UNINDENT
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-c CMD\fP
.sp
به شل دستور می‌دهد به جای نمایش اعلان شل تعاملی، دستور CMD را اجرا کند.
.sp
\fB\-h\fP, \fB\-\-help\fP
.sp
نمایش راهنمای خط فرمان و خروج.
.sp
\fB\-V\fP, \fB\-\-version\fP
.sp
نمایش اطلاعات نسخه و خروج.
.SH "پیکربندی (CONFIG)"
.sp
به صورت پیش‌فرض، \fBvirt\-login\-shell\fP برنامه \fB/bin/sh\fP را برای
کاربر اجرا می‌کند. می‌توانید این رفتار را با تعریف متغیر shell در فایل
\fB/etc/libvirt/virt\-login\-shell.conf\fP تغییر دهید؛ به عنوان مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
shell = [ \(dq/bin/bash\(dq ]
.EE
.UNINDENT
.UNINDENT
.sp
اگر گزینه پیکربندی \fBauto_shell\fP تنظیم شده باشد، تلاش می‌کند تا شل را به
طور خودکار از فایل \fB/etc/passwd\fP درون کانتینر شناسایی کند. این کار فقط
در صورتی باید انجام شود که کانتینر دایرکتوری \fB/etc\fP مجزایی از میزبان داشته
باشد؛ در غیر این صورت به فراخوانی بازگشتی \fBvirt\-login\-shell\fP منجر خواهد شد؛
به عنوان مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
auto_shell = 1
.EE
.UNINDENT
.UNINDENT
.sp
به طور پیش‌فرض هیچ کاربری مجاز به استفاده از virt\-login\-shell نیست. اگر می‌خواهید
به کاربران خاصی اجازه استفاده از virt\-login\-shell را بدهید، باید متغیر allowed_users
را در فایل /etc/libvirt/virt\-login\-shell.conf تغییر دهید؛ به عنوان مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
allowed_users = [ \(dqtom\(dq, \(dqdick\(dq, \(dqharry\(dq ]
.EE
.UNINDENT
.UNINDENT
.SH "وضعیت خروج (EXIT STATUS)"
.sp
\fBvirt\-login\-shell\fP معمولاً وضعیت خروج دستوری را که اجرا کرده است
بازمی‌گرداند. اگر دستور توسط یک سیگنال متوقف شده باشد، اما آن سیگنال برای
virt\-login\-shell کشنده نباشد، شماره سیگنال به علاوه ۱۲۸ بازگردانده می‌شود.
.sp
وضعیت‌های خروج تولیدشده توسط خود \fBvirt\-login\-shell\fP:
.INDENT 0.0
.IP \(bu 2
\fB0\fP یکی از گزینه‌ها برای کسب اطلاعات بیشتر درباره این فایل اجرایی استفاده شده است.
.IP \(bu 2
\fB125\fP خطای عمومی پیش از تلاش برای اجرای شل پیکربندی‌شده؛ برای مثال اگر libvirtd در حال اجرا نباشد.
.IP \(bu 2
\fB126\fP شل پیکربندی‌شده وجود دارد اما قابل اجرا نیست.
.IP \(bu 2
\fB127\fP شل پیکربندی‌شده یافت نشد.
.UNINDENT
.SH "اشکالات (BUGS)"
.sp
لطفاً هرگونه اشکال کشف‌شده را گزارش دهید. این کار را می‌توانید از طریق یکی از روش‌های زیر انجام دهید:
.INDENT 0.0
.IP 1. 3
فهرست پستی
.sp
\%<https://\:libvirt\:.org/\:contact\:.html>
.IP 2. 3
سیستم ردیابی اشکالات
.sp
\%<https://\:libvirt\:.org/\:bugs\:.html>
.UNINDENT
.sp
همچنین می‌توانید اشکالات را به توزیع‌کننده یا ارائه‌دهنده نرم‌افزار خود گزارش دهید.
.SH "نویسنده (AUTHOR)"
.sp
Daniel Walsh
.SH "حق نشر (COPYRIGHT)"
.sp
حق نشر \(co ۲۰۱۳-۲۰۱۴ متعلق به Red Hat, Inc. و نویسندگان فهرست‌شده در فایل AUTHORS مربوط به libvirt است.
.SH "مجوز (LICENSE)"
.sp
\fBvirt\-login\-shell\fP تحت شرایط مجوز GNU LGPL v2+ منتشر شده است.
این یک نرم‌افزار آزاد است؛ برای شرایط کپی‌برداری به کد منبع مراجعه کنید.
هیچ ضمانتی وجود ندارد؛ حتی برای قابلیت تجاری یا تناسب برای یک هدف خاص.
.SH "همچنین ببینید (SEE ALSO)"
.sp
virsh(1), \%<https://\:libvirt\:.org>
.\" End of generated man page.